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