Name

---

      ROT_3D

Purpose

---

      Rotate 3-d coordinate system.

Category

---

Calling Sequence

---

      rot_3d, axis, x1, y1, z1, ang, x2, y2, z2

Inputs

---

      axis=Axis number to rotate about: 1=X, 2=Y, 3=Z. in
      x1, y1, z1 = arrays of original x,y,z vector comp. in
      ang = rotation angle in radians. in

Keyword Parameters

---

Keywords

---

        /DEGREES means angle is in degrees, else radians.

Outputs

---

      x2, y2, z2 = arrays of new x,y,z vector components. out

Common Blocks

---

Notes

---

      Note: Right-hand rule is used: Point thumb along +axis.
        Fingers curl in vector rotation direction (for +ang).
        This is for coordinate system rotation. To rotate the
        vectors in a fixed coord. system use the left hand rule.

Modification History

---

      R. Sterner. 28 Jan, 1987.
      6 May, 1988 --- modified to work with any shape arrays.
      R. Sterner, 6 Nov, 1989 --- converted to SUN.
      RES 13 Feb, 1991 --- added /degrees.
      Johns Hopkins University Applied Physics Laboratory.
  Copyright (C) 1987, Johns Hopkins University/Applied Physics Laboratory
  This software may be used, copied, or redistributed as long as it is not
  sold and this copyright notice is reproduced on each copy made. This
  routine is provided as is without any express or implied warranties
  whatsoever. Other limitations apply as described in the file disclaimer.txt.