aboutsummaryrefslogtreecommitdiff
path: root/math/slalib/doc/deuler.hlp
blob: 1dc5584455053cb3600c64b69d41bf4584200d26 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
.help deuler Jun99 "Slalib Package"
.nf

      SUBROUTINE slDEUL (ORDER, PHI, THETA, PSI, RMAT)

     - - - - - - -
      D E U L
     - - - - - - -

  Form a rotation matrix from the Euler angles - three successive
  rotations about specified Cartesian axes (double precision)

  Given:
    ORDER   c*(*)   specifies about which axes the rotations occur
    PHI     d       1st rotation (radians)
    THETA   d       2nd rotation (   "   )
    PSI     d       3rd rotation (   "   )

  Returned:
    RMAT    d(3,3)  rotation matrix

  A rotation is positive when the reference frame rotates
  anticlockwise as seen looking towards the origin from the
  positive region of the specified axis.

  The characters of ORDER define which axes the three successive
  rotations are about.  A typical value is 'ZXZ', indicating that
  RMAT is to become the direction cosine matrix corresponding to
  rotations of the reference frame through PHI radians about the
  old Z-axis, followed by THETA radians about the resulting X-axis,
  then PSI radians about the resulting Z-axis.

  The axis names can be any of the following, in any order or
  combination:  X, Y, Z, uppercase or lowercase, 1, 2, 3.  Normal
  axis labeling/numbering conventions apply;  the xyz (=123)
  triad is right-handed.  Thus, the 'ZXZ' example given above
  could be written 'zxz' or '313' (or even 'ZxZ' or '3xZ').  ORDER
  is terminated by length or by the first unrecognized character.

  Fewer than three rotations are acceptable, in which case the later
  angle arguments are ignored.  If all rotations are zero, the
  identity matrix is produced.

  P.T.Wallace   Starlink   23 May 1997

  Copyright (C) 1997 Rutherford Appleton Laboratory
  Copyright (C) 1995 Association of Universities for Research in Astronomy Inc.

.fi
.endhelp