Quaternion Description
======================
The components of the QUATERNION keyword in a data label rotate
a vector defined in the instrument frame into the Earth Mean Equator
J2000 (EME J2000) frame.
The QUATERNION keyword provides an ordered list of the four components
of the quaternion, zero through three, with the zeroeth component as
the scalar and the first, second and third as the vector components,
where q0 = cos(a/2), q1 = -sin(a/2)*u1, q2 = -sin(a/2)*u2,
q3 = -sin(a/2)*u3, a is the angle (radians) representing the
magnitude of the rotation, and u1, u2, u3 are components of
the unit vector representing the axis of rotation. The order of
the components in the QUATERNION keyword is (q0, q1, q2, q3).
This is the structure employed in SPICE C-Kernels and Toolkit
subroutines, and is the PDS recommended structure. The SPICE Toolkit
provides an assortment of routines for applying quaternions.
In the SPICE context, the equations for forming a rotation matrix
(a C-inverse matrix) from the four quaternion elements are:
+- -+
| 1-2*(q2*q2+q3*q3) 2*(q1*q2-q0*q3) 2*(q1*q3+q0*q2) |
| |
CMAT = | 2*(q1*q2+q0*q3) 1-2*(q1*q1+q3*q3) 2*(q2*q3-q0 q1) |
| |
| 2*(q1*q3-q0*q2) 2*(q2*q3 + q0*q1) 1-2*(q1*q1+q2*q2) |
+- -+
The C-inverse matrix is a 3x3 matrix that transforms Cartesian coordinates
referenced to the instrument frame to coordinates in the EME J2000 frame.
The matrix transforms coordinates as follows: if a vector v has
coordinates (x, y, z) in instrument-fixed reference frame,
then v has coordinates (x', y', z') in EME J2000 frame, where
[ ] [ x ] [ x']
| CMAT | | y | = | y'|
[ ] [ z ] [ z']
Please note that q0, q1, q2, and q3 in this file correspond to the
keywords ADCQA, ADCQX, ADCQY, and ADCQZ in the FITS data headers.