STScI Logo

monitor stsdas.hst_calib.hsp


NAME · USAGE · DESCRIPTION · PARAMETERS · EXAMPLES · BUGS · REFERENCES
SEE_ALSO

NAME

monitor -- Reduce particle monitor data obtained with the High Speed Photomoter.

USAGE

monitor infile inmask nfiles intable outfile1 outfile2 outfile3 npoints

DESCRIPTION

This task sorts out the particle events that occurred in the input file(s), translates the epoch of events to geocentric position (longitude-latitude), and puts the results in three output files: the first output file contains the accumulated number of observations in each one degree square bin (1 to 360 degrees in longitude and -30 to +30 degrees in latitude); the second contains the accumulated count rates; and the third contains the accumulated count rate squares. If output files do not exist, this task will create them, if they already exist, this task will add the result from the input files to the existing results.

It is assumed that all particle monitor files are of digital data type. Therefore, raw data from the input file(s) are divided by the integration time. If any pixel in any file has a bad mask value, that point is not included in the final result.

The epoch of observation of each data point is calculated from the starting observation time (taken from the FPKTTIME header keyword) of the file and the interval of data points (the CD1_1 keyword). The input state vector table intable is also needed; intable is a text file, provided by the Flight Dynamics Facility, and contains the state vectors (at epoch J2000 = JD 2451545.0) of epochs in an interval of one minute. The data in intable must be tabulated in increasing epochs. Lagrange's polynomial interpolation is used to obtain the state vector for the epoch of each data point and the number of points used in the interpolation can be specified using the npoints parameter.

The maximum number of input data points for the input table is 2,000.

PARAMETERS

infiles [file name template]
Input file template. These files must be single-group files with uncalibrated digital data.
inmasks [file name template]
Template specifying mask files corresponding to infiles.
nfiles = [integer, min = 1]
Number of input files.
intable [file name]
Name of the input state vector table, which contains the epoch (in YYYY.DDD:HH:MM:SS.SSS format), and the state vector components X, Y, Z (in kilometers).
outfile[file name]
Name of the output file that will contain the accumulated number of observations.
outfile[file name]
Name of the output file that will contain the accumulated count rates.
outfile[file name]
Name of the output file that will contain the accumulated count rate squares.
npoints = [integer, min = 2, max = 20]
Number of points used in Lagrange's polynomial interpolation.

EXAMPLES

1. Reduce particle monitor data from the input files listed in the infiles.lis list file and the input masks in the inmasks.lis list file. Put the results in output files ymonitor$out1.hhh, ymonitor$out2.hhh, and ymonitor$out3.hhh. The input table is xmonitor$input.txt. Five points are used for Lagrange's polynomial interpolation. There are three input files and masks. The file infiles.lis contains the following:

xmonitor$test0.d0h
xmonitor$test0.d1h
xmonitor$test0.d2h

and the file inmasks.lis contains the following:

xmonitor$test0.q0h
xmonitor$test0.q1h
xmonitor$test0.q2h

hs> monitor "@infiles.lis" "@inmasks.lis" 3 "xmonitor$input.txt" 
            "ymonitor$out1.hhh" "ymonitor$out2.hhh" "ymonitor$out3.hhh" 5

or

hs> monitor "xmonitor$test0.d![0-2]h" "xmonitor$test0.q![0-2]h" 3
            "xmonitor$input.txt" "ymonitor$out1.hhh" "ymonitor$out2.hhh"
            "ymonitor$out3.hhh" 5

or, if these three file pairs are the only such files in the 'xmonitor'
directory,

hs> monitor "xmonitor$test0.d*h" "xmonitor$test0.q*h" 3
            "xmonitor$input.txt" "ymonitor$out1.hhh" "ymonitor$out2.hhh"
            "ymonitor$out3.hhh" 5

If list files are used (as in the first example above), the list files must be local files.

BUGS

REFERENCES

SEE ALSO


Source Code · Package Help · Search Form · STSDAS