HEADAS help file

NAME

sxiphas -- Merge inner 3x3 and outer 5x5 pulse height columns in SXI event list

USAGE

sxiphas infile outfile

DESCRIPTION

'sxiphas' reads an SXI FITS event list and merges pixel pulse height data from the inner 3x3 event island (9 pixels in the column PHAS_INNER3X3) and the outer 5x5 ring (16 pixels in the column PHAS_OUTER5X5) for each event. Since the inner 3x3 square are telemetered separately from the outer 5x5 ring, they must be combined into a single column. Also, depending on the telemetry bandwidth available, one or the other set of pulse heights might be missing.

The merged pulse height data from all 25 pixels are recorded in the column PHASALL. The contents of PHAS_INNER3X3 are also copied to the PHAS column. If the 3x3 data are present but the 5x5 data are missing, then the outer pixel values of PHASALL are set to TNULL, and STATUS flag 24 is set. If the inner 3x3 data are missing (which is abnormal), then regardless of whether the outer 5x5 ring is present, all of PHAS and PHASALL are set to TNULL, and STATUS flag 25 is set.

PARAMETERS

infile [filename]: Name of input SXI FITS event list.
outfile [filename]: Name of output SXI FITS event list.
(colbound = -32768,-32767,32767) [string]: Values to use for TNULL, TLMIN, and TLMAX in the output columns PHASALL and PHAS. TNULL is the value used for "no data". This is a comma-separated list of three integers.
(buffer = -1) [integer]: Rows to buffer (-1=auto, 0=none, >0=numrows).
(clobber = no) [boolean]: Overwrites the existing output file if set to yes (yes/[no]).
(chatter = 1) [integer]: 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]: Log filename. If set to DEFAULT uses the name of the task and, if preceded by '!', overwrite the file if it exists. If set to NONE no log file is created.
(debug = no) [boolean]: Diagnostic output is printed out on the screen if set to yes (yes/[no]).
(history = yes) [boolean]: Records tool parameters in HISTORY if set to yes ([yes]/no).
(mode = ql) [string ql|hl|q]: Mode to query the parameter file. Acceptable values include: "ql" (query and learn/remember), "hl" (hidden and learn/remember), "q" (query but don't remember), "h" (hidden).

EXAMPLES

Merge 3x3 and 5x5 pulse height columns, using the default TNULL, TLMIN, and TLMAX values for the output pulse height amplitude columns PHAS and PHASALL.
```
sxiphas infile=sxi_fff_test_20130418.fits outfile=sxi_sff_test_20130418.fits
```

LAST MODIFIED