to_angle_axis

kyosu::to_angle_axis = eve::functor<to_angle_axis_t>

inlineconstexpr

Callable object computing the angle and axis coordinates from a quaternion.

This function is the reciprocal of from_angle_axis

Header file

#include kyosu/quaternion.hpp>`

Callable Signatures

namespace eve
{
  auto to_angle_axis(auto q) const noexcept;
}

Parameters

q: quaternion

Return value

a tuple an angle of rotation and a vector of \(\mathbb{R}^3\) representing the direction of the rotation axis.

Example

#include <kyosu/kyosu.hpp>
#include <eve/wide.hpp>
#include <iostream>
 
int main()
{
  using kyosu::to_angle_axis;
  using kyosu::complex_t;
  using kyosu::quaternion_t;
  using e_t = float;
  using c_t = kyosu::complex_t<float>;
  using q_t = kyosu::quaternion_t<float>;
 
  std::cout << "Real:        "<< "\n";
  e_t e0(1);
  auto [ae, axe] = to_angle_axis(e0);
  std::cout << e0 << " -> "  << ae << ",  (" << axe[0] << ", " << axe[1] << ", " << axe[2] << ") "     "\n";
 
  std::cout << "Complex:     "<< "\n";
  c_t c0(1, 5);
  auto [ac, axc] = to_angle_axis(c0);
  std::cout << c0 << " -> "  << ac << ",  (" << axc[0] << ", " << axc[1] << ", " << axc[2] << ") "     "\n";
 
 
  std::cout << "Quaternion:  "<< "\n";
  q_t q0(1, 5, 2, 3);
  auto [aq, axq] = to_angle_axis(q0);
  std::cout << q0 << " -> "  << aq << ",  (" << axq[0] << ", " << axq[1] << ", " << axq[2] << ") "     "\n";
 
  return 0;
}