NAME

ahfilter - Generates an EHK file and a MKF filter file for Hitomi

USAGE

ahfilter mkconf attfile orbfile reference outehkfile outmkffile

DESCRIPTION

The ahfilter task runs the ahmkehk task to generate an expanded housekeeping file, using orbit and attitude files for a given observation. The task 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-ordered data file. The EHK and MKF files are used to filter the science (event) data.

The task ahfilter takes an input configuration file that is either an ASCII file or a FITS file, possibly stored in CALDB. The configuration file contains the file name, extension, and column names of the parameters that need to be sampled, as well as other characteristics; see the help file for makefilter for details on 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; these files 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 parameters of the EHK output file ('tsart', 'tstop', 'bintime', 'textend'), are also passed to ahmkehk. See the help file for ahmkehk for details.

The task outputs an MKF file produced by makefilter, and an EHK file produced by ahmkehk. These files can be further used with 'maketime' to create good time intervals (GTI) based on specified filtering criteria. See the help for those tools for more information.

PARAMETERS

mkfconf = ahconfig.fits [filename CALDB|file name]
Input makefilter configuration file.

attfile = ahNNN.att [filename]
Input attitude file.

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

(reference = NONE) [filename NONE|file name]
Reference file supplying the actual time points to be calculated for the output file, overriding 'tstart' and 'tstop'; the 'bintime' parameter is not relevant when a reference file is supplied. If set to NONE, the start and stop times are obtained either from the input parameters 'tstart' and 'tstop', or they supplied by the input attitude file.

(teldeffile = CALDB) [filename CALDB|file name]
Name of the teldef file giving the coordinate systems of the SXI instrument, used to obtain SKY to FOC coordinate transformation parameters. If set to CALDB, the file is read from the calibration database.

(leapsecfile = CALDB) [filename CALDB|file name]
Name of the file giving the table of leap seconds. If set to CALDB, the file is read from the calibration database.

(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, SXI, and SXS instruments, respectively.

(cor2file = CALDB) [filename CALDB|file name]
Name of the file that provides the cutoff rigidity, as a function of terrestrial coordinates, used to fill the COR2 column. If set to CALDB, the file used for Suzaku is read from the calibration database.

(cor3file = CALDB) [filename CALDB|file name]
Name of the file that provides the cutoff rigidity, as a function of terrestrial coordinates, used to fill the COR3 column. If set to CALDB, the file calculated for the year 2016.0, based on the IGRF 2015 data (https://www.ngdc.noaa.gov/IAGA/vmod/igrf.html), is read from the calibration database.

(saafile = CALDB) [filename CALDB|file name]
Name of the file which contains the vertices that define the SAA for each instrument. If set to CALDB, the file is read from the calibration database.

outehkfile [filename]
Name of output EHK file.

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

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

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

(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 VECTOR|COMPONENTS|KEPLERIAN]
Format of the input orbit velocity column in the 'orbext' extension of 'orbfile'.

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

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

(tstart = 0.0) [double]
Start of mission time interval [s] of the output file. 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) [double]
End of mission time interval [s] of the output file. 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) [double]
Time sampling interval [s] of the output file. This parameter is not relevant if a reference file is used to supply the time points (see parameter 'reference').

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

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

(buffer = -1) [integer -1|0|N]
Rows to buffer (-1=auto, 0=none, N>0=number of rows).

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

(chatter = 1) [integer 0|1|2|3]
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 DEFAULT|NONE|file name]
Log file name. If set to DEFAULT, uses the name of the task and, if preceded by "!", overwrites the file if it exists. If set to NONE, no log file is created.

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

(history = yes) [boolean yes|no]
Records task parameters in HISTORY.

EXAMPLES

1. Run ahfilter using the configuration file in CALDB, and the attitude, orbit, and housekeeping files corresponding to the Hitomi 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

November 2, 2023