euler_matrix_new

This IDL facility provides a means to generate a 3D rotation Euler matrix parametrized by three angles and three axes of rotation.

Location in HEALPix directory tree: src/idl/misc/euler_matrix_new.pro 

FORMAT

IDL> matrix = EULER_MATRIX_NEW(a1, a2, a3 [,DEG=, HELP=, X=, Y=, ZYX=])

QUALIFIERS

matrix

a 3x3 array containing the Euler matrix

a1

input, float scalar, angle of the first rotation, expressed in radians, unless DEG (see below) is set

a2

angle of the second rotation, same units as a1

a3

angle of the third rotation, same units as a1

KEYWORDS

DEG=

if set, the angles are in degrees instead of radians

HELP=

if set, the routine prints its documentation header and exits

X=

if set, uses the classical mechanics convention (ZXZ):
rotation a1 around original Z axis,
rotation a2 around intermediate X axis,
rotation a3 around final Z axis
(see Goldstein (1951) for more details).
Equivalent to:
rotation a3 around Z axis,
rotation a2 around initial (unrotated) X axis,
rotation a1 around initial (unrotated) Z axis.
default:this convention is used

Y=

if set, uses the quantum mechanics convention (ZYZ):
rotation a1 around original Z axis,
rotation a2 around intermediate Y axis,
rotation a3 around final Z axis.
Equivalent to:
rotation a3 around Z axis,
rotation a2 around initial (unrotated) Y axis,
rotation a1 around initial (unrotated) Z axis.

ZYX=

if set, uses the aeronautics convention (ZYX):
rotation a1 around original Z axis,
rotation a2 around intermediate Y axis,
rotation a3 around final X axis.
Equivalent to:
rotation a3 around X axis,
rotation a2 around initial (unrotated) Y axis,
rotation a1 around initial (unrotated) Z axis.

DESCRIPTION

$\parbox{\hsize}{\facname \ ~\ allows the generation of a rotation Eu... ...Y)) \\ [.1cm] euler\_matrix\_new(a,b,c,/Z) = euler\_matrix($-$a, b,$-$c,/Z) } }$

RELATED ROUTINES

This section lists the routines related to euler_matrix_new

idl

version 6.4 or more is necessary to run euler_matrix_new.

rotate_coord

apply a rotation to a set of position vectors and polarization Stokes parameters.