Appendix 3 - D2IMFILE Example

The D2IMFILE reference file only contains a single 1-D array that should correct the column (row) values based on the value of the ‘AXISCORR’ keyword in the SCI header.

FITS File Extensions

This simple reference file, therefore, contains only 2 extensions; namely,

Filename: /grp/hst/cdbs/jref/v971826mj_d2i.fits
No.    Name         Type      Cards   Dimensions   Format
0    PRIMARY     PrimaryHDU      35   ()           int16
1    DX          ImageHDU        18   (4096,)      float32

PRIMARY Header

The PRIMARY header only needs to contain information on what detector this file corrects, along with any available information on how this file was generated. The ACS/WFC D2IMFILE PRIMARY header only includes:

SIMPLE  =                    T / Fits standard
BITPIX  =                   16 / Bits per pixel
NAXIS   =                    0 / Number of axes
EXTEND  =                    T / File may contain extensions
ORIGIN  = 'NOAO-IRAF FITS Image Kernel July 2003' / FITS file originator
DATE    = '2010-02-01T20:19:11' / Date FITS file was generated
IRAF-TLM= '2011-09-02T13:04:07' / Time of last modification
NEXTEND =                    1 / number of extensions in file
FILENAME= 'v971826mj_d2i.fits' / name of file
FILETYPE= 'WFC D2I FILE'          / type of data found in data file
OBSTYPE = 'IMAGING '              / type of observation
TELESCOP= 'HST'                / telescope used to acquire data
INSTRUME= 'ACS   '             / identifier for instrument used to acquire data
DETECTOR= 'WFC     '
USEAFTER= 'Mar 01 2002 00:00:00'
COMMENT = 'D2I calibration file created by Warren Hack 29 APR 2010'
DESCRIP = 'Column-width correction file for WFC images------------------------'
PEDIGREE= 'INFLIGHT 11/11/2002 11/11/2002'
HISTORY
HISTORY   Fixed column (or row) width correction file. This is applied
HISTORY   as a correction to the input pixel position and the output of
HISTORY   this correction is to be used as input to the polynomial and
HISTORY   non-polynomial distortion corrections.
HISTORY
HISTORY   For ACS WFC data, the correction is stored as an image extension
HISTORY   (D2IMARR) with one row. Each element in the row specifies the
HISTORY   correction in pixels for every pixel in the column (or row) in
HISTORY   the science extension; for ACS WFC, the correction is in the X
HISTORY   direction.
HISTORY
HISTORY   For a more in-depth explanation of this file, please see the
HISTORY   draft writeup at:
HISTORY http://stsdas.stsci.edu/stsci_python_epydoc/stwcs/fits_conventions.html
HISTORY wfc_ref68col_d2i.fits renamed to v961506lj_d2i.fits on Sep 6 2011
HISTORY v961506lj_d2i.fits renamed to v971826mj_d2i.fits on Sep 7 2011

In this case, most of the keywords not required by FITS describe how this file was computed while also describing how it should be applied.

Data Extension Header

The header keywords for the actual DX array simply needs to provide the information necessary to apply the values to the data; namely,

XTENSION= 'IMAGE   '           / Image extension
BITPIX  =                  -32 / Bits per pixel
NAXIS   =                    1 / Number of axes
NAXIS1  =                 4096 / Axis length
PCOUNT  =                    0 / No 'random' parameters
GCOUNT  =                    1 / Only one group
EXTNAME = 'DX      '           / Extension name
EXTVER  =                   11 / Extension version
ORIGIN  = 'NOAO-IRAF FITS Image Kernel July 2003' / FITS file originator
INHERIT =                    F / Inherits global header
DATE    = '2009-03-18T19:28:09' / Date FITS file was generated
IRAF-TLM= '16:05:02 (18/03/2009)' / Time of last modification
CRPIX1  =                    0 / Distortion array reference pixel
CDELT1  =                    0 / Grid step size in first coordinate
CRVAL1  =                    0 / Image array pixel coordinate
CRPIX2  =                    0 / Distortion array reference pixel
CDELT2  =                    0 / Grid step size in second coordinate
CRVAL2  =                    0 / Image array pixel coordinate

The fact that these values get applied without interpolation to each pixel in a row, in this case, means that no translation terms are needed in the header, making for a very simple header and very simple application to the data.

[DistortionPaper]

Calabretta M. R., Valdes F. G., Greisen E. W., and Allen S. L., 2004, “Representations of distortions in FITS world coordinate systems”,[cited 2012 Sept 18], Available from: http://www.atnf.csiro.au/people/mcalabre/WCS/dcs_20040422.pdf

[SIPConvention]

Shupe D.L., Hook R.N., 2008, “The SIP Convention for Representing Distortion in FITS Image Headers”, [cited 2012 Sept 18], Available from: http://fits.gsfc.nasa.gov/registry/sip.html