NAME

rslanticolc - Extract XRISM Resolve antico light curve(s), with options to also extract spectra and apply screening criteria before extraction

USAGE

rslanticolc infile outroot

DESCRIPTION

The rslanticolc task is a script that generates a light curve from a Resolve anticoincidence detector event file that has had the PI column calculated by the rslanticopi task. There are options to also extract spectra ('extract' parameter set to yes), and to filter the event file using an expression (specified by the 'expr' parameter) or GTI file (specified by the 'gtifile' parameter) prior to extraction. If a GTI file is specified, it will be merged with that of the input event file before filtering.

The choice of pulse shape processor (PSP) side (A or B) may be selected using the 'antpsp' parameter; otherwise, events from both sides are used.

Once the event file has been filtered, the extractor task is run to create a light curve for each range of PI values specified by the 'picut' parameter. The light curve is produced only for times in the interval determined by the two parameters 'lcstart' and 'lcstop'. If 'lcstart' or 'lcstop' are set to their default value of -1, the interval is set by the event file keyword values TSTART or TSTOP respectively. The additional light curve control parameters, 'lcthresh', 'lctzero', and 'bintime' are explained below.

The output light curve file contains RATE and ERROR columns for each range of PI values specified by 'picut', with column names based on the 'picut' string inputs. For example, if 'picut=0-12200,0-1200,1201-12200', the RATE column names in the output file are: RATE0_12200, RATE0_1200, and RATE1201_12200.

If the 'extract' parameter is set to yes, extractor also creates a spectrum spanning the full PI range for antico events (PI = 0:12200).

PARAMETERS

infile [filename]
Input event file.

outroot = rslanticolc [string]
Root of output file names (".lc" and ".pha" are appended to this root for light curves and spectra, respectively).

(extract = yes) [boolean yes|no]
A spectrum is extracted if set to yes.

(bintime = 1.0) [double]
Time bin width [s].

(antpsp = A) [string A|B|NONE]
Antico PSP to use in light curve (A = PSP-A, B = PSP-B). If 'antpsp=NONE', the data are not filtered by PSP.

(expr = FLG_BASELINE==b0&&PI>=60&&PI<=12200&&DURATION>=2&&DURATION<=19) [string NONE|expression]
Event column selection expression.

(gtifile = NONE) [filename NONE|file name]
Input GTI file.

(picut = 60-12200) [string]
PI ranges for the created light curve(s) (e.g., 0-200, 201-1000).

(lcstart = -1) [double]
Light curve start time expressed as MET (if 'lcstart=-1', use 'infile' TSTART keyword value).

(lcstop = -1) [double]
Light curve stop time expressed as MET (if 'lcstop=-1', use 'infile' TSTOP keyword value).

(lcthresh = 1) [double]
Light curve exposure threshold (only bins that are exposed for duration lcthresh*[bin width] are included).

(lctzero = no) [boolean yes|no]
Set the TIMEZERO keyword equal to the value of the first light curve bin if set to yes.

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

(clobber = no) [boolean yes|no]
Overwrites the existing output file if set to yes.

(chatter = 2) [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. Extract a 20-second time-bin antico light curve (rslanticolc.lc) in three energy ranges, and a spectrum (rslanticolc.pha), using the PSP-A events after filtering by a specified GTI file and extension, and the default expression.
  2.   rslanticolc infile=xa100050020rsl_a0ac_uf.evt outroot=rslanticolc bintime=20 antpsp=A \
         gtifile=xa100050020rsl_el.gti[4] picut="0-12200,0-1200,1201-12200"
    
  3. Extract a single 1-second time-bin antico light curve using PSP-A events, over the restricted time range specified by 'lcstart' and 'lcstop'. The default (full-band) energy range (PI=60-12200) is used.
  4.   rslanticolc infile=xa100050020rsl_a0ac_uf.evt outroot=rslanticolc bintime=1 antpsp=A \
         lcstart=70203712 lcstop=70205402 expr=NONE
    

SEE ALSO

rslanticopi, extractor

LAST MODIFIED

November 1, 2023