NAME
nicertimecal - apply clock calibration to NICER event file
USAGE
nicertimecal infile hkfile calfile [outfile]
DESCRIPTION
This task applies clock calibration to NICER event files timestamps.
It adjusts the measured time values for known instrumental biases.
The end result a revised 'TIME' column in the output event file. Note
that the old time values are effectively overwritten, so the user
is strongly advised to not use this task on the original NICER
"_uf" event files. Normally this task will be run as a part of
the 'nimpucal' task.
Also note that it is not possible to apply clock calibration more than
once to an event file. Once the TIME column is overwritten it cannot
be recalibrated. After calibration, the CLOCKAPP keyword is set to
'T' to reflect this status.
This task currently corrects for the known electronics delays within
the instrument, as well as a global 1 second timestamp offset
introduced within the flight master computer.
PARAMETERS
- infile [filename]
- Input file name. Name of a NICER event file to have clock calibration
performed upon it. If outfile=INFILE then the input file will be modified
in place, otherwise it will be untouched.
- hkfile [filename]
-
Name of MPU housekeeping file, available in each observation.
- calfile [filename]
- Name of FPM/MPU clock calibration data file, or "CALDB". For standard
operation, the NICER team recommends to use "CALDB".
- outfile [filename]
- Name of output event file, or "INFILE". A new file named outfile will
be created with modified TIME column. If outfile=INFILE, then
the input file will be modified in place without creating a new file.
- (leapinit="AUTO") [string]
- Initialize LEAPINIT keyword of event extensions? An integer value
indicates to use that many leap seconds. A value of "AUTO" indicates use
the appropriate number of leap seconds for the given observation TSTART.
A value of "NONE" indicates to not change LEAPINIT.
- (calstation="FLIGHT") [string]
-
Station where data was collected. For in-flight operations use
calstation=FLIGHT. For ground-based testing, other values can be
used. This parameter selects the NICSTATN keyword value in CALDB.
- (cleanup="YES") [boolean]
- If yes, then clean up temporary files. If no, temporary files
remain. This is typically for debugging.
- (timeoffset=0.0) [real]
- Constant time offset to add to housekeeping timestamps to bring
them into alignment with event timestamps.
- (clobber = NO) [boolean]
-
If the output file already exists, then setting "clobber = yes" will cause it to be overwritten.
- (chatter = 1) [integer, 0 - 5]
-
Controls the amount of informative text written to standard output.
Setting chatter = 4 or higher will produce detailed diagnostic output;
chatter = 1 prints out a basic diagnostic message. The default is to
produce a brief summary on output.
- (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 nicertimecal task parameters that were used to produce the output
file.
EXAMPLES
This is a typical invocation:
nicertimecal crab_pulsar.evt mpu_hk.fits CALDB outfile=INFILE
The event file to be calibrated is crab_pulsar.evt. Since outfile=INFILE, the input file
is modified in place. The task queries CALDB for the gain calibration file.
LAST MODIFIED
Jul 2018