MecanumDriveKinematicsConstraint.hpp

Go to the documentation of this file.

// Copyright (c) FIRST and other WPILib contributors.
// Open Source Software; you can modify and/or share it under the terms of
// the WPILib BSD license file in the root directory of this project.
 
#pragma once
 
#include "wpi/math/kinematics/MecanumDriveKinematics.hpp"
#include "wpi/math/trajectory/constraint/TrajectoryConstraint.hpp"
#include "wpi/units/math.hpp"
#include "wpi/units/velocity.hpp"
#include "wpi/util/SymbolExports.hpp"
 
namespace wpi::math {
/**
 * A class that enforces constraints on the mecanum drive kinematics.
 * This can be used to ensure that the trajectory is constructed so that the
 * commanded velocities for wheels of the drivetrain stay below a certain
 * limit.
 */
class WPILIB_DLLEXPORT MecanumDriveKinematicsConstraint
    : public TrajectoryConstraint {
 public:
  MecanumDriveKinematicsConstraint(const MecanumDriveKinematics& kinematics,
                                   wpi::units::meters_per_second_t maxVelocity)
      : m_kinematics(kinematics), m_maxVelocity(maxVelocity) {}
 
  wpi::units::meters_per_second_t MaxVelocity(
      const Pose2d& pose, wpi::units::curvature_t curvature,
      wpi::units::meters_per_second_t velocity) const override {
    auto xVelocity = velocity * pose.Rotation().Cos();
    auto yVelocity = velocity * pose.Rotation().Sin();
    auto wheelVelocities =
        m_kinematics
            .ToWheelVelocities({xVelocity, yVelocity, velocity * curvature})
            .Desaturate(m_maxVelocity);
 
    auto normVelocities = m_kinematics.ToChassisVelocities(wheelVelocities);
 
    return wpi::units::math::hypot(normVelocities.vx, normVelocities.vy);
  }
 
  MinMax MinMaxAcceleration(
      const Pose2d& pose, wpi::units::curvature_t curvature,
      wpi::units::meters_per_second_t velocity) const override {
    return {};
  }
 
 private:
  MecanumDriveKinematics m_kinematics;
  wpi::units::meters_per_second_t m_maxVelocity;
};
}  // namespace wpi::math