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

  1. 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.
  2.    sxsseccor infile=event_in.fits outfile=event_out.fits 
    

SEE ALSO

sxssecid

LAST MODIFIED

August 2, 2024