/*
* matrix3.cpp
* Copyright (C) Andrew Tridgell 2012
*
* This file is free software: you can redistribute it and/or modify it
* under the terms of the GNU General Public License as published by the
* Free Software Foundation, either version 3 of the License, or
* (at your option) any later version.
*
* This file is distributed in the hope that it will be useful, but
* WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
* See the GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License along
* with this program. If not, see .
*/
#pragma GCC optimize("O2")
#include "AP_Math.h"
// create a rotation matrix given some euler angles
// this is based on https://github.com/ArduPilot/Datasheets/blob/main/References/EulerAngles.pdf
template
void Matrix3::from_euler(T roll, T pitch, T yaw)
{
const T cp = cosF(pitch);
const T sp = sinF(pitch);
const T sr = sinF(roll);
const T cr = cosF(roll);
const T sy = sinF(yaw);
const T cy = cosF(yaw);
a.x = cp * cy;
a.y = (sr * sp * cy) - (cr * sy);
a.z = (cr * sp * cy) + (sr * sy);
b.x = cp * sy;
b.y = (sr * sp * sy) + (cr * cy);
b.z = (cr * sp * sy) - (sr * cy);
c.x = -sp;
c.y = sr * cp;
c.z = cr * cp;
}
// calculate euler angles from a rotation matrix
// this is based on https://github.com/ArduPilot/Datasheets/blob/main/References/EulerAngles.pdf
template
void Matrix3::to_euler(T *roll, T *pitch, T *yaw) const
{
if (pitch != nullptr) {
*pitch = -safe_asin(c.x);
}
if (roll != nullptr) {
*roll = atan2F(c.y, c.z);
}
if (yaw != nullptr) {
*yaw = atan2F(b.x, a.x);
}
}
template
void Matrix3::from_rotation(enum Rotation rotation)
{
(*this).a = {1,0,0};
(*this).b = {0,1,0};
(*this).c = {0,0,1};
(*this).a.rotate(rotation);
(*this).b.rotate(rotation);
(*this).c.rotate(rotation);
(*this).transpose();
}
/*
calculate Euler angles (312 convention) for the matrix.
See http://www.atacolorado.com/eulersequences.doc
vector is returned in r, p, y order
*/
template
Vector3 Matrix3::to_euler312() const
{
return Vector3(asinF(c.y),
atan2F(-c.x, c.z),
atan2F(-a.y, b.y));
}
/*
fill the matrix from Euler angles in radians in 312 convention
*/
template
void Matrix3::from_euler312(T roll, T pitch, T yaw)
{
const T c3 = cosF(pitch);
const T s3 = sinF(pitch);
const T s2 = sinF(roll);
const T c2 = cosF(roll);
const T s1 = sinF(yaw);
const T c1 = cosF(yaw);
a.x = c1 * c3 - s1 * s2 * s3;
b.y = c1 * c2;
c.z = c3 * c2;
a.y = -c2*s1;
a.z = s3*c1 + c3*s2*s1;
b.x = c3*s1 + s3*s2*c1;
b.z = s1*s3 - s2*c1*c3;
c.x = -s3*c2;
c.y = s2;
}
// apply an additional rotation from a body frame gyro vector
// to a rotation matrix.
template
void Matrix3::rotate(const Vector3 &g)
{
(*this) += Matrix3{
a.y * g.z - a.z * g.y, a.z * g.x - a.x * g.z, a.x * g.y - a.y * g.x,
b.y * g.z - b.z * g.y, b.z * g.x - b.x * g.z, b.x * g.y - b.y * g.x,
c.y * g.z - c.z * g.y, c.z * g.x - c.x * g.z, c.x * g.y - c.y * g.x
};
}
/*
re-normalise a rotation matrix
*/
template
void Matrix3::normalize(void)
{
const T error = a * b;
const Vector3 t0 = a - (b * (0.5f * error));
const Vector3 t1 = b - (a * (0.5f * error));
const Vector3 t2 = t0 % t1;
a = t0 * (1.0f / t0.length());
b = t1 * (1.0f / t1.length());
c = t2 * (1.0f / t2.length());
}
// multiplication by a vector
template
Vector3 Matrix3::operator *(const Vector3 &v) const
{
return Vector3(a.x * v.x + a.y * v.y + a.z * v.z,
b.x * v.x + b.y * v.y + b.z * v.z,
c.x * v.x + c.y * v.y + c.z * v.z);
}
// multiplication by a vector, extracting only the xy components
template
Vector2 Matrix3::mulXY(const Vector3 &v) const
{
return Vector2(a.x * v.x + a.y * v.y + a.z * v.z,
b.x * v.x + b.y * v.y + b.z * v.z);
}
// multiplication of transpose by a vector
template
Vector3 Matrix3::mul_transpose(const Vector3 &v) const
{
return Vector3(a.x * v.x + b.x * v.y + c.x * v.z,
a.y * v.x + b.y * v.y + c.y * v.z,
a.z * v.x + b.z * v.y + c.z * v.z);
}
// multiplication by another Matrix3
template
Matrix3 Matrix3::operator *(const Matrix3 &m) const
{
Matrix3 temp (Vector3(a.x * m.a.x + a.y * m.b.x + a.z * m.c.x,
a.x * m.a.y + a.y * m.b.y + a.z * m.c.y,
a.x * m.a.z + a.y * m.b.z + a.z * m.c.z),
Vector3(b.x * m.a.x + b.y * m.b.x + b.z * m.c.x,
b.x * m.a.y + b.y * m.b.y + b.z * m.c.y,
b.x * m.a.z + b.y * m.b.z + b.z * m.c.z),
Vector3(c.x * m.a.x + c.y * m.b.x + c.z * m.c.x,
c.x * m.a.y + c.y * m.b.y + c.z * m.c.y,
c.x * m.a.z + c.y * m.b.z + c.z * m.c.z));
return temp;
}
template
Matrix3 Matrix3::transposed(void) const
{
return Matrix3(Vector3(a.x, b.x, c.x),
Vector3(a.y, b.y, c.y),
Vector3(a.z, b.z, c.z));
}
template
T Matrix3::det() const
{
return a.x * (b.y * c.z - b.z * c.y) +
a.y * (b.z * c.x - b.x * c.z) +
a.z * (b.x * c.y - b.y * c.x);
}
template
bool Matrix3::inverse(Matrix3& inv) const
{
const T d = det();
if (is_zero(d)) {
return false;
}
inv.a.x = (b.y * c.z - c.y * b.z) / d;
inv.a.y = (a.z * c.y - a.y * c.z) / d;
inv.a.z = (a.y * b.z - a.z * b.y) / d;
inv.b.x = (b.z * c.x - b.x * c.z) / d;
inv.b.y = (a.x * c.z - a.z * c.x) / d;
inv.b.z = (b.x * a.z - a.x * b.z) / d;
inv.c.x = (b.x * c.y - c.x * b.y) / d;
inv.c.y = (c.x * a.y - a.x * c.y) / d;
inv.c.z = (a.x * b.y - b.x * a.y) / d;
return true;
}
template
bool Matrix3::invert()
{
Matrix3 inv;
bool success = inverse(inv);
if (success) {
*this = inv;
}
return success;
}
// create rotation matrix for rotation about the vector v by angle theta
// See: http://www.euclideanspace.com/maths/geometry/rotations/conversions/angleToMatrix/
template
void Matrix3::from_axis_angle(const Vector3 &v, T theta)
{
const T C = cosF(theta);
const T S = sinF(theta);
const T t = 1.0f - C;
const Vector3 normv = v.normalized();
const T x = normv.x;
const T y = normv.y;
const T z = normv.z;
a.x = t*x*x + C;
a.y = t*x*y - z*S;
a.z = t*x*z + y*S;
b.x = t*x*y + z*S;
b.y = t*y*y + C;
b.z = t*y*z - x*S;
c.x = t*x*z - y*S;
c.y = t*y*z + x*S;
c.z = t*z*z + C;
}
// define for float and double
template class Matrix3;
template class Matrix3;