CSC Source Region Per-Observation Detections Data Products
The source-region, pre-observation detections detections data products are extracted from individual observations filtered by a rectangular region of interest around the position of the detection. These files are for the large part generated in the Source Properties pipeline run for each master source produced by the Master Match pipeline.
In addition to the tabulated properties for each source in the Master Sources Table, Stacked Observation Detections Table, and Per-Observation Detections Table, a number of file-based Level 3 data products are produced for each source and observation individually, in formats suitable for analysis in CIAO. These include such things as:
- Source region, background, and PSF images
- Source region photon event lists
- Ancillary Response Files (ARFs)
- Source and background light curves
- Pulse invariant (PI) spectra and Redistribution Matrix Files (RMFs) [for ACIS observations]
- Apertrure photometry with marginalized posterior probability distribution and MLE draws
Source Region, Per-Observation Detection Data Products
A set of source-based data products is created for each detected source region in each observation that undergoes catalog processing. The source region data products are identified by the region identifier, observation identification (ObsId) and observation interval identification (ObI), and by cycle for ACIS alternating exposure (interleaved) mode observations.
| Data product | Pipeline | Filename |
|---|---|---|
| Per-ObsId source region event list | Source Properties | 〈i〉〈s〉〈obs〉_〈obi〉N〈v〉[_〈c〉]_〈r〉_regevt3.fits |
| Per-ObsId source region image | Source Properties | 〈i〉〈s〉〈obs〉_〈obi〉N〈v〉[_〈c〉]_〈r〉〈b〉_regimg3.fits, 〈i〉〈s〉〈obs〉_〈obi〉N〈v〉[_〈c〉]_〈r〉〈b〉_regimg3.jpg |
| Per-ObsId point spread function image | MLE | 〈i〉〈s〉〈obs〉_〈obi〉N〈v〉[_〈c〉]_〈r〉〈b〉_psf3.fits, 〈i〉〈s〉〈obs〉_〈obi〉N〈v〉[_〈c〉]_〈r〉〈b〉_psf3.jpg |
| Per-ObsId source region exposure map | Source Properties | 〈i〉〈s〉〈obs〉_〈obi〉N〈v〉[_〈c〉]_〈r〉〈b〉_regexp3.fits |
| Per-ObsId source region PHA spectrum | Source Properties | 〈i〉〈s〉〈obs〉_〈obi〉N〈v〉[_〈c〉]_〈r〉_pha3.fits |
| Per-ObsId source region ancillary response file | Source Properties | 〈i〉〈s〉〈obs〉_〈obi〉N〈v〉[_〈c〉]_〈r〉_arf3.fits |
| Per-ObsId source region response matrix file | Source Properties | 〈i〉〈s〉〈obs〉_〈obi〉N〈v〉[_〈c〉]_〈r〉_rmf3.fits |
| Per-ObsId source region light curve | Source Properties | 〈i〉〈s〉〈obs〉_〈obi〉N〈v〉[_〈c〉]_〈r〉〈b〉_lc3.fits |
| Per-ObsId source region | Source Properties | 〈i〉〈s〉〈obs〉_〈obi〉N〈v〉[_〈c〉]_〈r〉_reg3.fits |
| Valid Per-ObsId MLE source fit draws | Source Properties | 〈i〉〈s〉〈obs〉_〈obi〉N〈v〉[_〈c〉]_〈r〉〈b〉_draws3.fits |
| Per-ObsId source region aperture photometry PDF | Source Properties | 〈i〉〈s〉〈obs〉_〈obi〉N〈v〉[_〈c〉]_〈r〉〈b〉_phot3.fits |
How Do I Find These Data Products?
Source-region, per-observation detections data products can be retrieved using CSCview. They can be selected from the Data products pane in the Results tab of CSCview (see areas highlighted in the figure), associated to one or more rows returned by the query, and by clicking on Search. The number of data products returned by CSCview as a function of the identifiers available in the rows select is determined as described in "CSCview and CSC 2.0 Help".
![[CSCView query results]](imgs/cscview_persrc-obs_results.png)
Filename Example
〈i〉 refers to detector used, formatted "acis" or "hrc", 〈s〉 is the source data "f" or "s", for "flight" data or simulated data, respectively.
For example, the stacked source region image file, acisfJ0025402m771522_001N020_r0010b_regimg3.fits.gz, the 〈stkpos〉 is "J0025402m771522", which is the epoch J2000 celestial coordinates of the stack's central position: RA=0h 25m 40.2s and Dec=-77° 15′ 22″. The "p" or "m" in the stack position string refers to "+" or "-" source declination. The 〈stkver〉 is a three digit stack version, 1 in this instance.
For the source region image file name, acisf11978_001N020_r0348b_regimg3.fits.gz the 〈obs〉 refers to ObsID 11978 and 〈obi〉 is the ObsID's observation interval, 1 in this case. The ObIs are numbered in three digits and the numbering within an ObsID does not have to be contiguous and might not start at zero (000).
〈v〉 is a three digit data product revision number preceded by "N", N020 means file revision version 20. 〈r〉 is the region ID, preceded by an "r" and appended by the 〈b〉 for the science energy band: "b", "h", "m", "s", "u", or "w". In this instance, in the file names, the b_ refers to the "broad" energy band. The file name is ended with the data product type and appended with the gzipped FITS file extension.