Last modified: December 2022

URL: https://cxc.cfa.harvard.edu/ciao/ahelp/readout_bkg.html
AHELP for CIAO 4.16

readout_bkg


Synopsis

Approximate the Out Of Time source contribution to the background.

Syntax

readout_bkg  infile outfile [tmpdir] [random] [check_vf_pha] [verbose]
[clobber]

Description

Since the ACIS detector does not have a shutter, some events are detected during the (typical) 0.04 seconds it takes to transfer the image to the frame-store to be read-out. These Out Of Time (OOT) events are detected with the correct CHIPX location, but are detected at random CHIPY locations. These events contribute to the observed background and can be especially important when analyzing bright, extended emission.

The 'readout_bkg' script can be used to model the OOT events contribution to the background. The algorithm is described in detail in Vikhlinin et al.. To summarize: the level 1 event file for an observation is modified by randomizing the CHIPY values. Then the standard calibrations (energy and coordinates) and filters (grade, status, GTIs) are applied. The exposure time is adjusted for the fraction of the readout time to the actual observation time by modifying the DTCOR (dead time correction) keyword. The end product is a Level 2 event file that can be used to model the OOT source contribution to the background.


Examples

Example 1

unix% download_chandra_obsid 10805
unix% readout_bkg 10805 abell2199_oot.evt
readout_bkg
           indir = 10805
         outfile = abell2199_oot.evt
          tmpdir = /tmp
    check_vf_pha = no
          random = 0
         verbose = 1
         clobber = no
            mode = ql

Working in temporary directory: /tmp/tmp.readout_bkg_v7pULX
Using event file /tmp/tmp.readout_bkg_v7pULX/secondary/acisf10805_001N002_evt1.fits
Randomizing chipy values between 2 and 1023
Modifying DTCOR keyword to account for hyperexposure: from 0.987 to 74.549
Saving modified events to /tmp/tmp.readout_bkg_v7pULX/secondary/acisf10805_001N002_randchipy_evt1.fits
Running chandra_repro
Copying output file
Cleaning up temporary files

Output background file : abell2199_oot.evt
The effective exposure is 2291.48 ks

The easiest way to get started is by downloading the current version of the data products for the observation, in this example OBS_ID=10805 (Abell 2199). The directory name is then input to readout_bkg along with the final output file name, abell2199_oot.evt.

The readout_bkg script internally runs the chandra_repro script, and therefore requires the full set of data products in the standard primary/ and secondary/ directories.

The "effective exposure" is the regular exposure time corrected for the ratio of frame time (~3.2 seconds) to the transfer time (~0.04 seconds).

Example 2

unix% readout_bkg 10805 abell2199_vfaint_oot.evt check_vf_pha=yes

Same as the example above, with the extra VFAINT mode background filter applied. Users should set check_vf_pha=yes if they have applied the VFAINT filter to the observed data


Parameters

name type ftype def min max reqd stacks
infile file input       yes no
outfile file output       yes no
tmpdir file output ${ASCDS_WORK_PATH}     no no
random integer   0 0      
check_vf_pha boolean   no     no  
verbose integer   1 0 5 no  
clobber boolean   no     no  

Detailed Parameter Descriptions

Parameter=infile (file required filetype=input stacks=no)

The name of the input directory

The readout_bkg script will look for the level 1 event file in the secondary/ sub-directory, and will uses the other files to apply the calibrations to the modified event file.

Parameter=outfile (file required filetype=output stacks=no)

The final Level 2 OOT background event file

After the chip coordinates are randomized and the events recalibrated, the standard filters are applied (GTIs, grade, status) to create the Level 2 OOT background event file.

Parameter=tmpdir (file not required filetype=output default=${ASCDS_WORK_PATH} stacks=no)

Temporary working directory

readout_bkg creates symbolic links to the input directory in a subdirectory of the tmpdir. It then runs chandra_repro from that copy of the input files; copying the final Level 2 event file to the outfile name. The default ${ASCDS_WORK_PATH}, is usually defaulted to "/tmp".

Parameter=random (integer default=0 min=0)

Random seed value

The random seed can be set to a positive interger value to produce repeatable results. A value of 0 will use the system clock to generate the random seed.

Parameter=check_vf_pha (boolean not required default=no)

Apply the additional VFAINT mode background filter?

The check_vf_pha filter can provide additional background suppression, though it can also sometimes mistakenly remove valid source events. More information on this setting can be found in the chandra_repro help file.

This filter only applies to data taken in VFAINT mode. Users should only apply this filter to the OOT background events if they also applied the filter to their observed data.

Parameter=verbose (integer not required default=1 min=0 max=5)

Controls the amount of information printed to the terminal

Parameter=clobber (boolean not required default=no)

Delete the output outfile if it already exists?


Comparison to acis_streak_map

Conceptually, this tool is somewhat similar to the acis_streak_map tool. They differ in that acis_streak_map explicitly tries to exclude sources whereas that is what readout_bkg is trying to capture. They also differ in that readout_bkg creates an output event file whereas acis_streak_map creates a background image.

Using with specextract and sherpa

The OOT event file can be used with standard CIAO tools as the background. For example it can be used with specextract as shown here:

unix% specextract infile="acisf10805_repro_evt.fits[sky=region(ds9.reg)]" \ 
   bkgfile="abell2199_oot.evt[sky=region(ds9.reg)]" \
   outroot=abell2199
unix% sherpa
-----------------------------------------------------
Welcome to Sherpa: CXC's Modeling and Fitting Package
-----------------------------------------------------

sherpa> load_data("abell2199.pi")
read ARF file abell2199.arf
read RMF file abell2199.rmf
read ARF (background) file abell2199_bkg.arf
read RMF (background) file abell2199_bkg.rmf
read background file abell2199_bkg.pi
sherpa> plot_bkg()

Changes in the scripts 4.8.2 (January 2016) release

The random parameter has been added to control the Numpy random seed.

About Contributed Software

This script is not an official part of the CIAO release but is made available as "contributed" software via the CIAO scripts page. Please see this page for installation instructions.


Bugs

There are no known bugs for this tool.

See Also

calibration
ardlib
chandra
eventdef
psf
psf
tools::acis
acis_build_badpix, acis_check_pha_range, acis_clear_status_bits, acis_detect_afterglow, acis_find_afterglow, acis_process_events, acis_streak_map, acisreadcorr, destreak
tools::aspect
asphist, dither_region
tools::background
acis_bkgrnd_lookup, hrc_bkgrnd_lookup
tools::composite
combine_grating_spectra, combine_spectra, specextract
tools::coordinates
sky2tdet
tools::core
dmextract
tools::response
acis_fef_lookup, acis_set_ardlib, addresp, dmarfadd, eff2evt, find_mono_energy, fullgarf, make_instmap_weights, mean_energy_map, mkacisrmf, mkarf, mkexpmap, mkgarf, mkgrmf, mkinstmap, mkpsfmap, mkrmf, mkwarf, psf_project_ray, rmfimg
tools::statistics
aprates