The area-ID number range covered by the processing can be restricted with command-line options. Otherwise, any area ID in the [4097, 4294967296] range that is found in the input timelines will be processed.
The field positions are computed from the target quaternions. Hooks are in place to allow a star-tracker/telescope boresight misalignment correction. A check is made and warning is given if, for a given area ID, the number of fields does not match the number of field indices; only area IDs >= 4096 are subject to this check (since calibration observations will deliberately violate the requirement that different field indices have different field positions).
Requires correction correction quaternions from star-tracker boresight to telescope boresight, which are either read from the command-line, or from the first timeline in the input list.
The tool is now under both CVS version control (/proj/wire/cvsroot/da/russ/guidestars), and make control (makefile.p-bin). It has been delivered to /proj/wire/so_tst/bin. It uses perl library readutils.pl to read in the timelines. The lastest CVS version number is 1.10. The source code is located in /proj/wire/russ//guidestars.
| Command-line input | Definition |
|---|---|
| -timeline or -tl list of filenames | Comma-separated list of timelines to be processed. The first timeline should include the full path, which is assumed to be valid for other timelines that may be in the list. Required. |
| -areaid or -ai value | Optional. Use this option to process only one area ID. |
| -areaidstart or -ais value | Optional. Use this option to specify the starting value for the range of area IDs to be processed. Default value is 4097. |
| -areaidend or -aie value | Optional. Use this option to specify the ending value for the range of area IDs to be processed. Default value is 4294967296. |
| -plot | Switch that causes IDL postscript-file plots to be made for each area ID processed that has either more than one field or more than one unique field index. |
| -q1StTl or -q1c value | Correction quaternion q1 for rotation from star-tracker boresight to telescope boresight. This value is taken from the first timeline if not specified here. |
| -q2StTl or -q2c value | Correction quaternion q2 for rotation from star-tracker boresight to telescope boresight. This value is taken from the first timeline if not specified here. |
| -q3StTl or -q3c value | Correction quaternion q3 for rotation from star-tracker boresight to telescope boresight. This value is taken from the first timeline in the input list if not specified here. |
| -q4StTl or -q4c value | Correction quaternion q4 for rotation from star-tracker boresight to telescope boresight. This value is taken from the first timeline if not specified here. |
| -verbose or -v switch | Verbose mode. Default is off. |
Corresponding IDL plots with names of the form plotfields_#.ps are created for each area ID # that has either more than one field or more than one unique field index.
Each IDL plot shows a tangent projection of the fields for a given area ID, with the area center at (0,0). The spacecraft body-X axis is anti-parallel to the X-axis of the plot. The spacecraft body-Y axis is parallel to the Y-axis of the plot. The roll angle given on the plot is related by CROTA2 for the corresponding 25-um WIRE image as follows: roll=crota2-90 degrees.
A final summary IPAC-table called plotfields.tbl is created which tabulates the results of the checking of number of fields points versus number of unique fields indices for each area ID. The table lists the area IDs checked, along with their positions and angles, their numbers of fields points found in the timelines, and their numbers of unique fields indices. The two latter columns of data should be row-by-row equal; otherwise, the timeline(s) are in error.
The log file, called plotfields.log, should be checked for any warning messages. Log file output from plotfields is appended to plotfields.log each time the tool is executed.
/proj/wire/so_tst/bin/plotfields -tl /proj/wire/soda/so/ops/tl_delivery/tl_test/I99069REGOTL.0/I99069REGOTL00.0,I99069REGOTL01.0,I99069REGOTL02.0,I99069REGOTL03.0,I99069REGOTL04.0,I99069REGOTL05.0,I99069REGOTL06.0 -plot | & tee plotfields.scr
Click here for a listing of STDOUT from plotfields (tee'd to plotfields.scr in the above example).
Click here for a listing of plotfields_94090.tbl.
Click here for a ghostview display of plotfields_94090.ps.
Click here for a listing of the final
summary table plotfields.tbl.
Last revised: January 15, 1999
Software Developer: Russ Laher
Webpage by: Russ Laher
URL: http://spider.ipac.caltech.edu/staff/laher/plotfields.html