Auterion App SDK
Auterion SDK is a library that can be used by AuterionOS apps to communicate with the system.
geometry.hpp
Go to the documentation of this file.
1 /****************************************************************************
2  *
3  * Copyright 2023 Auterion AG. All rights reserved.
4  *
5  * Redistribution and use in source and binary forms, with or without
6  * modification, are permitted provided that the following conditions are met:
7  *
8  * 1. Redistributions of source code must retain the above copyright notice, this
9  * list of conditions and the following disclaimer.
10  *
11  * 2. Redistributions in binary form must reproduce the above copyright notice,
12  * this list of conditions and the following disclaimer in the documentation
13  * and/or other materials provided with the distribution.
14  *
15  * 3. Neither the name of the copyright holder nor the names of its contributors
16  * may be used to endorse or promote products derived from this software without
17  * specific prior written permission.
18  *
19  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
20  * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
21  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
22  * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
23  * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
24  * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
25  * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
26  * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
27  * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
28  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
29  * POSSIBILITY OF SUCH DAMAGE.
30  *
31  ****************************************************************************/
32 
51 #pragma once
52 
53 #include <Eigen/Eigen>
54 
55 namespace auterion {
63 float radToDeg(const float rad);
64 double radToDeg(const double rad);
65 
69 float degToRad(const float deg);
70 double degToRad(const double deg);
71 
72 namespace literals {
73 inline constexpr float operator"" _deg(long double degrees);
74 inline constexpr float operator"" _rad(long double radians);
75 } // namespace literals
76 
83 float wrapAngleToPlusMinusPi(float yaw);
84 double wrapAngleToPlusMinusPi(double yaw);
85 
94 Eigen::Vector3f quaternionToEulerRpy(const Eigen::Quaternionf& q);
95 Eigen::Vector3d quaternionToEulerRpy(const Eigen::Quaterniond& q);
96 
103 Eigen::Quaternionf eulerRpyToQuaternion(const Eigen::Vector3f& euler);
104 Eigen::Quaterniond eulerRpyToQuaternion(const Eigen::Vector3d& euler);
105 
114 Eigen::Quaternionf eulerRpyToQuaternion(const float roll, const float pitch, const float yaw);
115 Eigen::Quaterniond eulerRpyToQuaternion(const double roll, const double pitch, const double yaw);
116 
123 float quaternionToRoll(const Eigen::Quaternionf& q);
124 double quaternionToRoll(const Eigen::Quaterniond& q);
125 
132 float quaternionToPitch(const Eigen::Quaternionf& q);
133 double quaternionToPitch(const Eigen::Quaterniond& q);
134 
141 float quaternionToYaw(const Eigen::Quaternionf& q);
142 double quaternionToYaw(const Eigen::Quaterniond& q);
143 
145 } // namespace auterion
float wrapAngleToPlusMinusPi(float yaw)
Wraps an angle to the range [-pi, pi).
Eigen::Quaternionf eulerRpyToQuaternion(const Eigen::Vector3f &euler)
Converts RPY extrinsic Tait-Bryan Euler angles (YPR intrinsic) to quaternion.
float quaternionToRoll(const Eigen::Quaternionf &q)
Convert quaternion to roll angle in extrinsic RPY order (intrinsic YPR)
float quaternionToYaw(const Eigen::Quaternionf &q)
Convert quaternion to yaw angle in extrinsic RPY order (intrinsic YPR)
float radToDeg(const float rad)
Converts radians to degrees.
float quaternionToPitch(const Eigen::Quaternionf &q)
Convert quaternion to pitch angle in extrinsic RPY order (intrinsic YPR)
float degToRad(const float deg)
Converts degrees to radians.
Eigen::Vector3f quaternionToEulerRpy(const Eigen::Quaternionf &q)
Converts a quaternion to RPY extrinsic Tait-Bryan Euler angles (YPR intrinsic) XYZ axes correspond to...