mkwingdir - Part of the wingscan suite of scripts. Determines the direction of the offset of an aperture relative to the tilt of the optics.
mkwingdir uses an IRAF-compatible parameter interface. A template parameter file is in /proj/axaf/simul/lib/uparm/mkwingdir.par
Name of the input file. If input equals 'stdin', mkwingdir reads input from STDIN.
Name of the output file. If output equals 'stdout' or 'stderr', mkwingdir writes output to STDOUT or STDERR, respectively.
Name of the aperture diameter column in the input file.
Name of the aperture X position (XRCF coords) column in the input file.
Name of the aperture Y position (XRCF coords) column in the input file.
Name of the aperture Z position (XRCF coords) column in the input file.
Name of the shutters configuration column in the input file.
Name of the direction column in the output file.
If set to 'yes', print this help information and exit.
If set to 'yes', print version information and exit.
mkwingdir filters the input file passing all existing columns through to the output. It adds a column, whose name is specified by the direction parameter, to the output file. The direction column specifies the direction of the offset of the aperture relative to the tilt of the optics. Values for direction are listed below.
The aperture is offset from the FOA in the direction of the optics tilt. With the top quadrant, there is a positive Z (XRCF coords) offset. With the south quadrant, there is a positive Y (XRCF coords) offset.
The aperture is offset from the FOA opposite the direction of the optics tilt. With the top quadrant, there is a negative Z (XRCF coords) offset. With the south quadrant, there is a negative Y (XRCF coords) offset.
The aperture is offset from the FOA either in the direction or opposite the direction of the optics tilt but 2 opposing quadrants are open. With the north and south quadrants, there is an offset along the Y (XRCF coords) axis. With the top and bottom quadrants, there is an offset along the Z (XRCF coords) axis.
The aperture is offset from the FOA perpendicular to the direction of the optics tilt. With the north quadrant, there is an offset along the Z (XRCF coords) axis.
The aperture is roughly centered on the FOA. This implies that the aperture is within one half the aperture diameter of the FOA in both XRCF Y and Z directions.
M. Tibbetts ( mtibbetts@head-cfa.harvard.edu )