WIRE SO Tool: plotfields


Description

Perl script plotfields reads in one or more timelines, sorts them by area ID, and outputs summary tables and plots of the field positions for each area ID. Basic syntax checking of the timeline(s), as well as internal consistency checking, are also performed.

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.

Required and Optional Inputs

The table below describes the available command-line inputs.
 
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.

Outputs

Output table files with names of the form plotfields_#.tbl are created for each area ID # treated by the tool. Each of these tables lists data for every field scheduled and the associated timelines, in ascending time order.

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.

Usage

Example of how to execute plotfields:
/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

Return to Home Page