rotate_ray - rotate rays about a fixed point
rotate_ray uses the standard parameter interface
Input ray stream. If the filename is the string stdin, it reads the UNIX standard input stream. It accepts rays in bpipe format.
Output ray stream. If the filename is the string stdout, it writes to the UNIX standard output stream. It writes rays in bpipe format.
raytrace X coordinate of rotation point.
raytrace Y coordinate of rotation point.
raytrace Z coordinate of rotation point.
Azimuth (in degrees) for rotation.
Elevation (in degrees) for rotation.
clocking (in degrees) for rotation.
Print out rotate_ray's version and exit.
Print out help and exit.
A list of debug flags. None are presently defined.
rotate_ray reads a ray stream in bpipe format. Each ray is rotated about a fixed point [cen0, cen1, cen2]. The rotation is specified by OSAC-style Euler angles (azimuth, elevation, clocking). It is interpreted as an active rotation, in which the ray positions and directions are rotated relative to a fixed underlying coordinate system.
The rotations are applied in the order azimuth, then elevation, then clocking. The sign convention is such that positive azimuth rotates the ray Z towards Y, positive elevation rotates ray Z towards X, and positive clocking rotates ray X towards Y.
The rotation affects the ray position and direction vector. If the ray stream includes polarization state information, the ray polarization state is also rotated appropriately.
T. Gaetz