<!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>SIP Convention — 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="FITS Distortion Proposal" href="convention.html" />
<link rel="prev" title="Problems Introduced by the HST/ACS Distortion" href="problems.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="convention.html" title="FITS Distortion Proposal"
accesskey="N">next</a> |</li>
<li class="right" >
<a href="problems.html" title="Problems Introduced by the HST/ACS Distortion"
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="#">SIP Convention</a><ul>
<li><a class="reference internal" href="#velocity-aberration-correction">Velocity Aberration Correction</a></li>
<li><a class="reference internal" href="#time-dependent-distortion">Time-Dependent Distortion</a></li>
</ul>
</li>
</ul>
<h4>Previous topic</h4>
<p class="topless"><a href="problems.html"
title="previous chapter">Problems Introduced by the HST/ACS Distortion</a></p>
<h4>Next topic</h4>
<p class="topless"><a href="convention.html"
title="next chapter">FITS Distortion Proposal</a></p>
<h3>This Page</h3>
<ul class="this-page-menu">
<li><a href="_sources/sip.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="sip-convention">
<h1>SIP Convention<a class="headerlink" href="#sip-convention" title="Permalink to this headline">¶</a></h1>
<p>Current implementations of distortion models in FITS headers have been limited to simply
describing polynomial models. The prime example of this would be the implementation of SIP
in WCSTOOLS and recognition of SIP keywords by DS9 as used for Spitzer data <a class="reference internal" href="appendix3.html#sipconvention">[SIPConvention]</a>.
The new keywords defined by the SIP standard and used by PyWCS are:</p>
<div class="highlight-python"><pre>A_ORDER = n / polynomial order, axis 1, detector to sky
A_i_j / High order coefficients for X axis
B_ORDER = m / polynomial order, axis 2, detector to sky
B_i_j / High order coefficients for axis 2</pre>
</div>
<p>These SIP keywords get used in conjunction with the linear WCS keywords defined
with these values:</p>
<div class="highlight-python"><pre>CTYPE1 = 'RA---TAN-SIP'
CTYPE2 = 'DEC--TAN-SIP'
CDi_j / Linear terms of distortion plus scale and orientation</pre>
</div>
<p>The SIP convention retains the use of the current definition of the CD matrix where the
linear terms of the distortion model are folded in with the orientation and scale at the
reference point for each chip to provide the best linear approximation to the distortion
available. The SIP convention gets applied to the input pixel positions by applying the
higher-order coefficients A_i_j, B_i_j, then by applying the CD matrix and adding the CRVAL
position to get the final world coordinates.</p>
<p>This convention was created from the original form of the FITS Distortion Paper standards, but the
FITS Distortion Paper proposal has since changed to use a different set of keywords and conventions.</p>
<p>A sample ACS/WFC SCI header can be found in <a class="reference internal" href="appendix1.html#appendix1"><em>Appendix 1 - Sample ACS/WFC Image</em></a> to illustrate how these
keywords actually get populated for an image. The current implementation does not
take advantage of the A_DMAX, B_DMAX, SIPREFi or SIPSCLi keywords, so these keywords
are not written out to the SCI header.</p>
<div class="section" id="velocity-aberration-correction">
<h2>Velocity Aberration Correction<a class="headerlink" href="#velocity-aberration-correction" title="Permalink to this headline">¶</a></h2>
<p>This correction simply serves as a correction to the overall linear scale of the field of view
due to velocity aberration observed due to the motion of HST in orbit. The typical plate scale
for HST cameras results in a measurable velocity aberration with variations from the center of
the field of view to the edge on the order of 0.1 pixels. More details about this correction can
be found in <a class="reference external" href="http://documents.stsci.edu/hst/HST_overview/documents/DrizzlePac/DrizzlePac.cover.html">Appendix A.3 of the DrizzlePac Handbook</a>.</p>
<p>This scale factor gets computed by
the HST ground systems for start of each exposure and recorded as the VAFACTOR keyword in each
image’s science extension header. This term, though, does not get included in the default
CD matrix computed by the ground systems. As a result, it needs to be accounted for when reading in the
distortion model polynomial coefficients from the IDCTAB reference table. The VAFACTOR scaling factor
gets folded into the computation of new values for the CD matrix for this specific exposure
without requiring any further use of the VAFACTOR keyword when applying this distortion
model to the science image. It also gets used to correct the reference position of each chip
on the sky, each chip’s CRVAL value, to account for this aberration.</p>
</div>
<div class="section" id="time-dependent-distortion">
<h2>Time-Dependent Distortion<a class="headerlink" href="#time-dependent-distortion" title="Permalink to this headline">¶</a></h2>
<p>Calibration of HST/ACS imaging data required the addition of a time dependent skew in addition
to the other distortion terms. This skew represented a linear correction to the polynomial model
and its residuals. This correction gets applied to the polynomial coefficients and
the residuals from the polynomial model when they are evaluated for each image. As a result, the
SIP keywords as written out to each HST/ACS image header
reflects this time-dependent correction without the need for any further evaluation of this skew.</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="convention.html" title="FITS Distortion Proposal"
>next</a> |</li>
<li class="right" >
<a href="problems.html" title="Problems Introduced by the HST/ACS Distortion"
>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>
