xseuler.c
Go to the documentation of this file.
1 
2 // Copyright (c) 2003-2021 Xsens Technologies B.V. or subsidiaries worldwide.
3 // All rights reserved.
4 //
5 // Redistribution and use in source and binary forms, with or without modification,
6 // are permitted provided that the following conditions are met:
7 //
8 // 1. Redistributions of source code must retain the above copyright notice,
9 // this 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 names of the copyright holders nor the names of their 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" AND ANY
20 // EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
21 // MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL
22 // THE COPYRIGHT HOLDERS OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
23 // SPECIAL, EXEMPLARY OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
24 // OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
25 // HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY OR
26 // TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
27 // SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.THE LAWS OF THE NETHERLANDS
28 // SHALL BE EXCLUSIVELY APPLICABLE AND ANY DISPUTES SHALL BE FINALLY SETTLED UNDER THE RULES
29 // OF ARBITRATION OF THE INTERNATIONAL CHAMBER OF COMMERCE IN THE HAGUE BY ONE OR MORE
30 // ARBITRATORS APPOINTED IN ACCORDANCE WITH SAID RULES.
31 //
32 
33 
34 // Copyright (c) 2003-2021 Xsens Technologies B.V. or subsidiaries worldwide.
35 // All rights reserved.
36 //
37 // Redistribution and use in source and binary forms, with or without modification,
38 // are permitted provided that the following conditions are met:
39 //
40 // 1. Redistributions of source code must retain the above copyright notice,
41 // this list of conditions, and the following disclaimer.
42 //
43 // 2. Redistributions in binary form must reproduce the above copyright notice,
44 // this list of conditions, and the following disclaimer in the documentation
45 // and/or other materials provided with the distribution.
46 //
47 // 3. Neither the names of the copyright holders nor the names of their contributors
48 // may be used to endorse or promote products derived from this software without
49 // specific prior written permission.
50 //
51 // THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY
52 // EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
53 // MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL
54 // THE COPYRIGHT HOLDERS OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
55 // SPECIAL, EXEMPLARY OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
56 // OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
57 // HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY OR
58 // TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
59 // SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.THE LAWS OF THE NETHERLANDS
60 // SHALL BE EXCLUSIVELY APPLICABLE AND ANY DISPUTES SHALL BE FINALLY SETTLED UNDER THE RULES
61 // OF ARBITRATION OF THE INTERNATIONAL CHAMBER OF COMMERCE IN THE HAGUE BY ONE OR MORE
62 // ARBITRATORS APPOINTED IN ACCORDANCE WITH SAID RULES.
63 //
64 
65 #include "xseuler.h"
66 #include "xsquaternion.h"
67 #include <math.h>
68 #include "xsfloatmath.h"
69 
85 void XsEuler_destruct(XsEuler* thisPtr)
86 {
87  thisPtr->m_x = XsMath_zero;
88  thisPtr->m_y = XsMath_zero;
89  thisPtr->m_z = XsMath_zero;
90 }
91 
95 int XsEuler_empty(const XsEuler* thisPtr)
96 {
97  return thisPtr->m_x == XsMath_zero && thisPtr->m_y == XsMath_zero && thisPtr->m_z == XsMath_zero;
98 }
99 
103 void XsEuler_fromQuaternion(XsEuler* thisPtr, const XsQuaternion* quat)
104 {
105  XsReal sqw, dphi, dpsi;
106 
107  if (XsQuaternion_empty(quat))
108  {
109  XsEuler_destruct(thisPtr);
110  return;
111  }
112 
113  sqw = quat->m_w * quat->m_w;
114  dphi = XsMath_two * (sqw + quat->m_z * quat->m_z) - XsMath_one;
115  dpsi = XsMath_two * (sqw + quat->m_x * quat->m_x) - XsMath_one;
116 
117  thisPtr->m_x = XsMath_rad2deg(atan2(XsMath_two * (quat->m_y * quat->m_z + quat->m_w * quat->m_x), dphi));
118  thisPtr->m_y = -XsMath_rad2deg(XsMath_asinClamped(XsMath_two * (quat->m_x * quat->m_z - quat->m_w * quat->m_y)));
119  thisPtr->m_z = XsMath_rad2deg(atan2(XsMath_two * (quat->m_x * quat->m_y + quat->m_w * quat->m_z), dpsi));
120 }
121 
XsMath_asinClamped
XSMATHINLINE XsReal XsMath_asinClamped(const XsReal x)
Returns asin(x) for -1 < x < 1.
Definition: xsmath.h:189
XsMath_one
XSMATHCONST XsReal XsMath_one
1.0
Definition: xsmath.h:158
xsquaternion.h
XsEuler::m_x
XsReal m_x
Stores the x component of the euler triplet.
Definition: xseuler.h:213
xsfloatmath.h
XsQuaternion
A class that implements a quaternion.
Definition: xsquaternion.h:102
XsQuaternion::XsQuaternion_empty
int XsQuaternion_empty(const XsQuaternion *thisPtr)
Test if this is a null object.
Definition: xsquaternion.c:94
XsMath_rad2deg
XSMATHINLINE XsReal XsMath_rad2deg(XsReal radians)
Convert radians to degrees.
Definition: xsmath.h:196
XsReal
double XsReal
Defines the floating point type used by the Xsens libraries.
Definition: xstypedefs.h:73
XsQuaternion::m_x
XsReal m_x
Stores the x component of the quaternion.
Definition: xsquaternion.h:110
XsEuler::m_z
XsReal m_z
Stores the z component of the euler triplet.
Definition: xseuler.h:215
XsMath_two
XSMATHCONST XsReal XsMath_two
2
Definition: xsmath.h:162
XsMath_zero
XSMATHCONST XsReal XsMath_zero
0
Definition: xsmath.h:150
XsEuler::XsEuler_destruct
void XsEuler_destruct(XsEuler *thisPtr)
Clears all angles in the XsEuler object by setting them to 0.
Definition: xseuler.c:85
XsEuler::XsEuler_fromQuaternion
void XsEuler_fromQuaternion(XsEuler *thisPtr, const XsQuaternion *quat)
Get an euler angle representation of the quaternion.
Definition: xseuler.c:103
xseuler.h
XsEuler
Contains Euler Angle data and conversion from Quaternion.
Definition: xseuler.h:92
XsQuaternion::m_y
XsReal m_y
Stores the y component of the quaternion.
Definition: xsquaternion.h:111
XsEuler::m_y
XsReal m_y
Stores the y component of the euler triplet.
Definition: xseuler.h:214
XsQuaternion::m_w
XsReal m_w
Stores the w component of the quaternion.
Definition: xsquaternion.h:109
XsQuaternion::m_z
XsReal m_z
Stores the z component of the quaternion.
Definition: xsquaternion.h:112
XsEuler::XsEuler_empty
int XsEuler_empty(const XsEuler *thisPtr)
Returns true if all angles in this object are zero.
Definition: xseuler.c:95


xsens_mti_driver
Author(s):
autogenerated on Sun Sep 3 2023 02:43:20