frc::DifferentialDriveKinematics Class Reference

Helper class that converts a chassis velocity (dx and dtheta components) to left and right wheel velocities for a differential drive. More...

#include <frc/kinematics/DifferentialDriveKinematics.h>

Inheritance diagram for frc::DifferentialDriveKinematics:

Public Member Functions
	DifferentialDriveKinematics (units::meter_t trackWidth)
	Constructs a differential drive kinematics object. More...
constexpr ChassisSpeeds	ToChassisSpeeds (const DifferentialDriveWheelSpeeds &wheelSpeeds) const override
	Returns a chassis speed from left and right component velocities using forward kinematics. More...
constexpr DifferentialDriveWheelSpeeds	ToWheelSpeeds (const ChassisSpeeds &chassisSpeeds) const override
	Returns left and right component velocities from a chassis speed using inverse kinematics. More...
constexpr Twist2d	ToTwist2d (const units::meter_t leftDistance, const units::meter_t rightDistance) const
	Returns a twist from left and right distance deltas using forward kinematics. More...
Twist2d	ToTwist2d (const DifferentialDriveWheelPositions &start, const DifferentialDriveWheelPositions &end) const override
	Performs forward kinematics to return the resulting Twist2d from the given change in wheel positions. More...
virtual ChassisSpeeds	ToChassisSpeeds (const DifferentialDriveWheelSpeeds &wheelSpeeds) const=0
	Performs forward kinematics to return the resulting chassis speed from the wheel speeds. More...
virtual DifferentialDriveWheelSpeeds	ToWheelSpeeds (const ChassisSpeeds &chassisSpeeds) const=0
	Performs inverse kinematics to return the wheel speeds from a desired chassis velocity. More...
virtual Twist2d	ToTwist2d (const DifferentialDriveWheelPositions &start, const DifferentialDriveWheelPositions &end) const=0
	Performs forward kinematics to return the resulting Twist2d from the given change in wheel positions. More...

Public Attributes
units::meter_t	trackWidth
	Differential drive trackwidth. More...

Detailed Description

Helper class that converts a chassis velocity (dx and dtheta components) to left and right wheel velocities for a differential drive.

Inverse kinematics converts a desired chassis speed into left and right velocity components whereas forward kinematics converts left and right component velocities into a linear and angular chassis speed.

Constructor & Destructor Documentation

DifferentialDriveKinematics()

frc::DifferentialDriveKinematics::DifferentialDriveKinematics ( units::meter_t  trackWidth )

inlineexplicit

Constructs a differential drive kinematics object.

Parameters

trackWidth

The track width of the drivetrain. Theoretically, this is the distance between the left wheels and right wheels. However, the empirical value may be larger than the physical measured value due to scrubbing effects.

Member Function Documentation

ToChassisSpeeds()

constexpr ChassisSpeeds frc::DifferentialDriveKinematics::ToChassisSpeeds ( const DifferentialDriveWheelSpeeds &  wheelSpeeds ) const

inlineconstexproverridevirtual

Returns a chassis speed from left and right component velocities using forward kinematics.

Parameters

wheelSpeeds

The left and right velocities.

Returns

The chassis speed.

Implements frc::Kinematics< DifferentialDriveWheelSpeeds, DifferentialDriveWheelPositions >.

ToTwist2d() [1/2]

Twist2d frc::DifferentialDriveKinematics::ToTwist2d ( const DifferentialDriveWheelPositions &  start, const DifferentialDriveWheelPositions &  end  ) const

inlineoverridevirtual

Performs forward kinematics to return the resulting Twist2d from the given change in wheel positions.

This method is often used for odometry – determining the robot's position on the field using changes in the distance driven by each wheel on the robot.

Parameters

start	The starting distances driven by the wheels.
end	The ending distances driven by the wheels.

Returns

The resulting Twist2d in the robot's movement.

Implements frc::Kinematics< DifferentialDriveWheelSpeeds, DifferentialDriveWheelPositions >.

ToTwist2d() [2/2]

constexpr Twist2d frc::DifferentialDriveKinematics::ToTwist2d ( const units::meter_t  leftDistance, const units::meter_t  rightDistance  ) const

inlineconstexpr

Returns a twist from left and right distance deltas using forward kinematics.

Parameters

leftDistance	The distance measured by the left encoder.
rightDistance	The distance measured by the right encoder.

Returns

The resulting Twist2d.

ToWheelSpeeds()

constexpr DifferentialDriveWheelSpeeds frc::DifferentialDriveKinematics::ToWheelSpeeds ( const ChassisSpeeds &  chassisSpeeds ) const

inlineconstexproverridevirtual

Returns left and right component velocities from a chassis speed using inverse kinematics.

Parameters

chassisSpeeds

The linear and angular (dx and dtheta) components that represent the chassis' speed.

Returns

The left and right velocities.

Implements frc::Kinematics< DifferentialDriveWheelSpeeds, DifferentialDriveWheelPositions >.

Member Data Documentation

trackWidth

units::meter_t frc::DifferentialDriveKinematics::trackWidth

Differential drive trackwidth.

---

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

• frc/kinematics/DifferentialDriveKinematics.h