NAME
batsurvey-erebin - perform energy correction on survey data
USAGE
batsurvey-erebin infile outfile calfile
DESCRIPTION
batsurvey-erebin does energy scale correction on survey data. The
benefit of this task is that it can do a batch of survey data at one
time (multiple DPH files), and that it can do automatic selection of
the correct gain/offset tables. The gain/offset maps must be located
in the standard directory within the observation.
Since batsurvey-erebin has the capability of correcting multiple DPH
files, one can specify a generic template output file name, and
batsurvey-erebin will create the output file name from the template.
batsurvey-erebin responds to two particular template strings, which
are: "%root" - full path of input file, with suffxes removed;
"%rootpath" - same as %root, with leading path components removed.
For example, infile="test.dph" outfile="outdir/%rootfile_erebin.dph"
would make an output file named "outdir/test_erebin.dph".
PARAMETERS
- infile [filename]
- Name of BAT survey file. If the name begins with an "@" symbol,
then it is assumed that the file contains an ASCII list of
files, one per line. Each listed file is corrected, and saved
according to the file name listed in 'outfile'.
- outfile [filename]
- Name of corrected output files. It is also possible to specify a
template filename, where portions of the input file are substituted
into the template, as described above.
- calfile [string]
- Gain/offset file(s) to use. Either specify one explicit file name
to be used for all input files; OR the name of a directory containing
multiple gain/offset files; OR the word "QUERY" to indicate using the
'repoquery' task to find gain/offset files (this last option is for
BAT team internal usage only). If specifying a directory, then each
file is scanned for internal keywords which specify the time of the
file. To speed up this indexing operation, the file name can
contain the time, in the form,
swOOOOOOOOOOObcboddddgdddd_mmmmmmmmm.fits, where mmmmmmmmmm is the
time in mission elapsed time.
- residfile="CALDB" [filename]
- "Residual" gain/offset file to use. Passed directly to baterebin.
- pulserfile="CALDB" [filename]
- "Ground pulser to energy" calibration file to use. Passed directly to baterebin.
- fltpulserfile="CALDB" [filename]
- "Flight pulser to energy" calibration file to use. Passed directly to baterebin.
- baterebin_opts="" [string]
- Extra options to be passed to baterebin.
- (clobber = NO) [boolean]
- If the output file already exists, then setting "clobber = yes" will cause it to be overwritten.
- (chatter = 2) [integer, 0 - 5]
- Same as baterebin chatter option.
- (history = YES) [boolean]
- If history = YES, then a set of HISTORY keywords will be written to
the header of the specified HDU in the output file to record the value
of all the task parameters that were used to produce the output
file.
EXAMPLES
1. List all survey files, and correct their energy scale, using the
gain/offset files found in the housekeeping directory.
ls 00035025015/bat/survey/*.dph* > mydphfiles.txt
batsurvey-erebin infile=@mydphfiles.txt \
outfile=output/%rootfile_erebin.dph calfile=bat/hk
SEE ALSO
baterebin,
batsurvey
LAST MODIFIED
Jun 2008