NAME

xtefilt -- assemble an RXTE filter file from observation inputs


USAGE

         xtefilt -a "appidfile"                   *REQUIRED*
                 -o "obsid"                       *REQUIRED*
                 -p "pathname to FITS database"   *REQUIRED*
                 -t "timestep (secs)"             *REQUIRED*
     
                 -b "breakfile"
                 -c (clobber)
                 -g "maximum gapsize (secs)"
                 -h (print help)
                 -i (interactive)
                 -f "output filename"
                 -s (put output file into stdprod directory)


DESCRIPTION

xtefilt is a script which assembles the scientifically important parameters from the Spacecraft and Orbit FITS data files for a given observation, derives some additional quantities and creates an XTE filter file.


PARAMETERS (SWITCHES/FLAGS)

-a [appidfile]
the name of the file containing the AppIds to be collected *PROMPTED FOR IF NOT SUPPLIED ON COMMAND LINE*

-b [breakfile]
the name of the PCA breakdown file (also can be "NONE" or "CALDB") (default: NONE)

-c
overwrite existing file with same name? (default: NO)

-f [filename]
output filename (.xfl will be appended) (default: FPxx_aaaaa_bbbbb.xfl)

-g [maxgap]
the maximum gap (in seconds) across which to interpolate (default: 128.0)

-h
print this help page

-i
if set, user is prompted for confirmation before modifying stdprod index file

-o [obsid]
the ObsId to be filtered *PROMPTED FOR IF NOT SUPPLIED ON COMMAND LINE*

-p [path]
full pathname for the top of the XTE FITS database (where FMI file is) *PROMPTED FOR IF NOT SUPPLIED ON COMMAND LINE*

-s
put output file in STDPROD directory and update the Std_Prod_Index_File (default: file stays in current working directory) If enabled, any filename specified with the -f flag will be ignored and an XFD-style name used.

-t [timestep]
delta T for the filter file (in seconds) (default: 16.0) *PROMPTED FOR IF NOT SUPPLIED ON COMMAND LINE*


EXAMPLES

1. xtefilt -o 00010-01-01-00 -p /data/xtegof/FITS/FD -a appidlist -t 1.0
The four required parameters are specified on the command line. If not, they will be prompted for by the script.

2. xtefilt -c -s
Prompt me for the required parameters and accept defaults for the rest, except that I want "clobber" enabled (-c) and I want the filter file placed into the standard products directory of the appropriate XTE database (-s).


NOTES

The current version of XTEDERIVE (called by XTEFILT) computes the following quantities: 

          'X_RA','X_DEC','Y_RA','Y_DEC','Z_RA','Z_DEC','POINT_RA','POINT_DEC',
          'POINT_L','POINT_B','ROLLBIAS','VEL_RA','VEL_DEC','SUN_RA','SUN_DEC',
          'MOON_RA','MOON_DEC','SUN_ANGLE','MOON_ANGLE','RAM_ANGLE','ELV',
          'MCILWAIN_L','OFFSET','BKGD_THETA','BKGD_PHI','PCU0_ON','PCU1_ON',
          'PCU2_ON','PCU3_ON','PCU4_ON','NUM_PCU_ON','TIME_SINCE_SAA','ELECTRON0',
          'ELECTRON1','ELECTRON2','ELECTRON3','ELECTRON4','L6CNTPCU0'

This version of XTEFILT requires FCOLLECT v4.2.1 or higher to run properly.

The following appidlist is currently being used in the RXTE-GOF: 

            14 ACSESTQ1
            14 ACSESTQ2
            14 ACSESTQ3
            14 ACSESTQ4
            15 ACSMODESTAT
            16 ACSSCPOSX
            16 ACSSCPOSY
            16 ACSSCPOSZ
            16 ACSSCVELX
            16 ACSSCVELY
            16 ACSSCVELZ
            17 ACSEARTHLAT
            17 ACSEARTHLON
            20 ACSLUNARX
            20 ACSLUNARY
            20 ACSLUNARZ
            21 ACSALTITUDE
            24 ACSEARTHX
            24 ACSSUNX
            24 ACSSUNY
            24 ACSSUNZ
            74 VpX1LCntPcu0
            74 VpX1RCntPcu0
            74 Q6VxVpXeCntPcu0
            74 VpX1LCntPcu1
            74 VpX1RCntPcu1
            74 Q6VxVpXeCntPcu1
            74 VpX1LCntPcu2
            74 VpX1RCntPcu2
            74 Q6VxVpXeCntPcu2
            74 VpX1LCntPcu3
            74 VpX1RCntPcu3
            74 Q6VxVpXeCntPcu3
            74 VpX1LCntPcu4
            74 VpX1RCntPcu4
            74 Q6VxVpXeCntPcu4
            74 X2LX2RCntPcu0
            74 X3LX3RCntPcu0
            74 X1LX2LCntPcu0
            74 X1RX2RCntPcu0
            74 X2LX3LCntPcu0
            74 X2RX3RCntPcu0
            83 ctLldPm pm_0
            89 ctLldPm pm_1
            90 cmdhvXE cmdhvXE_PCU0
            91 cmdhvXE cmdhvXE_PCU1
            92 cmdhvXE cmdhvXE_PCU2
            93 cmdhvXE cmdhvXE_PCU3
            94 cmdhvXE cmdhvXE_PCU4
            90 hvXEon hvXEon_PCU0
            91 hvXEon hvXEon_PCU1
            92 hvXEon hvXEon_PCU2
            93 hvXEon hvXEon_PCU3
            94 hvXEon hvXEon_PCU4
            90 hvXErly hvXErly_PCU0
            91 hvXErly hvXErly_PCU1
            92 hvXErly hvXErly_PCU2
            93 hvXErly hvXErly_PCU3
            94 hvXErly hvXErly_PCU4
            90 evXEgood evXEgood_PCU0
            91 evXEgood evXEgood_PCU1
            92 evXEgood evXEgood_PCU2
            93 evXEgood evXEgood_PCU3
            94 evXEgood evXEgood_PCU4
            251 hvD0 hvD0_0
            251 hvD1 hvD1_0
            251 hvD2 hvD2_0
            251 hvD3 hvD3_0
            252 hvD0 hvD0_1
            252 hvD1 hvD1_1
            252 hvD2 hvD2_1
            252 hvD3 hvD3_1
            295 TIME_SINCE_BRK0
            295 TIME_SINCE_BRK1
            295 TIME_SINCE_BRK2
            295 TIME_SINCE_BRK3
            295 TIME_SINCE_BRK4
            295 TIME_SINCE_BRK


BUGS

Please report problems to xtehelp@athena.gsfc.nasa.gov.


SEE ALSO

FCOLLECT, XTEDERIVE

CATEGORY

Jan95 ftools.xte