NAME
sxsseccor - Correct PHA values for mid-resolution secondary grade Hitomi SXS events.
USAGE
sxsseccor infile outfile
DESCRIPTION
The sxsseccor task corrects the telemetered PHA values of the SXS
mid-resolution secondary (Ms) events in an event file specified by the
'infile' parameter, based on the values of the TIME and PHA columns of
all preceding events that are members of the same group. A group is
defined as a primary event and all associated secondary events
occurring within a pixel, and groups for each event are designated and
written to the GROUPS column by the sxssecid task.
The secondary correction for each Ms event in a group is calculated
based on the SXS pulse shape estimated at the PHA value of the
event, the time interval between the event and the preceding event
in the group, the PHA value of the event, and the
(already-corrected) PHA value of the preceding event. The pulse
shape is obtained from average pulse shapes over a number of PHA
ranges for each pixel stored in the calibration database (CalDB)
file, CALDB, specified by the parameter 'pulsefile' (using the extension
with event threshold identifier matching that in the header of 'infile').
The corrected PHA value is written to a new column specified by the 'phaout'
parameter ('phaout' may not be set to PHA). No correction is
applied to "orphan" events, defined as secondaries not associated
with any primary (the value in the 'phaout' column is the same as that
in the PHA column).
PARAMETERS
- infile = [filename]
- Input SXS event file name. The file must have the TIME column assigned.
- outfile = out.fits [filename]
- Output file name. The output file is a copy of
the input file with a new column, whose name s pecified by the 'phaout'
parameter, that is populated with the corrected PHA values.
- (pulsefile = CALDB) [filename]
- Input file containing PHA pulse amplitude profiles over multiple
PHA ranges for each pixel. If this parameter is set to CALDB, the file
is read from the CalDB.
- (itypecol = ITYPE) [string]
- Name of the column used to identify grades, and associate secondary
events with the primary event in a group.
- (phaout = PHA2) [string]
- Name of the new column to populate with corrected PHA values. This
may not be set to PHA.
- (buffer = -1) [integer -1|0|N]
- Rows to buffer (-1=auto, 0=none, N>0=numrows).
- (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 tool parameters in HISTORY.
EXAMPLES
- Correct PHA values for mid-resolution secondary events using the
pulse amplitude file in the CALDB. Event grades are derived from the
ITYPE column and the corrected PHA values are written to the
column PHA2.
sxsseccor infile=event_in.fits outfile=event_out.fits
SEE ALSO
sxssecid
LAST MODIFIED
August 2, 2024