next up previous contents
Next: wqplot Up: Stage-I programs Previous: wmakgti

wmrggti

WMRGGTI -------

FUNCTION Program to merge two or more GTI FITS files.

USAGE wmrggti ingti outgti merge [options]

DESCRIPTION This task merges two or more (up to 50) Good Time Interval files, using either of two modes: AND - output GTI file contains time intervals common to both files, OR - output GTI file combines time intervals from both files.

PARAMETERS

ingti [filenames] The file names and extensions for input GTI FITS files to be merged.

outgti [filename] The file name for merged output GTI FITS file.

merge [string] The merge mode, either logical "AND" or logical "OR".

(instarts = "START") [string] Names of columns for start times in input files, up to 50. If the values are different in the different files, supply one column name for each file. Times are assumed to be in seconds.

(instops = "STOP") [string] Names of columns for stop times in input files, up to 50. If the values are different in the different files, supply one column name for each file. Times are assumed to be in seconds.

(indates = "MJDREF") [string] Names of keywords for reference date of the times in the input files, up to 50. If the values are different in the different files, supply one column name for each file. Two reference time formats are supported: the reference zero time may be in julian days, or in dd/mm/yy format. If no reference time checking is desired, a blank or "-" may be entered.

(intimes = " ") [string] Names of keywords for the reference start time of the time in input files, up to 50. If the values are different in the different files, supply one column name for each file. This value is only used for indates in dd/mm/yy format. The format of this keyword is hh:mm:ss.sss.

(outstart = "START") [string] Names of columns for start times in output file. Times are output in seconds.

(outstop = "STOP") [string] Names of columns for stop times. Times are output in seconds.

(title=" ") [string] User caption to be tagged to each output FITS file header

EXAMPLES 1. Merge by logical ANDing contents of the two GTI FITS files, gti1.fits and gti2.fits into the output GTI FITS file gtiout.fits using defaults for all other hidden parameters.

ft> wmrggti "gti1.fits,gti2.fits" gtiout.fits AND

2. Merge by logical ORing contents of the two GTI FITS files, gti1.fits[3] and gti2.fits[2] into the output GTI FITS file gtiout.fits

ft> wmrggti "gti1.fits[3],gti2.fits[2]" gtiout.fits OR

NOTES - The program uses the parameter passing of the FTOOLS convention. - This utility is almost identical to wmgtime. In addition it updates CREATOR/DATE keywords and adds keywords for archiving the program parameter arguments - It also prints the total number of resulting GTIs

SEE ALSO maketime



next up previous contents
Next: wqplot Up: Stage-I programs Previous: wmakgti



Mark Savenije
Sat Jan 18 15:04:49 MET 1997