<!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>Detector To Image Correction — 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="Merging Of The Conventions" href="merging.html" />
<link rel="prev" title="Non-polynomial Residual Correction" href="npolcorr.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="merging.html" title="Merging Of The Conventions"
accesskey="N">next</a> |</li>
<li class="right" >
<a href="npolcorr.html" title="Non-polynomial Residual Correction"
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="#">Detector To Image Correction</a><ul>
<li><a class="reference internal" href="#detector-to-image-reference-file">Detector To Image Reference File</a></li>
</ul>
</li>
</ul>
<h4>Previous topic</h4>
<p class="topless"><a href="npolcorr.html"
title="previous chapter">Non-polynomial Residual Correction</a></p>
<h4>Next topic</h4>
<p class="topless"><a href="merging.html"
title="next chapter">Merging Of The Conventions</a></p>
<h3>This Page</h3>
<ul class="this-page-menu">
<li><a href="_sources/d2imcorr.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="detector-to-image-correction">
<h1>Detector To Image Correction<a class="headerlink" href="#detector-to-image-correction" title="Permalink to this headline">¶</a></h1>
<p>The last element of the distortion which remains to be described is the fixed column
(or row) width correction. This needs to be applied as a correction to the input pixel
position and the output of this correction is to be used as input to the polynomial and
non-polynomial distortion corrections.</p>
<p>The adopted implementation is based on the FITS Distortion Paper lookup table convention. It is assumed
that the detector to image correction is the same for all chips but it can be extended
to arbitrary number of chips and extensions if necessary.</p>
<p>For ACS the correction is stored as an image extension with one row. Each element in
the row specifies the correction in pixels for every pixel in the column (or row) in
the science extension as predetermined by the calibration teams who would be responsible
for creating the reference files. For ACS the correction is in the X direction and for
WFPC2 - in the Y direction. The following new keywords are added to the header of each
science extension of a science file:</p>
<div class="highlight-python"><pre>'D2IMFILE' = "string - name of reference file to be used for creating the lookup table"
'AXISCORR' = "integer (1 or 2) - axis to which the det2im correction is applied"
'D2IMEXT' = "string - name of reference file which was last used to create the lookup table"
'D2IMERR' = (optional)" float - maximum value of the correction"</pre>
</div>
<p>‘D2IMFILE’ is used by UPDATEWCS as a flag that a reference file with this correction exists
and an extension should be created. UPDATEWCS records the name of the reference file used
for the lookup table extension to a keyword D2IMEXT in the primary header. It also populates
keyword ‘AXISCORR’ based on whether this is a row or column correction. The lookup table
extension has an ‘EXTNAME’ value of ‘D2IMARR’.</p>
<p>‘AXISCORR’ is used as an indication of the axis to which the correction should be applied
(1 - ‘X’ Axis, 2- ‘Y’ axis). ‘D2IMEXT’ stores the name of the reference file used by
UPDATEWCS to create a <tt class="docutils literal"><span class="pre">D2IMARR</span></tt> extension. If ‘D2IMEXT’ is present in the ‘SCI’ extension
header and is different from the current value of D2IMFILe in the primary header, the
correction array in <tt class="docutils literal"><span class="pre">D2IMARR</span></tt> is updated. The optional keyword ‘D2IMERR’ allows a user to
ignore this correction without modifying other header keywords by passing a parameter to
the software. The HSTWCS class accepts a parameter ‘minerr’ which specifies the minimum
value a distortion correction must have in order to be applied. If ‘minerr’ is larger than
‘D2IMERR’ the correction is not applied.</p>
<div class="section" id="detector-to-image-reference-file">
<h2>Detector To Image Reference File<a class="headerlink" href="#detector-to-image-reference-file" title="Permalink to this headline">¶</a></h2>
<p>An entirely new reference file, the D2IMFILE reference table, serves as the source of this 1-D correction
for each affected instrument. This reference file only contains a single array of offsets
corresponding to the 1-D correction to be applied. Header keywords in the reference file
specify which axis needs this correction. As a result, this new reference file remains
small enough to easily be added to an input image without significant change in size. An
initial <strong>D2IMFILE</strong> for ACS has been generated for testing with a sample header provided in
<a class="reference internal" href="appendix3.html#appendix3"><em>Appendix 3 - D2IMFILE Example</em></a>.</p>
<div class="figure align-center" id="figure2">
<img alt="ACS/WFC F475W D2IMFILE corrections" src="_images/d2im_bar.png" style="width: 95%;" />
<p class="caption">This figure illustrates the corrections included in the first 246 columns of
the ACS/WFC F475W D2IMFILE.</p>
</div>
<p>The WCS for this correction describes the extension as a 1-D image, even though it gets
applied to a 2-D image. This keeps it clear that the same correction gets applied to
all rows(columns) without interpolation. The header specifies which axis this correction
applies to through the use of the AXISCORR keyword. The WCS keywords in the header of the
<tt class="docutils literal"><span class="pre">D2IMARR</span></tt> extension specifies the transformation between pixel coordinates and lookup table
position as if the lookup table were an image itself with 1-based positions (starting pixel
is at a position of (1,1)). The value at that lookup table position then gets used to correct
the original input pixel position.</p>
</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="merging.html" title="Merging Of The Conventions"
>next</a> |</li>
<li class="right" >
<a href="npolcorr.html" title="Non-polynomial Residual Correction"
>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>
