NAME

ahfilter -- generate an EHK file and a MKF filter file

USAGE

ahfilter mkconf attitude orbit reference

DESCRIPTION

'ahfilter' script runs the 'ahmkehk' task to generate an expanded housekeeping file using orbit and attitude files for a given observation, and then runs 'makefilter' to generate an MKF filter file from an input configuration file. This MKF file combines information from various instrument, general housekeeping and auxiliary files for a given observation into a common time order datafile. The EHK and MKF files are used to filter the science data

'ahfilter' takes as input a configuration file that is either an ASCII file or a FITS file, possibly stored in CALDB. The configuration file contains the filename, extension, and column names of the parameters that need to be sampled as well as other characteristics; see the help for 'makefilter' for details on the configuration file format requirements. The tool also requires an observation-specific attitude file ('attfile') and orbit file ('orbfile') that describe the location and pointing of the telescope and are used as input to 'ahmkehk'. An optional time reference file ('reference') and additional CALDB files describing the orbit ('cor2file', 'cor3file', 'saafile') and time sampling of the EHK output file ('tsart', 'tstop', 'bintime', 'textend') are also passed to 'ahmkehk'. See the help for 'ahmkehk' for details.

The tool outputs an MKF file produced by 'makefilter', which can be further used with 'maketime' to create good time intervals (GTI) based on some filtering criteria. See the help for those tools for more information.

PARAMETERS

mkfconf [filename]
Input makefilter configuration file (or CALDB).

attfile [filename]
Input Hitomi attitude file.

orbfile [filename]
Input Hitomi orbit file, assumed to have the same format as Suzaku version 2 orbit files.

reference [filename]
Input time reference file (or NONE to use the attitude file) if 'tstart' or 'tstop' are set to 0.

(teldeffile = CALDB) [file]
Name of the input TELDEF file providing the coordinate systems of the SXI instrument, which is used fiducially to obtain sky coordinates (or CALDB).

(leapsecfile = REFDATA) [file]
Input leap second file (or CALDB, [REFDATA]).

(optaxis = 1215.5,1215.5,1215.5,1215.5,1215.5,1215.5,1215.5,1215.5) [string]
X and Y optical axis coordinates in FOC coordinates for HXI1, HXI2, SGD1, SGD2, SXI, and SXS instruments, respectively.

(cor2file = CALDB) [file]
Input cut-off rigidity Suzaku file (or CALDB).

(cor3file = CALDB) [file]
Input cut-off rigidity IGRF 2016 file (or CALDB).

(saafile = CALDB) [file]
Input SAA vertices for each instrument (or CALDB).

outehkfile [file]
Name of output EHK file.

outmkffile [file]
Name of output makefilter (MKF) file.

(attext = ATTITUDE) [string]
Name of the extension in the attitude file ('attfile') with pointing information.

(attform = EULER) [string]
Format of the input attitude column in the 'attext' extension of 'attfile'. Must be EULER or QUAT.

(attcol = EULER) [string]
Name of the input attitude column in the 'attext' extension of 'attfile'.

(orbext = ORBIT) [string]
Name of the extension in the orbit file ('orbfile').

(orbform = KEPLERIAN) [string]
Format of the input orbit velocity column in the 'orbext' extension of 'orbfile'. Must be VECTOR, COMPONENTS, or KEPLERIAN.

(orbcol = A,E,I,AN,AP,MA) [string]
Name of the input orbit columns in the 'orbext' extension of 'orbfile'.

(timecol = TIME) [string]
Name of the column containing mission time in the reference file.

(tstart = 0.0) [real]
Start of mission time interval of the output file [s]. If either tstart or tstop is 0.0, the time interval is set equal to the time range of the reference file if there is one, or else to that of the attitude file.

(tstop = 0.0) [real]
End of mission time interval of the output file [s]. If either tstart or tstop is 0.0, the time interval is set equal to the time range of the reference file if there is one, or else to that of the attitude file.

(bintime = 1.0) [real]
Time sampling interval of the output file [s].

(textend = 0.0) [real]
Time added to the beginning and end of the output file time interval, preceding tstart and following tstop [s].

(infileroot = ) [string]
Prefix of the input HK files for applying 'mkconf' file.

(buffer = -1) [integer]
Rows to buffer (-1=auto, 0=none, >0=numrows).

(clobber = no) [boolean]
Overwrites the existing output file if set to yes (yes/[no]).

(chatter = 1) [integer]
Chatter level for output. Set to 0 to suppress output, or to 1, 2, or 3 for increasing the chatter of the output.

(logfile = !DEFAULT) [string]
Log filename. If set to DEFAULT uses the name of the task and, if preceded by '!', overwrite the file if it exists. If set to NONE no log file is created.

(debug = no) [boolean]
Diagnostic output is printed out on the screen if set to yes (yes/[no]).

(history = yes) [boolean]
Records tool parameters in HISTORY ([yes]/no).

(mode = ql) [string ql|hl|q]
Mode to query the parameter file. Acceptable values include: 'ql' (query and learn/remember), 'hl' (hidden and learn/remember), 'q' (query but don't rem\ ember), 'h' (hidden).(Optional)

EXAMPLES

1. Run ahfilter using the configuration file in CALDB, and the attitude, orbit, and housekeeping files corresponding to sequence ah000507024.

    ahfilter mkfconf=ah_gen_mkfconf_20131001v004.fits attfile=ah000507024.att.gz orbfile=ah000507024.orb.gz reference=NONE \
    outehkfile=ahfilttest1.ehk outmkffile=ahfilttest2.mkf infileroot="ah000507024" clobber=yes
    

SEE ALSO

ahmkehk, makefilter, maketime

LAST MODIFIED

January 27 2016