The hxievtid task determines whether the signals in an occurrence constitute a valid event and computes the event position and the energy deposited in the detector. The input file to hxievtid is an SFF (second FITS file) with variable length array columns where each row contains an occurrence with multiple signals recorded at a given time. The output event file, specified by the parameter 'outfile', has a different structure and does not contain columns with variable length arrays. In the output file, each row corresponds to a reconstructed event, and the columns RAWX, RAWY, and PI contain the reconstructed x-position, y-position, and energy respectively of that event, along with additional columns containing other event characteristics, as described below.
The HXI consists of five detector layers in a vertical stack: four Si strip detectors at the top, and a single CdTe detector at the bottom. Each layer is a strip detector with top-side strips running perpendicular to bottom-side strips. Signals in more than one layer are rejected unless they are reconstructed with an X-ray fluorescence event. Signals below the threshold PHA values given in 'badpixfile' are not used in the reconstruction.
The only localization patterns recognized as a valid signal are:
Occurrences with signals matching one of the template patterns in both the CdTe layer and one Si layer may be accepted if the reconstructed energy deposited in the Si layer is within one of the ranges for a fluorescence X-ray from the CdTe layer.
The reconstructed energy of an event is computed using the signal EPI values calculated in hxisgdpha. For events occurring in a single layer, the event energy (EPI in keV) is taken to be the sum of the one or two signals in the top layer for Si or the bottom layer for CdTe. For events with signals in a single Si layer and the CdTe layer, the EPI is taken from the one or two bottom layer signals in the CdTe layer. The PI value of the event is calculated using a channel size of 0.1 keV.
The coordinate location (RAWX, RAWY) is evaluated by taking the strip number associated with the signal with the larger EPI in both top (RAWY) and bottom (RAWX) sides. In the case of an occurrence with both signals equally split and having the same EPI, the signal determining the position is chosen randomly. For events with signals in two layers, one on Si and one on CdTe, the procedure for position determination is applied for signals in the CdTe layer.
Reconstruction results for each occcurence are in the output file specified by the 'outfile' parameter. Columns copied from the input SFF are TIME, OCCURRENCE_ID, CATEGORY, FLAG_SEU, FLAG_LCHK, FLAG_TRIG, FLAG_TRIGPAT, FLAG_HITPAT, FLAG_FASTBGO, LIVETIME, PROC_STATUS, and STATUS.
Output file columns populated by the reconstruction are as follows:
Additional coordinate columns are added to the file but populated later by the coordevt task: ACTX, ACTY, DETX, DETY, FOCX, FOCY, X, and Y.
The bit flags in the RECO_STATUS (reconstruction status) column are as follows:
Bit Description ------(Occurrence mode identification)------------------------------- 0 Mode is Am 241 1 Mode is PSEUDO 2 Mode is CALMODE 3 Mode is READALL 4 Mode is NOTSURE ------(Event reconstruction skipped for this occurrence)------------- 5 Bad PROC_STATUS 6 Mode is READALL or CALMODE and SKIPRECO option is YES 7 Occurrence has no signals 8 FASTBGO or HITPAT flag is set and REJECTBGO option is YES ------(Event reconstruction outcome)--------------------------------- 9 Event could not be reconstructed
hxievtid infile=HXI_SFF.fits outfile=HXI_output.fits remapfile=CALDB fluorefile=CALDB badpixfile=CALDB enecutfile="CALDB2. Reconstruct HXI events and produce an extra output file.
hxievtid infile=HXI_SFF.fits outfile=HXI_output.fits remapfile=CALDB fluorefile=CALDB badpixfile=CALDB enecutfile=CALDB outcalfile=extra.fits clobber=yes3. Reconstruct HXI events for a single occurrence.
hxievtid infile=HXI_SFF.fits outfile=HXI_output.fits remapfile=CALDB fluorefile=CALDB badpixfile=CALDB enecutfile=CALDB occurrenceid=2 clobber=yes