pantering is used to convert HK packet files stemming from the X-ray
testing facility Panter, Munich into FITS format. These generated HK
FITS files can be further processed with standard FTOOLS or, for instance,
with the hkplot module in order to
create GTIs for event selection purposes.
PARAMETERS
The following command line parameters are recognized by the program:
infiles = "" [string]
This is a blank or colon separated list of Panter HK packet files which
will be concatenated and reformatted into a single FITS file.
The name of this newly generated file will have a suffix _xhk.fits
(for auXillary HouseKeeping).
indirpath = "" [string]
A colon separated list of directories to seek for the specified
input files.
For each file given in infiles
this is performed by first attempting to open the file as specified in
infiles. If this fails, each directory component in
indirpath
is inspected for the location of the desired input file.
nfiles = 1 [integer: >1]
The number of HK packet files that are to be concatenated. If
nfiles
is specified, and the packet file names follow the default naming convention
"UDyymmdd.aa" where "aa" is a consecutive number from 00 to 99, merely
the first file name has to be given. Example:
pantering UD941110.00 nfiles=3
is equivalent to pantering "UD941110.00 UD941110.01 UD941110.02".
outdir = "=" [string]
The destination directory for the FITS output file. If
"=" is specified for outdir
(the default), the output file is written to the directory where the
corresponding input file was found.
outname = "" [string]
The basename of the FITS file to be created. If unspecified the basename
of the first input file will be used.
caldb = no [boolean: yes|no]
If set to yes, the created FITS file is eligible for inclusion into
the SAX/LECS calibration database. In this case, the primary FITS
headers of the output file contains the mandatory keywords for
FITS calibration files. Default is "no".
survey = no [boolean: yes|no]
If set to "yes", no FITS file will be created but they program merely
inspects the given input file(s) for time coverage and data integrity.
origin = "-" [string]
Value of FITS header keyword "ORGIN". "-" means to use an
installation dependant default value - pantering help=yes shows this
default value.
observer = "-" [string]
Value of FITS header keyword "OBSERVER". "-" means to use an
installation dependant default value - pantering help=yes shows this
default value.
obsid = "-" [string]
Value of FITS header keyword "OBS_ID". "-" means to use an
installation dependant default value - pantering help=yes shows this
default value.
verbosity = 2 [integer: 0|1|2|3]
Determines the program verbosity level, i.e. the amount of screen output
that will be issued during program execution. Level 0 means "mute",
only fatal error messages will be printed. Verbosity level 3 results into
detailed diagnostic messages. Default is level 1.
help = no [boolean: yes|no]
Display a brief on-screen description of all available command line
parameters with default values and the current program version number.
EXAMPLES
Convert the three consecutive packet files UD941110.00,
UD941110.01, and UD941110.00 into a single FITS file and
seek these input files in various directories: