<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <html xmlns="http://www.w3.org/1999/xhtml"> <head> <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> <title>Appendix 2 - NPOLFILE Example — SSB TSR 2012-01 documentation</title> <link rel="stylesheet" href="_static/stsci_sphinx.css" type="text/css" /> <link rel="stylesheet" href="_static/pygments.css" type="text/css" /> <script type="text/javascript"> var DOCUMENTATION_OPTIONS = { URL_ROOT: '', VERSION: 'TSR 2012-01', COLLAPSE_INDEX: false, FILE_SUFFIX: '.html', HAS_SOURCE: true }; </script> <script type="text/javascript" src="_static/jquery.js"></script> <script type="text/javascript" src="_static/underscore.js"></script> <script type="text/javascript" src="_static/doctools.js"></script> <link rel="top" title="SSB TSR 2012-01 documentation" href="index.html" /> <link rel="next" title="Appendix 3 - D2IMFILE Example" href="appendix3.html" /> <link rel="prev" title="Appendix 1 - Sample ACS/WFC Image" href="appendix1.html" /> </head> <body> <div class="related"> <h3>Navigation</h3> <ul> <li class="right" style="margin-right: 10px"> <a href="genindex.html" title="General Index" accesskey="I">index</a></li> <li class="right" > <a href="appendix3.html" title="Appendix 3 - D2IMFILE Example" accesskey="N">next</a> |</li> <li class="right" > <a href="appendix1.html" title="Appendix 1 - Sample ACS/WFC Image" accesskey="P">previous</a> |</li> <li><a href="index.html">SSB TSR 2012-01 documentation</a> »</li> </ul> </div> <div class="sphinxsidebar"> <div class="sphinxsidebarwrapper"> <p class="logo"><a href="index.html"> <img class="logo" src="_static/stsci_logo.png" alt="Logo"/> </a></p> <h3><a href="index.html">Table Of Contents</a></h3> <ul> <li><a class="reference internal" href="#">Appendix 2 - NPOLFILE Example</a><ul> <li><a class="reference internal" href="#fits-file-extensions">FITS File Extensions</a></li> <li><a class="reference internal" href="#primary-header">Primary Header</a></li> <li><a class="reference internal" href="#data-extension-header">Data Extension Header</a></li> </ul> </li> </ul> <h4>Previous topic</h4> <p class="topless"><a href="appendix1.html" title="previous chapter">Appendix 1 - Sample ACS/WFC Image</a></p> <h4>Next topic</h4> <p class="topless"><a href="appendix3.html" title="next chapter">Appendix 3 - D2IMFILE Example</a></p> <h3>This Page</h3> <ul class="this-page-menu"> <li><a href="_sources/appendix2.txt" rel="nofollow">Show Source</a></li> </ul> <div id="searchbox" style="display: none"> <h3>Quick search</h3> <form class="search" action="search.html" method="get"> <input type="text" name="q" /> <input type="submit" value="Go" /> <input type="hidden" name="check_keywords" value="yes" /> <input type="hidden" name="area" value="default" /> </form> <p class="searchtip" style="font-size: 90%"> Enter search terms or a module, class or function name. </p> </div> <script type="text/javascript">$('#searchbox').show(0);</script> </div> </div> <div class="document"> <div class="documentwrapper"> <div class="bodywrapper"> <div class="body"> <div class="section" id="appendix-2-npolfile-example"> <span id="appendix2"></span><h1>Appendix 2 - NPOLFILE Example<a class="headerlink" href="#appendix-2-npolfile-example" title="Permalink to this headline">¶</a></h1> <p>The NPOLFILE reference file format includes a PRIMARY header describing what kind of image should be corrected by this file, along with extensions containing the corrections for each chip.</p> <div class="section" id="fits-file-extensions"> <h2>FITS File Extensions<a class="headerlink" href="#fits-file-extensions" title="Permalink to this headline">¶</a></h2> <p>A sample NPOLFILE applicable to ACS/WFC F475W images has the FITS extensions:</p> <div class="highlight-python"><pre>Filename: /grp/hst/cdbs/jref/v971826aj_npl.fits No. Name Type Cards Dimensions Format 0 PRIMARY PrimaryHDU 35 () int16 1 DX ImageHDU 180 (65, 33) float32 2 DY ImageHDU 215 (65, 33) float32 3 DX ImageHDU 215 (65, 33) float32 4 DY ImageHDU 215 (65, 33) float32</pre> </div> <p>The extensions with the name ‘DX’ provide the corrections in X for each of the ACS/WFC’s 2 chips, while the ‘DY’ extensions provide the corrections in Y for each chip.</p> </div> <div class="section" id="primary-header"> <h2>Primary Header<a class="headerlink" href="#primary-header" title="Permalink to this headline">¶</a></h2> <p>The PRIMARY header of this file only includes the minimum information necessary to describe what exposures should be corrected by this reference file and how it was generated. A full listing of the PRIMARY header includes:</p> <div class="highlight-python"><pre>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 IRAF-TLM= '2011-09-09T13:24:40' NEXTEND = 4 / Number of standard extensions DATE = '2010-04-02T19:53:08' FILENAME= 'v971826aj_npl.fits' / name of file FILETYPE= 'DXY GRID' / 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' / detector in use: WFC, HRC, or SBC FILTER1 = 'F475W ' / element selected from filter wheel 1 FILTER2 = 'CLEAR2L ' / element selected from filter wheel 2 USEAFTER= 'Mar 01 2002 00:00:00' COMMENT = 'NPOL calibration file created by Ray A. Lucas 29 APR 2010' DESCRIP = 'Residual geometric distortion file for use with astrodrizzle-------' PEDIGREE= 'INFLIGHT 11/11/2002 11/11/2002' HISTORY Non-polynomial offset file generated from qbu16420j_dxy.fits HISTORY Only added to the flt.fits file and used in coordinate HISTORY transformations if the npol reference filename is specified in HISTORY the header. The offsets are copied from the reference file into HISTORY two arrays for each chip. Each array is stored as a 65x33 pixel HISTORY image that gets interpolated up to the full chip size. Two new HISTORY extensions for each chip are also appended to the flt file HISTORY (WCSDVARR). HISTORY qbu16420j_npl.fits renamed to v9615069j_npl.fits on Sep 6 2011 HISTORY v9615069j_npl.fits renamed to v971826aj_npl.fits on Sep 7 2011</pre> </div> </div> <div class="section" id="data-extension-header"> <h2>Data Extension Header<a class="headerlink" href="#data-extension-header" title="Permalink to this headline">¶</a></h2> <p>Each ACS/WFC chip has a shape of 4096 x 2048 pixels, yet the data arrays in this specific reference file only have 65x33 values. Each data extension (‘DX’ and ‘DY’) contains only those keywords necessary to properly interpolate the sub-sampled values from the arrays to apply to each individual pixel in the full ACS/WFC exposure. The full header for the [‘DX’,1] extension contains:</p> <div class="highlight-python"><pre>XTENSION= 'IMAGE ' / Image extension BITPIX = -32 / Bits per pixel NAXIS = 2 / Number of axes NAXIS1 = 65 / Axis length NAXIS2 = 33 / Axis length PCOUNT = 0 / No 'random' parameters GCOUNT = 1 / Only one group EXTNAME = 'DX ' / Extension name EXTVER = 1 / Extension version ORIGIN = 'NOAO-IRAF FITS Image Kernel July 2003' / FITS file originator INHERIT = F / Inherits global header DATE = '2004-04-28T16:44:21' IRAF-TLM= '16:42:00 (30/11/2006)' WCSDIM = 2 LTM1_1 = 1. LTM2_2 = 1. WAT0_001= 'system=physical' WAT1_001= 'wtype=linear' WAT2_001= 'wtype=linear' CCDCHIP = 2 / CCDCHIP from full size dgeo file LTV1 = 0 LTV2 = 0 ONAXIS1 = 4096 / NAXIS1 of full size dgeo file ONAXIS2 = 2048 / NAXIS2 of full size dgeo file CDELT1 = 64 / Coordinate increment along axis CDELT2 = 64 / Coordinate increment along axis</pre> </div> </div> </div> </div> </div> </div> <div class="clearer"></div> </div> <div class="related"> <h3>Navigation</h3> <ul> <li class="right" style="margin-right: 10px"> <a href="genindex.html" title="General Index" >index</a></li> <li class="right" > <a href="appendix3.html" title="Appendix 3 - D2IMFILE Example" >next</a> |</li> <li class="right" > <a href="appendix1.html" title="Appendix 1 - Sample ACS/WFC Image" >previous</a> |</li> <li><a href="index.html">SSB TSR 2012-01 documentation</a> »</li> </ul> </div> <div class="footer"> © Copyright 2012, Nadia Dencheva, Warren Hack. Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.1.3. </div> </body> </html>