Robot Core Documentation
|
Public Member Functions | |
SwerveDriveOdometry (SwerveDriveKinematics kinematics, Rotation2d gyroAngle, SwerveModulePosition[] modulePositions, Pose2d initialPose) | |
SwerveDriveOdometry (SwerveDriveKinematics kinematics, Rotation2d gyroAngle, SwerveModulePosition[] modulePositions) | |
void | resetPosition (Rotation2d gyroAngle, SwerveModulePosition[] modulePositions, Pose2d pose) |
Pose2d | update (Rotation2d gyroAngle, SwerveModulePosition[] modulePositions) |
Class for swerve drive odometry. Odometry allows you to track the robot's position on the field over a course of a match using readings from your swerve drive encoders and swerve azimuth encoders.
Teams can use odometry during the autonomous period for complex tasks like path following. Furthermore, odometry can be used for latency compensation when using computer-vision systems.
edu.wpi.first.math.kinematics.SwerveDriveOdometry.SwerveDriveOdometry | ( | SwerveDriveKinematics | kinematics, |
Rotation2d | gyroAngle, | ||
SwerveModulePosition[] | modulePositions, | ||
Pose2d | initialPose ) |
Constructs a SwerveDriveOdometry object.
kinematics | The swerve drive kinematics for your drivetrain. |
gyroAngle | The angle reported by the gyroscope. |
modulePositions | The wheel positions reported by each module. |
initialPose | The starting position of the robot on the field. |
edu.wpi.first.math.kinematics.SwerveDriveOdometry.SwerveDriveOdometry | ( | SwerveDriveKinematics | kinematics, |
Rotation2d | gyroAngle, | ||
SwerveModulePosition[] | modulePositions ) |
Constructs a SwerveDriveOdometry object with the default pose at the origin.
kinematics | The swerve drive kinematics for your drivetrain. |
gyroAngle | The angle reported by the gyroscope. |
modulePositions | The wheel positions reported by each module. |
void edu.wpi.first.math.kinematics.SwerveDriveOdometry.resetPosition | ( | Rotation2d | gyroAngle, |
SwerveModulePosition[] | modulePositions, | ||
Pose2d | pose ) |
Resets the robot's position on the field.
The gyroscope angle does not need to be reset here on the user's robot code. The library automatically takes care of offsetting the gyro angle.
Similarly, module positions do not need to be reset in user code.
gyroAngle | The angle reported by the gyroscope. |
modulePositions | The wheel positions reported by each module., |
pose | The position on the field that your robot is at. |
Pose2d edu.wpi.first.math.kinematics.SwerveDriveOdometry.update | ( | Rotation2d | gyroAngle, |
SwerveModulePosition[] | modulePositions ) |
Updates the robot's position on the field using forward kinematics and integration of the pose over time. This method automatically calculates the current time to calculate period (difference between two timestamps). The period is used to calculate the change in distance from a velocity. This also takes in an angle parameter which is used instead of the angular rate that is calculated from forward kinematics.
gyroAngle | The angle reported by the gyroscope. |
modulePositions | The current position of all swerve modules. Please provide the positions in the same order in which you instantiated your SwerveDriveKinematics. |