CoordinateAxis.h

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 <Eigen/Core>
#include <wpi/SymbolExports.h>
 
#include "frc/geometry/Pose3d.h"
#include "frc/geometry/Rotation3d.h"
 
namespace frc {
 
/**
 * A class representing a coordinate system axis within the NWU coordinate
 * system.
 */
class WPILIB_DLLEXPORT CoordinateAxis {
 public:
  /**
   * Constructs a coordinate system axis within the NWU coordinate system and
   * normalizes it.
   *
   * @param x The x component.
   * @param y The y component.
   * @param z The z component.
   */
  CoordinateAxis(double x, double y, double z);
 
  CoordinateAxis(const CoordinateAxis&) = default;
  CoordinateAxis& operator=(const CoordinateAxis&) = default;
 
  CoordinateAxis(CoordinateAxis&&) = default;
  CoordinateAxis& operator=(CoordinateAxis&&) = default;
 
  /**
   * Returns a coordinate axis corresponding to +X in the NWU coordinate system.
   */
  static const CoordinateAxis& N();
 
  /**
   * Returns a coordinate axis corresponding to -X in the NWU coordinate system.
   */
  static const CoordinateAxis& S();
 
  /**
   * Returns a coordinate axis corresponding to -Y in the NWU coordinate system.
   */
  static const CoordinateAxis& E();
 
  /**
   * Returns a coordinate axis corresponding to +Y in the NWU coordinate system.
   */
  static const CoordinateAxis& W();
 
  /**
   * Returns a coordinate axis corresponding to +Z in the NWU coordinate system.
   */
  static const CoordinateAxis& U();
 
  /**
   * Returns a coordinate axis corresponding to -Z in the NWU coordinate system.
   */
  static const CoordinateAxis& D();
 
 private:
  friend class CoordinateSystem;
 
  Eigen::Vector3d m_axis;
};
 
}  // namespace frc