OdometryBase Class Reference

#include <odometry_base.h>

Inheritance diagram for OdometryBase:

Public Member Functions
	OdometryBase (bool is_async)
virtual Pose2d	get_position (void)
virtual void	set_position (const Pose2d &newpos=zero_pos)
virtual Pose2d	update ()=0
void	end_async ()
virtual double	get_speed ()
virtual double	get_accel ()
double	get_angular_speed_deg ()
double	get_angular_accel_deg ()

Static Public Member Functions
static int	background_task (void *ptr)
static double	smallest_angle (double start_deg, double end_deg)

Public Attributes
bool	end_task = false
	end_task is true if we instruct the odometry thread to shut down
vex::task *	handle
vex::mutex	mut
Pose2d	current_pos
double	speed
double	accel
double	ang_speed_deg
double	ang_accel_deg

Detailed Description

OdometryBase

This base class contains all the shared code between different implementations of odometry. It handles the asynchronous management, position input/output and basic math functions, and holds positional types specific to field orientation.

All future odometry implementations should extend this file and redefine update() function.

Author

Ryan McGee

Date

Aug 11 2021

Constructor & Destructor Documentation

OdometryBase()

OdometryBase::OdometryBase

(

bool

is_async

)

Construct a new Odometry Base object

Parameters

is_async

True to run constantly in the background, false to call update() manually

Member Function Documentation

background_task()

int OdometryBase::background_task ( void * ptr )

static

Function that runs in the background task. This function pointer is passed to the vex::task constructor.

Parameters

ptr	Pointer to OdometryBase object

Returns

Required integer return code. Unused.

end_async()

void OdometryBase::end_async

(

)

End the background task. Cannot be restarted. If the user wants to end the thread but keep the data up to date, they must run the update() function manually from then on.

get_accel()

double OdometryBase::get_accel ( )

virtual

Get the current acceleration

Returns

the acceleration rate of the robot (inch/s^2)

get_angular_accel_deg()

double OdometryBase::get_angular_accel_deg

(

)

Get the current angular acceleration in degrees

Returns

the angular acceleration at which we are turning (deg/s^2)

get_angular_speed_deg()

double OdometryBase::get_angular_speed_deg

(

)

Get the current angular speed in degrees

Returns

the angular velocity at which we are turning (deg/s)

get_position()

Pose2d OdometryBase::get_position ( void )

virtual

Gets the current position and rotation

Returns

the position that the odometry believes the robot is at

Gets the current position and rotation

get_speed()

double OdometryBase::get_speed ( )

virtual

Get the current speed

Returns

the speed at which the robot is moving and grooving (inch/s)

set_position()

void OdometryBase::set_position ( const Pose2d & newpos = zero_pos )

virtual

Sets the current position of the robot

Parameters

newpos

the new position that the odometry will believe it is at

Sets the current position of the robot

Reimplemented in OdometryTank.

smallest_angle()

double OdometryBase::smallest_angle ( double start_deg, double end_deg )

static

Get the smallest difference in angle between a start heading and end heading. Returns the difference between -180 degrees and +180 degrees, representing the robot turning left or right, respectively.

Parameters

start_deg	intitial angle (degrees)
end_deg	final angle (degrees)

Returns

the smallest angle from the initial to the final angle. This takes into account the wrapping of rotations around 360 degrees

Get the smallest difference in angle between a start heading and end heading. Returns the difference between -180 degrees and +180 degrees, representing the robot turning left or right, respectively.

update()

virtual Pose2d OdometryBase::update ( )

pure virtual

Update the current position on the field based on the sensors

Returns

the location that the robot is at after the odometry does its calculations

Implemented in Odometry3Wheel, and OdometryTank.

Member Data Documentation

accel

double OdometryBase::accel

the rate at which we are accelerating (inch/s^2)

ang_accel_deg

double OdometryBase::ang_accel_deg

the rate at which we are accelerating our turn (deg/s^2)

ang_speed_deg

double OdometryBase::ang_speed_deg

the speed at which we are turning (deg/s)

current_pos

Pose2d OdometryBase::current_pos

Current position of the robot in terms of x,y,rotation

handle

vex::task* OdometryBase::handle

handle to the vex task that is running the odometry code

mut

vex::mutex OdometryBase::mut

Mutex to control multithreading

speed

double OdometryBase::speed

the speed at which we are travelling (inch/s)

---

The documentation for this class was generated from the following files:

• odometry_base.h
• odometry_base.cpp