NAME

transform_ray - rotate and translate rays

PARAMETERS

transform_ray uses an IRAF compatible parameter interface

input file

Input ray stream. If the filename is the string stdin, it reads from the standard input stream.

output file

Output ray stream. If the filename is the string stdout, it writes to the standard output stream.

coeff

The transformation coefficients. See "Specifying Coefficients" for more information.

x double
y double
z double

Coordinates of the optional translation

translate before | after | none

What order to apply the translation relative to the transformation specified by the coeff parameter. If none, no translation is performed.

version boolean

Print out transform_ray's version and exit.

help boolean

Print out help and exit.

debug list

A list of debug flags. The available flags are:

xfrm

Output the final rotation and translation matrices to the standard error stream. The rotation is applied before the translation.

DESCRIPTION

transform_ray performs translation and rotation of rays (their position, direction, and polarization). It reads and writes rays in bpipe format.

Transformations may be supplied as a combination of an optional translation with any of the following:

Transformations are done by left-multiplying vectors by matrices. The translation may be applied before or after the above transformation. See the translate parameter for more information.

Specifying Coefficients

The coeff parameter accepts a number of different transformation coefficient specifications.

COPYRIGHT & LICENSE

Copyright 2013 Smithsonian Astrophysical Observatory

This software is released under the GNU General Public License. You may find a copy at http://www.fsf.org/copyleft/gpl.html

AUTHOR

T. Gaetz

D. Jerius