2.2 ACS File Structure
The ACS calibration pipeline assembles data received from HST into datasets, applies standard calibrations (so that calibrated image header keyword values can be entered in the Archive database), and stores uncalibrated datasets in the HST Data Archive. When a user requests data, it is fetched from the MAST static archive unless newer versions of the pipeline and/or calibration reference files are present. In the latter case, the requested data will be moved to the top of the reprocessing queue.
Data from the Archive arrives as multi-extension FITS files that have three main categories, as listed below (see Figure 2.1 for a graphical representation of this information). Single quotes around the extension names are required in Python usage.
- Global header extension ('PRIMARY'): this is always in extension , and contains a selection of header keyword values applicable to all information in the FITS file.
- Science image ('SCI'), error array ('ERR'), and data quality array ('DQ') extensions:
- HRC and SBC are single-detector channels. For these channels, the science image is in extension  or ['SCI',1], error array in extension  or ['ERR',1], and data quality array in extension  or ['DQ',1].
- WFC data comes from two chips, each with its own science, error, and data quality arrays. For WFC2, the science image is in extension  or ['SCI',1], error array in extension  or ['ERR',1], and data quality array in extension  or ['DQ',1]. For WFC1, the science image is in extension  or ['SCI',2], error array in extension  or ['ERR',2], and data quality array in extension  or ['DQ',2]. See Figure 2.2 for a visual representation of the WFC chips projected onto the V2,V3 axis. Figure 2.2 shows the WFC apertures plotted with respect to the V2,V3 reference frame, and oriented such that the x-axis runs approximately towards the right and the y-axis runs approximately straight up. In pipeline data products, WFC2 is displayed below WFC1 (along the y-axis) and is therefore designated as extension 1.
- AstroDrizzle extensions:
- Drizzled data from the pipeline have the suffix
drz.fits, and additionally
drc.fitsfor WFC CTE-corrected data. These products are delivered as multi-extension FITS files with three image data extensions: science image ['SCI'], weight image ['WHT'], and context image ['CTX']. However, AstroDrizzle also adds new FITS extensions to the
drz.fits/drc.fitsfiles, as summarized below. For more information on drizzled data, please refer to the Drizzlepac Handbook.
flt.fits/flc.fitsimages: during OTFR processing, AstroDrizzle updates the WCS of these images with distortion corrections. Linear distortion corrections (scale, rotation, and time-dependent skew) are incorporated into the CD-Matrix. Coefficients for higher order polynomial functions that describe the distortion corrections are stored as SIP1 header keyword values. Some distortion corrections, however, cannot be expressed as equations and have to be stored in array form as FITS extensions.
- The ['D2IMARR'] fits extensions are tabular data required only for WFC, with one extension per chip axis. They are filter-independent corrections for the CCD pixel-grid irregularities resulting from the manufacturing process and contain both X and Y corrections for each WFC CCD chip.
- The ['WCSDVARR'] fits extensions, with one extension per chip axis, hold tabular data which describe small-scale distortions due to filter-dependent non-polynomial distortion corrections which include both X and Y corrections for each WFC CCD chip. Therefore, a WFC
flt.fits/flc.fitsimage has four ['WCSDVARR'] extensions while HRC and SBC only have two ['WCSDVARR'] extensions.
- If the data were reprocessed with a new distortion correction reference file, a FITS extension called ['WCSCORR'] is added that contains a history of WCS changes.
- Several ['HEADERLET'] FITS extensions containing WCS transformations that can be applied as the primary WCS. For more detailed information please consult the Hubble Advanced Products (HAP) headerlets page.
drz.fit/drc.fitsimages: a fourth extension has been added, called ['HDRTAB'], which is a compilation of important header keywords that have unique values for each input image.
- Drizzled data from the pipeline have the suffix
The number of headerlets may vary from image to image depending on what has been done to it. Here below is the header listing of a standard *_flc.fits file and for comparison farther below, the header listing of a standard *_drc.fits file.
Similarly, one may list the header groups of a *_drc.fits image.
One can also look for a specific keyword in a specific extension, such as the GAIN value in the Group 0 header extension here.
One can also look at the full header contents for a specific extension, in this case below, the Group 0 extension.
1 Simple Image Polynomial (SIP) convention (Shupe et. al 2005). This convention has been in use for describing the geometry of Spitzer Space Telescope images, and it has become a FITS standard. Representing image distortion corrections using the SIP convention improves the handling of image combination and astrometric information.
ACS Data Handbook
- • Acknowledgments
- • Change Log
- Chapter 1: ACS Overview
- Chapter 2: ACS Data Structure
- Chapter 3: ACS Calibration Pipeline
- Chapter 4: ACS Data Processing Considerations
- Chapter 5: ACS Data Analysis