NAME

ahpipeline - HXI/SGD/SXS/SXI reprocessing tool

USAGE

ahpipeline indir outdir steminputs stemoutputs entry_stage instrument

DESCRIPTION

ahpipeline duplicates most of the pipeline (not trend data). It allows the user to run all or part of the pipeline processing and to vary the calibration files and filtering (screening) criteria used. A number of other pipeline processing parameters can also be changed.

Pipeline Stages

The pipeline is divided into 3 stages:

  1. Calibration
  2. Data screening
  3. Product creation
Each stage may be run singly or in combination with the preceding stages. This is controlled by the entry_stage and exit_stage parameters.

HXI Stage 1 consists of the following ordered steps:

  1. Run cams2att*
  2. Run hxisgdsff
  3. Run hxisgdpha
  4. Run hxisgdexpand
  5. Run hxievtid
  6. Run coordevt

*Note: cams2att is automatically run twice. Once with parameters set for HXI1, the other with parameters set for HXI2.

SGD Stage 1 consists of the following steps:

  1. Run hxisgdsff
  2. Run hxisgdpha
  3. Run hxisgdexpand
  4. Run sgdevtid

SXI Stage 1 consists of the following steps:

    For each event file:
  1. (optional) Run coordevt on hot pixel file
  2. Run coordevt
  3. Run sxiphas
  4. Run sxiflagpix
  5. Run sxipi
  6. Run sxipi
    1. Create flickering pixel file
      1. Filter SXI events STATUS[1]==b0
      2. Run searchflickpix
      3. Run coordevt on flickering pixel events
  7. Run sxiflagpix with flickering pixels

SXS Stage 1 consists of the following steps:

  1. (optional) Calculate GTIFOUNDALL (gtiinvert on GTILOST)
  2. Run mxsgti
  3. Calculate <gaingti> GTI file:
  4. Run sxsanticopi
  5. For each event file:
    1. Run coordevt
    2. Run sxsflagpix
    3. Run sxssecid
  6. Calculate GHF
    1. Merge pointing and slew event files
    2. Select merged file
      • if linetocorrect eq 'MnKa':
        PIXEL==12&&ITYPE<5&&gtifilter("<gaingti>")
      • else:
        PIXEL!=12&&ITYPE<5&&gtifilter("<gaingti>")
    3. Run ftsort on filtered merged file
    4. Run sxsgain on filtered, sorted merged file
  7. For each event file:
    1. Run sxspha2pi (GHF input)
    2. Run sxsflagpix
    3. Run sxssecid
    4. Run sxsseccor
    5. Run sxspha2pi (GHF input)
    6. Run sxsperseus

The data screening (Stage 2) is identical to that in the production pipeline, when default parameters are used. ahpipeline uses the individual instrument pipelines to screen the data: hxipipeline, sgdpipeline, sxipipeline, sxspipeline. For details on the default screening applied to the events (respectively), see:

The product creation (Stage 3) is identical to that in the production pipeline, when default parameters are used. For HXI, SXI & SXS events extractor is run on SKY coordinates and a lightcurve, spectra and images are created for each cleaned event file. For SGD, extractor coordinates are set to NONE. No gif images are created.

Instruments

ahpipeline allows the processing of data on an instrument-by-instrument basis. This is controlled by the instrument parameter. Possible values are:

More than one value may be specified at one time.
Combination of HXI1 and HXI2 is allowed, is equivalent to HXI.
Combination of SGD1 and SGD2 is allowed, is equivalent to SGD.

INPUT

The input to ahpipeline is specified using (at minimum) the indir parameter. This should be specified as the top-level sequence directory, e.g.:

ahpipeline indir=/path/to/100039010 ...

Paths to specific housekeeping and satellite data files can be specified using the attitude, housekeeping, extended_housekeeping, makefilter, orbit and timfile parameters. But this should NOT be necessary if indir is specified correctly.

NOTE: Errors can occur if a subdirectory of a sequence directory is used for the indir parameter or if the output is stored within the sequence directory.

OUTPUT

Report

An output report is produced with the default name "ahpipeline.log". The name of the log can be changed with the logfile parameter. This lists all processing done in any particular run of ahpipeline. The level of detail of this report is controlled by the chatter parameter. (Default = "2", range 0 - 3.)

NOTE: Setting chatter to "3" or above can produce very large output reports.

Filenames, etc.

The number of output files depends on both pipeline processing stage(s) and the instrument(s) selected. All output files are written to the directory specified by the outdir parameter. The archive directory structure is NOT reproduced (i.e. all output files are in a single directory).

The names of files produced are the same as those found in the HEASARC archive. However the usual "ahXXXXXXXXX" prefix (where "XXXXXXXXX" is the sequence number) can be replaced by a character string set by the stemoutputs parameter. This defaults to the value set by the steminputs parameter.

PARAMETERS

indir [string]
Directory containing the input data. This should be the full, or relative path to the top-level sequence directory, e.g.:

    /path/to/805062010/

NOTE: Problems can arise if a sub-directory of the top-level sequence directory is used.

outdir [string]
Output directory used for all output data, as well as the report file. If clobber is not set, and this directory already exists, the task fails. This should NEVER be a sub-directory of the input directory (the top level sequence directory).

CAUTION: If clobber is set, and this directory already exists, then this task overwrites files as needed in this directory.

steminputs [string]
Stem for FITS input files, e.g. ah100039010. This string is used as the base filename for finding input files. For example, if steminputs=ah100039010, then to find the attitude file, ahpipeline matches the regular expression /ah100039010\.att(\..+)?$/ against all files found in the indir directory.

When doing this matching, ahpipeline prefers files that match the original archive directory structure over files with the same name that do not. For example, if the files:

    /path/to/805062010/hxi/event_uf/ah805062010hxi_0_uf.evt

    /path/to/805062010/hxi/event_uf_2/ah805062010hxi_0_uf.evt

both exist, ahpipeline uses the first file, and not the second. If two files of the same name are found and neither one resides in an archive directory structure, ahpipeline exits with an error.

NOTE: The above file finding issues can be avoided if the downloaded archive data set is left "pristine", by specifying an output directory OUTSIDE of the input directory tree.

(stemoutputs = DEFAULT) [string]
Base (stem) output name used for creating output files. If set to "DEFAULT", then steminputs is used.

entry_stage = 1 [1|2|3]
Entry stage, 1 or 2.

Stage 1: Re-calibrate unfiltered event files.

Stage 2: Start from existing unfiltered event files.

exit_stage = 2 [1|2|3]
Exit stage, 1 or 2.

Stage 1: Produces calibrated unfiltered event files.

Stage 2: Produces screened event files.

instrument = ALL [string]
Comma delimited list of which instruments to process. List can include the following values:

More than one value may be specified at one time:

verify_input [boolean]
Verify with ftverify (yes, no)

(attitude = DEFAULT) [string]
Attitude file

(housekeeping = DEFAULT) [string]
Housekeeping file

(extended_housekeeping = DEFAULT) [string]
Extended housekeeping file

(makefilter = DEFAULT) [string]
Makefilter file

(orbit = DEFAULT) [string]
Orbit file

(timfile = DEFAULT) [string]
Time file

(obsgti = DEFAULT) [string]
Observation GTI file

(calc_pointing = yes) [boolean]
Calculate nominal pointing ([yes]/no)

(calc_optaxis = yes) [boolean]
Calculate optical axis keywords ([yes]/no)

(create_ehkmkf = no) [boolean]
Create the EHK and MKF files (yes/[no])

(makeregion = no) [boolean]
Make a region file (yes/[no])

(ra = -999.99999) [real]
RA of nominal pointing [deg]

(dec = -999.99999) [real]
Dec of nominal pointing [deg]

(roll = 0.0) [real]
Roll of nominal pointing [deg]

(leapsecfile = REFDATA) [filename]
gen: Input leap second file (or CALDB, [REFDATA])

(selectfile = CALDB) [filename]
gen: Input file with the selection expressions

(mkfconf = CALDB) [filename]
gen: Input file with the selection expressions

(cor2file = CALDB) [filename]
Input cut-off rigidity Suzaku file (or CALDB)

(cor3file = CALDB) [filename]
Input cut-off rigidity IGRF 2016 file (or CALDB)

(saafile = CALDB) [filename]
CALDB

(hxi_start = 0.0) [real]
HXI CALDB start time

(hx1_teldef = CALDB) [filename]
coordevt: teldeffile hxi1

(hx2_teldef = CALDB) [filename]
coordevt: teldeffile hxi2

(hxi_remapfile = CALDB) [filename]
hxisgdsff/hxievtid: remapping file

(hxi_gainfile = CALDB) [filename]
hxisgdpha: PHA calibration functions

(hxi_badpixfile = CALDB) [filename]
hxisgdpha/hxievtid: readout channels

(hxi_fluorefile = CALDB) [filename]
hxievtid: Input fluorescence file

(hxi_enecutfile = CALDB) [filename]
hxievtid: Input energy cut file

(cm1_teldef = CALDB) [filename]
cams2att: CAMS1 teldeffile

(cm2_teldef = CALDB) [filename]
cams2att: CAMS2 teldeffile

(camstempxy = CALDB) [filename]
cams2att: CAMS temperature correction file

(sgd_start = 0.0) [real]
SGD CALDB start time

(sg1_teldef = CALDB) [filename]
coordevt: teldeffile

(sg2_teldef = CALDB) [filename]
coordevt: teldeffile

(sgd_remapfile = CALDB) [filename]
hxisgdsff/hxievtid: remapping file

(sgd_gainfile = CALDB) [filename]
hxisgdpha: PHA calibration functions

(sgd_badpixfile = CALDB) [filename]
hxisgdpha/hxievtid: readout channels

(sgd_fluorefile = CALDB) [filename]
sgdevtid: Input fluorescence file

(sgd_probseqfile = CALDB) [filename]
sgdevtid: sequence probability file

(sgd_probfovfile = CALDB) [filename]
sgdevtid: FOV probability file

(sxi_start = 0.0) [real]
SXI CALDB start time

(sxi_teldef = CALDB) [filename]
coordevt: teldeffile

(sxi_badpixfile = CALDB) [filename]
sxiflagpix: badpixfile

(sxi_maskfile = CALDB) [filename]
sxiflagpix: maskfile

(sxi_vtevnodd = CALDB) [filename]
sxipi: evenodd

(sxi_ctifile = CALDB) [filename]
sxipi: cti

(sxi_chtrailfile = CALDB) [filename]
sxipi: chtrail

(sxi_spthfile = CALDB) [filename]
sxipi: splitth

(sxi_gainfile = CALDB) [filename]
sxipi: gain

(sxi_patternfile = CALDB) [filename]
sxipi: grade

(sxs_start = 0.0) [real]
SXS CALDB start time

(sxs_teldef = CALDB) [filename]
coordevt: teldeffile

(sxs_coeftime = CALDB) [string]
sxssamcnt: Input file with arrival time coeffs

(sxs_pixdeffile = CALDB) [filename]
sxsflagpix: Input SXS electrical pixel map file

(sxs_gainfile = CALDB) [filename]
sxsupi: Input SXS gain coefficients file

(sxs_linefitfile = CALDB) [filename]
sxsdrift: Input calibration line file

(sxs_gainantfile = CALDB) [filename]
sxsanticopi: Input antico gain file

(sxs_delayfile = CALDB) [filename]
Input instrument delay file (or CALDB)

(hxi_mkflabel = HXISFFA1CAM) [string]
Label to use for HXI MKF GTI creation
For pseudo events "PSE" replaces CAM in the label

(hxi_ehklabel = HXISFFA1CAM) [string]
Label to use for HXI EHK GTI creation
For pseudo events "PSE" replaces CAM in the label

(hxi_evtlabel = HXISFFA1CAM) [string]
Label to use for HXI event screening
For pseudo events "PSE" replaces CAM in the label

(sgd_mkflabel = SGDSFFA1#) [string]
Label to use for SGD MKF GTI creation. The hash is replaced by a respective Compton camera: CC1, CC2 or CC3
For pseudo events "PSE" is appended to the end of the label

(sgd_ehklabel = SGDSFFA1#) [string]
Label to use for SGD EHK GTI creation. The hash is replaced by a respective Compton camera: CC1, CC2 or CC3
For pseudo events "PSE" is appended to the end of the label

(sgd_evtlabel = SGDSFFA1#) [string]
Label to use for SGD event screening. The hash is replaced by a respective Compton camera: CC1, CC2 or CC3
For pseudo events "PSE" is appended to the end of the label

(sxi_mkflabel = SXI#SCI) [string]
Label to use for SXI MKF GTI creation. The hash is replaced by a respective mode: CCDW1, CCD12WA or CCD34WF

(sxi_ehklabel = SXI#SCI) [string]
Label to use for SXI EHK GTI creation. The hash is replaced by a respective mode: CCDW1, CCD12WA or CCD34WF

(sxi_evtlabel = SXI#SCI) [string]
Label to use for SXI event screening. The hash is replaced by a respective mode: CCDW1, CCD12WA or CCD34WF

(sxs_mkflabel = PIXELALL3) [string]
Label to use for SXS MKF GTI creation

(sxs_ehklabel = PIXELALL3) [string]
Label to use for SXS EHK GTI creation

(sxs_evtlabel = PIXELALL3) [string]
Label to use for SXS event screening

(dattfile = datt.out) [string]
output datt file with drift corrections

(coordevt_startsys = LOWEST) [string]
Starting coordinate system

(stopsys = HIGHEST) [string]
Final coordinate system

(annaber = no) [string]
Apply annual aberration correction (yes, [no], INVERT)

(followsun = no) [boolean]
Recalculate the Sun position for each event (yes, [no])

(orbaber = no) [string]
Apply sat orbital aberration correction (yes, [no], INVERT)

(attinterp = LINEAR) [string]
Sky attitude interpolation method (LINEAR, CONSTANT)

(dattinterp = LINEAR) [string]
Delta attitude interpolation method (LINEAR, CONSTANT)

(attdt = 32.) [real]
Allowed margin for time extrapolation in attfile [s]

(dattdt = 0.5) [real]
Allowed margin for time extrapolation in dattfile [s]

(chkattgap = no) [boolean]
Limit attitude interpolation if gaps present (yes, [no])

(chkdattgap = yes) [boolean]
Limit delta attitude interpolation if gaps present ([yes], no)

(attext = ATTITUDE) [string]
Attitude extension

(attcol = QPARAM) [string]
Attitude column

(attform = QUAT) [string]
Attitude format ([QUAT], EULER)

(orbext = ORBIT) [string]
Orbit extension

(orbcol = VELOCITY) [string]
Orbital velocity column

(orbform = VECTOR) [string]
Orbital velocity format ([VECTOR], COMPONENTS, KEPLERIAN)

(coordevt_randomize = TELDEF) [string]
Randomize coordinates when rebinning ([TELDEF], yes, no)

(randsys = TELDEF) [string]
Starting system for randomization (or TELDEF)

(randscalesys = TELDEF) [string]
System to determine randomization amount (or TELDEF)

(infileext = EVENTS) [string]
Event extension

(inclfloatcol = no) [boolean]
Write non-rounded coordinate columns (yes, [no])

(inclfloatskycol = no) [boolean]
Write non-rounded sky coordinate columns (yes, [no])

(floatcolsuffix = _FLOAT) [string]
Suffix for non-rounded coordinate columns

(startwithfloat = no) [boolean]
Start with non-rounded startsys coordinates (yes, [no])

(blankcol = yes) [boolean]
Assign null values to columns not calculated ([yes], no)

(btnull = 255) [integer]
TNULL for byte (B) columns

(itnull = -999) [integer]
TNULL for short (I) columns

(jtnull = -999) [integer]
TNULL for long (J) columns

(ktnull = -999) [integer]
TNULL for long (K) columns

(sbtnull = 255) [integer]
TNULL for signed byte columns

(uitnull = -999) [integer]
TNULL for unsigned short columns

(ujtnull = -999) [integer]
TNULL for unsigned long columns

(outnsubcol = no) [boolean]
Output the PHA_NSUB column (yes/no)

(datamode = NONE) [string]
Substitute DATAMODE in place of event value (or NONE)

(outcalfile = NONE) [filename]
Output reconstruction tracing file (or NONE)

(startstep = 1) [integer]
Starting step of calculation (1-5)

(stopstep = 5) [integer]
Ending step of calculation (1-5)

(inext = EVENTS) [string]
Input extension

(outext = CAMS_OFFSETS) [string]
Output extension

(flipsign = no) [boolean]
Flip sign of output offsets and angles (yes/[no])

(prefiltfile1 = NONE) [string]
Prefiltered file for CAMS1

(prefiltfile2 = NONE) [string]
Prefiltered file for CAMS2

(filtoffset = NONE) [string]
Filtered offset file

(prefiltexpr = DSP_UP==1 && IS_SAMPLING==1) [string]
Expression to filter input files

(filtexpr = BAD_UNITS==0) [string]
Expression to filter offset file

(gtiexpr0 = BAD_UNITS==0) [string]
Expression to create GTI for both CAMS

(gtiexpr1 = BAD_UNITS==2) [string]
Expression to create GTI for CAMS1

(gtiexpr2 = BAD_UNITS==1) [string]
Expression to create GTI for CAMS2

(startsys = RAW) [string]
Starting coordinate system (cams2att)

(deltaxcol = DELTARAWX) [string]
Column with change in detector X coordinate

(deltaycol = DELTARAWY) [string]
Column with change in detector Y coordinate

(sincol = SINANGLE) [string]
Column with sine of rotation angle

(coscol = COSANGLE) [string]
Column with cosine of rotation angle

(outtracefile = NONE) [filename]
Output reconstruction tracing file (or NONE)

(numsignal = 48) [integer]
Maximum number of signals to analyze

(d10 = 3.2) [real]
Shortest distance between two adjacent pixels [mm]

(d1a1a = 5.0) [real]
Diag distance between two adjacent pixels in layer [mm]

(d1a1b = 5.0) [real]
Distance between two layers (CdTe-CdTe fluor) [mm]

(d1a2 = 14.0) [real]
Distance for combining Si-CdTe fluorescence [mm]

(d1a3 = 5.0) [real]
Distance for combining Si-Si electron scattering [mm]

(a = 3.0) [real]
Acceptance tolerance for F test in Step 2

(b = 3.0) [real]
Acceptance tolerance for G test in Step 2

(probaccept2 = 0.1) [real]
Probability threshold for M=2 acceptance in Step 3

(probaccept3 = 0.1) [real]
Probability threshold for M=3 acceptance in Step 3

(probaccept4 = 0.1) [real]
Probability threshold for M=4 acceptance in Step 3

(distz = 1000000.0) [real]
Very large distance of target object in Step 4 [mm]

(paraoffset0 = 1.6) [real]
Parameter used in calculating G[k,0]

(paraoffset1 = 1.0) [real]
Parameter used in calculating G[k,1]

(paraoffset2 = 1.0) [real]
Parameter used in calculating G[k,2]

(weight0 = 1.0) [real]
Parameter used in calculating G[k,0] for FOM

(weight1 = 0.0) [real]
Parameter used in calculating G[k,1] for FOM

(weight2 = 0.0) [real]
Parameter used in calculating G[k,2] for FOM

(weight3 = 0.0) [real]
Parameter used in calculating Prob[k] for FOM

(delgmethod = ANALYTIC) [string]
Method used to calculate Delta cos(theta)

(skipreco = no) [boolean]
Skip reconstruction of READALL/CALMODE events

(rejectbgo = no) [boolean]
Reject BGO events (yes/[no])

(occurrenceid = -1) [integer]
Occurrence to process (if >0)

(calc_hotpix = no) [boolean]
Run coordevt on hot pixel file (yes/[no])

(calc_modegti = yes) [boolean]
Calculate SXI data mode GTI ([yes]/no)

(colbound = -32768) [string]
TNULL, TLMIN, TLMAX for PHAS

(chipcol = CCD_ID) [string]
Chip column (or NONE)

(xcol = ACTX) [string]
X coordinate column

(ycol = ACTY) [string]
Y coordinate column

(chancol = PI) [string]
Pulse height column (or NONE)

(gradecol = GRADE) [string]
Event grade column (or NONE)

(grade = 0) [string]
Event grade for clean (or ALL)

(n_division = 1) [integer]
Divide total observation time into the given number

(cleanimg = no) [boolean]
Output cleaned image for debugging (yes, no)

(cellsize = 7) [integer]
Poisson clean cell size (odd integer > 1)

(impfac = 320) [real]
Factor for gamma function

(logprob1 = -5.6) [real]
Log Poisson probability threshold

(logprob2 = -5.6) [real]
Log Poisson probability threshold for second step

(iterate = yes) [boolean]
Iterate the second step Poisson clean (yes, no)

(flagedge = no) [boolean]
Zero chip edge pixels (yes, no)

(bthresh = 3) [integer]
Zero background threshold

(duration = no) [boolean]
Perform detailed search for flickering duration (yes, no)

(sigma = 3.0) [real]
Significance level for flickering duration

(firstchip = TLMIN) [string]
Min value for chip number

(lastchip = TLMAX) [string]
Max value for chip number

(xmin = TLMIN) [string]
Min value for X coordinate

(xmax = TLMAX) [string]
Max value for X coordinate

(ymin = TLMIN) [string]
Min value for Y coordinate

(ymax = TLMAX) [string]
Max value for Y coordinate

(chanmin = TLMIN) [string]
Min pulse-height value for clean (inclusive)

(chanmax = TLMAX) [string]
Max pulse-height value for clean (inclusive)

(outbadpix = no) [boolean]
Output bad pixel file (yes/[no]). This parameter is not a boolean in sxiflagpix but rather a filename. For ahpipeline and sxipipeline this is boolean to account for multiple files

(outbadimg = yes) [boolean]
Output bad pixel image ([yes]/no). This parameter is not a boolean in sxiflagpix but rather a filename. For ahpipeline and sxipipeline this is boolean to account for multiple files

(npixnbr = 1) [integer]
Pixel distance defining a neighbor

(nboundnbr = 1) [integer]
Pixel distance defining neighbor from CCD/window/segment boundary

(citrailnbr = 2) [integer]
Pixel distance trailing CI row

(ciprenbr = 1) [integer]
Pixel distance preceding CI row

(echoflag = yes) [integer]
Flag CR echo pixels ([yes]/no)

(echomap = yes) [integer]
Output CR echo pixel fraction map (yes/[no])

(echonbr = 2) [integer]
Distance in pixels from a cosmic ray echo pixel to flag a neighbor pixel.

(echomin = 6) [integer]
Minimum number of events for the cosmic ray echo fraction calculation.

(echospth = 15) [integer]
Split threshold for cosmic ray echo fraction calculation.

(echofrac = 0.7) [float]
Minimum fraction of hits defining a cosmic ray echo pixel. For any pixel contained in at least 'echomin' events, if at least 'echofrac' of those events have a pulse height above 'echospth', then the pixel is considered a cosmic ray echo pixel.

(bad_status = 3:9,11,12,16:19,25:28,30,37) [string]
Bad status list, colons can used to specify a range (e.g. 1:3,5 = 1,2,3,5)

(copyphas = yes) [boolean]
Copy original PHAS before processing ([yes]/no)

(resetflags = yes) [boolean]
Reset all sxiflagpix STATUS flags ([yes]/no)

(hkext = HK_SXI_USR_USER_HK1) [string]
HK extension with video temperatures

(hkcolstem = SXI_USR_HKTBL_) [string]
Column name stem for video temperatures

(hkvideoid = A,B,B,B) [string]
Video card ID for gain correction of CCD1-4

(startcol = PHAS) [string]
Starting point of correction

(evnoddcor = yes) [boolean]
Enable even-odd correction [yes/no]

(chtrailcor = yes) [boolean]
Enable charge trail correction [yes/no]

(cticor = yes) [boolean]
Enable CTI correction [yes/no]

(gaincor = yes) [boolean]
Enable gain correction [yes/no]

(ctigrade = no) [boolean]
Use grade information in CTI correction [yes/no]

(copygrade = no) [boolean]
Copy existing GRADE and PHA columns [yes/no]

(phcut = CALDB) [string]
Pulse-height cut for CTI correction, or CALDB

(badpixopt = 2) [integer]
Options for events with bad pixels: ignore bad pixels (1), null bad pixels (2), null whole event (3)

(spthiter = yes) [boolean]
Enable split threshold iteration [yes/no]

(spthcaldb = yes) [boolean]
Use split thresholds from spthfile [yes/no]

(spthoffset = 15.) [real]
Split threshold offset value (if spthcaldb = no)

(spthslope = 0.) [real]
Split threshold slope value (if spthcaldb = no)

(evtthre = DEFAULT) [string]
Event threshold (or DEFAULT)

(negthre = -5000) [integer]
Minimum PHAS value for normal event

(deltatime = 8) [integer]
Max allowed time gap in HK temp search [s]

(debugcol = no) [boolean]
Write out the debug columns [yes/no]

(sxs_resetflags = yes) [boolean]
Reset all sxsflagpix STATUS flags ([yes]/no)

(adrgti = REFDATA) [string]
Input ADR GTI file (or [REFDATA])

(acphaoffset = 0.0) [float]
Average offset added to PHA values before applying the gain. A random offset is added to each PHA between -0.5+acphaoffset and +0.5+acphaoffset. So, when acphaoffset=0.5, the random offset is between 0 and 1.

(pxphaoffset = 0.0) [float]
Average offset added to PHA values before applying the gain. A random offset is added to each PHA between -0.5+acphaoffset and +0.5+acphaoffset. So, when acphaoffset=0.5, the random offset is between 0 and 1.

(timecol = TIME) [string]
Time column

(stimecol = S_TIME) [string]
Name of S_TIME column

(tioncol = FWE_TI_LED#_ON) [string]
Input TI columns with LED on (#=1-4)

(tioffcol = FWE_TI_LED#_OFF) [string]
Input TI columns with LED off (#=1-4)

(plslencol = FWE_LED#_PLS_LEN) [string]
Input pulse length columns (#=1-4)

(plsspccol = FWE_LED#_PLS_SPC) [string]
Input pulse spacing columns (#=1-4)

(timeoncol = TIME_LED#_ON) [string]
Output LED-on time columns (#=1-4)

(timeoffcol = TIME_LED#_OFF) [string]
Output LED-off time columns (#=1-4)

(calctime = yes) [boolean]
Perform time assignment ([yes]/no)

(calcgti = yes) [boolean]
Produce GTI files ([yes]/no)

(afterglow = no) [boolean]
Add afterglow to fine GTI STOP times (no/[yes])

(dtdecay = CALDB) [string]
Afterglow time [s] (or CALDB)

(interp = twopoint) [string]
Interpolation method (NEAREST, TWOPOINT)

(margingti = yes) [boolean]
Create GTI between TSTART/TSTOP and first/last input GTI

(tstart = DEFAULT) [string]
Value to use for TSTART in seconds (or take from infile)

(tstop = DEFAULT) [string]
Value to use for TSTOP in seconds(or take from infile)

(dt = 0.) [real]
Time separation between input and output GTI (seconds)

(antpsp = A) [string]
Antico PSP to use for coincidence (A=PSPA B=PSPB)

(antshift = CALDB) [string]
Time shift [s] to apply to antico events (or CALDB)

(calcant = yes) [boolean]
Flag antico events ([yes]/no)

(antdtpre = CALDB) [string]
Delta time [s] preceding an antico event (or CALDB)

(antdtfol = CALDB) [string]
Delta time [s] following an antico event (or CALDB)

(antswitch = 1) [integer]
If =1 use antdtfol, =0 read delta-time from file

(antphathr = 71) [integer]
PHA threshold for antico events

(antdurthr = 2) [integer]
DURATION threshold for antico events

(calcctrec = yes) [boolean]
Flag recoil cross-talk ([yes]/no)

(ctrecdt = CALDB) [string]
Delta time [s] for flagging recoil cross-talk (or CALDB)

(calcprox = yes) [boolean]
Flag electrical cross talk ([yes]/no)

(proxdt = CALDB) [string]
Delta time [s] to define simultaneous events (or CALDB)

(calcctel = yes) [boolean]
Flag electrical cross talk ([yes]/no)

(cteldt = CALDB) [string]
Delta time [s] for flagging electrical cross-talk (or CALDB)

(ctelnear = 1) [integer]
Number of pixels for flagging electrical cross-talk

(calcctel2 = yes) [boolean]
Flag electrical cross talk 2 ([yes]/no)

(cteldt2 = CALDB) [string]
Delta time [s] for flagging electrical cross-talk 2 (or CALDB)

(ctelnear2 = 1) [integer]
Number of pixels for flagging electrical cross-talk 2

(pxpithr = 600) [integer]
Events with PI values below this threshold are excluded from flagging checks given by the usepxpithr parameter.

(usepxpithr = ALL) [string]
A comma-delimited list specifying which flagging types should use the pxpithr parameter for excluding events. Allowed values in the list are ALL, NONE, PROX (proximity), CTEL (electrical cross talk), CTEL2 (2nd electrical cross talk), and CTREC (recoil cross talk). Events that do not belong to the types specified in the list are excluded from flagging regardless of their PI value.

(calcmxs = yes) [boolean]
Flag MXS pixels ([yes]/no)

(calc_gtilost = no) [boolean]
Calculate SXS lost off GTI (yes/[no])

(screenlost = no) [boolean]
Screen lost events (yes/[no])

(mxsdt = CALDB) [string]
Delta time [s] to extend MXS stop time (or CALDB)

(kalow = 5860.) [real]
Lower energy limit of Mn K-alpha for recoil PHA test [eV]

(kahigh = 5930.) [real]
Upper energy limit of Mn K-alpha for recoil PHA test [eV]

(kbeta = 6450.) [real]
Energy of Mn K-beta for recoil PHA test [eV]

(dtflag = no) [boolean]
Add delta-time columns for cross-talk and antico (yes/[no])

(dtprimary = CALDB) [string]
Time interval [ms] for primary (or CALDB)

(dtlowmid = CALDB) [string]
Upper time range [ms] for low secondary (or CALDB)

(dtmidhigh = CALDB) [string]
Upper time range [ms] for mid secondary (or CALDB)

(tol = 2.) [real]
Tolerance of time intervals [ns]

(regrade = no) [boolean]
Recalculate grade assignment (yes/[no])

(gaincoeff = H) [string]
Type of gain coefficients to use ([H]/M/L)

(linetocorrect = Mnka) [string]
Line to fit (HDU name in linefitfile)

(numevent = 250) [integer]
Maximum number of events in a single spectrum

(minevent = 150) [integer]
Minimum number of events in a single spectrum

(grpoverlap = 0.) [real]
Percentage of overlap between adjacent groups

(startenergy = -1.) [real]
Start energy [eV] of bin mesh (-1 = automatic)

(stopenergy = -1.) [real]
Stop energy [eV] of bin mesh (-1 = automatic)

(extraspread = 100.) [real]
Extend bin mesh energy range [eV]

(broadening = 1.0) [real]
FWHM Gaussian broadening of calibration line profile [eV]

(gridprofile = no) [boolean]
Calculate only the grid profile (yes/[no])

(fitwidth = yes) [boolean]
Fit spectrum width (yes/[no])

(background = CONST) [string]
Fitted background type (NONE, CONST, SLOPE)

(spangti = no) [boolean]
Ignore GTI boundaries when binning spectra (yes/[no])

(usemp = no) [boolean]
Include Mp events when fitting (yes/[no])

(calcerr = no) [boolean]
Compute uncertainties on shift and width (yes/[no])

(writeerrfunc = no) [boolean]
Output uncertainty functions (yes/[no])

(avgwinrad = 30) [real]
Radius of interval [binwidth] used to update average

(minwidth0 = 1.0) [real]
Smallest allowed initial value in width fitting [binwidth]

(maxitcycle = 5) [integer]
Maximum number of fitting iterations

(r2tol = .001) [real]
Convergence criterion for R^2

(searchstepshift = 2.) [real]
Step size when fitting shift [binwidth]

(maxdshift = 5.) [real]
Largest allowed deviation from initial guess of shift [binwidth]

(bisectolshift = .001) [real]
Tolerance of shift to stop bisection method [binwidth]

(searchstepwidth = 5.) [real]
Step size when fitting width [binwidth]

(maxdwidth = 10.) [real]
Largest allowed deviation from initial guess of width [binwidth]

(bisectolwidth = .001) [real]
Tolerance of width to stop bisection method [binwidth]

(minwidth = .5) [real]
Smallest width to allow in width fitting [binwidth]

(nerrshift = 100) [integer]
Number of shift values in uncertainty calculations

(nerrwidth = 100) [integer]
Number of width values in uncertainty calculations

(shifterrfac = 3.0) [real]
Factor for determining domain of shift uncertainty arrays

(widtherrfac = 4.0) [real]
Factor for determining domain of width uncertainty arrays

(calcupi = yes) [boolean]
Calculate UPI column ([yes]/no)

(sxs_pulsefile = CALDB) [filename]
Input file with pulse amplitudes (or CALDB)

(phaout = PHA2) [filename]
Name of output PHA column

(sxs_scalefile = CALDB) [filename]
Input EPI scale file for cal-pix (or CALDB)

(secphacol = PHA) [string]
Input PHA column to use for secondary correction

(scaleepi = no) [boolean]
Scale EPI values using scalefile (yes/[no])

(scalegrade = 0) [string]
List of grades to apply scale factors

(calcpi = yes) [boolean]
Calculate PI column ([yes]/no)

(addepicol = EPI2) [string]
Output energy column with secondary correction

(method = FIT) [string]
Correction method (FIT or AVERAGE)

(extended = no) [boolean]
Use extended energy range (yes/[no])

(binwidth = 0.5) [real]
PI bin width for extended energy range [eV]

(offset = 0.5) [real]
Offset for first PI for extended energy range [eV]

(tlmax = 32767) [integer]
Maximum PI channel for extended energy range

(writetemp = no) [boolean]
Output temperature used for each event (yes/[no])

(dgfile = REFDATA) [file]
Input gain coefficients file

(offsetfile = REFDATA) [file]
calibration offset file

(outrange = NULL) [file]
How events are handled outside time range

(itypecol = ITYPE) [string]
ITYPE column

(ckctrec = no) [boolean]
Exclude events with recoil cross-talk (yes/[no])

(ckctel = no) [boolean]
Exclude events with electrical cross-talk (yes/[no])

(ckant = no) [boolean]
Exclude events with antico coincidence (yes/[no])

(ckrisetime = yes) [boolean]
Do not use events with RISE_TIME > 127 ([yes]/no)

(tempidx = 2) [integer]
Input temperature index for selecting gain

(ntemp = 3) [integer]
Number of temperatures from gain file to use in interpolation

(gapdt = -1.) [real]
Time [s] between events to define a gap (or <0)

(extrap = no) [boolean]
Allow extrapolation when determining drift temperature (yes/[no])

(randomize = yes) [boolean]
Allow randomization ([yes]/no)

(seed = 0) [integer]
Random number generator seed (0=use system time)

(startdate = ) [string]
Start date/time of ahpipeline (output)

(numerrs = 0) [string]
Number of errors from ahpipeline (output)

(cleanup = yes) [boolean]
Delete temporary files ([yes]/no)

(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 ([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

  1. The following command recalibrates (stage 1) and re-screen (stage 2) all HXI, SGD, SXS and SXI data for sequence 100039010 that currently resides in the directory /data/100039010/, and the output is stored in a directory called /data/100039010_reproc/:

    ahpipeline indir=/data/100039010 outdir=/data/100039010_reproc entry_stage=1 exit_stage=2 steminputs=ah100039010 instrument=ALL

  2. The following command re-screens (stage 2 only) HXI1 data for the same data set as in the previous example:

    ahpipeline indir=/data/100039010 outdir=/data/100039010_reproc entry_stage=2 exit_stage=2 steminputs=ah100039010 instrument=HXI1

NOTES

None, but see help for individual parameters above.

SEE ALSO

ahcalctime hxipipeline sgdpipeline sxipipeline sxspipeline ahfilter ahgtigen ahscreen

LAST MODIFIED

February 2016