WPILibC++ 2023.4.3
frc::LTVUnicycleController Class Reference

The linear time-varying unicycle controller has a similar form to the LQR, but the model used to compute the controller gain is the nonlinear model linearized around the drivetrain's current state. More...

#include <frc/controller/LTVUnicycleController.h>

Public Member Functions

 LTVUnicycleController (units::second_t dt, units::meters_per_second_t maxVelocity=9_mps)
 Constructs a linear time-varying unicycle controller with default maximum desired error tolerances of (0.0625 m, 0.125 m, 2 rad) and default maximum desired control effort of (1 m/s, 2 rad/s). More...
 
 LTVUnicycleController (const wpi::array< double, 3 > &Qelems, const wpi::array< double, 2 > &Relems, units::second_t dt, units::meters_per_second_t maxVelocity=9_mps)
 Constructs a linear time-varying unicycle controller. More...
 
 LTVUnicycleController (LTVUnicycleController &&)=default
 Move constructor. More...
 
LTVUnicycleControlleroperator= (LTVUnicycleController &&)=default
 Move assignment operator. More...
 
bool AtReference () const
 Returns true if the pose error is within tolerance of the reference. More...
 
void SetTolerance (const Pose2d &poseTolerance)
 Sets the pose error which is considered tolerable for use with AtReference(). More...
 
ChassisSpeeds Calculate (const Pose2d &currentPose, const Pose2d &poseRef, units::meters_per_second_t linearVelocityRef, units::radians_per_second_t angularVelocityRef)
 Returns the linear and angular velocity outputs of the LTV controller. More...
 
ChassisSpeeds Calculate (const Pose2d &currentPose, const Trajectory::State &desiredState)
 Returns the linear and angular velocity outputs of the LTV controller. More...
 
void SetEnabled (bool enabled)
 Enables and disables the controller for troubleshooting purposes. More...
 

Detailed Description

The linear time-varying unicycle controller has a similar form to the LQR, but the model used to compute the controller gain is the nonlinear model linearized around the drivetrain's current state.

See section 8.9 in Controls Engineering in FRC for a derivation of the control law we used shown in theorem 8.9.1.

Constructor & Destructor Documentation

◆ LTVUnicycleController() [1/3]

frc::LTVUnicycleController::LTVUnicycleController ( units::second_t  dt,
units::meters_per_second_t  maxVelocity = 9_mps 
)
explicit

Constructs a linear time-varying unicycle controller with default maximum desired error tolerances of (0.0625 m, 0.125 m, 2 rad) and default maximum desired control effort of (1 m/s, 2 rad/s).

Parameters
dtDiscretization timestep.
maxVelocityThe maximum velocity for the controller gain lookup table.
Exceptions
std::domain_errorif maxVelocity <= 0.

◆ LTVUnicycleController() [2/3]

frc::LTVUnicycleController::LTVUnicycleController ( const wpi::array< double, 3 > &  Qelems,
const wpi::array< double, 2 > &  Relems,
units::second_t  dt,
units::meters_per_second_t  maxVelocity = 9_mps 
)

Constructs a linear time-varying unicycle controller.

Parameters
QelemsThe maximum desired error tolerance for each state.
RelemsThe maximum desired control effort for each input.
dtDiscretization timestep.
maxVelocityThe maximum velocity for the controller gain lookup table.
Exceptions
std::domain_errorif maxVelocity <= 0.

◆ LTVUnicycleController() [3/3]

frc::LTVUnicycleController::LTVUnicycleController ( LTVUnicycleController &&  )
default

Move constructor.

Member Function Documentation

◆ AtReference()

bool frc::LTVUnicycleController::AtReference ( ) const

Returns true if the pose error is within tolerance of the reference.

◆ Calculate() [1/2]

ChassisSpeeds frc::LTVUnicycleController::Calculate ( const Pose2d currentPose,
const Pose2d poseRef,
units::meters_per_second_t  linearVelocityRef,
units::radians_per_second_t  angularVelocityRef 
)

Returns the linear and angular velocity outputs of the LTV controller.

The reference pose, linear velocity, and angular velocity should come from a drivetrain trajectory.

Parameters
currentPoseThe current pose.
poseRefThe desired pose.
linearVelocityRefThe desired linear velocity.
angularVelocityRefThe desired angular velocity.

◆ Calculate() [2/2]

ChassisSpeeds frc::LTVUnicycleController::Calculate ( const Pose2d currentPose,
const Trajectory::State desiredState 
)

Returns the linear and angular velocity outputs of the LTV controller.

The reference pose, linear velocity, and angular velocity should come from a drivetrain trajectory.

Parameters
currentPoseThe current pose.
desiredStateThe desired pose, linear velocity, and angular velocity from a trajectory.

◆ operator=()

LTVUnicycleController & frc::LTVUnicycleController::operator= ( LTVUnicycleController &&  )
default

Move assignment operator.

◆ SetEnabled()

void frc::LTVUnicycleController::SetEnabled ( bool  enabled)

Enables and disables the controller for troubleshooting purposes.

Parameters
enabledIf the controller is enabled or not.

◆ SetTolerance()

void frc::LTVUnicycleController::SetTolerance ( const Pose2d poseTolerance)

Sets the pose error which is considered tolerable for use with AtReference().

Parameters
poseTolerancePose error which is tolerable.

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