<!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/xhtml;charset=UTF-8"/>
<meta http-equiv="X-UA-Compatible" content="IE=9"/>
<meta name="generator" content="Doxygen 1.8.4"/>
<title>WCSLIB 4.18: cel.h File Reference</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="jquery.js"></script>
<script type="text/javascript" src="dynsections.js"></script>
<link href="doxygen.css" rel="stylesheet" type="text/css" />
</head>
<body>
<div id="top"><!-- do not remove this div, it is closed by doxygen! -->
<div id="titlearea">
<table cellspacing="0" cellpadding="0">
<tbody>
<tr style="height: 56px;">
<td style="padding-left: 0.5em;">
<div id="projectname">WCSLIB 4.18
</div>
</td>
</tr>
</tbody>
</table>
</div>
<!-- end header part -->
<!-- Generated by Doxygen 1.8.4 -->
<div id="navrow1" class="tabs">
<ul class="tablist">
<li><a href="index.html"><span>Main Page</span></a></li>
<li><a href="pages.html"><span>Related Pages</span></a></li>
<li><a href="annotated.html"><span>Data Structures</span></a></li>
<li class="current"><a href="files.html"><span>Files</span></a></li>
</ul>
</div>
<div id="navrow2" class="tabs2">
<ul class="tablist">
<li><a href="files.html"><span>File List</span></a></li>
<li><a href="globals.html"><span>Globals</span></a></li>
</ul>
</div>
<div id="nav-path" class="navpath">
<ul>
<li class="navelem"><a class="el" href="dir_af99bb3c152a306abd27951285ad1127.html">C</a></li> </ul>
</div>
</div><!-- top -->
<div class="header">
<div class="summary">
<a href="#nested-classes">Data Structures</a> |
<a href="#define-members">Macros</a> |
<a href="#enum-members">Enumerations</a> |
<a href="#func-members">Functions</a> |
<a href="#var-members">Variables</a> </div>
<div class="headertitle">
<div class="title">cel.h File Reference</div> </div>
</div><!--header-->
<div class="contents">
<div class="textblock"><code>#include "<a class="el" href="prj_8h_source.html">prj.h</a>"</code><br/>
<code>#include "<a class="el" href="wcserr_8h_source.html">wcserr.h</a>"</code><br/>
</div>
<p><a href="cel_8h_source.html">Go to the source code of this file.</a></p>
<table class="memberdecls">
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="nested-classes"></a>
Data Structures</h2></td></tr>
<tr class="memitem:"><td class="memItemLeft" align="right" valign="top">struct  </td><td class="memItemRight" valign="bottom"><a class="el" href="structcelprm.html">celprm</a></td></tr>
<tr class="memdesc:"><td class="mdescLeft"> </td><td class="mdescRight">Celestial transformation parameters. <a href="structcelprm.html#details">More...</a><br/></td></tr>
<tr class="separator:"><td class="memSeparator" colspan="2"> </td></tr>
</table><table class="memberdecls">
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="define-members"></a>
Macros</h2></td></tr>
<tr class="memitem:a055ad88aa219a0207e221d62e03d2e23"><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="cel_8h.html#a055ad88aa219a0207e221d62e03d2e23">CELLEN</a>   (sizeof(struct <a class="el" href="structcelprm.html">celprm</a>)/sizeof(int))</td></tr>
<tr class="memdesc:a055ad88aa219a0207e221d62e03d2e23"><td class="mdescLeft"> </td><td class="mdescRight">Size of the <a class="el" href="structcelprm.html" title="Celestial transformation parameters. ">celprm</a> struct in <em>int</em> units. <a href="#a055ad88aa219a0207e221d62e03d2e23">More...</a><br/></td></tr>
<tr class="separator:a055ad88aa219a0207e221d62e03d2e23"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a0474e3e2d6c39249acbe58cedd573e84"><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="cel_8h.html#a0474e3e2d6c39249acbe58cedd573e84">celini_errmsg</a>   <a class="el" href="cel_8h.html#a2ac33dbe3aa2efff60543213b0a691f5">cel_errmsg</a></td></tr>
<tr class="memdesc:a0474e3e2d6c39249acbe58cedd573e84"><td class="mdescLeft"> </td><td class="mdescRight">Deprecated. <a href="#a0474e3e2d6c39249acbe58cedd573e84">More...</a><br/></td></tr>
<tr class="separator:a0474e3e2d6c39249acbe58cedd573e84"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a9e188b582ee4eb815466e86bb684fc82"><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="cel_8h.html#a9e188b582ee4eb815466e86bb684fc82">celprt_errmsg</a>   <a class="el" href="cel_8h.html#a2ac33dbe3aa2efff60543213b0a691f5">cel_errmsg</a></td></tr>
<tr class="memdesc:a9e188b582ee4eb815466e86bb684fc82"><td class="mdescLeft"> </td><td class="mdescRight">Deprecated. <a href="#a9e188b582ee4eb815466e86bb684fc82">More...</a><br/></td></tr>
<tr class="separator:a9e188b582ee4eb815466e86bb684fc82"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a2fe5a30084717036a54e7f0a920da105"><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="cel_8h.html#a2fe5a30084717036a54e7f0a920da105">celset_errmsg</a>   <a class="el" href="cel_8h.html#a2ac33dbe3aa2efff60543213b0a691f5">cel_errmsg</a></td></tr>
<tr class="memdesc:a2fe5a30084717036a54e7f0a920da105"><td class="mdescLeft"> </td><td class="mdescRight">Deprecated. <a href="#a2fe5a30084717036a54e7f0a920da105">More...</a><br/></td></tr>
<tr class="separator:a2fe5a30084717036a54e7f0a920da105"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:af72e24d2f169c3c343c55c880a74050f"><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="cel_8h.html#af72e24d2f169c3c343c55c880a74050f">celx2s_errmsg</a>   <a class="el" href="cel_8h.html#a2ac33dbe3aa2efff60543213b0a691f5">cel_errmsg</a></td></tr>
<tr class="memdesc:af72e24d2f169c3c343c55c880a74050f"><td class="mdescLeft"> </td><td class="mdescRight">Deprecated. <a href="#af72e24d2f169c3c343c55c880a74050f">More...</a><br/></td></tr>
<tr class="separator:af72e24d2f169c3c343c55c880a74050f"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ac398f2bea2deac6d86c10a7b3efca966"><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="cel_8h.html#ac398f2bea2deac6d86c10a7b3efca966">cels2x_errmsg</a>   <a class="el" href="cel_8h.html#a2ac33dbe3aa2efff60543213b0a691f5">cel_errmsg</a></td></tr>
<tr class="memdesc:ac398f2bea2deac6d86c10a7b3efca966"><td class="mdescLeft"> </td><td class="mdescRight">Deprecated. <a href="#ac398f2bea2deac6d86c10a7b3efca966">More...</a><br/></td></tr>
<tr class="separator:ac398f2bea2deac6d86c10a7b3efca966"><td class="memSeparator" colspan="2"> </td></tr>
</table><table class="memberdecls">
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="enum-members"></a>
Enumerations</h2></td></tr>
<tr class="memitem:ab20292954fb236dafb2cd78aee121c31"><td class="memItemLeft" align="right" valign="top">enum  </td><td class="memItemRight" valign="bottom"><a class="el" href="cel_8h.html#ab20292954fb236dafb2cd78aee121c31">cel_errmsg_enum</a> { <br/>
  <a class="el" href="cel_8h.html#ab20292954fb236dafb2cd78aee121c31a4ca7a593593157772f3788801138dd12">CELERR_SUCCESS</a> = 0,
<a class="el" href="cel_8h.html#ab20292954fb236dafb2cd78aee121c31a7fa1e5cb9c23e5f138638dad3f938e1e">CELERR_NULL_POINTER</a> = 1,
<a class="el" href="cel_8h.html#ab20292954fb236dafb2cd78aee121c31a33a743bdcdd17bae9c6961234ed6b642">CELERR_BAD_PARAM</a> = 2,
<a class="el" href="cel_8h.html#ab20292954fb236dafb2cd78aee121c31a367cf89b74764f9462bfa50c2eb50fb6">CELERR_BAD_COORD_TRANS</a> = 3,
<br/>
  <a class="el" href="cel_8h.html#ab20292954fb236dafb2cd78aee121c31acb1dec1ea393b198b93a26425ee901a2">CELERR_ILL_COORD_TRANS</a> = 4,
<a class="el" href="cel_8h.html#ab20292954fb236dafb2cd78aee121c31a44042efc5a9894182447dfcbcd24e1d4">CELERR_BAD_PIX</a> = 5,
<a class="el" href="cel_8h.html#ab20292954fb236dafb2cd78aee121c31aac8beaf37d754d1a7a7aab5307a2140b">CELERR_BAD_WORLD</a> = 6
<br/>
}</td></tr>
<tr class="separator:ab20292954fb236dafb2cd78aee121c31"><td class="memSeparator" colspan="2"> </td></tr>
</table><table class="memberdecls">
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="func-members"></a>
Functions</h2></td></tr>
<tr class="memitem:a1fe1b137ade45ea28e61f44d4708fb77"><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="cel_8h.html#a1fe1b137ade45ea28e61f44d4708fb77">celini</a> (struct <a class="el" href="structcelprm.html">celprm</a> *cel)</td></tr>
<tr class="memdesc:a1fe1b137ade45ea28e61f44d4708fb77"><td class="mdescLeft"> </td><td class="mdescRight">Default constructor for the <a class="el" href="structcelprm.html" title="Celestial transformation parameters. ">celprm</a> struct. <a href="#a1fe1b137ade45ea28e61f44d4708fb77">More...</a><br/></td></tr>
<tr class="separator:a1fe1b137ade45ea28e61f44d4708fb77"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a39bb7bf8e545c200191d51884ecfb89b"><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="cel_8h.html#a39bb7bf8e545c200191d51884ecfb89b">celfree</a> (struct <a class="el" href="structcelprm.html">celprm</a> *cel)</td></tr>
<tr class="memdesc:a39bb7bf8e545c200191d51884ecfb89b"><td class="mdescLeft"> </td><td class="mdescRight">Destructor for the <a class="el" href="structcelprm.html" title="Celestial transformation parameters. ">celprm</a> struct. <a href="#a39bb7bf8e545c200191d51884ecfb89b">More...</a><br/></td></tr>
<tr class="separator:a39bb7bf8e545c200191d51884ecfb89b"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:adb2e4565f61a9de5fe278d9035850dc3"><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="cel_8h.html#adb2e4565f61a9de5fe278d9035850dc3">celprt</a> (const struct <a class="el" href="structcelprm.html">celprm</a> *cel)</td></tr>
<tr class="memdesc:adb2e4565f61a9de5fe278d9035850dc3"><td class="mdescLeft"> </td><td class="mdescRight">Print routine for the <a class="el" href="structcelprm.html" title="Celestial transformation parameters. ">celprm</a> struct. <a href="#adb2e4565f61a9de5fe278d9035850dc3">More...</a><br/></td></tr>
<tr class="separator:adb2e4565f61a9de5fe278d9035850dc3"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ab0f67d1727750616f71c7bfcb3a037b6"><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="cel_8h.html#ab0f67d1727750616f71c7bfcb3a037b6">celset</a> (struct <a class="el" href="structcelprm.html">celprm</a> *cel)</td></tr>
<tr class="memdesc:ab0f67d1727750616f71c7bfcb3a037b6"><td class="mdescLeft"> </td><td class="mdescRight">Setup routine for the <a class="el" href="structcelprm.html" title="Celestial transformation parameters. ">celprm</a> struct. <a href="#ab0f67d1727750616f71c7bfcb3a037b6">More...</a><br/></td></tr>
<tr class="separator:ab0f67d1727750616f71c7bfcb3a037b6"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a1fe7f134670262eb54b6049c0275a27b"><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="cel_8h.html#a1fe7f134670262eb54b6049c0275a27b">celx2s</a> (struct <a class="el" href="structcelprm.html">celprm</a> *cel, int nx, int ny, int sxy, int sll, const double x[], const double y[], double phi[], double theta[], double lng[], double lat[], int stat[])</td></tr>
<tr class="memdesc:a1fe7f134670262eb54b6049c0275a27b"><td class="mdescLeft"> </td><td class="mdescRight">Pixel-to-world celestial transformation. <a href="#a1fe7f134670262eb54b6049c0275a27b">More...</a><br/></td></tr>
<tr class="separator:a1fe7f134670262eb54b6049c0275a27b"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a6661c05703158b0808038b7d551f1ea1"><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="cel_8h.html#a6661c05703158b0808038b7d551f1ea1">cels2x</a> (struct <a class="el" href="structcelprm.html">celprm</a> *cel, int nlng, int nlat, int sll, int sxy, const double lng[], const double lat[], double phi[], double theta[], double x[], double y[], int stat[])</td></tr>
<tr class="memdesc:a6661c05703158b0808038b7d551f1ea1"><td class="mdescLeft"> </td><td class="mdescRight">World-to-pixel celestial transformation. <a href="#a6661c05703158b0808038b7d551f1ea1">More...</a><br/></td></tr>
<tr class="separator:a6661c05703158b0808038b7d551f1ea1"><td class="memSeparator" colspan="2"> </td></tr>
</table><table class="memberdecls">
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="var-members"></a>
Variables</h2></td></tr>
<tr class="memitem:a2ac33dbe3aa2efff60543213b0a691f5"><td class="memItemLeft" align="right" valign="top">const char * </td><td class="memItemRight" valign="bottom"><a class="el" href="cel_8h.html#a2ac33dbe3aa2efff60543213b0a691f5">cel_errmsg</a> []</td></tr>
<tr class="separator:a2ac33dbe3aa2efff60543213b0a691f5"><td class="memSeparator" colspan="2"> </td></tr>
</table>
<a name="details" id="details"></a><h2 class="groupheader">Detailed Description</h2>
<div class="textblock"><p>These routines implement the part of the FITS World Coordinate System (WCS) standard that deals with celestial coordinates. They define methods to be used for computing celestial world coordinates from intermediate world coordinates (a linear transformation of image pixel coordinates), and vice versa. They are based on the <a class="el" href="structcelprm.html" title="Celestial transformation parameters. ">celprm</a> struct which contains all information needed for the computations. This struct contains some elements that must be set by the user, and others that are maintained by these routines, somewhat like a C++ class but with no encapsulation.</p>
<p>Routine <a class="el" href="cel_8h.html#a1fe1b137ade45ea28e61f44d4708fb77" title="Default constructor for the celprm struct. ">celini()</a> is provided to initialize the <a class="el" href="structcelprm.html" title="Celestial transformation parameters. ">celprm</a> struct with default values, <a class="el" href="cel_8h.html#a39bb7bf8e545c200191d51884ecfb89b" title="Destructor for the celprm struct. ">celfree()</a> reclaims any memory that may have been allocated to store an error message, and <a class="el" href="cel_8h.html#adb2e4565f61a9de5fe278d9035850dc3" title="Print routine for the celprm struct. ">celprt()</a> prints its contents.</p>
<p>A setup routine, <a class="el" href="cel_8h.html#ab0f67d1727750616f71c7bfcb3a037b6" title="Setup routine for the celprm struct. ">celset()</a>, computes intermediate values in the <a class="el" href="structcelprm.html" title="Celestial transformation parameters. ">celprm</a> struct from parameters in it that were supplied by the user. The struct always needs to be set up by <a class="el" href="cel_8h.html#ab0f67d1727750616f71c7bfcb3a037b6" title="Setup routine for the celprm struct. ">celset()</a> but it need not be called explicitly - refer to the explanation of <a class="el" href="structcelprm.html#a408a39c1d060d5b32f884f8a8c60aaa2">celprm::flag</a>.</p>
<p><a class="el" href="cel_8h.html#a1fe7f134670262eb54b6049c0275a27b" title="Pixel-to-world celestial transformation. ">celx2s()</a> and <a class="el" href="cel_8h.html#a6661c05703158b0808038b7d551f1ea1" title="World-to-pixel celestial transformation. ">cels2x()</a> implement the WCS celestial coordinate transformations. In fact, they are high level driver routines for the lower level spherical coordinate rotation and projection routines described in <a class="el" href="sph_8h.html">sph.h</a> and <a class="el" href="prj_8h.html">prj.h</a>. </p>
</div><h2 class="groupheader">Macro Definition Documentation</h2>
<a class="anchor" id="a055ad88aa219a0207e221d62e03d2e23"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define CELLEN   (sizeof(struct <a class="el" href="structcelprm.html">celprm</a>)/sizeof(int))</td>
</tr>
</table>
</div><div class="memdoc">
<p>Size of the <a class="el" href="structcelprm.html" title="Celestial transformation parameters. ">celprm</a> struct in <em>int</em> units, used by the Fortran wrappers. </p>
</div>
</div>
<a class="anchor" id="a0474e3e2d6c39249acbe58cedd573e84"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define celini_errmsg   <a class="el" href="cel_8h.html#a2ac33dbe3aa2efff60543213b0a691f5">cel_errmsg</a></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="deprecated"><dt><b><a class="el" href="deprecated.html#_deprecated000001">Deprecated:</a></b></dt><dd>Added for backwards compatibility, use <a class="el" href="cel_8h.html#a2ac33dbe3aa2efff60543213b0a691f5">cel_errmsg</a> directly now instead. </dd></dl>
</div>
</div>
<a class="anchor" id="a9e188b582ee4eb815466e86bb684fc82"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define celprt_errmsg   <a class="el" href="cel_8h.html#a2ac33dbe3aa2efff60543213b0a691f5">cel_errmsg</a></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="deprecated"><dt><b><a class="el" href="deprecated.html#_deprecated000002">Deprecated:</a></b></dt><dd>Added for backwards compatibility, use <a class="el" href="cel_8h.html#a2ac33dbe3aa2efff60543213b0a691f5">cel_errmsg</a> directly now instead. </dd></dl>
</div>
</div>
<a class="anchor" id="a2fe5a30084717036a54e7f0a920da105"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define celset_errmsg   <a class="el" href="cel_8h.html#a2ac33dbe3aa2efff60543213b0a691f5">cel_errmsg</a></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="deprecated"><dt><b><a class="el" href="deprecated.html#_deprecated000003">Deprecated:</a></b></dt><dd>Added for backwards compatibility, use <a class="el" href="cel_8h.html#a2ac33dbe3aa2efff60543213b0a691f5">cel_errmsg</a> directly now instead. </dd></dl>
</div>
</div>
<a class="anchor" id="af72e24d2f169c3c343c55c880a74050f"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define celx2s_errmsg   <a class="el" href="cel_8h.html#a2ac33dbe3aa2efff60543213b0a691f5">cel_errmsg</a></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="deprecated"><dt><b><a class="el" href="deprecated.html#_deprecated000004">Deprecated:</a></b></dt><dd>Added for backwards compatibility, use <a class="el" href="cel_8h.html#a2ac33dbe3aa2efff60543213b0a691f5">cel_errmsg</a> directly now instead. </dd></dl>
</div>
</div>
<a class="anchor" id="ac398f2bea2deac6d86c10a7b3efca966"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define cels2x_errmsg   <a class="el" href="cel_8h.html#a2ac33dbe3aa2efff60543213b0a691f5">cel_errmsg</a></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="deprecated"><dt><b><a class="el" href="deprecated.html#_deprecated000005">Deprecated:</a></b></dt><dd>Added for backwards compatibility, use <a class="el" href="cel_8h.html#a2ac33dbe3aa2efff60543213b0a691f5">cel_errmsg</a> directly now instead. </dd></dl>
</div>
</div>
<h2 class="groupheader">Enumeration Type Documentation</h2>
<a class="anchor" id="ab20292954fb236dafb2cd78aee121c31"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">enum <a class="el" href="cel_8h.html#ab20292954fb236dafb2cd78aee121c31">cel_errmsg_enum</a></td>
</tr>
</table>
</div><div class="memdoc">
<table class="fieldtable">
<tr><th colspan="2">Enumerator</th></tr><tr><td class="fieldname"><em><a class="anchor" id="ab20292954fb236dafb2cd78aee121c31a4ca7a593593157772f3788801138dd12"></a>CELERR_SUCCESS</em> </td><td class="fielddoc">
</td></tr>
<tr><td class="fieldname"><em><a class="anchor" id="ab20292954fb236dafb2cd78aee121c31a7fa1e5cb9c23e5f138638dad3f938e1e"></a>CELERR_NULL_POINTER</em> </td><td class="fielddoc">
</td></tr>
<tr><td class="fieldname"><em><a class="anchor" id="ab20292954fb236dafb2cd78aee121c31a33a743bdcdd17bae9c6961234ed6b642"></a>CELERR_BAD_PARAM</em> </td><td class="fielddoc">
</td></tr>
<tr><td class="fieldname"><em><a class="anchor" id="ab20292954fb236dafb2cd78aee121c31a367cf89b74764f9462bfa50c2eb50fb6"></a>CELERR_BAD_COORD_TRANS</em> </td><td class="fielddoc">
</td></tr>
<tr><td class="fieldname"><em><a class="anchor" id="ab20292954fb236dafb2cd78aee121c31acb1dec1ea393b198b93a26425ee901a2"></a>CELERR_ILL_COORD_TRANS</em> </td><td class="fielddoc">
</td></tr>
<tr><td class="fieldname"><em><a class="anchor" id="ab20292954fb236dafb2cd78aee121c31a44042efc5a9894182447dfcbcd24e1d4"></a>CELERR_BAD_PIX</em> </td><td class="fielddoc">
</td></tr>
<tr><td class="fieldname"><em><a class="anchor" id="ab20292954fb236dafb2cd78aee121c31aac8beaf37d754d1a7a7aab5307a2140b"></a>CELERR_BAD_WORLD</em> </td><td class="fielddoc">
</td></tr>
</table>
</div>
</div>
<h2 class="groupheader">Function Documentation</h2>
<a class="anchor" id="a1fe1b137ade45ea28e61f44d4708fb77"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int celini </td>
<td>(</td>
<td class="paramtype">struct <a class="el" href="structcelprm.html">celprm</a> * </td>
<td class="paramname"><em>cel</em>)</td><td></td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p><b>celini</b>() sets all members of a <a class="el" href="structcelprm.html" title="Celestial transformation parameters. ">celprm</a> struct to default values. It should be used to initialize every <a class="el" href="structcelprm.html" title="Celestial transformation parameters. ">celprm</a> struct.</p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramdir">[out]</td><td class="paramname">cel</td><td>Celestial transformation parameters.</td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>Status return value:<ul>
<li>0: Success.</li>
<li>1: Null <a class="el" href="structcelprm.html" title="Celestial transformation parameters. ">celprm</a> pointer passed. </li>
</ul>
</dd></dl>
</div>
</div>
<a class="anchor" id="a39bb7bf8e545c200191d51884ecfb89b"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int celfree </td>
<td>(</td>
<td class="paramtype">struct <a class="el" href="structcelprm.html">celprm</a> * </td>
<td class="paramname"><em>cel</em>)</td><td></td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p><b>celfree</b>() frees any memory that may have been allocated to store an error message in the <a class="el" href="structcelprm.html" title="Celestial transformation parameters. ">celprm</a> struct.</p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramdir">[in]</td><td class="paramname">cel</td><td>Celestial transformation parameters.</td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>Status return value:<ul>
<li>0: Success.</li>
<li>1: Null <a class="el" href="structcelprm.html" title="Celestial transformation parameters. ">celprm</a> pointer passed. </li>
</ul>
</dd></dl>
</div>
</div>
<a class="anchor" id="adb2e4565f61a9de5fe278d9035850dc3"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int celprt </td>
<td>(</td>
<td class="paramtype">const struct <a class="el" href="structcelprm.html">celprm</a> * </td>
<td class="paramname"><em>cel</em>)</td><td></td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p><b>celprt</b>() prints the contents of a <a class="el" href="structcelprm.html" title="Celestial transformation parameters. ">celprm</a> struct using <a class="el" href="wcsprintf_8h.html#a46950abaf5a27347da8160741f98f973" title="Print function used by WCSLIB diagnostic routines. ">wcsprintf()</a>. Mainly intended for diagnostic purposes.</p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramdir">[in]</td><td class="paramname">cel</td><td>Celestial transformation parameters.</td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>Status return value:<ul>
<li>0: Success.</li>
<li>1: Null <a class="el" href="structcelprm.html" title="Celestial transformation parameters. ">celprm</a> pointer passed. </li>
</ul>
</dd></dl>
</div>
</div>
<a class="anchor" id="ab0f67d1727750616f71c7bfcb3a037b6"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int celset </td>
<td>(</td>
<td class="paramtype">struct <a class="el" href="structcelprm.html">celprm</a> * </td>
<td class="paramname"><em>cel</em>)</td><td></td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p><b>celset</b>() sets up a <a class="el" href="structcelprm.html" title="Celestial transformation parameters. ">celprm</a> struct according to information supplied within it.</p>
<p>Note that this routine need not be called directly; it will be invoked by <a class="el" href="cel_8h.html#a1fe7f134670262eb54b6049c0275a27b" title="Pixel-to-world celestial transformation. ">celx2s()</a> and <a class="el" href="cel_8h.html#a6661c05703158b0808038b7d551f1ea1" title="World-to-pixel celestial transformation. ">cels2x()</a> if <a class="el" href="structcelprm.html#a408a39c1d060d5b32f884f8a8c60aaa2">celprm::flag</a> is anything other than a predefined magic value.</p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramdir">[in,out]</td><td class="paramname">cel</td><td>Celestial transformation parameters.</td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>Status return value:<ul>
<li>0: Success.</li>
<li>1: Null <a class="el" href="structcelprm.html" title="Celestial transformation parameters. ">celprm</a> pointer passed.</li>
<li>2: Invalid projection parameters.</li>
<li>3: Invalid coordinate transformation parameters.</li>
<li>4: Ill-conditioned coordinate transformation parameters.</li>
</ul>
For returns > 1, a detailed error message is set in <a class="el" href="structcelprm.html#a1b9cbfd7cfa2306464d57dc4acd03b06">celprm::err</a> if enabled, see <a class="el" href="wcserr_8h.html#a1691b8bd184d40ca6fda255be078fa53" title="Enable/disable error messaging. ">wcserr_enable()</a>. </dd></dl>
</div>
</div>
<a class="anchor" id="a1fe7f134670262eb54b6049c0275a27b"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int celx2s </td>
<td>(</td>
<td class="paramtype">struct <a class="el" href="structcelprm.html">celprm</a> * </td>
<td class="paramname"><em>cel</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"><em>nx</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"><em>ny</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"><em>sxy</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"><em>sll</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const double </td>
<td class="paramname"><em>x</em>[], </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const double </td>
<td class="paramname"><em>y</em>[], </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">double </td>
<td class="paramname"><em>phi</em>[], </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">double </td>
<td class="paramname"><em>theta</em>[], </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">double </td>
<td class="paramname"><em>lng</em>[], </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">double </td>
<td class="paramname"><em>lat</em>[], </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"><em>stat</em>[] </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p><b>celx2s</b>() transforms <img class="formulaInl" alt="$(x,y)$" src="form_0.png"/> coordinates in the plane of projection to celestial coordinates <img class="formulaInl" alt="$(\alpha,\delta)$" src="form_1.png"/>.</p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramdir">[in,out]</td><td class="paramname">cel</td><td>Celestial transformation parameters.</td></tr>
<tr><td class="paramdir">[in]</td><td class="paramname">nx,ny</td><td>Vector lengths. </td></tr>
<tr><td class="paramdir">[in]</td><td class="paramname">sxy,sll</td><td>Vector strides. </td></tr>
<tr><td class="paramdir">[in]</td><td class="paramname">x,y</td><td>Projected coordinates in pseudo "degrees".</td></tr>
<tr><td class="paramdir">[out]</td><td class="paramname">phi,theta</td><td>Longitude and latitude <img class="formulaInl" alt="$(\phi,\theta)$" src="form_2.png"/> in the native coordinate system of the projection [deg]. </td></tr>
<tr><td class="paramdir">[out]</td><td class="paramname">lng,lat</td><td>Celestial longitude and latitude <img class="formulaInl" alt="$(\alpha,\delta)$" src="form_1.png"/> of the projected point [deg]. </td></tr>
<tr><td class="paramdir">[out]</td><td class="paramname">stat</td><td>Status return value for each vector element:<ul>
<li>0: Success.</li>
<li>1: Invalid value of <img class="formulaInl" alt="$(x,y)$" src="form_0.png"/>.</li>
</ul>
</td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>Status return value:<ul>
<li>0: Success.</li>
<li>1: Null <a class="el" href="structcelprm.html" title="Celestial transformation parameters. ">celprm</a> pointer passed.</li>
<li>2: Invalid projection parameters.</li>
<li>3: Invalid coordinate transformation parameters.</li>
<li>4: Ill-conditioned coordinate transformation parameters.</li>
<li>5: One or more of the <img class="formulaInl" alt="$(x,y)$" src="form_0.png"/> coordinates were invalid, as indicated by the stat vector.</li>
</ul>
For returns > 1, a detailed error message is set in <a class="el" href="structcelprm.html#a1b9cbfd7cfa2306464d57dc4acd03b06">celprm::err</a> if enabled, see <a class="el" href="wcserr_8h.html#a1691b8bd184d40ca6fda255be078fa53" title="Enable/disable error messaging. ">wcserr_enable()</a>. </dd></dl>
</div>
</div>
<a class="anchor" id="a6661c05703158b0808038b7d551f1ea1"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int cels2x </td>
<td>(</td>
<td class="paramtype">struct <a class="el" href="structcelprm.html">celprm</a> * </td>
<td class="paramname"><em>cel</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"><em>nlng</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"><em>nlat</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"><em>sll</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"><em>sxy</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const double </td>
<td class="paramname"><em>lng</em>[], </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const double </td>
<td class="paramname"><em>lat</em>[], </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">double </td>
<td class="paramname"><em>phi</em>[], </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">double </td>
<td class="paramname"><em>theta</em>[], </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">double </td>
<td class="paramname"><em>x</em>[], </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">double </td>
<td class="paramname"><em>y</em>[], </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"><em>stat</em>[] </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p><b>cels2x</b>() transforms celestial coordinates <img class="formulaInl" alt="$(\alpha,\delta)$" src="form_1.png"/> to <img class="formulaInl" alt="$(x,y)$" src="form_0.png"/> coordinates in the plane of projection.</p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramdir">[in,out]</td><td class="paramname">cel</td><td>Celestial transformation parameters.</td></tr>
<tr><td class="paramdir">[in]</td><td class="paramname">nlng,nlat</td><td>Vector lengths. </td></tr>
<tr><td class="paramdir">[in]</td><td class="paramname">sll,sxy</td><td>Vector strides. </td></tr>
<tr><td class="paramdir">[in]</td><td class="paramname">lng,lat</td><td>Celestial longitude and latitude <img class="formulaInl" alt="$(\alpha,\delta)$" src="form_1.png"/> of the projected point [deg].</td></tr>
<tr><td class="paramdir">[out]</td><td class="paramname">phi,theta</td><td>Longitude and latitude <img class="formulaInl" alt="$(\phi,\theta)$" src="form_2.png"/> in the native coordinate system of the projection [deg]. </td></tr>
<tr><td class="paramdir">[out]</td><td class="paramname">x,y</td><td>Projected coordinates in pseudo "degrees". </td></tr>
<tr><td class="paramdir">[out]</td><td class="paramname">stat</td><td>Status return value for each vector element:<ul>
<li>0: Success.</li>
<li>1: Invalid value of <img class="formulaInl" alt="$(\alpha,\delta)$" src="form_1.png"/>.</li>
</ul>
</td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>Status return value:<ul>
<li>0: Success.</li>
<li>1: Null <a class="el" href="structcelprm.html" title="Celestial transformation parameters. ">celprm</a> pointer passed.</li>
<li>2: Invalid projection parameters.</li>
<li>3: Invalid coordinate transformation parameters.</li>
<li>4: Ill-conditioned coordinate transformation parameters.</li>
<li>6: One or more of the <img class="formulaInl" alt="$(\alpha,\delta)$" src="form_1.png"/> coordinates were invalid, as indicated by the stat vector.</li>
</ul>
For returns > 1, a detailed error message is set in <a class="el" href="structcelprm.html#a1b9cbfd7cfa2306464d57dc4acd03b06">celprm::err</a> if enabled, see <a class="el" href="wcserr_8h.html#a1691b8bd184d40ca6fda255be078fa53" title="Enable/disable error messaging. ">wcserr_enable()</a>. </dd></dl>
</div>
</div>
<h2 class="groupheader">Variable Documentation</h2>
<a class="anchor" id="a2ac33dbe3aa2efff60543213b0a691f5"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">const char* cel_errmsg[]</td>
</tr>
</table>
</div><div class="memdoc">
</div>
</div>
</div><!-- contents -->
<!-- start footer part -->
<hr class="footer"/><address class="footer"><small>
Generated on Sat Jul 13 2013 20:00:26 for WCSLIB 4.18 by  <a href="http://www.doxygen.org/index.html">
<img class="footer" src="doxygen.png" alt="doxygen"/>
</a> 1.8.4
</small></address>
</body>
</html>
