KilloughDrive

class wpilib.drive.KilloughDrive(*args, **kwargs)

Bases: wpilib.drive.RobotDriveBase, wpilib.Sendable

A class for driving Killough drive platforms.

Killough drives are triangular with one omni wheel on each corner.

Drive base diagram:

/_____ * / \   /  *    \ /
  ---

Each Drive() function provides different inverse kinematic relations for a Killough drive. The default wheel vectors are parallel to their respective opposite sides, but can be overridden. See the constructor for more information.

This library uses the NED axes convention (North-East-Down as external reference in the world frame): http://www.nuclearprojects.com/ins/images/axis_big.png.

The positive X axis points ahead, the positive Y axis points right, and the and the positive Z axis points down. Rotations follow the right-hand rule, so clockwise rotation around the Z axis is positive.

Overloaded function.

  1. __init__(self: wpilib.drive._drive.KilloughDrive, leftMotor: wpilib.interfaces._interfaces.SpeedController, rightMotor: wpilib.interfaces._interfaces.SpeedController, backMotor: wpilib.interfaces._interfaces.SpeedController) -> None

Construct a Killough drive with the given motors and default motor angles.

The default motor angles make the wheels on each corner parallel to their respective opposite sides.

If a motor needs to be inverted, do so before passing it in.

Parameters
  • leftMotor – The motor on the left corner.

  • rightMotor – The motor on the right corner.

  • backMotor – The motor on the back corner.

  1. __init__(self: wpilib.drive._drive.KilloughDrive, leftMotor: wpilib.interfaces._interfaces.SpeedController, rightMotor: wpilib.interfaces._interfaces.SpeedController, backMotor: wpilib.interfaces._interfaces.SpeedController, leftMotorAngle: float, rightMotorAngle: float, backMotorAngle: float) -> None

Construct a Killough drive with the given motors.

Angles are measured in degrees clockwise from the positive X axis.

Parameters
  • leftMotor – The motor on the left corner.

  • rightMotor – The motor on the right corner.

  • backMotor – The motor on the back corner.

  • leftMotorAngle – The angle of the left wheel’s forward direction of travel.

  • rightMotorAngle – The angle of the right wheel’s forward direction of travel.

  • backMotorAngle – The angle of the back wheel’s forward direction of travel.

driveCartesian(ySpeed: float, xSpeed: float, zRotation: float, gyroAngle: float = 0.0)None

Drive method for Killough platform.

Angles are measured clockwise from the positive X axis. The robot’s speed is independent from its angle or rotation rate.

Parameters
  • ySpeed – The robot’s speed along the Y axis [-1.0..1.0]. Right is positive.

  • xSpeed – The robot’s speed along the X axis [-1.0..1.0]. Forward is positive.

  • zRotation – The robot’s rotation rate around the Z axis [-1.0..1.0]. Clockwise is positive.

  • gyroAngle – The current angle reading from the gyro in degrees around the Z axis. Use this to implement field-oriented controls.

drivePolar(magnitude: float, angle: float, zRotation: float)None

Drive method for Killough platform.

Angles are measured clockwise from the positive X axis. The robot’s speed is independent from its angle or rotation rate.

Parameters
  • magnitude – The robot’s speed at a given angle [-1.0..1.0]. Forward is positive.

  • angle – The angle around the Z axis at which the robot drives in degrees [-180..180].

  • zRotation – The robot’s rotation rate around the Z axis [-1.0..1.0]. Clockwise is positive.

getDescription()str
initSendable(builder: wpilib.SendableBuilder)None
kDefaultBackMotorAngle = 270.0
kDefaultLeftMotorAngle = 60.0
kDefaultRightMotorAngle = 120.0
stopMotor()None