wcslib (8.2.2)

(root)/
share/
doc/
wcslib-8.2.2/
html/
wcs_8h_source.html
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "https://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" lang="en-US">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<meta http-equiv="X-UA-Compatible" content="IE=11"/>
<meta name="generator" content="Doxygen 1.9.8"/>
<meta name="viewport" content="width=device-width, initial-scale=1"/>
<title>WCSLIB: wcs.h Source File</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="search/search.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="search/searchdata.js"></script>
<script type="text/javascript" src="search/search.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 id="projectrow">
  <td id="projectalign">
   <div id="projectname">WCSLIB<span id="projectnumber">&#160;8.2.2</span>
   </div>
  </td>
 </tr>
 </tbody>
</table>
</div>
<!-- end header part -->
<!-- Generated by Doxygen 1.9.8 -->
<script type="text/javascript">
/* @license magnet:?xt=urn:btih:d3d9a9a6595521f9666a5e94cc830dab83b65699&amp;dn=expat.txt MIT */
var searchBox = new SearchBox("searchBox", "search/",'.html');
/* @license-end */
</script>
<script type="text/javascript" src="menudata.js"></script>
<script type="text/javascript" src="menu.js"></script>
<script type="text/javascript">
/* @license magnet:?xt=urn:btih:d3d9a9a6595521f9666a5e94cc830dab83b65699&amp;dn=expat.txt MIT */
$(function() {
  initMenu('',true,false,'search.php','Search');
  $(document).ready(function() { init_search(); });
});
/* @license-end */
</script>
<div id="main-nav"></div>
<script type="text/javascript">
/* @license magnet:?xt=urn:btih:d3d9a9a6595521f9666a5e94cc830dab83b65699&amp;dn=expat.txt MIT */
$(document).ready(function() { init_codefold(0); });
/* @license-end */
</script>
<!-- window showing the filter options -->
<div id="MSearchSelectWindow"
     onmouseover="return searchBox.OnSearchSelectShow()"
     onmouseout="return searchBox.OnSearchSelectHide()"
     onkeydown="return searchBox.OnSearchSelectKey(event)">
</div>

<!-- iframe showing the search results (closed by default) -->
<div id="MSearchResultsWindow">
<div id="MSearchResults">
<div class="SRPage">
<div id="SRIndex">
<div id="SRResults"></div>
<div class="SRStatus" id="Loading">Loading...</div>
<div class="SRStatus" id="Searching">Searching...</div>
<div class="SRStatus" id="NoMatches">No Matches</div>
</div>
</div>
</div>
</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="headertitle"><div class="title">wcs.h</div></div>
</div><!--header-->
<div class="contents">
<a href="wcs_8h.html">Go to the documentation of this file.</a><div class="fragment"><div class="line"><a id="l00001" name="l00001"></a><span class="lineno">    1</span><span class="comment">/*============================================================================</span></div>
<div class="line"><a id="l00002" name="l00002"></a><span class="lineno">    2</span><span class="comment">  WCSLIB 8.2 - an implementation of the FITS WCS standard.</span></div>
<div class="line"><a id="l00003" name="l00003"></a><span class="lineno">    3</span><span class="comment">  Copyright (C) 1995-2023, Mark Calabretta</span></div>
<div class="line"><a id="l00004" name="l00004"></a><span class="lineno">    4</span><span class="comment"></span> </div>
<div class="line"><a id="l00005" name="l00005"></a><span class="lineno">    5</span><span class="comment">  This file is part of WCSLIB.</span></div>
<div class="line"><a id="l00006" name="l00006"></a><span class="lineno">    6</span><span class="comment"></span> </div>
<div class="line"><a id="l00007" name="l00007"></a><span class="lineno">    7</span><span class="comment">  WCSLIB is free software: you can redistribute it and/or modify it under the</span></div>
<div class="line"><a id="l00008" name="l00008"></a><span class="lineno">    8</span><span class="comment">  terms of the GNU Lesser General Public License as published by the Free</span></div>
<div class="line"><a id="l00009" name="l00009"></a><span class="lineno">    9</span><span class="comment">  Software Foundation, either version 3 of the License, or (at your option)</span></div>
<div class="line"><a id="l00010" name="l00010"></a><span class="lineno">   10</span><span class="comment">  any later version.</span></div>
<div class="line"><a id="l00011" name="l00011"></a><span class="lineno">   11</span><span class="comment"></span> </div>
<div class="line"><a id="l00012" name="l00012"></a><span class="lineno">   12</span><span class="comment">  WCSLIB is distributed in the hope that it will be useful, but WITHOUT ANY</span></div>
<div class="line"><a id="l00013" name="l00013"></a><span class="lineno">   13</span><span class="comment">  WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS</span></div>
<div class="line"><a id="l00014" name="l00014"></a><span class="lineno">   14</span><span class="comment">  FOR A PARTICULAR PURPOSE.  See the GNU Lesser General Public License for</span></div>
<div class="line"><a id="l00015" name="l00015"></a><span class="lineno">   15</span><span class="comment">  more details.</span></div>
<div class="line"><a id="l00016" name="l00016"></a><span class="lineno">   16</span><span class="comment"></span> </div>
<div class="line"><a id="l00017" name="l00017"></a><span class="lineno">   17</span><span class="comment">  You should have received a copy of the GNU Lesser General Public License</span></div>
<div class="line"><a id="l00018" name="l00018"></a><span class="lineno">   18</span><span class="comment">  along with WCSLIB.  If not, see http://www.gnu.org/licenses.</span></div>
<div class="line"><a id="l00019" name="l00019"></a><span class="lineno">   19</span><span class="comment"></span> </div>
<div class="line"><a id="l00020" name="l00020"></a><span class="lineno">   20</span><span class="comment">  Author: Mark Calabretta, Australia Telescope National Facility, CSIRO.</span></div>
<div class="line"><a id="l00021" name="l00021"></a><span class="lineno">   21</span><span class="comment">  http://www.atnf.csiro.au/people/Mark.Calabretta</span></div>
<div class="line"><a id="l00022" name="l00022"></a><span class="lineno">   22</span><span class="comment">  $Id: wcs.h,v 8.2.1.1 2023/11/16 10:05:57 mcalabre Exp mcalabre $</span></div>
<div class="line"><a id="l00023" name="l00023"></a><span class="lineno">   23</span><span class="comment">*=============================================================================</span></div>
<div class="line"><a id="l00024" name="l00024"></a><span class="lineno">   24</span><span class="comment">*</span></div>
<div class="line"><a id="l00025" name="l00025"></a><span class="lineno">   25</span><span class="comment">* WCSLIB 8.2 - C routines that implement the FITS World Coordinate System</span></div>
<div class="line"><a id="l00026" name="l00026"></a><span class="lineno">   26</span><span class="comment">* (WCS) standard.  Refer to the README file provided with WCSLIB for an</span></div>
<div class="line"><a id="l00027" name="l00027"></a><span class="lineno">   27</span><span class="comment">* overview of the library.</span></div>
<div class="line"><a id="l00028" name="l00028"></a><span class="lineno">   28</span><span class="comment">*</span></div>
<div class="line"><a id="l00029" name="l00029"></a><span class="lineno">   29</span><span class="comment">*</span></div>
<div class="line"><a id="l00030" name="l00030"></a><span class="lineno">   30</span><span class="comment">* Summary of the wcs routines</span></div>
<div class="line"><a id="l00031" name="l00031"></a><span class="lineno">   31</span><span class="comment">* ---------------------------</span></div>
<div class="line"><a id="l00032" name="l00032"></a><span class="lineno">   32</span><span class="comment">* Routines in this suite implement the FITS World Coordinate System (WCS)</span></div>
<div class="line"><a id="l00033" name="l00033"></a><span class="lineno">   33</span><span class="comment">* standard which defines methods to be used for computing world coordinates</span></div>
<div class="line"><a id="l00034" name="l00034"></a><span class="lineno">   34</span><span class="comment">* from image pixel coordinates, and vice versa.  The standard, and proposed</span></div>
<div class="line"><a id="l00035" name="l00035"></a><span class="lineno">   35</span><span class="comment">* extensions for handling distortions, are described in</span></div>
<div class="line"><a id="l00036" name="l00036"></a><span class="lineno">   36</span><span class="comment">*</span></div>
<div class="line"><a id="l00037" name="l00037"></a><span class="lineno">   37</span><span class="comment">=   &quot;Representations of world coordinates in FITS&quot;,</span></div>
<div class="line"><a id="l00038" name="l00038"></a><span class="lineno">   38</span><span class="comment">=   Greisen, E.W., &amp; Calabretta, M.R. 2002, A&amp;A, 395, 1061 (WCS Paper I)</span></div>
<div class="line"><a id="l00039" name="l00039"></a><span class="lineno">   39</span><span class="comment">=</span></div>
<div class="line"><a id="l00040" name="l00040"></a><span class="lineno">   40</span><span class="comment">=   &quot;Representations of celestial coordinates in FITS&quot;,</span></div>
<div class="line"><a id="l00041" name="l00041"></a><span class="lineno">   41</span><span class="comment">=   Calabretta, M.R., &amp; Greisen, E.W. 2002, A&amp;A, 395, 1077 (WCS Paper II)</span></div>
<div class="line"><a id="l00042" name="l00042"></a><span class="lineno">   42</span><span class="comment">=</span></div>
<div class="line"><a id="l00043" name="l00043"></a><span class="lineno">   43</span><span class="comment">=   &quot;Representations of spectral coordinates in FITS&quot;,</span></div>
<div class="line"><a id="l00044" name="l00044"></a><span class="lineno">   44</span><span class="comment">=   Greisen, E.W., Calabretta, M.R., Valdes, F.G., &amp; Allen, S.L.</span></div>
<div class="line"><a id="l00045" name="l00045"></a><span class="lineno">   45</span><span class="comment">=   2006, A&amp;A, 446, 747 (WCS Paper III)</span></div>
<div class="line"><a id="l00046" name="l00046"></a><span class="lineno">   46</span><span class="comment">=</span></div>
<div class="line"><a id="l00047" name="l00047"></a><span class="lineno">   47</span><span class="comment">=   &quot;Representations of distortions in FITS world coordinate systems&quot;,</span></div>
<div class="line"><a id="l00048" name="l00048"></a><span class="lineno">   48</span><span class="comment">=   Calabretta, M.R. et al. (WCS Paper IV, draft dated 2004/04/22),</span></div>
<div class="line"><a id="l00049" name="l00049"></a><span class="lineno">   49</span><span class="comment">=   available from http://www.atnf.csiro.au/people/Mark.Calabretta</span></div>
<div class="line"><a id="l00050" name="l00050"></a><span class="lineno">   50</span><span class="comment">=</span></div>
<div class="line"><a id="l00051" name="l00051"></a><span class="lineno">   51</span><span class="comment">=   &quot;Mapping on the HEALPix grid&quot;,</span></div>
<div class="line"><a id="l00052" name="l00052"></a><span class="lineno">   52</span><span class="comment">=   Calabretta, M.R., &amp; Roukema, B.F. 2007, MNRAS, 381, 865 (WCS Paper V)</span></div>
<div class="line"><a id="l00053" name="l00053"></a><span class="lineno">   53</span><span class="comment">=</span></div>
<div class="line"><a id="l00054" name="l00054"></a><span class="lineno">   54</span><span class="comment">=   &quot;Representing the &#39;Butterfly&#39; Projection in FITS -- Projection Code XPH&quot;,</span></div>
<div class="line"><a id="l00055" name="l00055"></a><span class="lineno">   55</span><span class="comment">=   Calabretta, M.R., &amp; Lowe, S.R. 2013, PASA, 30, e050 (WCS Paper VI)</span></div>
<div class="line"><a id="l00056" name="l00056"></a><span class="lineno">   56</span><span class="comment">=</span></div>
<div class="line"><a id="l00057" name="l00057"></a><span class="lineno">   57</span><span class="comment">=   &quot;Representations of time coordinates in FITS -</span></div>
<div class="line"><a id="l00058" name="l00058"></a><span class="lineno">   58</span><span class="comment">=    Time and relative dimension in space&quot;,</span></div>
<div class="line"><a id="l00059" name="l00059"></a><span class="lineno">   59</span><span class="comment">=   Rots, A.H., Bunclark, P.S., Calabretta, M.R., Allen, S.L.,</span></div>
<div class="line"><a id="l00060" name="l00060"></a><span class="lineno">   60</span><span class="comment">=   Manchester, R.N., &amp; Thompson, W.T. 2015, A&amp;A, 574, A36 (WCS Paper VII)</span></div>
<div class="line"><a id="l00061" name="l00061"></a><span class="lineno">   61</span><span class="comment">*</span></div>
<div class="line"><a id="l00062" name="l00062"></a><span class="lineno">   62</span><span class="comment">* These routines are based on the wcsprm struct which contains all information</span></div>
<div class="line"><a id="l00063" name="l00063"></a><span class="lineno">   63</span><span class="comment">* needed for the computations.  The struct contains some members that must be</span></div>
<div class="line"><a id="l00064" name="l00064"></a><span class="lineno">   64</span><span class="comment">* set by the user, and others that are maintained by these routines, somewhat</span></div>
<div class="line"><a id="l00065" name="l00065"></a><span class="lineno">   65</span><span class="comment">* like a C++ class but with no encapsulation.</span></div>
<div class="line"><a id="l00066" name="l00066"></a><span class="lineno">   66</span><span class="comment">*</span></div>
<div class="line"><a id="l00067" name="l00067"></a><span class="lineno">   67</span><span class="comment">* wcsnpv(), wcsnps(), wcsini(), wcsinit(), wcssub(), wcsfree(), and wcstrim(),</span></div>
<div class="line"><a id="l00068" name="l00068"></a><span class="lineno">   68</span><span class="comment">* are provided to manage the wcsprm struct, wcssize() computes its total size</span></div>
<div class="line"><a id="l00069" name="l00069"></a><span class="lineno">   69</span><span class="comment">* including allocated memory, and wcsprt() prints its contents.  Refer to the</span></div>
<div class="line"><a id="l00070" name="l00070"></a><span class="lineno">   70</span><span class="comment">* description of the wcsprm struct for an explanation of the anticipated usage</span></div>
<div class="line"><a id="l00071" name="l00071"></a><span class="lineno">   71</span><span class="comment">* of these routines.  wcscopy(), which does a deep copy of one wcsprm struct</span></div>
<div class="line"><a id="l00072" name="l00072"></a><span class="lineno">   72</span><span class="comment">* to another, is defined as a preprocessor macro function that invokes</span></div>
<div class="line"><a id="l00073" name="l00073"></a><span class="lineno">   73</span><span class="comment">* wcssub().</span></div>
<div class="line"><a id="l00074" name="l00074"></a><span class="lineno">   74</span><span class="comment">*</span></div>
<div class="line"><a id="l00075" name="l00075"></a><span class="lineno">   75</span><span class="comment">* wcsperr() prints the error message(s) (if any) stored in a wcsprm struct,</span></div>
<div class="line"><a id="l00076" name="l00076"></a><span class="lineno">   76</span><span class="comment">* and the linprm, celprm, prjprm, spcprm, and tabprm structs that it contains.</span></div>
<div class="line"><a id="l00077" name="l00077"></a><span class="lineno">   77</span><span class="comment">*</span></div>
<div class="line"><a id="l00078" name="l00078"></a><span class="lineno">   78</span><span class="comment">* A setup routine, wcsset(), computes intermediate values in the wcsprm struct</span></div>
<div class="line"><a id="l00079" name="l00079"></a><span class="lineno">   79</span><span class="comment">* from parameters in it that were supplied by the user.  The struct always</span></div>
<div class="line"><a id="l00080" name="l00080"></a><span class="lineno">   80</span><span class="comment">* needs to be set up by wcsset() but this need not be called explicitly -</span></div>
<div class="line"><a id="l00081" name="l00081"></a><span class="lineno">   81</span><span class="comment">* refer to the explanation of wcsprm::flag.</span></div>
<div class="line"><a id="l00082" name="l00082"></a><span class="lineno">   82</span><span class="comment">*</span></div>
<div class="line"><a id="l00083" name="l00083"></a><span class="lineno">   83</span><span class="comment">* wcsp2s() and wcss2p() implement the WCS world coordinate transformations.</span></div>
<div class="line"><a id="l00084" name="l00084"></a><span class="lineno">   84</span><span class="comment">* In fact, they are high level driver routines for the WCS linear,</span></div>
<div class="line"><a id="l00085" name="l00085"></a><span class="lineno">   85</span><span class="comment">* logarithmic, celestial, spectral and tabular transformation routines</span></div>
<div class="line"><a id="l00086" name="l00086"></a><span class="lineno">   86</span><span class="comment">* described in lin.h, log.h, cel.h, spc.h and tab.h.</span></div>
<div class="line"><a id="l00087" name="l00087"></a><span class="lineno">   87</span><span class="comment">*</span></div>
<div class="line"><a id="l00088" name="l00088"></a><span class="lineno">   88</span><span class="comment">* Given either the celestial longitude or latitude plus an element of the</span></div>
<div class="line"><a id="l00089" name="l00089"></a><span class="lineno">   89</span><span class="comment">* pixel coordinate a hybrid routine, wcsmix(), iteratively solves for the</span></div>
<div class="line"><a id="l00090" name="l00090"></a><span class="lineno">   90</span><span class="comment">* unknown elements.</span></div>
<div class="line"><a id="l00091" name="l00091"></a><span class="lineno">   91</span><span class="comment">*</span></div>
<div class="line"><a id="l00092" name="l00092"></a><span class="lineno">   92</span><span class="comment">* wcsccs() changes the celestial coordinate system of a wcsprm struct, for</span></div>
<div class="line"><a id="l00093" name="l00093"></a><span class="lineno">   93</span><span class="comment">* example, from equatorial to galactic, and wcssptr() translates the spectral</span></div>
<div class="line"><a id="l00094" name="l00094"></a><span class="lineno">   94</span><span class="comment">* axis.  For example, a &#39;FREQ&#39; axis may be translated into &#39;ZOPT-F2W&#39; and vice</span></div>
<div class="line"><a id="l00095" name="l00095"></a><span class="lineno">   95</span><span class="comment">* versa.</span></div>
<div class="line"><a id="l00096" name="l00096"></a><span class="lineno">   96</span><span class="comment">*</span></div>
<div class="line"><a id="l00097" name="l00097"></a><span class="lineno">   97</span><span class="comment">* wcslib_version() returns the WCSLIB version number.</span></div>
<div class="line"><a id="l00098" name="l00098"></a><span class="lineno">   98</span><span class="comment">*</span></div>
<div class="line"><a id="l00099" name="l00099"></a><span class="lineno">   99</span><span class="comment">* Quadcube projections:</span></div>
<div class="line"><a id="l00100" name="l00100"></a><span class="lineno">  100</span><span class="comment">* ---------------------</span></div>
<div class="line"><a id="l00101" name="l00101"></a><span class="lineno">  101</span><span class="comment">*   The quadcube projections (TSC, CSC, QSC) may be represented in FITS in</span></div>
<div class="line"><a id="l00102" name="l00102"></a><span class="lineno">  102</span><span class="comment">*   either of two ways:</span></div>
<div class="line"><a id="l00103" name="l00103"></a><span class="lineno">  103</span><span class="comment">*</span></div>
<div class="line"><a id="l00104" name="l00104"></a><span class="lineno">  104</span><span class="comment">*     a: The six faces may be laid out in one plane and numbered as follows:</span></div>
<div class="line"><a id="l00105" name="l00105"></a><span class="lineno">  105</span><span class="comment">*</span></div>
<div class="line"><a id="l00106" name="l00106"></a><span class="lineno">  106</span><span class="comment">=                                 0</span></div>
<div class="line"><a id="l00107" name="l00107"></a><span class="lineno">  107</span><span class="comment">=</span></div>
<div class="line"><a id="l00108" name="l00108"></a><span class="lineno">  108</span><span class="comment">=                        4  3  2  1  4  3  2</span></div>
<div class="line"><a id="l00109" name="l00109"></a><span class="lineno">  109</span><span class="comment">=</span></div>
<div class="line"><a id="l00110" name="l00110"></a><span class="lineno">  110</span><span class="comment">=                                 5</span></div>
<div class="line"><a id="l00111" name="l00111"></a><span class="lineno">  111</span><span class="comment">*</span></div>
<div class="line"><a id="l00112" name="l00112"></a><span class="lineno">  112</span><span class="comment">*        Faces 2, 3 and 4 may appear on one side or the other (or both).  The</span></div>
<div class="line"><a id="l00113" name="l00113"></a><span class="lineno">  113</span><span class="comment">*        world-to-pixel routines map faces 2, 3 and 4 to the left but the</span></div>
<div class="line"><a id="l00114" name="l00114"></a><span class="lineno">  114</span><span class="comment">*        pixel-to-world routines accept them on either side.</span></div>
<div class="line"><a id="l00115" name="l00115"></a><span class="lineno">  115</span><span class="comment">*</span></div>
<div class="line"><a id="l00116" name="l00116"></a><span class="lineno">  116</span><span class="comment">*     b: The &quot;COBE&quot; convention in which the six faces are stored in a</span></div>
<div class="line"><a id="l00117" name="l00117"></a><span class="lineno">  117</span><span class="comment">*        three-dimensional structure using a CUBEFACE axis indexed from</span></div>
<div class="line"><a id="l00118" name="l00118"></a><span class="lineno">  118</span><span class="comment">*        0 to 5 as above.</span></div>
<div class="line"><a id="l00119" name="l00119"></a><span class="lineno">  119</span><span class="comment">*</span></div>
<div class="line"><a id="l00120" name="l00120"></a><span class="lineno">  120</span><span class="comment">*   These routines support both methods; wcsset() determines which is being</span></div>
<div class="line"><a id="l00121" name="l00121"></a><span class="lineno">  121</span><span class="comment">*   used by the presence or absence of a CUBEFACE axis in ctype[].  wcsp2s()</span></div>
<div class="line"><a id="l00122" name="l00122"></a><span class="lineno">  122</span><span class="comment">*   and wcss2p() translate the CUBEFACE axis representation to the single</span></div>
<div class="line"><a id="l00123" name="l00123"></a><span class="lineno">  123</span><span class="comment">*   plane representation understood by the lower-level WCSLIB projection</span></div>
<div class="line"><a id="l00124" name="l00124"></a><span class="lineno">  124</span><span class="comment">*   routines.</span></div>
<div class="line"><a id="l00125" name="l00125"></a><span class="lineno">  125</span><span class="comment">*</span></div>
<div class="line"><a id="l00126" name="l00126"></a><span class="lineno">  126</span><span class="comment">*</span></div>
<div class="line"><a id="l00127" name="l00127"></a><span class="lineno">  127</span><span class="comment">* wcsnpv() - Memory allocation for PVi_ma</span></div>
<div class="line"><a id="l00128" name="l00128"></a><span class="lineno">  128</span><span class="comment">* ---------------------------------------</span></div>
<div class="line"><a id="l00129" name="l00129"></a><span class="lineno">  129</span><span class="comment">* wcsnpv() sets or gets the value of NPVMAX (default 64).  This global</span></div>
<div class="line"><a id="l00130" name="l00130"></a><span class="lineno">  130</span><span class="comment">* variable controls the number of pvcard structs, for holding PVi_ma</span></div>
<div class="line"><a id="l00131" name="l00131"></a><span class="lineno">  131</span><span class="comment">* keyvalues, that wcsini() should allocate space for.  It is also used by</span></div>
<div class="line"><a id="l00132" name="l00132"></a><span class="lineno">  132</span><span class="comment">* wcsinit() as the default value of npvmax.</span></div>
<div class="line"><a id="l00133" name="l00133"></a><span class="lineno">  133</span><span class="comment">*</span></div>
<div class="line"><a id="l00134" name="l00134"></a><span class="lineno">  134</span><span class="comment">* PLEASE NOTE: This function is not thread-safe.</span></div>
<div class="line"><a id="l00135" name="l00135"></a><span class="lineno">  135</span><span class="comment">*</span></div>
<div class="line"><a id="l00136" name="l00136"></a><span class="lineno">  136</span><span class="comment">* Given:</span></div>
<div class="line"><a id="l00137" name="l00137"></a><span class="lineno">  137</span><span class="comment">*   n         int       Value of NPVMAX; ignored if &lt; 0.  Use a value less</span></div>
<div class="line"><a id="l00138" name="l00138"></a><span class="lineno">  138</span><span class="comment">*                       than zero to get the current value.</span></div>
<div class="line"><a id="l00139" name="l00139"></a><span class="lineno">  139</span><span class="comment">*</span></div>
<div class="line"><a id="l00140" name="l00140"></a><span class="lineno">  140</span><span class="comment">* Function return value:</span></div>
<div class="line"><a id="l00141" name="l00141"></a><span class="lineno">  141</span><span class="comment">*             int       Current value of NPVMAX.</span></div>
<div class="line"><a id="l00142" name="l00142"></a><span class="lineno">  142</span><span class="comment">*</span></div>
<div class="line"><a id="l00143" name="l00143"></a><span class="lineno">  143</span><span class="comment">*</span></div>
<div class="line"><a id="l00144" name="l00144"></a><span class="lineno">  144</span><span class="comment">* wcsnps() - Memory allocation for PSi_ma</span></div>
<div class="line"><a id="l00145" name="l00145"></a><span class="lineno">  145</span><span class="comment">* ---------------------------------------</span></div>
<div class="line"><a id="l00146" name="l00146"></a><span class="lineno">  146</span><span class="comment">* wcsnps() sets or gets the value of NPSMAX (default 8).  This global variable</span></div>
<div class="line"><a id="l00147" name="l00147"></a><span class="lineno">  147</span><span class="comment">* controls the number of pscard structs, for holding PSi_ma keyvalues, that</span></div>
<div class="line"><a id="l00148" name="l00148"></a><span class="lineno">  148</span><span class="comment">* wcsini() should allocate space for.  It is also used by wcsinit() as the</span></div>
<div class="line"><a id="l00149" name="l00149"></a><span class="lineno">  149</span><span class="comment">* default value of npsmax.</span></div>
<div class="line"><a id="l00150" name="l00150"></a><span class="lineno">  150</span><span class="comment">*</span></div>
<div class="line"><a id="l00151" name="l00151"></a><span class="lineno">  151</span><span class="comment">* PLEASE NOTE: This function is not thread-safe.</span></div>
<div class="line"><a id="l00152" name="l00152"></a><span class="lineno">  152</span><span class="comment">*</span></div>
<div class="line"><a id="l00153" name="l00153"></a><span class="lineno">  153</span><span class="comment">* Given:</span></div>
<div class="line"><a id="l00154" name="l00154"></a><span class="lineno">  154</span><span class="comment">*   n         int       Value of NPSMAX; ignored if &lt; 0.  Use a value less</span></div>
<div class="line"><a id="l00155" name="l00155"></a><span class="lineno">  155</span><span class="comment">*                       than zero to get the current value.</span></div>
<div class="line"><a id="l00156" name="l00156"></a><span class="lineno">  156</span><span class="comment">*</span></div>
<div class="line"><a id="l00157" name="l00157"></a><span class="lineno">  157</span><span class="comment">* Function return value:</span></div>
<div class="line"><a id="l00158" name="l00158"></a><span class="lineno">  158</span><span class="comment">*             int       Current value of NPSMAX.</span></div>
<div class="line"><a id="l00159" name="l00159"></a><span class="lineno">  159</span><span class="comment">*</span></div>
<div class="line"><a id="l00160" name="l00160"></a><span class="lineno">  160</span><span class="comment">*</span></div>
<div class="line"><a id="l00161" name="l00161"></a><span class="lineno">  161</span><span class="comment">* wcsini() - Default constructor for the wcsprm struct</span></div>
<div class="line"><a id="l00162" name="l00162"></a><span class="lineno">  162</span><span class="comment">* ----------------------------------------------------</span></div>
<div class="line"><a id="l00163" name="l00163"></a><span class="lineno">  163</span><span class="comment">* wcsini() is a thin wrapper on wcsinit().  It invokes it with npvmax,</span></div>
<div class="line"><a id="l00164" name="l00164"></a><span class="lineno">  164</span><span class="comment">* npsmax, and ndpmax set to -1 which causes it to use the values of the</span></div>
<div class="line"><a id="l00165" name="l00165"></a><span class="lineno">  165</span><span class="comment">* global variables NDPMAX, NPSMAX, and NDPMAX.  It is thereby potentially</span></div>
<div class="line"><a id="l00166" name="l00166"></a><span class="lineno">  166</span><span class="comment">* thread-unsafe if these variables are altered dynamically via wcsnpv(),</span></div>
<div class="line"><a id="l00167" name="l00167"></a><span class="lineno">  167</span><span class="comment">* wcsnps(), and disndp().  Use wcsinit() for a thread-safe alternative in</span></div>
<div class="line"><a id="l00168" name="l00168"></a><span class="lineno">  168</span><span class="comment">* this case.</span></div>
<div class="line"><a id="l00169" name="l00169"></a><span class="lineno">  169</span><span class="comment">*</span></div>
<div class="line"><a id="l00170" name="l00170"></a><span class="lineno">  170</span><span class="comment">*</span></div>
<div class="line"><a id="l00171" name="l00171"></a><span class="lineno">  171</span><span class="comment">* wcsinit() - Default constructor for the wcsprm struct</span></div>
<div class="line"><a id="l00172" name="l00172"></a><span class="lineno">  172</span><span class="comment">* -----------------------------------------------------</span></div>
<div class="line"><a id="l00173" name="l00173"></a><span class="lineno">  173</span><span class="comment">* wcsinit() optionally allocates memory for arrays in a wcsprm struct and sets</span></div>
<div class="line"><a id="l00174" name="l00174"></a><span class="lineno">  174</span><span class="comment">* all members of the struct to default values.</span></div>
<div class="line"><a id="l00175" name="l00175"></a><span class="lineno">  175</span><span class="comment">*</span></div>
<div class="line"><a id="l00176" name="l00176"></a><span class="lineno">  176</span><span class="comment">* PLEASE NOTE: every wcsprm struct should be initialized by wcsinit(),</span></div>
<div class="line"><a id="l00177" name="l00177"></a><span class="lineno">  177</span><span class="comment">* possibly repeatedly.  On the first invokation, and only the first</span></div>
<div class="line"><a id="l00178" name="l00178"></a><span class="lineno">  178</span><span class="comment">* invokation, wcsprm::flag must be set to -1 to initialize memory management,</span></div>
<div class="line"><a id="l00179" name="l00179"></a><span class="lineno">  179</span><span class="comment">* regardless of whether wcsinit() will actually be used to allocate memory.</span></div>
<div class="line"><a id="l00180" name="l00180"></a><span class="lineno">  180</span><span class="comment">*</span></div>
<div class="line"><a id="l00181" name="l00181"></a><span class="lineno">  181</span><span class="comment">* Given:</span></div>
<div class="line"><a id="l00182" name="l00182"></a><span class="lineno">  182</span><span class="comment">*   alloc     int       If true, allocate memory unconditionally for the</span></div>
<div class="line"><a id="l00183" name="l00183"></a><span class="lineno">  183</span><span class="comment">*                       crpix, etc. arrays.  Please note that memory is never</span></div>
<div class="line"><a id="l00184" name="l00184"></a><span class="lineno">  184</span><span class="comment">*                       allocated by wcsinit() for the auxprm, tabprm, nor</span></div>
<div class="line"><a id="l00185" name="l00185"></a><span class="lineno">  185</span><span class="comment">*                       wtbarr structs.</span></div>
<div class="line"><a id="l00186" name="l00186"></a><span class="lineno">  186</span><span class="comment">*</span></div>
<div class="line"><a id="l00187" name="l00187"></a><span class="lineno">  187</span><span class="comment">*                       If false, it is assumed that pointers to these arrays</span></div>
<div class="line"><a id="l00188" name="l00188"></a><span class="lineno">  188</span><span class="comment">*                       have been set by the user except if they are null</span></div>
<div class="line"><a id="l00189" name="l00189"></a><span class="lineno">  189</span><span class="comment">*                       pointers in which case memory will be allocated for</span></div>
<div class="line"><a id="l00190" name="l00190"></a><span class="lineno">  190</span><span class="comment">*                       them regardless.  (In other words, setting alloc true</span></div>
<div class="line"><a id="l00191" name="l00191"></a><span class="lineno">  191</span><span class="comment">*                       saves having to initalize these pointers to zero.)</span></div>
<div class="line"><a id="l00192" name="l00192"></a><span class="lineno">  192</span><span class="comment">*</span></div>
<div class="line"><a id="l00193" name="l00193"></a><span class="lineno">  193</span><span class="comment">*   naxis     int       The number of world coordinate axes.  This is used to</span></div>
<div class="line"><a id="l00194" name="l00194"></a><span class="lineno">  194</span><span class="comment">*                       determine the length of the various wcsprm vectors and</span></div>
<div class="line"><a id="l00195" name="l00195"></a><span class="lineno">  195</span><span class="comment">*                       matrices and therefore the amount of memory to</span></div>
<div class="line"><a id="l00196" name="l00196"></a><span class="lineno">  196</span><span class="comment">*                       allocate for them.</span></div>
<div class="line"><a id="l00197" name="l00197"></a><span class="lineno">  197</span><span class="comment">*</span></div>
<div class="line"><a id="l00198" name="l00198"></a><span class="lineno">  198</span><span class="comment">* Given and returned:</span></div>
<div class="line"><a id="l00199" name="l00199"></a><span class="lineno">  199</span><span class="comment">*   wcs       struct wcsprm*</span></div>
<div class="line"><a id="l00200" name="l00200"></a><span class="lineno">  200</span><span class="comment">*                       Coordinate transformation parameters.</span></div>
<div class="line"><a id="l00201" name="l00201"></a><span class="lineno">  201</span><span class="comment">*</span></div>
<div class="line"><a id="l00202" name="l00202"></a><span class="lineno">  202</span><span class="comment">*                       Note that, in order to initialize memory management,</span></div>
<div class="line"><a id="l00203" name="l00203"></a><span class="lineno">  203</span><span class="comment">*                       wcsprm::flag should be set to -1 when wcs is</span></div>
<div class="line"><a id="l00204" name="l00204"></a><span class="lineno">  204</span><span class="comment">*                       initialized for the first time (memory leaks may</span></div>
<div class="line"><a id="l00205" name="l00205"></a><span class="lineno">  205</span><span class="comment">*                       result if it had already been initialized).</span></div>
<div class="line"><a id="l00206" name="l00206"></a><span class="lineno">  206</span><span class="comment">*</span></div>
<div class="line"><a id="l00207" name="l00207"></a><span class="lineno">  207</span><span class="comment">* Given:</span></div>
<div class="line"><a id="l00208" name="l00208"></a><span class="lineno">  208</span><span class="comment">*   npvmax    int       The number of PVi_ma keywords to allocate space for.</span></div>
<div class="line"><a id="l00209" name="l00209"></a><span class="lineno">  209</span><span class="comment">*                       If set to -1, the value of the global variable NPVMAX</span></div>
<div class="line"><a id="l00210" name="l00210"></a><span class="lineno">  210</span><span class="comment">*                       will be used.  This is potentially thread-unsafe if</span></div>
<div class="line"><a id="l00211" name="l00211"></a><span class="lineno">  211</span><span class="comment">*                       wcsnpv() is being used dynamically to alter its value.</span></div>
<div class="line"><a id="l00212" name="l00212"></a><span class="lineno">  212</span><span class="comment">*</span></div>
<div class="line"><a id="l00213" name="l00213"></a><span class="lineno">  213</span><span class="comment">*   npsmax    int       The number of PSi_ma keywords to allocate space for.</span></div>
<div class="line"><a id="l00214" name="l00214"></a><span class="lineno">  214</span><span class="comment">*                       If set to -1, the value of the global variable NPSMAX</span></div>
<div class="line"><a id="l00215" name="l00215"></a><span class="lineno">  215</span><span class="comment">*                       will be used.  This is potentially thread-unsafe if</span></div>
<div class="line"><a id="l00216" name="l00216"></a><span class="lineno">  216</span><span class="comment">*                       wcsnps() is being used dynamically to alter its value.</span></div>
<div class="line"><a id="l00217" name="l00217"></a><span class="lineno">  217</span><span class="comment">*</span></div>
<div class="line"><a id="l00218" name="l00218"></a><span class="lineno">  218</span><span class="comment">*   ndpmax    int       The number of DPja or DQia keywords to allocate space</span></div>
<div class="line"><a id="l00219" name="l00219"></a><span class="lineno">  219</span><span class="comment">*                       for.  If set to -1, the value of the global variable</span></div>
<div class="line"><a id="l00220" name="l00220"></a><span class="lineno">  220</span><span class="comment">*                       NDPMAX will be used.  This is potentially</span></div>
<div class="line"><a id="l00221" name="l00221"></a><span class="lineno">  221</span><span class="comment">*                       thread-unsafe if disndp() is being used dynamically to</span></div>
<div class="line"><a id="l00222" name="l00222"></a><span class="lineno">  222</span><span class="comment">*                       alter its value.</span></div>
<div class="line"><a id="l00223" name="l00223"></a><span class="lineno">  223</span><span class="comment">*</span></div>
<div class="line"><a id="l00224" name="l00224"></a><span class="lineno">  224</span><span class="comment">* Function return value:</span></div>
<div class="line"><a id="l00225" name="l00225"></a><span class="lineno">  225</span><span class="comment">*             int       Status return value:</span></div>
<div class="line"><a id="l00226" name="l00226"></a><span class="lineno">  226</span><span class="comment">*                         0: Success.</span></div>
<div class="line"><a id="l00227" name="l00227"></a><span class="lineno">  227</span><span class="comment">*                         1: Null wcsprm pointer passed.</span></div>
<div class="line"><a id="l00228" name="l00228"></a><span class="lineno">  228</span><span class="comment">*                         2: Memory allocation failed.</span></div>
<div class="line"><a id="l00229" name="l00229"></a><span class="lineno">  229</span><span class="comment">*</span></div>
<div class="line"><a id="l00230" name="l00230"></a><span class="lineno">  230</span><span class="comment">*                       For returns &gt; 1, a detailed error message is set in</span></div>
<div class="line"><a id="l00231" name="l00231"></a><span class="lineno">  231</span><span class="comment">*                       wcsprm::err if enabled, see wcserr_enable().</span></div>
<div class="line"><a id="l00232" name="l00232"></a><span class="lineno">  232</span><span class="comment">*</span></div>
<div class="line"><a id="l00233" name="l00233"></a><span class="lineno">  233</span><span class="comment">*</span></div>
<div class="line"><a id="l00234" name="l00234"></a><span class="lineno">  234</span><span class="comment">* wcsauxi() - Default constructor for the auxprm struct</span></div>
<div class="line"><a id="l00235" name="l00235"></a><span class="lineno">  235</span><span class="comment">* -----------------------------------------------------</span></div>
<div class="line"><a id="l00236" name="l00236"></a><span class="lineno">  236</span><span class="comment">* wcsauxi() optionally allocates memory for an auxprm struct, attaches it to</span></div>
<div class="line"><a id="l00237" name="l00237"></a><span class="lineno">  237</span><span class="comment">* wcsprm, and sets all members of the struct to default values.</span></div>
<div class="line"><a id="l00238" name="l00238"></a><span class="lineno">  238</span><span class="comment">*</span></div>
<div class="line"><a id="l00239" name="l00239"></a><span class="lineno">  239</span><span class="comment">* Given:</span></div>
<div class="line"><a id="l00240" name="l00240"></a><span class="lineno">  240</span><span class="comment">*   alloc     int       If true, allocate memory unconditionally for the</span></div>
<div class="line"><a id="l00241" name="l00241"></a><span class="lineno">  241</span><span class="comment">*                       auxprm struct.</span></div>
<div class="line"><a id="l00242" name="l00242"></a><span class="lineno">  242</span><span class="comment">*</span></div>
<div class="line"><a id="l00243" name="l00243"></a><span class="lineno">  243</span><span class="comment">*                       If false, it is assumed that wcsprm::aux has already</span></div>
<div class="line"><a id="l00244" name="l00244"></a><span class="lineno">  244</span><span class="comment">*                       been set to point to an auxprm struct, in which case</span></div>
<div class="line"><a id="l00245" name="l00245"></a><span class="lineno">  245</span><span class="comment">*                       the user is responsible for managing that memory.</span></div>
<div class="line"><a id="l00246" name="l00246"></a><span class="lineno">  246</span><span class="comment">*                       However, if wcsprm::aux is a null pointer, memory will</span></div>
<div class="line"><a id="l00247" name="l00247"></a><span class="lineno">  247</span><span class="comment">*                       be allocated regardless.  (In other words, setting</span></div>
<div class="line"><a id="l00248" name="l00248"></a><span class="lineno">  248</span><span class="comment">*                       alloc true saves having to initalize the pointer to</span></div>
<div class="line"><a id="l00249" name="l00249"></a><span class="lineno">  249</span><span class="comment">*                       zero.)</span></div>
<div class="line"><a id="l00250" name="l00250"></a><span class="lineno">  250</span><span class="comment">*</span></div>
<div class="line"><a id="l00251" name="l00251"></a><span class="lineno">  251</span><span class="comment">* Given and returned:</span></div>
<div class="line"><a id="l00252" name="l00252"></a><span class="lineno">  252</span><span class="comment">*   wcs       struct wcsprm*</span></div>
<div class="line"><a id="l00253" name="l00253"></a><span class="lineno">  253</span><span class="comment">*                       Coordinate transformation parameters.</span></div>
<div class="line"><a id="l00254" name="l00254"></a><span class="lineno">  254</span><span class="comment">*</span></div>
<div class="line"><a id="l00255" name="l00255"></a><span class="lineno">  255</span><span class="comment">* Function return value:</span></div>
<div class="line"><a id="l00256" name="l00256"></a><span class="lineno">  256</span><span class="comment">*             int       Status return value:</span></div>
<div class="line"><a id="l00257" name="l00257"></a><span class="lineno">  257</span><span class="comment">*                         0: Success.</span></div>
<div class="line"><a id="l00258" name="l00258"></a><span class="lineno">  258</span><span class="comment">*                         1: Null wcsprm pointer passed.</span></div>
<div class="line"><a id="l00259" name="l00259"></a><span class="lineno">  259</span><span class="comment">*                         2: Memory allocation failed.</span></div>
<div class="line"><a id="l00260" name="l00260"></a><span class="lineno">  260</span><span class="comment">*</span></div>
<div class="line"><a id="l00261" name="l00261"></a><span class="lineno">  261</span><span class="comment">*</span></div>
<div class="line"><a id="l00262" name="l00262"></a><span class="lineno">  262</span><span class="comment">* wcssub() - Subimage extraction routine for the wcsprm struct</span></div>
<div class="line"><a id="l00263" name="l00263"></a><span class="lineno">  263</span><span class="comment">* ------------------------------------------------------------</span></div>
<div class="line"><a id="l00264" name="l00264"></a><span class="lineno">  264</span><span class="comment">* wcssub() extracts the coordinate description for a subimage from a wcsprm</span></div>
<div class="line"><a id="l00265" name="l00265"></a><span class="lineno">  265</span><span class="comment">* struct.  It does a deep copy, using wcsinit() to allocate memory for its</span></div>
<div class="line"><a id="l00266" name="l00266"></a><span class="lineno">  266</span><span class="comment">* arrays if required.  Only the &quot;information to be provided&quot; part of the</span></div>
<div class="line"><a id="l00267" name="l00267"></a><span class="lineno">  267</span><span class="comment">* struct is extracted.  Consequently, wcsset() need not have been, and won&#39;t</span></div>
<div class="line"><a id="l00268" name="l00268"></a><span class="lineno">  268</span><span class="comment">* be invoked on the struct from which the subimage is extracted.  A call to</span></div>
<div class="line"><a id="l00269" name="l00269"></a><span class="lineno">  269</span><span class="comment">* wcsset() is required to set up the subimage struct.</span></div>
<div class="line"><a id="l00270" name="l00270"></a><span class="lineno">  270</span><span class="comment">*</span></div>
<div class="line"><a id="l00271" name="l00271"></a><span class="lineno">  271</span><span class="comment">* The world coordinate system of the subimage must be separable in the sense</span></div>
<div class="line"><a id="l00272" name="l00272"></a><span class="lineno">  272</span><span class="comment">* that the world coordinates at any point in the subimage must depend only on</span></div>
<div class="line"><a id="l00273" name="l00273"></a><span class="lineno">  273</span><span class="comment">* the pixel coordinates of the axes extracted.  In practice, this means that</span></div>
<div class="line"><a id="l00274" name="l00274"></a><span class="lineno">  274</span><span class="comment">* the linear transformation matrix of the original image must not contain</span></div>
<div class="line"><a id="l00275" name="l00275"></a><span class="lineno">  275</span><span class="comment">* non-zero off-diagonal terms that associate any of the subimage axes with any</span></div>
<div class="line"><a id="l00276" name="l00276"></a><span class="lineno">  276</span><span class="comment">* of the non-subimage axes.  Likewise, if any distortions are associated with</span></div>
<div class="line"><a id="l00277" name="l00277"></a><span class="lineno">  277</span><span class="comment">* the subimage axes, they must not depend on any of the axes that are not</span></div>
<div class="line"><a id="l00278" name="l00278"></a><span class="lineno">  278</span><span class="comment">* being extracted.</span></div>
<div class="line"><a id="l00279" name="l00279"></a><span class="lineno">  279</span><span class="comment">*</span></div>
<div class="line"><a id="l00280" name="l00280"></a><span class="lineno">  280</span><span class="comment">* Note that while the required elements of the tabprm array are extracted, the</span></div>
<div class="line"><a id="l00281" name="l00281"></a><span class="lineno">  281</span><span class="comment">* wtbarr array is not.  (Thus it is not appropriate to call wcssub() after</span></div>
<div class="line"><a id="l00282" name="l00282"></a><span class="lineno">  282</span><span class="comment">* wcstab() but before filling the tabprm structs - refer to wcshdr.h.)</span></div>
<div class="line"><a id="l00283" name="l00283"></a><span class="lineno">  283</span><span class="comment">*</span></div>
<div class="line"><a id="l00284" name="l00284"></a><span class="lineno">  284</span><span class="comment">* wcssub() can also add axes to a wcsprm struct.  The new axes will be created</span></div>
<div class="line"><a id="l00285" name="l00285"></a><span class="lineno">  285</span><span class="comment">* using the defaults set by wcsinit() which produce a simple, unnamed, linear</span></div>
<div class="line"><a id="l00286" name="l00286"></a><span class="lineno">  286</span><span class="comment">* axis with world coordinate equal to the pixel coordinate.  These default</span></div>
<div class="line"><a id="l00287" name="l00287"></a><span class="lineno">  287</span><span class="comment">* values can be changed afterwards, before invoking wcsset().</span></div>
<div class="line"><a id="l00288" name="l00288"></a><span class="lineno">  288</span><span class="comment">*</span></div>
<div class="line"><a id="l00289" name="l00289"></a><span class="lineno">  289</span><span class="comment">* Given:</span></div>
<div class="line"><a id="l00290" name="l00290"></a><span class="lineno">  290</span><span class="comment">*   alloc     int       If true, allocate memory for the crpix, etc. arrays in</span></div>
<div class="line"><a id="l00291" name="l00291"></a><span class="lineno">  291</span><span class="comment">*                       the destination.  Otherwise, it is assumed that</span></div>
<div class="line"><a id="l00292" name="l00292"></a><span class="lineno">  292</span><span class="comment">*                       pointers to these arrays have been set by the user</span></div>
<div class="line"><a id="l00293" name="l00293"></a><span class="lineno">  293</span><span class="comment">*                       except if they are null pointers in which case memory</span></div>
<div class="line"><a id="l00294" name="l00294"></a><span class="lineno">  294</span><span class="comment">*                       will be allocated for them regardless.</span></div>
<div class="line"><a id="l00295" name="l00295"></a><span class="lineno">  295</span><span class="comment">*</span></div>
<div class="line"><a id="l00296" name="l00296"></a><span class="lineno">  296</span><span class="comment">*   wcssrc    const struct wcsprm*</span></div>
<div class="line"><a id="l00297" name="l00297"></a><span class="lineno">  297</span><span class="comment">*                       Struct to extract from.</span></div>
<div class="line"><a id="l00298" name="l00298"></a><span class="lineno">  298</span><span class="comment">*</span></div>
<div class="line"><a id="l00299" name="l00299"></a><span class="lineno">  299</span><span class="comment">* Given and returned:</span></div>
<div class="line"><a id="l00300" name="l00300"></a><span class="lineno">  300</span><span class="comment">*   nsub      int*</span></div>
<div class="line"><a id="l00301" name="l00301"></a><span class="lineno">  301</span><span class="comment">*   axes      int[]     Vector of length *nsub containing the image axis</span></div>
<div class="line"><a id="l00302" name="l00302"></a><span class="lineno">  302</span><span class="comment">*                       numbers (1-relative) to extract.  Order is</span></div>
<div class="line"><a id="l00303" name="l00303"></a><span class="lineno">  303</span><span class="comment">*                       significant; axes[0] is the axis number of the input</span></div>
<div class="line"><a id="l00304" name="l00304"></a><span class="lineno">  304</span><span class="comment">*                       image that corresponds to the first axis in the</span></div>
<div class="line"><a id="l00305" name="l00305"></a><span class="lineno">  305</span><span class="comment">*                       subimage, etc.</span></div>
<div class="line"><a id="l00306" name="l00306"></a><span class="lineno">  306</span><span class="comment">*</span></div>
<div class="line"><a id="l00307" name="l00307"></a><span class="lineno">  307</span><span class="comment">*                       Use an axis number of 0 to create a new axis using</span></div>
<div class="line"><a id="l00308" name="l00308"></a><span class="lineno">  308</span><span class="comment">*                       the defaults set by wcsinit().  They can be changed</span></div>
<div class="line"><a id="l00309" name="l00309"></a><span class="lineno">  309</span><span class="comment">*                       later.</span></div>
<div class="line"><a id="l00310" name="l00310"></a><span class="lineno">  310</span><span class="comment">*</span></div>
<div class="line"><a id="l00311" name="l00311"></a><span class="lineno">  311</span><span class="comment">*                       nsub (the pointer) may be set to zero, and so also may</span></div>
<div class="line"><a id="l00312" name="l00312"></a><span class="lineno">  312</span><span class="comment">*                       *nsub, which is interpreted to mean all axes in the</span></div>
<div class="line"><a id="l00313" name="l00313"></a><span class="lineno">  313</span><span class="comment">*                       input image; the number of axes will be returned if</span></div>
<div class="line"><a id="l00314" name="l00314"></a><span class="lineno">  314</span><span class="comment">*                       nsub != 0x0.  axes itself (the pointer) may be set to</span></div>
<div class="line"><a id="l00315" name="l00315"></a><span class="lineno">  315</span><span class="comment">*                       zero to indicate the first *nsub axes in their</span></div>
<div class="line"><a id="l00316" name="l00316"></a><span class="lineno">  316</span><span class="comment">*                       original order.</span></div>
<div class="line"><a id="l00317" name="l00317"></a><span class="lineno">  317</span><span class="comment">*</span></div>
<div class="line"><a id="l00318" name="l00318"></a><span class="lineno">  318</span><span class="comment">*                       Set both nsub (or *nsub) and axes to zero to do a deep</span></div>
<div class="line"><a id="l00319" name="l00319"></a><span class="lineno">  319</span><span class="comment">*                       copy of one wcsprm struct to another.</span></div>
<div class="line"><a id="l00320" name="l00320"></a><span class="lineno">  320</span><span class="comment">*</span></div>
<div class="line"><a id="l00321" name="l00321"></a><span class="lineno">  321</span><span class="comment">*                       Subimage extraction by coordinate axis type may be</span></div>
<div class="line"><a id="l00322" name="l00322"></a><span class="lineno">  322</span><span class="comment">*                       done by setting the elements of axes[] to the</span></div>
<div class="line"><a id="l00323" name="l00323"></a><span class="lineno">  323</span><span class="comment">*                       following special preprocessor macro values:</span></div>
<div class="line"><a id="l00324" name="l00324"></a><span class="lineno">  324</span><span class="comment">*</span></div>
<div class="line"><a id="l00325" name="l00325"></a><span class="lineno">  325</span><span class="comment">*                         WCSSUB_LONGITUDE: Celestial longitude.</span></div>
<div class="line"><a id="l00326" name="l00326"></a><span class="lineno">  326</span><span class="comment">*                         WCSSUB_LATITUDE:  Celestial latitude.</span></div>
<div class="line"><a id="l00327" name="l00327"></a><span class="lineno">  327</span><span class="comment">*                         WCSSUB_CUBEFACE:  Quadcube CUBEFACE axis.</span></div>
<div class="line"><a id="l00328" name="l00328"></a><span class="lineno">  328</span><span class="comment">*                         WCSSUB_SPECTRAL:  Spectral axis.</span></div>
<div class="line"><a id="l00329" name="l00329"></a><span class="lineno">  329</span><span class="comment">*                         WCSSUB_STOKES:    Stokes axis.</span></div>
<div class="line"><a id="l00330" name="l00330"></a><span class="lineno">  330</span><span class="comment">*                         WCSSUB_TIME:      Time axis.</span></div>
<div class="line"><a id="l00331" name="l00331"></a><span class="lineno">  331</span><span class="comment">*</span></div>
<div class="line"><a id="l00332" name="l00332"></a><span class="lineno">  332</span><span class="comment">*                       Refer to the notes (below) for further usage examples.</span></div>
<div class="line"><a id="l00333" name="l00333"></a><span class="lineno">  333</span><span class="comment">*</span></div>
<div class="line"><a id="l00334" name="l00334"></a><span class="lineno">  334</span><span class="comment">*                       On return, *nsub will be set to the number of axes in</span></div>
<div class="line"><a id="l00335" name="l00335"></a><span class="lineno">  335</span><span class="comment">*                       the subimage; this may be zero if there were no axes</span></div>
<div class="line"><a id="l00336" name="l00336"></a><span class="lineno">  336</span><span class="comment">*                       of the required type(s) (in which case no memory will</span></div>
<div class="line"><a id="l00337" name="l00337"></a><span class="lineno">  337</span><span class="comment">*                       be allocated).  axes[] will contain the axis numbers</span></div>
<div class="line"><a id="l00338" name="l00338"></a><span class="lineno">  338</span><span class="comment">*                       that were extracted, or 0 for newly created axes.  The</span></div>
<div class="line"><a id="l00339" name="l00339"></a><span class="lineno">  339</span><span class="comment">*                       vector length must be sufficient to contain all axis</span></div>
<div class="line"><a id="l00340" name="l00340"></a><span class="lineno">  340</span><span class="comment">*                       numbers.  No checks are performed to verify that the</span></div>
<div class="line"><a id="l00341" name="l00341"></a><span class="lineno">  341</span><span class="comment">*                       coordinate axes are consistent, this is done by</span></div>
<div class="line"><a id="l00342" name="l00342"></a><span class="lineno">  342</span><span class="comment">*                       wcsset().</span></div>
<div class="line"><a id="l00343" name="l00343"></a><span class="lineno">  343</span><span class="comment">*</span></div>
<div class="line"><a id="l00344" name="l00344"></a><span class="lineno">  344</span><span class="comment">*   wcsdst    struct wcsprm*</span></div>
<div class="line"><a id="l00345" name="l00345"></a><span class="lineno">  345</span><span class="comment">*                       Struct describing the subimage.  wcsprm::flag should</span></div>
<div class="line"><a id="l00346" name="l00346"></a><span class="lineno">  346</span><span class="comment">*                       be set to -1 if wcsdst was not previously initialized</span></div>
<div class="line"><a id="l00347" name="l00347"></a><span class="lineno">  347</span><span class="comment">*                       (memory leaks may result if it was previously</span></div>
<div class="line"><a id="l00348" name="l00348"></a><span class="lineno">  348</span><span class="comment">*                       initialized).</span></div>
<div class="line"><a id="l00349" name="l00349"></a><span class="lineno">  349</span><span class="comment">*</span></div>
<div class="line"><a id="l00350" name="l00350"></a><span class="lineno">  350</span><span class="comment">* Function return value:</span></div>
<div class="line"><a id="l00351" name="l00351"></a><span class="lineno">  351</span><span class="comment">*             int       Status return value:</span></div>
<div class="line"><a id="l00352" name="l00352"></a><span class="lineno">  352</span><span class="comment">*                         0: Success.</span></div>
<div class="line"><a id="l00353" name="l00353"></a><span class="lineno">  353</span><span class="comment">*                         1: Null wcsprm pointer passed.</span></div>
<div class="line"><a id="l00354" name="l00354"></a><span class="lineno">  354</span><span class="comment">*                         2: Memory allocation failed.</span></div>
<div class="line"><a id="l00355" name="l00355"></a><span class="lineno">  355</span><span class="comment">*                        12: Invalid subimage specification.</span></div>
<div class="line"><a id="l00356" name="l00356"></a><span class="lineno">  356</span><span class="comment">*                        13: Non-separable subimage coordinate system.</span></div>
<div class="line"><a id="l00357" name="l00357"></a><span class="lineno">  357</span><span class="comment">*</span></div>
<div class="line"><a id="l00358" name="l00358"></a><span class="lineno">  358</span><span class="comment">*                       For returns &gt; 1, a detailed error message is set in</span></div>
<div class="line"><a id="l00359" name="l00359"></a><span class="lineno">  359</span><span class="comment">*                       wcsprm::err if enabled, see wcserr_enable().</span></div>
<div class="line"><a id="l00360" name="l00360"></a><span class="lineno">  360</span><span class="comment">*</span></div>
<div class="line"><a id="l00361" name="l00361"></a><span class="lineno">  361</span><span class="comment">* Notes:</span></div>
<div class="line"><a id="l00362" name="l00362"></a><span class="lineno">  362</span><span class="comment">*   1: Combinations of subimage axes of particular types may be extracted in</span></div>
<div class="line"><a id="l00363" name="l00363"></a><span class="lineno">  363</span><span class="comment">*      the same order as they occur in the input image by combining</span></div>
<div class="line"><a id="l00364" name="l00364"></a><span class="lineno">  364</span><span class="comment">*      preprocessor codes, for example</span></div>
<div class="line"><a id="l00365" name="l00365"></a><span class="lineno">  365</span><span class="comment">*</span></div>
<div class="line"><a id="l00366" name="l00366"></a><span class="lineno">  366</span><span class="comment">=        *nsub = 1;</span></div>
<div class="line"><a id="l00367" name="l00367"></a><span class="lineno">  367</span><span class="comment">=        axes[0] = WCSSUB_LONGITUDE | WCSSUB_LATITUDE | WCSSUB_SPECTRAL;</span></div>
<div class="line"><a id="l00368" name="l00368"></a><span class="lineno">  368</span><span class="comment">*</span></div>
<div class="line"><a id="l00369" name="l00369"></a><span class="lineno">  369</span><span class="comment">*      would extract the longitude, latitude, and spectral axes in the same</span></div>
<div class="line"><a id="l00370" name="l00370"></a><span class="lineno">  370</span><span class="comment">*      order as the input image.  If one of each were present, *nsub = 3 would</span></div>
<div class="line"><a id="l00371" name="l00371"></a><span class="lineno">  371</span><span class="comment">*      be returned.</span></div>
<div class="line"><a id="l00372" name="l00372"></a><span class="lineno">  372</span><span class="comment">*</span></div>
<div class="line"><a id="l00373" name="l00373"></a><span class="lineno">  373</span><span class="comment">*      For convenience, WCSSUB_CELESTIAL is defined as the combination</span></div>
<div class="line"><a id="l00374" name="l00374"></a><span class="lineno">  374</span><span class="comment">*      WCSSUB_LONGITUDE | WCSSUB_LATITUDE | WCSSUB_CUBEFACE.</span></div>
<div class="line"><a id="l00375" name="l00375"></a><span class="lineno">  375</span><span class="comment">*</span></div>
<div class="line"><a id="l00376" name="l00376"></a><span class="lineno">  376</span><span class="comment">*      The codes may also be negated to extract all but the types specified,</span></div>
<div class="line"><a id="l00377" name="l00377"></a><span class="lineno">  377</span><span class="comment">*      for example</span></div>
<div class="line"><a id="l00378" name="l00378"></a><span class="lineno">  378</span><span class="comment">*</span></div>
<div class="line"><a id="l00379" name="l00379"></a><span class="lineno">  379</span><span class="comment">=        *nsub = 4;</span></div>
<div class="line"><a id="l00380" name="l00380"></a><span class="lineno">  380</span><span class="comment">=        axes[0] = WCSSUB_LONGITUDE;</span></div>
<div class="line"><a id="l00381" name="l00381"></a><span class="lineno">  381</span><span class="comment">=        axes[1] = WCSSUB_LATITUDE;</span></div>
<div class="line"><a id="l00382" name="l00382"></a><span class="lineno">  382</span><span class="comment">=        axes[2] = WCSSUB_CUBEFACE;</span></div>
<div class="line"><a id="l00383" name="l00383"></a><span class="lineno">  383</span><span class="comment">=        axes[3] = -(WCSSUB_SPECTRAL | WCSSUB_STOKES);</span></div>
<div class="line"><a id="l00384" name="l00384"></a><span class="lineno">  384</span><span class="comment">*</span></div>
<div class="line"><a id="l00385" name="l00385"></a><span class="lineno">  385</span><span class="comment">*      The last of these specifies all axis types other than spectral or</span></div>
<div class="line"><a id="l00386" name="l00386"></a><span class="lineno">  386</span><span class="comment">*      Stokes.  Extraction is done in the order specified by axes[] a</span></div>
<div class="line"><a id="l00387" name="l00387"></a><span class="lineno">  387</span><span class="comment">*      longitude axis (if present) would be extracted first (via axes[0]) and</span></div>
<div class="line"><a id="l00388" name="l00388"></a><span class="lineno">  388</span><span class="comment">*      not subsequently (via axes[3]).  Likewise for the latitude and cubeface</span></div>
<div class="line"><a id="l00389" name="l00389"></a><span class="lineno">  389</span><span class="comment">*      axes in this example.</span></div>
<div class="line"><a id="l00390" name="l00390"></a><span class="lineno">  390</span><span class="comment">*</span></div>
<div class="line"><a id="l00391" name="l00391"></a><span class="lineno">  391</span><span class="comment">*      From the foregoing, it is apparent that the value of *nsub returned may</span></div>
<div class="line"><a id="l00392" name="l00392"></a><span class="lineno">  392</span><span class="comment">*      be less than or greater than that given.  However, it will never exceed</span></div>
<div class="line"><a id="l00393" name="l00393"></a><span class="lineno">  393</span><span class="comment">*      the number of axes in the input image (plus the number of newly-created</span></div>
<div class="line"><a id="l00394" name="l00394"></a><span class="lineno">  394</span><span class="comment">*      axes if any were specified on input).</span></div>
<div class="line"><a id="l00395" name="l00395"></a><span class="lineno">  395</span><span class="comment">*</span></div>
<div class="line"><a id="l00396" name="l00396"></a><span class="lineno">  396</span><span class="comment">*</span></div>
<div class="line"><a id="l00397" name="l00397"></a><span class="lineno">  397</span><span class="comment">* wcscompare() - Compare two wcsprm structs for equality</span></div>
<div class="line"><a id="l00398" name="l00398"></a><span class="lineno">  398</span><span class="comment">* ------------------------------------------------------</span></div>
<div class="line"><a id="l00399" name="l00399"></a><span class="lineno">  399</span><span class="comment">* wcscompare() compares two wcsprm structs for equality.</span></div>
<div class="line"><a id="l00400" name="l00400"></a><span class="lineno">  400</span><span class="comment">*</span></div>
<div class="line"><a id="l00401" name="l00401"></a><span class="lineno">  401</span><span class="comment">* Given:</span></div>
<div class="line"><a id="l00402" name="l00402"></a><span class="lineno">  402</span><span class="comment">*   cmp       int       A bit field controlling the strictness of the</span></div>
<div class="line"><a id="l00403" name="l00403"></a><span class="lineno">  403</span><span class="comment">*                       comparison.  When 0, all fields must be identical.</span></div>
<div class="line"><a id="l00404" name="l00404"></a><span class="lineno">  404</span><span class="comment">*</span></div>
<div class="line"><a id="l00405" name="l00405"></a><span class="lineno">  405</span><span class="comment">*                       The following constants may be or&#39;ed together to</span></div>
<div class="line"><a id="l00406" name="l00406"></a><span class="lineno">  406</span><span class="comment">*                       relax the comparison:</span></div>
<div class="line"><a id="l00407" name="l00407"></a><span class="lineno">  407</span><span class="comment">*                         WCSCOMPARE_ANCILLARY: Ignore ancillary keywords</span></div>
<div class="line"><a id="l00408" name="l00408"></a><span class="lineno">  408</span><span class="comment">*                           that don&#39;t change the WCS transformation, such</span></div>
<div class="line"><a id="l00409" name="l00409"></a><span class="lineno">  409</span><span class="comment">*                           as DATE-OBS or EQUINOX.</span></div>
<div class="line"><a id="l00410" name="l00410"></a><span class="lineno">  410</span><span class="comment">*                         WCSCOMPARE_TILING: Ignore integral differences in</span></div>
<div class="line"><a id="l00411" name="l00411"></a><span class="lineno">  411</span><span class="comment">*                           CRPIXja.  This is the &#39;tiling&#39; condition, where</span></div>
<div class="line"><a id="l00412" name="l00412"></a><span class="lineno">  412</span><span class="comment">*                           two WCSes cover different regions of the same</span></div>
<div class="line"><a id="l00413" name="l00413"></a><span class="lineno">  413</span><span class="comment">*                           map projection and align on the same map grid.</span></div>
<div class="line"><a id="l00414" name="l00414"></a><span class="lineno">  414</span><span class="comment">*                         WCSCOMPARE_CRPIX: Ignore any differences at all in</span></div>
<div class="line"><a id="l00415" name="l00415"></a><span class="lineno">  415</span><span class="comment">*                           CRPIXja.  The two WCSes cover different regions</span></div>
<div class="line"><a id="l00416" name="l00416"></a><span class="lineno">  416</span><span class="comment">*                           of the same map projection but may not align on</span></div>
<div class="line"><a id="l00417" name="l00417"></a><span class="lineno">  417</span><span class="comment">*                           the same map grid.  Overrides WCSCOMPARE_TILING.</span></div>
<div class="line"><a id="l00418" name="l00418"></a><span class="lineno">  418</span><span class="comment">*</span></div>
<div class="line"><a id="l00419" name="l00419"></a><span class="lineno">  419</span><span class="comment">*   tol       double    Tolerance for comparison of floating-point values.</span></div>
<div class="line"><a id="l00420" name="l00420"></a><span class="lineno">  420</span><span class="comment">*                       For example, for tol == 1e-6, all floating-point</span></div>
<div class="line"><a id="l00421" name="l00421"></a><span class="lineno">  421</span><span class="comment">*                       values in the structs must be equal to the first 6</span></div>
<div class="line"><a id="l00422" name="l00422"></a><span class="lineno">  422</span><span class="comment">*                       decimal places.  A value of 0 implies exact equality.</span></div>
<div class="line"><a id="l00423" name="l00423"></a><span class="lineno">  423</span><span class="comment">*</span></div>
<div class="line"><a id="l00424" name="l00424"></a><span class="lineno">  424</span><span class="comment">*   wcs1      const struct wcsprm*</span></div>
<div class="line"><a id="l00425" name="l00425"></a><span class="lineno">  425</span><span class="comment">*                       The first wcsprm struct to compare.</span></div>
<div class="line"><a id="l00426" name="l00426"></a><span class="lineno">  426</span><span class="comment">*</span></div>
<div class="line"><a id="l00427" name="l00427"></a><span class="lineno">  427</span><span class="comment">*   wcs2      const struct wcsprm*</span></div>
<div class="line"><a id="l00428" name="l00428"></a><span class="lineno">  428</span><span class="comment">*                       The second wcsprm struct to compare.</span></div>
<div class="line"><a id="l00429" name="l00429"></a><span class="lineno">  429</span><span class="comment">*</span></div>
<div class="line"><a id="l00430" name="l00430"></a><span class="lineno">  430</span><span class="comment">* Returned:</span></div>
<div class="line"><a id="l00431" name="l00431"></a><span class="lineno">  431</span><span class="comment">*   equal     int*      Non-zero when the given structs are equal.</span></div>
<div class="line"><a id="l00432" name="l00432"></a><span class="lineno">  432</span><span class="comment">*</span></div>
<div class="line"><a id="l00433" name="l00433"></a><span class="lineno">  433</span><span class="comment">* Function return value:</span></div>
<div class="line"><a id="l00434" name="l00434"></a><span class="lineno">  434</span><span class="comment">*             int       Status return value:</span></div>
<div class="line"><a id="l00435" name="l00435"></a><span class="lineno">  435</span><span class="comment">*                         0: Success.</span></div>
<div class="line"><a id="l00436" name="l00436"></a><span class="lineno">  436</span><span class="comment">*                         1: Null pointer passed.</span></div>
<div class="line"><a id="l00437" name="l00437"></a><span class="lineno">  437</span><span class="comment">*</span></div>
<div class="line"><a id="l00438" name="l00438"></a><span class="lineno">  438</span><span class="comment">*</span></div>
<div class="line"><a id="l00439" name="l00439"></a><span class="lineno">  439</span><span class="comment">* wcscopy() macro - Copy routine for the wcsprm struct</span></div>
<div class="line"><a id="l00440" name="l00440"></a><span class="lineno">  440</span><span class="comment">* ----------------------------------------------------</span></div>
<div class="line"><a id="l00441" name="l00441"></a><span class="lineno">  441</span><span class="comment">* wcscopy() does a deep copy of one wcsprm struct to another.  As of</span></div>
<div class="line"><a id="l00442" name="l00442"></a><span class="lineno">  442</span><span class="comment">* WCSLIB 3.6, it is implemented as a preprocessor macro that invokes</span></div>
<div class="line"><a id="l00443" name="l00443"></a><span class="lineno">  443</span><span class="comment">* wcssub() with the nsub and axes pointers both set to zero.</span></div>
<div class="line"><a id="l00444" name="l00444"></a><span class="lineno">  444</span><span class="comment">*</span></div>
<div class="line"><a id="l00445" name="l00445"></a><span class="lineno">  445</span><span class="comment">*</span></div>
<div class="line"><a id="l00446" name="l00446"></a><span class="lineno">  446</span><span class="comment">* wcsfree() - Destructor for the wcsprm struct</span></div>
<div class="line"><a id="l00447" name="l00447"></a><span class="lineno">  447</span><span class="comment">* --------------------------------------------</span></div>
<div class="line"><a id="l00448" name="l00448"></a><span class="lineno">  448</span><span class="comment">* wcsfree() frees memory allocated for the wcsprm arrays by wcsinit() and/or</span></div>
<div class="line"><a id="l00449" name="l00449"></a><span class="lineno">  449</span><span class="comment">* wcsset().  wcsinit() records the memory it allocates and wcsfree() will only</span></div>
<div class="line"><a id="l00450" name="l00450"></a><span class="lineno">  450</span><span class="comment">* attempt to free this.</span></div>
<div class="line"><a id="l00451" name="l00451"></a><span class="lineno">  451</span><span class="comment">*</span></div>
<div class="line"><a id="l00452" name="l00452"></a><span class="lineno">  452</span><span class="comment">* PLEASE NOTE: wcsfree() must not be invoked on a wcsprm struct that was not</span></div>
<div class="line"><a id="l00453" name="l00453"></a><span class="lineno">  453</span><span class="comment">* initialized by wcsinit().</span></div>
<div class="line"><a id="l00454" name="l00454"></a><span class="lineno">  454</span><span class="comment">*</span></div>
<div class="line"><a id="l00455" name="l00455"></a><span class="lineno">  455</span><span class="comment">* Given and returned:</span></div>
<div class="line"><a id="l00456" name="l00456"></a><span class="lineno">  456</span><span class="comment">*   wcs       struct wcsprm*</span></div>
<div class="line"><a id="l00457" name="l00457"></a><span class="lineno">  457</span><span class="comment">*                       Coordinate transformation parameters.</span></div>
<div class="line"><a id="l00458" name="l00458"></a><span class="lineno">  458</span><span class="comment">*</span></div>
<div class="line"><a id="l00459" name="l00459"></a><span class="lineno">  459</span><span class="comment">* Function return value:</span></div>
<div class="line"><a id="l00460" name="l00460"></a><span class="lineno">  460</span><span class="comment">*             int       Status return value:</span></div>
<div class="line"><a id="l00461" name="l00461"></a><span class="lineno">  461</span><span class="comment">*                         0: Success.</span></div>
<div class="line"><a id="l00462" name="l00462"></a><span class="lineno">  462</span><span class="comment">*                         1: Null wcsprm pointer passed.</span></div>
<div class="line"><a id="l00463" name="l00463"></a><span class="lineno">  463</span><span class="comment">*</span></div>
<div class="line"><a id="l00464" name="l00464"></a><span class="lineno">  464</span><span class="comment">*</span></div>
<div class="line"><a id="l00465" name="l00465"></a><span class="lineno">  465</span><span class="comment">* wcstrim() - Free unused arrays in the wcsprm struct</span></div>
<div class="line"><a id="l00466" name="l00466"></a><span class="lineno">  466</span><span class="comment">* ---------------------------------------------------</span></div>
<div class="line"><a id="l00467" name="l00467"></a><span class="lineno">  467</span><span class="comment">* wcstrim() frees memory allocated by wcsinit() for arrays in the wcsprm</span></div>
<div class="line"><a id="l00468" name="l00468"></a><span class="lineno">  468</span><span class="comment">* struct that remains unused after it has been set up by wcsset().</span></div>
<div class="line"><a id="l00469" name="l00469"></a><span class="lineno">  469</span><span class="comment">*</span></div>
<div class="line"><a id="l00470" name="l00470"></a><span class="lineno">  470</span><span class="comment">* The free&#39;d array members are associated with FITS WCS keyrecords that are</span></div>
<div class="line"><a id="l00471" name="l00471"></a><span class="lineno">  471</span><span class="comment">* rarely used and usually just bloat the struct: wcsprm::crota, wcsprm::colax,</span></div>
<div class="line"><a id="l00472" name="l00472"></a><span class="lineno">  472</span><span class="comment">* wcsprm::cname, wcsprm::crder, wcsprm::csyer, wcsprm::czphs, and</span></div>
<div class="line"><a id="l00473" name="l00473"></a><span class="lineno">  473</span><span class="comment">* wcsprm::cperi.  If unused, wcsprm::pv, wcsprm::ps, and wcsprm::cd are also</span></div>
<div class="line"><a id="l00474" name="l00474"></a><span class="lineno">  474</span><span class="comment">* freed.</span></div>
<div class="line"><a id="l00475" name="l00475"></a><span class="lineno">  475</span><span class="comment">*</span></div>
<div class="line"><a id="l00476" name="l00476"></a><span class="lineno">  476</span><span class="comment">* Once these arrays have been freed, a test such as</span></div>
<div class="line"><a id="l00477" name="l00477"></a><span class="lineno">  477</span><span class="comment">=</span></div>
<div class="line"><a id="l00478" name="l00478"></a><span class="lineno">  478</span><span class="comment">=        if (!undefined(wcs-&gt;cname[i])) {...}</span></div>
<div class="line"><a id="l00479" name="l00479"></a><span class="lineno">  479</span><span class="comment">=</span></div>
<div class="line"><a id="l00480" name="l00480"></a><span class="lineno">  480</span><span class="comment">* must be protected as follows</span></div>
<div class="line"><a id="l00481" name="l00481"></a><span class="lineno">  481</span><span class="comment">=</span></div>
<div class="line"><a id="l00482" name="l00482"></a><span class="lineno">  482</span><span class="comment">=        if (wcs-&gt;cname &amp;&amp; !undefined(wcs-&gt;cname[i])) {...}</span></div>
<div class="line"><a id="l00483" name="l00483"></a><span class="lineno">  483</span><span class="comment">=</span></div>
<div class="line"><a id="l00484" name="l00484"></a><span class="lineno">  484</span><span class="comment">* In addition, if wcsprm::npv is non-zero but less than wcsprm::npvmax, then</span></div>
<div class="line"><a id="l00485" name="l00485"></a><span class="lineno">  485</span><span class="comment">* the unused space in wcsprm::pv will be recovered (using realloc()).</span></div>
<div class="line"><a id="l00486" name="l00486"></a><span class="lineno">  486</span><span class="comment">* Likewise for wcsprm::ps.</span></div>
<div class="line"><a id="l00487" name="l00487"></a><span class="lineno">  487</span><span class="comment">*</span></div>
<div class="line"><a id="l00488" name="l00488"></a><span class="lineno">  488</span><span class="comment">* Given and returned:</span></div>
<div class="line"><a id="l00489" name="l00489"></a><span class="lineno">  489</span><span class="comment">*   wcs       struct wcsprm*</span></div>
<div class="line"><a id="l00490" name="l00490"></a><span class="lineno">  490</span><span class="comment">*                       Coordinate transformation parameters.</span></div>
<div class="line"><a id="l00491" name="l00491"></a><span class="lineno">  491</span><span class="comment">*</span></div>
<div class="line"><a id="l00492" name="l00492"></a><span class="lineno">  492</span><span class="comment">* Function return value:</span></div>
<div class="line"><a id="l00493" name="l00493"></a><span class="lineno">  493</span><span class="comment">*             int       Status return value:</span></div>
<div class="line"><a id="l00494" name="l00494"></a><span class="lineno">  494</span><span class="comment">*                         0: Success.</span></div>
<div class="line"><a id="l00495" name="l00495"></a><span class="lineno">  495</span><span class="comment">*                         1: Null wcsprm pointer passed.</span></div>
<div class="line"><a id="l00496" name="l00496"></a><span class="lineno">  496</span><span class="comment">*                        14: wcsprm struct is unset.</span></div>
<div class="line"><a id="l00497" name="l00497"></a><span class="lineno">  497</span><span class="comment">*</span></div>
<div class="line"><a id="l00498" name="l00498"></a><span class="lineno">  498</span><span class="comment">*</span></div>
<div class="line"><a id="l00499" name="l00499"></a><span class="lineno">  499</span><span class="comment">* wcssize() - Compute the size of a wcsprm struct</span></div>
<div class="line"><a id="l00500" name="l00500"></a><span class="lineno">  500</span><span class="comment">* -----------------------------------------------</span></div>
<div class="line"><a id="l00501" name="l00501"></a><span class="lineno">  501</span><span class="comment">* wcssize() computes the full size of a wcsprm struct, including allocated</span></div>
<div class="line"><a id="l00502" name="l00502"></a><span class="lineno">  502</span><span class="comment">* memory.</span></div>
<div class="line"><a id="l00503" name="l00503"></a><span class="lineno">  503</span><span class="comment">*</span></div>
<div class="line"><a id="l00504" name="l00504"></a><span class="lineno">  504</span><span class="comment">* Given:</span></div>
<div class="line"><a id="l00505" name="l00505"></a><span class="lineno">  505</span><span class="comment">*   wcs       const struct wcsprm*</span></div>
<div class="line"><a id="l00506" name="l00506"></a><span class="lineno">  506</span><span class="comment">*                       Coordinate transformation parameters.</span></div>
<div class="line"><a id="l00507" name="l00507"></a><span class="lineno">  507</span><span class="comment">*</span></div>
<div class="line"><a id="l00508" name="l00508"></a><span class="lineno">  508</span><span class="comment">*                       If NULL, the base size of the struct and the allocated</span></div>
<div class="line"><a id="l00509" name="l00509"></a><span class="lineno">  509</span><span class="comment">*                       size are both set to zero.</span></div>
<div class="line"><a id="l00510" name="l00510"></a><span class="lineno">  510</span><span class="comment">*</span></div>
<div class="line"><a id="l00511" name="l00511"></a><span class="lineno">  511</span><span class="comment">* Returned:</span></div>
<div class="line"><a id="l00512" name="l00512"></a><span class="lineno">  512</span><span class="comment">*   sizes     int[2]    The first element is the base size of the struct as</span></div>
<div class="line"><a id="l00513" name="l00513"></a><span class="lineno">  513</span><span class="comment">*                       returned by sizeof(struct wcsprm).  The second element</span></div>
<div class="line"><a id="l00514" name="l00514"></a><span class="lineno">  514</span><span class="comment">*                       is the total allocated size, in bytes, assuming that</span></div>
<div class="line"><a id="l00515" name="l00515"></a><span class="lineno">  515</span><span class="comment">*                       the allocation was done by wcsini().  This figure</span></div>
<div class="line"><a id="l00516" name="l00516"></a><span class="lineno">  516</span><span class="comment">*                       includes memory allocated for members of constituent</span></div>
<div class="line"><a id="l00517" name="l00517"></a><span class="lineno">  517</span><span class="comment">*                       structs, such as wcsprm::lin.</span></div>
<div class="line"><a id="l00518" name="l00518"></a><span class="lineno">  518</span><span class="comment">*</span></div>
<div class="line"><a id="l00519" name="l00519"></a><span class="lineno">  519</span><span class="comment">*                       It is not an error for the struct not to have been set</span></div>
<div class="line"><a id="l00520" name="l00520"></a><span class="lineno">  520</span><span class="comment">*                       up via wcsset(), which normally results in additional</span></div>
<div class="line"><a id="l00521" name="l00521"></a><span class="lineno">  521</span><span class="comment">*                       memory allocation. </span></div>
<div class="line"><a id="l00522" name="l00522"></a><span class="lineno">  522</span><span class="comment">*</span></div>
<div class="line"><a id="l00523" name="l00523"></a><span class="lineno">  523</span><span class="comment">* Function return value:</span></div>
<div class="line"><a id="l00524" name="l00524"></a><span class="lineno">  524</span><span class="comment">*             int       Status return value:</span></div>
<div class="line"><a id="l00525" name="l00525"></a><span class="lineno">  525</span><span class="comment">*                         0: Success.</span></div>
<div class="line"><a id="l00526" name="l00526"></a><span class="lineno">  526</span><span class="comment">*</span></div>
<div class="line"><a id="l00527" name="l00527"></a><span class="lineno">  527</span><span class="comment">*</span></div>
<div class="line"><a id="l00528" name="l00528"></a><span class="lineno">  528</span><span class="comment">* auxsize() - Compute the size of a auxprm struct</span></div>
<div class="line"><a id="l00529" name="l00529"></a><span class="lineno">  529</span><span class="comment">* -----------------------------------------------</span></div>
<div class="line"><a id="l00530" name="l00530"></a><span class="lineno">  530</span><span class="comment">* auxsize() computes the full size of an auxprm struct, including allocated</span></div>
<div class="line"><a id="l00531" name="l00531"></a><span class="lineno">  531</span><span class="comment">* memory.</span></div>
<div class="line"><a id="l00532" name="l00532"></a><span class="lineno">  532</span><span class="comment">*</span></div>
<div class="line"><a id="l00533" name="l00533"></a><span class="lineno">  533</span><span class="comment">* Given:</span></div>
<div class="line"><a id="l00534" name="l00534"></a><span class="lineno">  534</span><span class="comment">*   aux       const struct auxprm*</span></div>
<div class="line"><a id="l00535" name="l00535"></a><span class="lineno">  535</span><span class="comment">*                       Auxiliary coordinate information.</span></div>
<div class="line"><a id="l00536" name="l00536"></a><span class="lineno">  536</span><span class="comment">*</span></div>
<div class="line"><a id="l00537" name="l00537"></a><span class="lineno">  537</span><span class="comment">*                       If NULL, the base size of the struct and the allocated</span></div>
<div class="line"><a id="l00538" name="l00538"></a><span class="lineno">  538</span><span class="comment">*                       size are both set to zero.</span></div>
<div class="line"><a id="l00539" name="l00539"></a><span class="lineno">  539</span><span class="comment">*</span></div>
<div class="line"><a id="l00540" name="l00540"></a><span class="lineno">  540</span><span class="comment">* Returned:</span></div>
<div class="line"><a id="l00541" name="l00541"></a><span class="lineno">  541</span><span class="comment">*   sizes     int[2]    The first element is the base size of the struct as</span></div>
<div class="line"><a id="l00542" name="l00542"></a><span class="lineno">  542</span><span class="comment">*                       returned by sizeof(struct auxprm).  The second element</span></div>
<div class="line"><a id="l00543" name="l00543"></a><span class="lineno">  543</span><span class="comment">*                       is the total allocated size, in bytes, currently zero.</span></div>
<div class="line"><a id="l00544" name="l00544"></a><span class="lineno">  544</span><span class="comment">*</span></div>
<div class="line"><a id="l00545" name="l00545"></a><span class="lineno">  545</span><span class="comment">* Function return value:</span></div>
<div class="line"><a id="l00546" name="l00546"></a><span class="lineno">  546</span><span class="comment">*             int       Status return value:</span></div>
<div class="line"><a id="l00547" name="l00547"></a><span class="lineno">  547</span><span class="comment">*                         0: Success.</span></div>
<div class="line"><a id="l00548" name="l00548"></a><span class="lineno">  548</span><span class="comment">*</span></div>
<div class="line"><a id="l00549" name="l00549"></a><span class="lineno">  549</span><span class="comment">*</span></div>
<div class="line"><a id="l00550" name="l00550"></a><span class="lineno">  550</span><span class="comment">* wcsprt() - Print routine for the wcsprm struct</span></div>
<div class="line"><a id="l00551" name="l00551"></a><span class="lineno">  551</span><span class="comment">* ----------------------------------------------</span></div>
<div class="line"><a id="l00552" name="l00552"></a><span class="lineno">  552</span><span class="comment">* wcsprt() prints the contents of a wcsprm struct using wcsprintf().  Mainly</span></div>
<div class="line"><a id="l00553" name="l00553"></a><span class="lineno">  553</span><span class="comment">* intended for diagnostic purposes.</span></div>
<div class="line"><a id="l00554" name="l00554"></a><span class="lineno">  554</span><span class="comment">*</span></div>
<div class="line"><a id="l00555" name="l00555"></a><span class="lineno">  555</span><span class="comment">* Given:</span></div>
<div class="line"><a id="l00556" name="l00556"></a><span class="lineno">  556</span><span class="comment">*   wcs       const struct wcsprm*</span></div>
<div class="line"><a id="l00557" name="l00557"></a><span class="lineno">  557</span><span class="comment">*                       Coordinate transformation parameters.</span></div>
<div class="line"><a id="l00558" name="l00558"></a><span class="lineno">  558</span><span class="comment">*</span></div>
<div class="line"><a id="l00559" name="l00559"></a><span class="lineno">  559</span><span class="comment">* Function return value:</span></div>
<div class="line"><a id="l00560" name="l00560"></a><span class="lineno">  560</span><span class="comment">*             int       Status return value:</span></div>
<div class="line"><a id="l00561" name="l00561"></a><span class="lineno">  561</span><span class="comment">*                         0: Success.</span></div>
<div class="line"><a id="l00562" name="l00562"></a><span class="lineno">  562</span><span class="comment">*                         1: Null wcsprm pointer passed.</span></div>
<div class="line"><a id="l00563" name="l00563"></a><span class="lineno">  563</span><span class="comment">*</span></div>
<div class="line"><a id="l00564" name="l00564"></a><span class="lineno">  564</span><span class="comment">*</span></div>
<div class="line"><a id="l00565" name="l00565"></a><span class="lineno">  565</span><span class="comment">* wcsperr() - Print error messages from a wcsprm struct</span></div>
<div class="line"><a id="l00566" name="l00566"></a><span class="lineno">  566</span><span class="comment">* -----------------------------------------------------</span></div>
<div class="line"><a id="l00567" name="l00567"></a><span class="lineno">  567</span><span class="comment">* wcsperr() prints the error message(s), if any, stored in a wcsprm struct,</span></div>
<div class="line"><a id="l00568" name="l00568"></a><span class="lineno">  568</span><span class="comment">* and the linprm, celprm, prjprm, spcprm, and tabprm structs that it contains.</span></div>
<div class="line"><a id="l00569" name="l00569"></a><span class="lineno">  569</span><span class="comment">* If there are no errors then nothing is printed.  It uses wcserr_prt(), q.v.</span></div>
<div class="line"><a id="l00570" name="l00570"></a><span class="lineno">  570</span><span class="comment">*</span></div>
<div class="line"><a id="l00571" name="l00571"></a><span class="lineno">  571</span><span class="comment">* Given:</span></div>
<div class="line"><a id="l00572" name="l00572"></a><span class="lineno">  572</span><span class="comment">*   wcs       const struct wcsprm*</span></div>
<div class="line"><a id="l00573" name="l00573"></a><span class="lineno">  573</span><span class="comment">*                       Coordinate transformation parameters.</span></div>
<div class="line"><a id="l00574" name="l00574"></a><span class="lineno">  574</span><span class="comment">*</span></div>
<div class="line"><a id="l00575" name="l00575"></a><span class="lineno">  575</span><span class="comment">*   prefix    const char *</span></div>
<div class="line"><a id="l00576" name="l00576"></a><span class="lineno">  576</span><span class="comment">*                       If non-NULL, each output line will be prefixed with</span></div>
<div class="line"><a id="l00577" name="l00577"></a><span class="lineno">  577</span><span class="comment">*                       this string.</span></div>
<div class="line"><a id="l00578" name="l00578"></a><span class="lineno">  578</span><span class="comment">*</span></div>
<div class="line"><a id="l00579" name="l00579"></a><span class="lineno">  579</span><span class="comment">* Function return value:</span></div>
<div class="line"><a id="l00580" name="l00580"></a><span class="lineno">  580</span><span class="comment">*             int       Status return value:</span></div>
<div class="line"><a id="l00581" name="l00581"></a><span class="lineno">  581</span><span class="comment">*                         0: Success.</span></div>
<div class="line"><a id="l00582" name="l00582"></a><span class="lineno">  582</span><span class="comment">*                         1: Null wcsprm pointer passed.</span></div>
<div class="line"><a id="l00583" name="l00583"></a><span class="lineno">  583</span><span class="comment">*</span></div>
<div class="line"><a id="l00584" name="l00584"></a><span class="lineno">  584</span><span class="comment">*</span></div>
<div class="line"><a id="l00585" name="l00585"></a><span class="lineno">  585</span><span class="comment">* wcsbchk() - Enable/disable bounds checking</span></div>
<div class="line"><a id="l00586" name="l00586"></a><span class="lineno">  586</span><span class="comment">* ------------------------------------------</span></div>
<div class="line"><a id="l00587" name="l00587"></a><span class="lineno">  587</span><span class="comment">* wcsbchk() is used to control bounds checking in the projection routines.</span></div>
<div class="line"><a id="l00588" name="l00588"></a><span class="lineno">  588</span><span class="comment">* Note that wcsset() always enables bounds checking.  wcsbchk() will invoke</span></div>
<div class="line"><a id="l00589" name="l00589"></a><span class="lineno">  589</span><span class="comment">* wcsset() on the wcsprm struct beforehand if necessary.</span></div>
<div class="line"><a id="l00590" name="l00590"></a><span class="lineno">  590</span><span class="comment">*</span></div>
<div class="line"><a id="l00591" name="l00591"></a><span class="lineno">  591</span><span class="comment">* Given and returned:</span></div>
<div class="line"><a id="l00592" name="l00592"></a><span class="lineno">  592</span><span class="comment">*   wcs       struct wcsprm*</span></div>
<div class="line"><a id="l00593" name="l00593"></a><span class="lineno">  593</span><span class="comment">*                       Coordinate transformation parameters.</span></div>
<div class="line"><a id="l00594" name="l00594"></a><span class="lineno">  594</span><span class="comment">*</span></div>
<div class="line"><a id="l00595" name="l00595"></a><span class="lineno">  595</span><span class="comment">* Given:</span></div>
<div class="line"><a id="l00596" name="l00596"></a><span class="lineno">  596</span><span class="comment">*   bounds    int       If bounds&amp;1 then enable strict bounds checking for the</span></div>
<div class="line"><a id="l00597" name="l00597"></a><span class="lineno">  597</span><span class="comment">*                       spherical-to-Cartesian (s2x) transformation for the</span></div>
<div class="line"><a id="l00598" name="l00598"></a><span class="lineno">  598</span><span class="comment">*                       AZP, SZP, TAN, SIN, ZPN, and COP projections.</span></div>
<div class="line"><a id="l00599" name="l00599"></a><span class="lineno">  599</span><span class="comment">*</span></div>
<div class="line"><a id="l00600" name="l00600"></a><span class="lineno">  600</span><span class="comment">*                       If bounds&amp;2 then enable strict bounds checking for the</span></div>
<div class="line"><a id="l00601" name="l00601"></a><span class="lineno">  601</span><span class="comment">*                       Cartesian-to-spherical (x2s) transformation for the</span></div>
<div class="line"><a id="l00602" name="l00602"></a><span class="lineno">  602</span><span class="comment">*                       HPX and XPH projections.</span></div>
<div class="line"><a id="l00603" name="l00603"></a><span class="lineno">  603</span><span class="comment">*</span></div>
<div class="line"><a id="l00604" name="l00604"></a><span class="lineno">  604</span><span class="comment">*                       If bounds&amp;4 then enable bounds checking on the native</span></div>
<div class="line"><a id="l00605" name="l00605"></a><span class="lineno">  605</span><span class="comment">*                       coordinates returned by the Cartesian-to-spherical</span></div>
<div class="line"><a id="l00606" name="l00606"></a><span class="lineno">  606</span><span class="comment">*                       (x2s) transformations using prjchk().</span></div>
<div class="line"><a id="l00607" name="l00607"></a><span class="lineno">  607</span><span class="comment">*</span></div>
<div class="line"><a id="l00608" name="l00608"></a><span class="lineno">  608</span><span class="comment">*                       Zero it to disable all checking.</span></div>
<div class="line"><a id="l00609" name="l00609"></a><span class="lineno">  609</span><span class="comment">*</span></div>
<div class="line"><a id="l00610" name="l00610"></a><span class="lineno">  610</span><span class="comment">* Function return value:</span></div>
<div class="line"><a id="l00611" name="l00611"></a><span class="lineno">  611</span><span class="comment">*             int       Status return value:</span></div>
<div class="line"><a id="l00612" name="l00612"></a><span class="lineno">  612</span><span class="comment">*                         0: Success.</span></div>
<div class="line"><a id="l00613" name="l00613"></a><span class="lineno">  613</span><span class="comment">*                         1: Null wcsprm pointer passed.</span></div>
<div class="line"><a id="l00614" name="l00614"></a><span class="lineno">  614</span><span class="comment">*</span></div>
<div class="line"><a id="l00615" name="l00615"></a><span class="lineno">  615</span><span class="comment">*</span></div>
<div class="line"><a id="l00616" name="l00616"></a><span class="lineno">  616</span><span class="comment">* wcsset() - Setup routine for the wcsprm struct</span></div>
<div class="line"><a id="l00617" name="l00617"></a><span class="lineno">  617</span><span class="comment">* ----------------------------------------------</span></div>
<div class="line"><a id="l00618" name="l00618"></a><span class="lineno">  618</span><span class="comment">* wcsset() sets up a wcsprm struct according to information supplied within</span></div>
<div class="line"><a id="l00619" name="l00619"></a><span class="lineno">  619</span><span class="comment">* it (refer to the description of the wcsprm struct).</span></div>
<div class="line"><a id="l00620" name="l00620"></a><span class="lineno">  620</span><span class="comment">*</span></div>
<div class="line"><a id="l00621" name="l00621"></a><span class="lineno">  621</span><span class="comment">* wcsset() recognizes the NCP projection and converts it to the equivalent SIN</span></div>
<div class="line"><a id="l00622" name="l00622"></a><span class="lineno">  622</span><span class="comment">* projection and likewise translates GLS into SFL.  It also translates the</span></div>
<div class="line"><a id="l00623" name="l00623"></a><span class="lineno">  623</span><span class="comment">* AIPS spectral types (&#39;FREQ-LSR&#39;, &#39;FELO-HEL&#39;, etc.), possibly changing the</span></div>
<div class="line"><a id="l00624" name="l00624"></a><span class="lineno">  624</span><span class="comment">* input header keywords wcsprm::ctype and/or wcsprm::specsys if necessary.</span></div>
<div class="line"><a id="l00625" name="l00625"></a><span class="lineno">  625</span><span class="comment">*</span></div>
<div class="line"><a id="l00626" name="l00626"></a><span class="lineno">  626</span><span class="comment">* Note that this routine need not be called directly; it will be invoked by</span></div>
<div class="line"><a id="l00627" name="l00627"></a><span class="lineno">  627</span><span class="comment">* wcsp2s() and wcss2p() if the wcsprm::flag is anything other than a</span></div>
<div class="line"><a id="l00628" name="l00628"></a><span class="lineno">  628</span><span class="comment">* predefined magic value.</span></div>
<div class="line"><a id="l00629" name="l00629"></a><span class="lineno">  629</span><span class="comment">*</span></div>
<div class="line"><a id="l00630" name="l00630"></a><span class="lineno">  630</span><span class="comment">* Given and returned:</span></div>
<div class="line"><a id="l00631" name="l00631"></a><span class="lineno">  631</span><span class="comment">*   wcs       struct wcsprm*</span></div>
<div class="line"><a id="l00632" name="l00632"></a><span class="lineno">  632</span><span class="comment">*                       Coordinate transformation parameters.</span></div>
<div class="line"><a id="l00633" name="l00633"></a><span class="lineno">  633</span><span class="comment">*</span></div>
<div class="line"><a id="l00634" name="l00634"></a><span class="lineno">  634</span><span class="comment">* Function return value:</span></div>
<div class="line"><a id="l00635" name="l00635"></a><span class="lineno">  635</span><span class="comment">*             int       Status return value:</span></div>
<div class="line"><a id="l00636" name="l00636"></a><span class="lineno">  636</span><span class="comment">*                         0: Success.</span></div>
<div class="line"><a id="l00637" name="l00637"></a><span class="lineno">  637</span><span class="comment">*                         1: Null wcsprm pointer passed.</span></div>
<div class="line"><a id="l00638" name="l00638"></a><span class="lineno">  638</span><span class="comment">*                         2: Memory allocation failed.</span></div>
<div class="line"><a id="l00639" name="l00639"></a><span class="lineno">  639</span><span class="comment">*                         3: Linear transformation matrix is singular.</span></div>
<div class="line"><a id="l00640" name="l00640"></a><span class="lineno">  640</span><span class="comment">*                         4: Inconsistent or unrecognized coordinate axis</span></div>
<div class="line"><a id="l00641" name="l00641"></a><span class="lineno">  641</span><span class="comment">*                            types.</span></div>
<div class="line"><a id="l00642" name="l00642"></a><span class="lineno">  642</span><span class="comment">*                         5: Invalid parameter value.</span></div>
<div class="line"><a id="l00643" name="l00643"></a><span class="lineno">  643</span><span class="comment">*                         6: Invalid coordinate transformation parameters.</span></div>
<div class="line"><a id="l00644" name="l00644"></a><span class="lineno">  644</span><span class="comment">*                         7: Ill-conditioned coordinate transformation</span></div>
<div class="line"><a id="l00645" name="l00645"></a><span class="lineno">  645</span><span class="comment">*                            parameters.</span></div>
<div class="line"><a id="l00646" name="l00646"></a><span class="lineno">  646</span><span class="comment">*</span></div>
<div class="line"><a id="l00647" name="l00647"></a><span class="lineno">  647</span><span class="comment">*                       For returns &gt; 1, a detailed error message is set in</span></div>
<div class="line"><a id="l00648" name="l00648"></a><span class="lineno">  648</span><span class="comment">*                       wcsprm::err if enabled, see wcserr_enable().</span></div>
<div class="line"><a id="l00649" name="l00649"></a><span class="lineno">  649</span><span class="comment">*</span></div>
<div class="line"><a id="l00650" name="l00650"></a><span class="lineno">  650</span><span class="comment">* Notes:</span></div>
<div class="line"><a id="l00651" name="l00651"></a><span class="lineno">  651</span><span class="comment">*   1: wcsset() always enables strict bounds checking in the projection</span></div>
<div class="line"><a id="l00652" name="l00652"></a><span class="lineno">  652</span><span class="comment">*      routines (via a call to prjini()).  Use wcsbchk() to modify</span></div>
<div class="line"><a id="l00653" name="l00653"></a><span class="lineno">  653</span><span class="comment">*      bounds-checking after wcsset() is invoked.</span></div>
<div class="line"><a id="l00654" name="l00654"></a><span class="lineno">  654</span><span class="comment">*</span></div>
<div class="line"><a id="l00655" name="l00655"></a><span class="lineno">  655</span><span class="comment">*</span></div>
<div class="line"><a id="l00656" name="l00656"></a><span class="lineno">  656</span><span class="comment">* wcsp2s() - Pixel-to-world transformation</span></div>
<div class="line"><a id="l00657" name="l00657"></a><span class="lineno">  657</span><span class="comment">* ----------------------------------------</span></div>
<div class="line"><a id="l00658" name="l00658"></a><span class="lineno">  658</span><span class="comment">* wcsp2s() transforms pixel coordinates to world coordinates.</span></div>
<div class="line"><a id="l00659" name="l00659"></a><span class="lineno">  659</span><span class="comment">*</span></div>
<div class="line"><a id="l00660" name="l00660"></a><span class="lineno">  660</span><span class="comment">* Given and returned:</span></div>
<div class="line"><a id="l00661" name="l00661"></a><span class="lineno">  661</span><span class="comment">*   wcs       struct wcsprm*</span></div>
<div class="line"><a id="l00662" name="l00662"></a><span class="lineno">  662</span><span class="comment">*                       Coordinate transformation parameters.</span></div>
<div class="line"><a id="l00663" name="l00663"></a><span class="lineno">  663</span><span class="comment">*</span></div>
<div class="line"><a id="l00664" name="l00664"></a><span class="lineno">  664</span><span class="comment">* Given:</span></div>
<div class="line"><a id="l00665" name="l00665"></a><span class="lineno">  665</span><span class="comment">*   ncoord,</span></div>
<div class="line"><a id="l00666" name="l00666"></a><span class="lineno">  666</span><span class="comment">*   nelem     int       The number of coordinates, each of vector length</span></div>
<div class="line"><a id="l00667" name="l00667"></a><span class="lineno">  667</span><span class="comment">*                       nelem but containing wcs.naxis coordinate elements.</span></div>
<div class="line"><a id="l00668" name="l00668"></a><span class="lineno">  668</span><span class="comment">*                       Thus nelem must equal or exceed the value of the</span></div>
<div class="line"><a id="l00669" name="l00669"></a><span class="lineno">  669</span><span class="comment">*                       NAXIS keyword unless ncoord == 1, in which case nelem</span></div>
<div class="line"><a id="l00670" name="l00670"></a><span class="lineno">  670</span><span class="comment">*                       is not used.</span></div>
<div class="line"><a id="l00671" name="l00671"></a><span class="lineno">  671</span><span class="comment">*</span></div>
<div class="line"><a id="l00672" name="l00672"></a><span class="lineno">  672</span><span class="comment">*   pixcrd    const double[ncoord][nelem]</span></div>
<div class="line"><a id="l00673" name="l00673"></a><span class="lineno">  673</span><span class="comment">*                       Array of pixel coordinates.</span></div>
<div class="line"><a id="l00674" name="l00674"></a><span class="lineno">  674</span><span class="comment">*</span></div>
<div class="line"><a id="l00675" name="l00675"></a><span class="lineno">  675</span><span class="comment">* Returned:</span></div>
<div class="line"><a id="l00676" name="l00676"></a><span class="lineno">  676</span><span class="comment">*   imgcrd    double[ncoord][nelem]</span></div>
<div class="line"><a id="l00677" name="l00677"></a><span class="lineno">  677</span><span class="comment">*                       Array of intermediate world coordinates.  For</span></div>
<div class="line"><a id="l00678" name="l00678"></a><span class="lineno">  678</span><span class="comment">*                       celestial axes, imgcrd[][wcs.lng] and</span></div>
<div class="line"><a id="l00679" name="l00679"></a><span class="lineno">  679</span><span class="comment">*                       imgcrd[][wcs.lat] are the projected x-, and</span></div>
<div class="line"><a id="l00680" name="l00680"></a><span class="lineno">  680</span><span class="comment">*                       y-coordinates in pseudo &quot;degrees&quot;.  For spectral</span></div>
<div class="line"><a id="l00681" name="l00681"></a><span class="lineno">  681</span><span class="comment">*                       axes, imgcrd[][wcs.spec] is the intermediate spectral</span></div>
<div class="line"><a id="l00682" name="l00682"></a><span class="lineno">  682</span><span class="comment">*                       coordinate, in SI units.  For time axes,</span></div>
<div class="line"><a id="l00683" name="l00683"></a><span class="lineno">  683</span><span class="comment">*                       imgcrd[][wcs.time] is the intermediate time</span></div>
<div class="line"><a id="l00684" name="l00684"></a><span class="lineno">  684</span><span class="comment">*                       coordinate.</span></div>
<div class="line"><a id="l00685" name="l00685"></a><span class="lineno">  685</span><span class="comment">*</span></div>
<div class="line"><a id="l00686" name="l00686"></a><span class="lineno">  686</span><span class="comment">*   phi,theta double[ncoord]</span></div>
<div class="line"><a id="l00687" name="l00687"></a><span class="lineno">  687</span><span class="comment">*                       Longitude and latitude in the native coordinate system</span></div>
<div class="line"><a id="l00688" name="l00688"></a><span class="lineno">  688</span><span class="comment">*                       of the projection [deg].</span></div>
<div class="line"><a id="l00689" name="l00689"></a><span class="lineno">  689</span><span class="comment">*</span></div>
<div class="line"><a id="l00690" name="l00690"></a><span class="lineno">  690</span><span class="comment">*   world     double[ncoord][nelem]</span></div>
<div class="line"><a id="l00691" name="l00691"></a><span class="lineno">  691</span><span class="comment">*                       Array of world coordinates.  For celestial axes,</span></div>
<div class="line"><a id="l00692" name="l00692"></a><span class="lineno">  692</span><span class="comment">*                       world[][wcs.lng] and world[][wcs.lat] are the</span></div>
<div class="line"><a id="l00693" name="l00693"></a><span class="lineno">  693</span><span class="comment">*                       celestial longitude and latitude [deg].  For spectral</span></div>
<div class="line"><a id="l00694" name="l00694"></a><span class="lineno">  694</span><span class="comment">*                       axes, world[][wcs.spec] is the spectral coordinate, in</span></div>
<div class="line"><a id="l00695" name="l00695"></a><span class="lineno">  695</span><span class="comment">*                       SI units.  For time axes, world[][wcs.time] is the</span></div>
<div class="line"><a id="l00696" name="l00696"></a><span class="lineno">  696</span><span class="comment">*                       time coordinate.</span></div>
<div class="line"><a id="l00697" name="l00697"></a><span class="lineno">  697</span><span class="comment">*</span></div>
<div class="line"><a id="l00698" name="l00698"></a><span class="lineno">  698</span><span class="comment">*   stat      int[ncoord]</span></div>
<div class="line"><a id="l00699" name="l00699"></a><span class="lineno">  699</span><span class="comment">*                       Status return value for each coordinate:</span></div>
<div class="line"><a id="l00700" name="l00700"></a><span class="lineno">  700</span><span class="comment">*                         0: Success.</span></div>
<div class="line"><a id="l00701" name="l00701"></a><span class="lineno">  701</span><span class="comment">*                        1+: A bit mask indicating invalid pixel coordinate</span></div>
<div class="line"><a id="l00702" name="l00702"></a><span class="lineno">  702</span><span class="comment">*                            element(s).</span></div>
<div class="line"><a id="l00703" name="l00703"></a><span class="lineno">  703</span><span class="comment">*</span></div>
<div class="line"><a id="l00704" name="l00704"></a><span class="lineno">  704</span><span class="comment">* Function return value:</span></div>
<div class="line"><a id="l00705" name="l00705"></a><span class="lineno">  705</span><span class="comment">*             int       Status return value:</span></div>
<div class="line"><a id="l00706" name="l00706"></a><span class="lineno">  706</span><span class="comment">*                         0: Success.</span></div>
<div class="line"><a id="l00707" name="l00707"></a><span class="lineno">  707</span><span class="comment">*                         1: Null wcsprm pointer passed.</span></div>
<div class="line"><a id="l00708" name="l00708"></a><span class="lineno">  708</span><span class="comment">*                         2: Memory allocation failed.</span></div>
<div class="line"><a id="l00709" name="l00709"></a><span class="lineno">  709</span><span class="comment">*                         3: Linear transformation matrix is singular.</span></div>
<div class="line"><a id="l00710" name="l00710"></a><span class="lineno">  710</span><span class="comment">*                         4: Inconsistent or unrecognized coordinate axis</span></div>
<div class="line"><a id="l00711" name="l00711"></a><span class="lineno">  711</span><span class="comment">*                            types.</span></div>
<div class="line"><a id="l00712" name="l00712"></a><span class="lineno">  712</span><span class="comment">*                         5: Invalid parameter value.</span></div>
<div class="line"><a id="l00713" name="l00713"></a><span class="lineno">  713</span><span class="comment">*                         6: Invalid coordinate transformation parameters.</span></div>
<div class="line"><a id="l00714" name="l00714"></a><span class="lineno">  714</span><span class="comment">*                         7: Ill-conditioned coordinate transformation</span></div>
<div class="line"><a id="l00715" name="l00715"></a><span class="lineno">  715</span><span class="comment">*                            parameters.</span></div>
<div class="line"><a id="l00716" name="l00716"></a><span class="lineno">  716</span><span class="comment">*                         8: One or more of the pixel coordinates were</span></div>
<div class="line"><a id="l00717" name="l00717"></a><span class="lineno">  717</span><span class="comment">*                            invalid, as indicated by the stat vector.</span></div>
<div class="line"><a id="l00718" name="l00718"></a><span class="lineno">  718</span><span class="comment">*</span></div>
<div class="line"><a id="l00719" name="l00719"></a><span class="lineno">  719</span><span class="comment">*                       For returns &gt; 1, a detailed error message is set in</span></div>
<div class="line"><a id="l00720" name="l00720"></a><span class="lineno">  720</span><span class="comment">*                       wcsprm::err if enabled, see wcserr_enable().</span></div>
<div class="line"><a id="l00721" name="l00721"></a><span class="lineno">  721</span><span class="comment">*</span></div>
<div class="line"><a id="l00722" name="l00722"></a><span class="lineno">  722</span><span class="comment">*</span></div>
<div class="line"><a id="l00723" name="l00723"></a><span class="lineno">  723</span><span class="comment">* wcss2p() - World-to-pixel transformation</span></div>
<div class="line"><a id="l00724" name="l00724"></a><span class="lineno">  724</span><span class="comment">* ----------------------------------------</span></div>
<div class="line"><a id="l00725" name="l00725"></a><span class="lineno">  725</span><span class="comment">* wcss2p() transforms world coordinates to pixel coordinates.</span></div>
<div class="line"><a id="l00726" name="l00726"></a><span class="lineno">  726</span><span class="comment">*</span></div>
<div class="line"><a id="l00727" name="l00727"></a><span class="lineno">  727</span><span class="comment">* Given and returned:</span></div>
<div class="line"><a id="l00728" name="l00728"></a><span class="lineno">  728</span><span class="comment">*   wcs       struct wcsprm*</span></div>
<div class="line"><a id="l00729" name="l00729"></a><span class="lineno">  729</span><span class="comment">*                       Coordinate transformation parameters.</span></div>
<div class="line"><a id="l00730" name="l00730"></a><span class="lineno">  730</span><span class="comment">*</span></div>
<div class="line"><a id="l00731" name="l00731"></a><span class="lineno">  731</span><span class="comment">* Given:</span></div>
<div class="line"><a id="l00732" name="l00732"></a><span class="lineno">  732</span><span class="comment">*   ncoord,</span></div>
<div class="line"><a id="l00733" name="l00733"></a><span class="lineno">  733</span><span class="comment">*   nelem     int       The number of coordinates, each of vector length nelem</span></div>
<div class="line"><a id="l00734" name="l00734"></a><span class="lineno">  734</span><span class="comment">*                       but containing wcs.naxis coordinate elements.  Thus</span></div>
<div class="line"><a id="l00735" name="l00735"></a><span class="lineno">  735</span><span class="comment">*                       nelem must equal or exceed the value of the NAXIS</span></div>
<div class="line"><a id="l00736" name="l00736"></a><span class="lineno">  736</span><span class="comment">*                       keyword unless ncoord == 1, in which case nelem is not</span></div>
<div class="line"><a id="l00737" name="l00737"></a><span class="lineno">  737</span><span class="comment">*                       used.</span></div>
<div class="line"><a id="l00738" name="l00738"></a><span class="lineno">  738</span><span class="comment">*</span></div>
<div class="line"><a id="l00739" name="l00739"></a><span class="lineno">  739</span><span class="comment">*   world     const double[ncoord][nelem]</span></div>
<div class="line"><a id="l00740" name="l00740"></a><span class="lineno">  740</span><span class="comment">*                       Array of world coordinates.  For celestial axes,</span></div>
<div class="line"><a id="l00741" name="l00741"></a><span class="lineno">  741</span><span class="comment">*                       world[][wcs.lng] and world[][wcs.lat] are the</span></div>
<div class="line"><a id="l00742" name="l00742"></a><span class="lineno">  742</span><span class="comment">*                       celestial longitude and latitude [deg]. For spectral</span></div>
<div class="line"><a id="l00743" name="l00743"></a><span class="lineno">  743</span><span class="comment">*                       axes, world[][wcs.spec] is the spectral coordinate, in</span></div>
<div class="line"><a id="l00744" name="l00744"></a><span class="lineno">  744</span><span class="comment">*                       SI units.  For time axes, world[][wcs.time] is the</span></div>
<div class="line"><a id="l00745" name="l00745"></a><span class="lineno">  745</span><span class="comment">*                       time coordinate.</span></div>
<div class="line"><a id="l00746" name="l00746"></a><span class="lineno">  746</span><span class="comment">*</span></div>
<div class="line"><a id="l00747" name="l00747"></a><span class="lineno">  747</span><span class="comment">* Returned:</span></div>
<div class="line"><a id="l00748" name="l00748"></a><span class="lineno">  748</span><span class="comment">*   phi,theta double[ncoord]</span></div>
<div class="line"><a id="l00749" name="l00749"></a><span class="lineno">  749</span><span class="comment">*                       Longitude and latitude in the native coordinate</span></div>
<div class="line"><a id="l00750" name="l00750"></a><span class="lineno">  750</span><span class="comment">*                       system of the projection [deg].</span></div>
<div class="line"><a id="l00751" name="l00751"></a><span class="lineno">  751</span><span class="comment">*</span></div>
<div class="line"><a id="l00752" name="l00752"></a><span class="lineno">  752</span><span class="comment">*   imgcrd    double[ncoord][nelem]</span></div>
<div class="line"><a id="l00753" name="l00753"></a><span class="lineno">  753</span><span class="comment">*                       Array of intermediate world coordinates.  For</span></div>
<div class="line"><a id="l00754" name="l00754"></a><span class="lineno">  754</span><span class="comment">*                       celestial axes, imgcrd[][wcs.lng] and</span></div>
<div class="line"><a id="l00755" name="l00755"></a><span class="lineno">  755</span><span class="comment">*                       imgcrd[][wcs.lat] are the projected x-, and</span></div>
<div class="line"><a id="l00756" name="l00756"></a><span class="lineno">  756</span><span class="comment">*                       y-coordinates in pseudo &quot;degrees&quot;.  For quadcube</span></div>
<div class="line"><a id="l00757" name="l00757"></a><span class="lineno">  757</span><span class="comment">*                       projections with a CUBEFACE axis the face number is</span></div>
<div class="line"><a id="l00758" name="l00758"></a><span class="lineno">  758</span><span class="comment">*                       also returned in imgcrd[][wcs.cubeface].  For</span></div>
<div class="line"><a id="l00759" name="l00759"></a><span class="lineno">  759</span><span class="comment">*                       spectral axes, imgcrd[][wcs.spec] is the intermediate</span></div>
<div class="line"><a id="l00760" name="l00760"></a><span class="lineno">  760</span><span class="comment">*                       spectral coordinate, in SI units.  For time axes,</span></div>
<div class="line"><a id="l00761" name="l00761"></a><span class="lineno">  761</span><span class="comment">*                       imgcrd[][wcs.time] is the intermediate time</span></div>
<div class="line"><a id="l00762" name="l00762"></a><span class="lineno">  762</span><span class="comment">*                       coordinate.</span></div>
<div class="line"><a id="l00763" name="l00763"></a><span class="lineno">  763</span><span class="comment">*</span></div>
<div class="line"><a id="l00764" name="l00764"></a><span class="lineno">  764</span><span class="comment">*   pixcrd    double[ncoord][nelem]</span></div>
<div class="line"><a id="l00765" name="l00765"></a><span class="lineno">  765</span><span class="comment">*                       Array of pixel coordinates.</span></div>
<div class="line"><a id="l00766" name="l00766"></a><span class="lineno">  766</span><span class="comment">*</span></div>
<div class="line"><a id="l00767" name="l00767"></a><span class="lineno">  767</span><span class="comment">*   stat      int[ncoord]</span></div>
<div class="line"><a id="l00768" name="l00768"></a><span class="lineno">  768</span><span class="comment">*                       Status return value for each coordinate:</span></div>
<div class="line"><a id="l00769" name="l00769"></a><span class="lineno">  769</span><span class="comment">*                         0: Success.</span></div>
<div class="line"><a id="l00770" name="l00770"></a><span class="lineno">  770</span><span class="comment">*                        1+: A bit mask indicating invalid world coordinate</span></div>
<div class="line"><a id="l00771" name="l00771"></a><span class="lineno">  771</span><span class="comment">*                            element(s).</span></div>
<div class="line"><a id="l00772" name="l00772"></a><span class="lineno">  772</span><span class="comment">*</span></div>
<div class="line"><a id="l00773" name="l00773"></a><span class="lineno">  773</span><span class="comment">* Function return value:</span></div>
<div class="line"><a id="l00774" name="l00774"></a><span class="lineno">  774</span><span class="comment">*             int       Status return value:</span></div>
<div class="line"><a id="l00775" name="l00775"></a><span class="lineno">  775</span><span class="comment">*                         0: Success.</span></div>
<div class="line"><a id="l00776" name="l00776"></a><span class="lineno">  776</span><span class="comment">*                         1: Null wcsprm pointer passed.</span></div>
<div class="line"><a id="l00777" name="l00777"></a><span class="lineno">  777</span><span class="comment">*                         2: Memory allocation failed.</span></div>
<div class="line"><a id="l00778" name="l00778"></a><span class="lineno">  778</span><span class="comment">*                         3: Linear transformation matrix is singular.</span></div>
<div class="line"><a id="l00779" name="l00779"></a><span class="lineno">  779</span><span class="comment">*                         4: Inconsistent or unrecognized coordinate axis</span></div>
<div class="line"><a id="l00780" name="l00780"></a><span class="lineno">  780</span><span class="comment">*                            types.</span></div>
<div class="line"><a id="l00781" name="l00781"></a><span class="lineno">  781</span><span class="comment">*                         5: Invalid parameter value.</span></div>
<div class="line"><a id="l00782" name="l00782"></a><span class="lineno">  782</span><span class="comment">*                         6: Invalid coordinate transformation parameters.</span></div>
<div class="line"><a id="l00783" name="l00783"></a><span class="lineno">  783</span><span class="comment">*                         7: Ill-conditioned coordinate transformation</span></div>
<div class="line"><a id="l00784" name="l00784"></a><span class="lineno">  784</span><span class="comment">*                            parameters.</span></div>
<div class="line"><a id="l00785" name="l00785"></a><span class="lineno">  785</span><span class="comment">*                         9: One or more of the world coordinates were</span></div>
<div class="line"><a id="l00786" name="l00786"></a><span class="lineno">  786</span><span class="comment">*                            invalid, as indicated by the stat vector.</span></div>
<div class="line"><a id="l00787" name="l00787"></a><span class="lineno">  787</span><span class="comment">*</span></div>
<div class="line"><a id="l00788" name="l00788"></a><span class="lineno">  788</span><span class="comment">*                       For returns &gt; 1, a detailed error message is set in</span></div>
<div class="line"><a id="l00789" name="l00789"></a><span class="lineno">  789</span><span class="comment">*                       wcsprm::err if enabled, see wcserr_enable().</span></div>
<div class="line"><a id="l00790" name="l00790"></a><span class="lineno">  790</span><span class="comment">*</span></div>
<div class="line"><a id="l00791" name="l00791"></a><span class="lineno">  791</span><span class="comment">*</span></div>
<div class="line"><a id="l00792" name="l00792"></a><span class="lineno">  792</span><span class="comment">* wcsmix() - Hybrid coordinate transformation</span></div>
<div class="line"><a id="l00793" name="l00793"></a><span class="lineno">  793</span><span class="comment">* -------------------------------------------</span></div>
<div class="line"><a id="l00794" name="l00794"></a><span class="lineno">  794</span><span class="comment">* wcsmix(), given either the celestial longitude or latitude plus an element</span></div>
<div class="line"><a id="l00795" name="l00795"></a><span class="lineno">  795</span><span class="comment">* of the pixel coordinate, solves for the remaining elements by iterating on</span></div>
<div class="line"><a id="l00796" name="l00796"></a><span class="lineno">  796</span><span class="comment">* the unknown celestial coordinate element using wcss2p().  Refer also to the</span></div>
<div class="line"><a id="l00797" name="l00797"></a><span class="lineno">  797</span><span class="comment">* notes below.</span></div>
<div class="line"><a id="l00798" name="l00798"></a><span class="lineno">  798</span><span class="comment">*</span></div>
<div class="line"><a id="l00799" name="l00799"></a><span class="lineno">  799</span><span class="comment">* Given and returned:</span></div>
<div class="line"><a id="l00800" name="l00800"></a><span class="lineno">  800</span><span class="comment">*   wcs       struct wcsprm*</span></div>
<div class="line"><a id="l00801" name="l00801"></a><span class="lineno">  801</span><span class="comment">*                       Indices for the celestial coordinates obtained</span></div>
<div class="line"><a id="l00802" name="l00802"></a><span class="lineno">  802</span><span class="comment">*                       by parsing the wcsprm::ctype[].</span></div>
<div class="line"><a id="l00803" name="l00803"></a><span class="lineno">  803</span><span class="comment">*</span></div>
<div class="line"><a id="l00804" name="l00804"></a><span class="lineno">  804</span><span class="comment">* Given:</span></div>
<div class="line"><a id="l00805" name="l00805"></a><span class="lineno">  805</span><span class="comment">*   mixpix    int       Which element of the pixel coordinate is given.</span></div>
<div class="line"><a id="l00806" name="l00806"></a><span class="lineno">  806</span><span class="comment">*</span></div>
<div class="line"><a id="l00807" name="l00807"></a><span class="lineno">  807</span><span class="comment">*   mixcel    int       Which element of the celestial coordinate is given:</span></div>
<div class="line"><a id="l00808" name="l00808"></a><span class="lineno">  808</span><span class="comment">*                         1: Celestial longitude is given in</span></div>
<div class="line"><a id="l00809" name="l00809"></a><span class="lineno">  809</span><span class="comment">*                            world[wcs.lng], latitude returned in</span></div>
<div class="line"><a id="l00810" name="l00810"></a><span class="lineno">  810</span><span class="comment">*                            world[wcs.lat].</span></div>
<div class="line"><a id="l00811" name="l00811"></a><span class="lineno">  811</span><span class="comment">*                         2: Celestial latitude is given in</span></div>
<div class="line"><a id="l00812" name="l00812"></a><span class="lineno">  812</span><span class="comment">*                            world[wcs.lat], longitude returned in</span></div>
<div class="line"><a id="l00813" name="l00813"></a><span class="lineno">  813</span><span class="comment">*                            world[wcs.lng].</span></div>
<div class="line"><a id="l00814" name="l00814"></a><span class="lineno">  814</span><span class="comment">*</span></div>
<div class="line"><a id="l00815" name="l00815"></a><span class="lineno">  815</span><span class="comment">*   vspan     const double[2]</span></div>
<div class="line"><a id="l00816" name="l00816"></a><span class="lineno">  816</span><span class="comment">*                       Solution interval for the celestial coordinate [deg].</span></div>
<div class="line"><a id="l00817" name="l00817"></a><span class="lineno">  817</span><span class="comment">*                       The ordering of the two limits is irrelevant.</span></div>
<div class="line"><a id="l00818" name="l00818"></a><span class="lineno">  818</span><span class="comment">*                       Longitude ranges may be specified with any convenient</span></div>
<div class="line"><a id="l00819" name="l00819"></a><span class="lineno">  819</span><span class="comment">*                       normalization, for example [-120,+120] is the same as</span></div>
<div class="line"><a id="l00820" name="l00820"></a><span class="lineno">  820</span><span class="comment">*                       [240,480], except that the solution will be returned</span></div>
<div class="line"><a id="l00821" name="l00821"></a><span class="lineno">  821</span><span class="comment">*                       with the same normalization, i.e. lie within the</span></div>
<div class="line"><a id="l00822" name="l00822"></a><span class="lineno">  822</span><span class="comment">*                       interval specified.</span></div>
<div class="line"><a id="l00823" name="l00823"></a><span class="lineno">  823</span><span class="comment">*</span></div>
<div class="line"><a id="l00824" name="l00824"></a><span class="lineno">  824</span><span class="comment">*   vstep     const double</span></div>
<div class="line"><a id="l00825" name="l00825"></a><span class="lineno">  825</span><span class="comment">*                       Step size for solution search [deg].  If zero, a</span></div>
<div class="line"><a id="l00826" name="l00826"></a><span class="lineno">  826</span><span class="comment">*                       sensible, although perhaps non-optimal default will be</span></div>
<div class="line"><a id="l00827" name="l00827"></a><span class="lineno">  827</span><span class="comment">*                       used.</span></div>
<div class="line"><a id="l00828" name="l00828"></a><span class="lineno">  828</span><span class="comment">*</span></div>
<div class="line"><a id="l00829" name="l00829"></a><span class="lineno">  829</span><span class="comment">*   viter     int       If a solution is not found then the step size will be</span></div>
<div class="line"><a id="l00830" name="l00830"></a><span class="lineno">  830</span><span class="comment">*                       halved and the search recommenced.  viter controls how</span></div>
<div class="line"><a id="l00831" name="l00831"></a><span class="lineno">  831</span><span class="comment">*                       many times the step size is halved.  The allowed range</span></div>
<div class="line"><a id="l00832" name="l00832"></a><span class="lineno">  832</span><span class="comment">*                       is 5 - 10.</span></div>
<div class="line"><a id="l00833" name="l00833"></a><span class="lineno">  833</span><span class="comment">*</span></div>
<div class="line"><a id="l00834" name="l00834"></a><span class="lineno">  834</span><span class="comment">* Given and returned:</span></div>
<div class="line"><a id="l00835" name="l00835"></a><span class="lineno">  835</span><span class="comment">*   world     double[naxis]</span></div>
<div class="line"><a id="l00836" name="l00836"></a><span class="lineno">  836</span><span class="comment">*                       World coordinate elements.  world[wcs.lng] and</span></div>
<div class="line"><a id="l00837" name="l00837"></a><span class="lineno">  837</span><span class="comment">*                       world[wcs.lat] are the celestial longitude and</span></div>
<div class="line"><a id="l00838" name="l00838"></a><span class="lineno">  838</span><span class="comment">*                       latitude [deg].  Which is given and which returned</span></div>
<div class="line"><a id="l00839" name="l00839"></a><span class="lineno">  839</span><span class="comment">*                       depends on the value of mixcel.  All other elements</span></div>
<div class="line"><a id="l00840" name="l00840"></a><span class="lineno">  840</span><span class="comment">*                       are given.</span></div>
<div class="line"><a id="l00841" name="l00841"></a><span class="lineno">  841</span><span class="comment">*</span></div>
<div class="line"><a id="l00842" name="l00842"></a><span class="lineno">  842</span><span class="comment">* Returned:</span></div>
<div class="line"><a id="l00843" name="l00843"></a><span class="lineno">  843</span><span class="comment">*   phi,theta double[naxis]</span></div>
<div class="line"><a id="l00844" name="l00844"></a><span class="lineno">  844</span><span class="comment">*                       Longitude and latitude in the native coordinate</span></div>
<div class="line"><a id="l00845" name="l00845"></a><span class="lineno">  845</span><span class="comment">*                       system of the projection [deg].</span></div>
<div class="line"><a id="l00846" name="l00846"></a><span class="lineno">  846</span><span class="comment">*</span></div>
<div class="line"><a id="l00847" name="l00847"></a><span class="lineno">  847</span><span class="comment">*   imgcrd    double[naxis]</span></div>
<div class="line"><a id="l00848" name="l00848"></a><span class="lineno">  848</span><span class="comment">*                       Image coordinate elements.  imgcrd[wcs.lng] and</span></div>
<div class="line"><a id="l00849" name="l00849"></a><span class="lineno">  849</span><span class="comment">*                       imgcrd[wcs.lat] are the projected x-, and</span></div>
<div class="line"><a id="l00850" name="l00850"></a><span class="lineno">  850</span><span class="comment">*                       y-coordinates in pseudo &quot;degrees&quot;.</span></div>
<div class="line"><a id="l00851" name="l00851"></a><span class="lineno">  851</span><span class="comment">*</span></div>
<div class="line"><a id="l00852" name="l00852"></a><span class="lineno">  852</span><span class="comment">* Given and returned:</span></div>
<div class="line"><a id="l00853" name="l00853"></a><span class="lineno">  853</span><span class="comment">*   pixcrd    double[naxis]</span></div>
<div class="line"><a id="l00854" name="l00854"></a><span class="lineno">  854</span><span class="comment">*                       Pixel coordinate.  The element indicated by mixpix is</span></div>
<div class="line"><a id="l00855" name="l00855"></a><span class="lineno">  855</span><span class="comment">*                       given and the remaining elements are returned.</span></div>
<div class="line"><a id="l00856" name="l00856"></a><span class="lineno">  856</span><span class="comment">*</span></div>
<div class="line"><a id="l00857" name="l00857"></a><span class="lineno">  857</span><span class="comment">* Function return value:</span></div>
<div class="line"><a id="l00858" name="l00858"></a><span class="lineno">  858</span><span class="comment">*             int       Status return value:</span></div>
<div class="line"><a id="l00859" name="l00859"></a><span class="lineno">  859</span><span class="comment">*                         0: Success.</span></div>
<div class="line"><a id="l00860" name="l00860"></a><span class="lineno">  860</span><span class="comment">*                         1: Null wcsprm pointer passed.</span></div>
<div class="line"><a id="l00861" name="l00861"></a><span class="lineno">  861</span><span class="comment">*                         2: Memory allocation failed.</span></div>
<div class="line"><a id="l00862" name="l00862"></a><span class="lineno">  862</span><span class="comment">*                         3: Linear transformation matrix is singular.</span></div>
<div class="line"><a id="l00863" name="l00863"></a><span class="lineno">  863</span><span class="comment">*                         4: Inconsistent or unrecognized coordinate axis</span></div>
<div class="line"><a id="l00864" name="l00864"></a><span class="lineno">  864</span><span class="comment">*                            types.</span></div>
<div class="line"><a id="l00865" name="l00865"></a><span class="lineno">  865</span><span class="comment">*                         5: Invalid parameter value.</span></div>
<div class="line"><a id="l00866" name="l00866"></a><span class="lineno">  866</span><span class="comment">*                         6: Invalid coordinate transformation parameters.</span></div>
<div class="line"><a id="l00867" name="l00867"></a><span class="lineno">  867</span><span class="comment">*                         7: Ill-conditioned coordinate transformation</span></div>
<div class="line"><a id="l00868" name="l00868"></a><span class="lineno">  868</span><span class="comment">*                            parameters.</span></div>
<div class="line"><a id="l00869" name="l00869"></a><span class="lineno">  869</span><span class="comment">*                        10: Invalid world coordinate.</span></div>
<div class="line"><a id="l00870" name="l00870"></a><span class="lineno">  870</span><span class="comment">*                        11: No solution found in the specified interval.</span></div>
<div class="line"><a id="l00871" name="l00871"></a><span class="lineno">  871</span><span class="comment">*</span></div>
<div class="line"><a id="l00872" name="l00872"></a><span class="lineno">  872</span><span class="comment">*                       For returns &gt; 1, a detailed error message is set in</span></div>
<div class="line"><a id="l00873" name="l00873"></a><span class="lineno">  873</span><span class="comment">*                       wcsprm::err if enabled, see wcserr_enable().</span></div>
<div class="line"><a id="l00874" name="l00874"></a><span class="lineno">  874</span><span class="comment">*</span></div>
<div class="line"><a id="l00875" name="l00875"></a><span class="lineno">  875</span><span class="comment">* Notes:</span></div>
<div class="line"><a id="l00876" name="l00876"></a><span class="lineno">  876</span><span class="comment">*   1: Initially the specified solution interval is checked to see if it&#39;s a</span></div>
<div class="line"><a id="l00877" name="l00877"></a><span class="lineno">  877</span><span class="comment">*      &quot;crossing&quot; interval.  If it isn&#39;t, a search is made for a crossing</span></div>
<div class="line"><a id="l00878" name="l00878"></a><span class="lineno">  878</span><span class="comment">*      solution by iterating on the unknown celestial coordinate starting at</span></div>
<div class="line"><a id="l00879" name="l00879"></a><span class="lineno">  879</span><span class="comment">*      the upper limit of the solution interval and decrementing by the</span></div>
<div class="line"><a id="l00880" name="l00880"></a><span class="lineno">  880</span><span class="comment">*      specified step size.  A crossing is indicated if the trial value of the</span></div>
<div class="line"><a id="l00881" name="l00881"></a><span class="lineno">  881</span><span class="comment">*      pixel coordinate steps through the value specified.  If a crossing</span></div>
<div class="line"><a id="l00882" name="l00882"></a><span class="lineno">  882</span><span class="comment">*      interval is found then the solution is determined by a modified form of</span></div>
<div class="line"><a id="l00883" name="l00883"></a><span class="lineno">  883</span><span class="comment">*      &quot;regula falsi&quot; division of the crossing interval.  If no crossing</span></div>
<div class="line"><a id="l00884" name="l00884"></a><span class="lineno">  884</span><span class="comment">*      interval was found within the specified solution interval then a search</span></div>
<div class="line"><a id="l00885" name="l00885"></a><span class="lineno">  885</span><span class="comment">*      is made for a &quot;non-crossing&quot; solution as may arise from a point of</span></div>
<div class="line"><a id="l00886" name="l00886"></a><span class="lineno">  886</span><span class="comment">*      tangency.  The process is complicated by having to make allowance for</span></div>
<div class="line"><a id="l00887" name="l00887"></a><span class="lineno">  887</span><span class="comment">*      the discontinuities that occur in all map projections.</span></div>
<div class="line"><a id="l00888" name="l00888"></a><span class="lineno">  888</span><span class="comment">*</span></div>
<div class="line"><a id="l00889" name="l00889"></a><span class="lineno">  889</span><span class="comment">*      Once one solution has been determined others may be found by subsequent</span></div>
<div class="line"><a id="l00890" name="l00890"></a><span class="lineno">  890</span><span class="comment">*      invokations of wcsmix() with suitably restricted solution intervals.</span></div>
<div class="line"><a id="l00891" name="l00891"></a><span class="lineno">  891</span><span class="comment">*</span></div>
<div class="line"><a id="l00892" name="l00892"></a><span class="lineno">  892</span><span class="comment">*      Note the circumstance that arises when the solution point lies at a</span></div>
<div class="line"><a id="l00893" name="l00893"></a><span class="lineno">  893</span><span class="comment">*      native pole of a projection in which the pole is represented as a</span></div>
<div class="line"><a id="l00894" name="l00894"></a><span class="lineno">  894</span><span class="comment">*      finite curve, for example the zenithals and conics.  In such cases two</span></div>
<div class="line"><a id="l00895" name="l00895"></a><span class="lineno">  895</span><span class="comment">*      or more valid solutions may exist but wcsmix() only ever returns one.</span></div>
<div class="line"><a id="l00896" name="l00896"></a><span class="lineno">  896</span><span class="comment">*</span></div>
<div class="line"><a id="l00897" name="l00897"></a><span class="lineno">  897</span><span class="comment">*      Because of its generality wcsmix() is very compute-intensive.  For</span></div>
<div class="line"><a id="l00898" name="l00898"></a><span class="lineno">  898</span><span class="comment">*      compute-limited applications more efficient special-case solvers could</span></div>
<div class="line"><a id="l00899" name="l00899"></a><span class="lineno">  899</span><span class="comment">*      be written for simple projections, for example non-oblique cylindrical</span></div>
<div class="line"><a id="l00900" name="l00900"></a><span class="lineno">  900</span><span class="comment">*      projections.</span></div>
<div class="line"><a id="l00901" name="l00901"></a><span class="lineno">  901</span><span class="comment">*</span></div>
<div class="line"><a id="l00902" name="l00902"></a><span class="lineno">  902</span><span class="comment">*</span></div>
<div class="line"><a id="l00903" name="l00903"></a><span class="lineno">  903</span><span class="comment">* wcsccs() - Change celestial coordinate system</span></div>
<div class="line"><a id="l00904" name="l00904"></a><span class="lineno">  904</span><span class="comment">* ---------------------------------------------</span></div>
<div class="line"><a id="l00905" name="l00905"></a><span class="lineno">  905</span><span class="comment">* wcsccs() changes the celestial coordinate system of a wcsprm struct.  For</span></div>
<div class="line"><a id="l00906" name="l00906"></a><span class="lineno">  906</span><span class="comment">* example, from equatorial to galactic coordinates.</span></div>
<div class="line"><a id="l00907" name="l00907"></a><span class="lineno">  907</span><span class="comment">*</span></div>
<div class="line"><a id="l00908" name="l00908"></a><span class="lineno">  908</span><span class="comment">* Parameters that define the spherical coordinate transformation, essentially</span></div>
<div class="line"><a id="l00909" name="l00909"></a><span class="lineno">  909</span><span class="comment">* being three Euler angles, must be provided.  Thereby wcsccs() does not need</span></div>
<div class="line"><a id="l00910" name="l00910"></a><span class="lineno">  910</span><span class="comment">* prior knowledge of specific celestial coordinate systems.  It also has the</span></div>
<div class="line"><a id="l00911" name="l00911"></a><span class="lineno">  911</span><span class="comment">* advantage of making it completely general.</span></div>
<div class="line"><a id="l00912" name="l00912"></a><span class="lineno">  912</span><span class="comment">*</span></div>
<div class="line"><a id="l00913" name="l00913"></a><span class="lineno">  913</span><span class="comment">* Auxiliary members of the wcsprm struct relating to equatorial celestial</span></div>
<div class="line"><a id="l00914" name="l00914"></a><span class="lineno">  914</span><span class="comment">* coordinate systems may also be changed.</span></div>
<div class="line"><a id="l00915" name="l00915"></a><span class="lineno">  915</span><span class="comment">*</span></div>
<div class="line"><a id="l00916" name="l00916"></a><span class="lineno">  916</span><span class="comment">* Only orthodox spherical coordinate systems are supported.  That is, they</span></div>
<div class="line"><a id="l00917" name="l00917"></a><span class="lineno">  917</span><span class="comment">* must be right-handed, with latitude increasing from zero at the equator to</span></div>
<div class="line"><a id="l00918" name="l00918"></a><span class="lineno">  918</span><span class="comment">* +90 degrees at the pole.  This precludes systems such as aziumuth and zenith</span></div>
<div class="line"><a id="l00919" name="l00919"></a><span class="lineno">  919</span><span class="comment">* distance, which, however, could be handled as negative azimuth and</span></div>
<div class="line"><a id="l00920" name="l00920"></a><span class="lineno">  920</span><span class="comment">* elevation.</span></div>
<div class="line"><a id="l00921" name="l00921"></a><span class="lineno">  921</span><span class="comment">*</span></div>
<div class="line"><a id="l00922" name="l00922"></a><span class="lineno">  922</span><span class="comment">* PLEASE NOTE: Information in the wcsprm struct relating to the original</span></div>
<div class="line"><a id="l00923" name="l00923"></a><span class="lineno">  923</span><span class="comment">* coordinate system will be overwritten and therefore lost.  If this is</span></div>
<div class="line"><a id="l00924" name="l00924"></a><span class="lineno">  924</span><span class="comment">* undesirable, invoke wcsccs() on a copy of the struct made with wcssub().</span></div>
<div class="line"><a id="l00925" name="l00925"></a><span class="lineno">  925</span><span class="comment">* The wcsprm struct is reset on return with an explicit call to wcsset().</span></div>
<div class="line"><a id="l00926" name="l00926"></a><span class="lineno">  926</span><span class="comment">*</span></div>
<div class="line"><a id="l00927" name="l00927"></a><span class="lineno">  927</span><span class="comment">* Given and returned:</span></div>
<div class="line"><a id="l00928" name="l00928"></a><span class="lineno">  928</span><span class="comment">*   wcs       struct wcsprm*</span></div>
<div class="line"><a id="l00929" name="l00929"></a><span class="lineno">  929</span><span class="comment">*                       Coordinate transformation parameters.  Particular</span></div>
<div class="line"><a id="l00930" name="l00930"></a><span class="lineno">  930</span><span class="comment">*                       &quot;values to be given&quot; elements of the wcsprm struct</span></div>
<div class="line"><a id="l00931" name="l00931"></a><span class="lineno">  931</span><span class="comment">*                       are modified.</span></div>
<div class="line"><a id="l00932" name="l00932"></a><span class="lineno">  932</span><span class="comment">*</span></div>
<div class="line"><a id="l00933" name="l00933"></a><span class="lineno">  933</span><span class="comment">* Given:</span></div>
<div class="line"><a id="l00934" name="l00934"></a><span class="lineno">  934</span><span class="comment">*   lng2p1,</span></div>
<div class="line"><a id="l00935" name="l00935"></a><span class="lineno">  935</span><span class="comment">*   lat2p1    double    Longitude and latitude in the new celestial coordinate</span></div>
<div class="line"><a id="l00936" name="l00936"></a><span class="lineno">  936</span><span class="comment">*                       system of the pole (i.e. latitude +90) of the original</span></div>
<div class="line"><a id="l00937" name="l00937"></a><span class="lineno">  937</span><span class="comment">*                       system [deg].  See notes 1 and 2 below.</span></div>
<div class="line"><a id="l00938" name="l00938"></a><span class="lineno">  938</span><span class="comment">*</span></div>
<div class="line"><a id="l00939" name="l00939"></a><span class="lineno">  939</span><span class="comment">*   lng1p2    double    Longitude in the original celestial coordinate system</span></div>
<div class="line"><a id="l00940" name="l00940"></a><span class="lineno">  940</span><span class="comment">*                       of the pole (i.e. latitude +90) of the new system</span></div>
<div class="line"><a id="l00941" name="l00941"></a><span class="lineno">  941</span><span class="comment">*                       [deg].  See note 1 below.</span></div>
<div class="line"><a id="l00942" name="l00942"></a><span class="lineno">  942</span><span class="comment">*</span></div>
<div class="line"><a id="l00943" name="l00943"></a><span class="lineno">  943</span><span class="comment">*   clng,clat const char*</span></div>
<div class="line"><a id="l00944" name="l00944"></a><span class="lineno">  944</span><span class="comment">*                       Longitude and latitude identifiers of the new CTYPEia</span></div>
<div class="line"><a id="l00945" name="l00945"></a><span class="lineno">  945</span><span class="comment">*                       celestial axis codes, without trailing dashes.  For</span></div>
<div class="line"><a id="l00946" name="l00946"></a><span class="lineno">  946</span><span class="comment">*                       example, &quot;RA&quot; and &quot;DEC&quot; or &quot;GLON&quot; and &quot;GLAT&quot;.  Up to</span></div>
<div class="line"><a id="l00947" name="l00947"></a><span class="lineno">  947</span><span class="comment">*                       four characters are used, longer strings need not be</span></div>
<div class="line"><a id="l00948" name="l00948"></a><span class="lineno">  948</span><span class="comment">*                       null-terminated.</span></div>
<div class="line"><a id="l00949" name="l00949"></a><span class="lineno">  949</span><span class="comment">*</span></div>
<div class="line"><a id="l00950" name="l00950"></a><span class="lineno">  950</span><span class="comment">*   radesys   const char*</span></div>
<div class="line"><a id="l00951" name="l00951"></a><span class="lineno">  951</span><span class="comment">*                       Used when transforming to equatorial coordinates,</span></div>
<div class="line"><a id="l00952" name="l00952"></a><span class="lineno">  952</span><span class="comment">*                       identified by clng == &quot;RA&quot; and clat = &quot;DEC&quot;.  May be</span></div>
<div class="line"><a id="l00953" name="l00953"></a><span class="lineno">  953</span><span class="comment">*                       set to the null pointer to preserve the current value.</span></div>
<div class="line"><a id="l00954" name="l00954"></a><span class="lineno">  954</span><span class="comment">*                       Up to 71 characters are used, longer strings need not</span></div>
<div class="line"><a id="l00955" name="l00955"></a><span class="lineno">  955</span><span class="comment">*                       be null-terminated.</span></div>
<div class="line"><a id="l00956" name="l00956"></a><span class="lineno">  956</span><span class="comment">*</span></div>
<div class="line"><a id="l00957" name="l00957"></a><span class="lineno">  957</span><span class="comment">*                       If the new coordinate system is anything other than</span></div>
<div class="line"><a id="l00958" name="l00958"></a><span class="lineno">  958</span><span class="comment">*                       equatorial, then wcsprm::radesys will be cleared.</span></div>
<div class="line"><a id="l00959" name="l00959"></a><span class="lineno">  959</span><span class="comment">*</span></div>
<div class="line"><a id="l00960" name="l00960"></a><span class="lineno">  960</span><span class="comment">*   equinox   double    Used when transforming to equatorial coordinates.  May</span></div>
<div class="line"><a id="l00961" name="l00961"></a><span class="lineno">  961</span><span class="comment">*                       be set to zero to preserve the current value.</span></div>
<div class="line"><a id="l00962" name="l00962"></a><span class="lineno">  962</span><span class="comment">*</span></div>
<div class="line"><a id="l00963" name="l00963"></a><span class="lineno">  963</span><span class="comment">*                       If the new coordinate system is not equatorial, then</span></div>
<div class="line"><a id="l00964" name="l00964"></a><span class="lineno">  964</span><span class="comment">*                       wcsprm::equinox will be marked as undefined.</span></div>
<div class="line"><a id="l00965" name="l00965"></a><span class="lineno">  965</span><span class="comment">*</span></div>
<div class="line"><a id="l00966" name="l00966"></a><span class="lineno">  966</span><span class="comment">*   alt       const char*</span></div>
<div class="line"><a id="l00967" name="l00967"></a><span class="lineno">  967</span><span class="comment">*                       Character code for alternate coordinate descriptions</span></div>
<div class="line"><a id="l00968" name="l00968"></a><span class="lineno">  968</span><span class="comment">*                       (i.e. the &#39;a&#39; in keyword names such as CTYPEia).  This</span></div>
<div class="line"><a id="l00969" name="l00969"></a><span class="lineno">  969</span><span class="comment">*                       is blank for the primary coordinate description, or</span></div>
<div class="line"><a id="l00970" name="l00970"></a><span class="lineno">  970</span><span class="comment">*                       one of the 26 upper-case letters, A-Z.  May be set to</span></div>
<div class="line"><a id="l00971" name="l00971"></a><span class="lineno">  971</span><span class="comment">*                       the null pointer, or null string if no change is</span></div>
<div class="line"><a id="l00972" name="l00972"></a><span class="lineno">  972</span><span class="comment">*                       required.</span></div>
<div class="line"><a id="l00973" name="l00973"></a><span class="lineno">  973</span><span class="comment">*</span></div>
<div class="line"><a id="l00974" name="l00974"></a><span class="lineno">  974</span><span class="comment">* Function return value:</span></div>
<div class="line"><a id="l00975" name="l00975"></a><span class="lineno">  975</span><span class="comment">*             int       Status return value:</span></div>
<div class="line"><a id="l00976" name="l00976"></a><span class="lineno">  976</span><span class="comment">*                         0: Success.</span></div>
<div class="line"><a id="l00977" name="l00977"></a><span class="lineno">  977</span><span class="comment">*                         1: Null wcsprm pointer passed.</span></div>
<div class="line"><a id="l00978" name="l00978"></a><span class="lineno">  978</span><span class="comment">*                        12: Invalid subimage specification (no celestial</span></div>
<div class="line"><a id="l00979" name="l00979"></a><span class="lineno">  979</span><span class="comment">*                            axes).</span></div>
<div class="line"><a id="l00980" name="l00980"></a><span class="lineno">  980</span><span class="comment">*</span></div>
<div class="line"><a id="l00981" name="l00981"></a><span class="lineno">  981</span><span class="comment">* Notes:</span></div>
<div class="line"><a id="l00982" name="l00982"></a><span class="lineno">  982</span><span class="comment">*   1: Follows the prescription given in WCS Paper II, Sect. 2.7 for changing</span></div>
<div class="line"><a id="l00983" name="l00983"></a><span class="lineno">  983</span><span class="comment">*      celestial coordinates.</span></div>
<div class="line"><a id="l00984" name="l00984"></a><span class="lineno">  984</span><span class="comment">*</span></div>
<div class="line"><a id="l00985" name="l00985"></a><span class="lineno">  985</span><span class="comment">*      The implementation takes account of indeterminacies that arise in that</span></div>
<div class="line"><a id="l00986" name="l00986"></a><span class="lineno">  986</span><span class="comment">*      prescription in the particular cases where one of the poles of the new</span></div>
<div class="line"><a id="l00987" name="l00987"></a><span class="lineno">  987</span><span class="comment">*      system is at the fiducial point, or one of them is at the native pole.</span></div>
<div class="line"><a id="l00988" name="l00988"></a><span class="lineno">  988</span><span class="comment">*</span></div>
<div class="line"><a id="l00989" name="l00989"></a><span class="lineno">  989</span><span class="comment">*   2: If lat2p1 == +90, i.e. where the poles of the two coordinate systems</span></div>
<div class="line"><a id="l00990" name="l00990"></a><span class="lineno">  990</span><span class="comment">*      coincide, then the spherical coordinate transformation becomes a simple</span></div>
<div class="line"><a id="l00991" name="l00991"></a><span class="lineno">  991</span><span class="comment">*      change in origin of longitude given by</span></div>
<div class="line"><a id="l00992" name="l00992"></a><span class="lineno">  992</span><span class="comment">*      lng2 = lng1 + (lng2p1 - lng1p2 - 180), and lat2 = lat1, where</span></div>
<div class="line"><a id="l00993" name="l00993"></a><span class="lineno">  993</span><span class="comment">*      (lng2,lat2) are coordinates in the new system, and (lng1,lat1) are</span></div>
<div class="line"><a id="l00994" name="l00994"></a><span class="lineno">  994</span><span class="comment">*      coordinates in the original system.</span></div>
<div class="line"><a id="l00995" name="l00995"></a><span class="lineno">  995</span><span class="comment">*</span></div>
<div class="line"><a id="l00996" name="l00996"></a><span class="lineno">  996</span><span class="comment">*      Likewise, if lat2p1 == -90, then lng2 = -lng1 + (lng2p1 + lng1p2), and</span></div>
<div class="line"><a id="l00997" name="l00997"></a><span class="lineno">  997</span><span class="comment">*      lat2 = -lat1.</span></div>
<div class="line"><a id="l00998" name="l00998"></a><span class="lineno">  998</span><span class="comment">*</span></div>
<div class="line"><a id="l00999" name="l00999"></a><span class="lineno">  999</span><span class="comment">*   3: For example, if the original coordinate system is B1950 equatorial and</span></div>
<div class="line"><a id="l01000" name="l01000"></a><span class="lineno"> 1000</span><span class="comment">*      the desired new coordinate system is galactic, then</span></div>
<div class="line"><a id="l01001" name="l01001"></a><span class="lineno"> 1001</span><span class="comment">*</span></div>
<div class="line"><a id="l01002" name="l01002"></a><span class="lineno"> 1002</span><span class="comment">*      - (lng2p1,lat2p1) are the galactic coordinates of the B1950 celestial</span></div>
<div class="line"><a id="l01003" name="l01003"></a><span class="lineno"> 1003</span><span class="comment">*        pole, defined by the IAU to be (123.0,+27.4), and lng1p2 is the B1950</span></div>
<div class="line"><a id="l01004" name="l01004"></a><span class="lineno"> 1004</span><span class="comment">*        right ascension of the galactic pole, defined as 192.25.  Clearly</span></div>
<div class="line"><a id="l01005" name="l01005"></a><span class="lineno"> 1005</span><span class="comment">*        these coordinates are fixed for a particular coordinate</span></div>
<div class="line"><a id="l01006" name="l01006"></a><span class="lineno"> 1006</span><span class="comment">*        transformation.</span></div>
<div class="line"><a id="l01007" name="l01007"></a><span class="lineno"> 1007</span><span class="comment">*</span></div>
<div class="line"><a id="l01008" name="l01008"></a><span class="lineno"> 1008</span><span class="comment">*      - (clng,clat) would be &#39;GLON&#39; and &#39;GLAT&#39;, these being the FITS standard</span></div>
<div class="line"><a id="l01009" name="l01009"></a><span class="lineno"> 1009</span><span class="comment">*        identifiers for galactic coordinates.</span></div>
<div class="line"><a id="l01010" name="l01010"></a><span class="lineno"> 1010</span><span class="comment">*</span></div>
<div class="line"><a id="l01011" name="l01011"></a><span class="lineno"> 1011</span><span class="comment">*      - Since the new coordinate system is not equatorial, wcsprm::radesys</span></div>
<div class="line"><a id="l01012" name="l01012"></a><span class="lineno"> 1012</span><span class="comment">*        and wcsprm::equinox will be cleared.</span></div>
<div class="line"><a id="l01013" name="l01013"></a><span class="lineno"> 1013</span><span class="comment">*</span></div>
<div class="line"><a id="l01014" name="l01014"></a><span class="lineno"> 1014</span><span class="comment">*   4. The coordinates required for some common transformations (obtained from</span></div>
<div class="line"><a id="l01015" name="l01015"></a><span class="lineno"> 1015</span><span class="comment">*      https://ned.ipac.caltech.edu/coordinate_calculator) are as follows:</span></div>
<div class="line"><a id="l01016" name="l01016"></a><span class="lineno"> 1016</span><span class="comment">*</span></div>
<div class="line"><a id="l01017" name="l01017"></a><span class="lineno"> 1017</span><span class="comment">=      (123.0000,+27.4000) galactic coordinates of B1950 celestial pole,</span></div>
<div class="line"><a id="l01018" name="l01018"></a><span class="lineno"> 1018</span><span class="comment">=      (192.2500,+27.4000) B1950 equatorial coordinates of galactic pole.</span></div>
<div class="line"><a id="l01019" name="l01019"></a><span class="lineno"> 1019</span><span class="comment">*</span></div>
<div class="line"><a id="l01020" name="l01020"></a><span class="lineno"> 1020</span><span class="comment">=      (122.9319,+27.1283) galactic coordinates of J2000 celestial pole,</span></div>
<div class="line"><a id="l01021" name="l01021"></a><span class="lineno"> 1021</span><span class="comment">=      (192.8595,+27.1283) J2000 equatorial coordinates of galactic pole.</span></div>
<div class="line"><a id="l01022" name="l01022"></a><span class="lineno"> 1022</span><span class="comment">*</span></div>
<div class="line"><a id="l01023" name="l01023"></a><span class="lineno"> 1023</span><span class="comment">=      (359.6774,+89.7217) B1950 equatorial coordinates of J2000 pole,</span></div>
<div class="line"><a id="l01024" name="l01024"></a><span class="lineno"> 1024</span><span class="comment">=      (180.3162,+89.7217) J2000 equatorial coordinates of B1950 pole.</span></div>
<div class="line"><a id="l01025" name="l01025"></a><span class="lineno"> 1025</span><span class="comment">*</span></div>
<div class="line"><a id="l01026" name="l01026"></a><span class="lineno"> 1026</span><span class="comment">=      (270.0000,+66.5542) B1950 equatorial coordinates of B1950 ecliptic pole,</span></div>
<div class="line"><a id="l01027" name="l01027"></a><span class="lineno"> 1027</span><span class="comment">=      ( 90.0000,+66.5542) B1950 ecliptic coordinates of B1950 celestial pole.</span></div>
<div class="line"><a id="l01028" name="l01028"></a><span class="lineno"> 1028</span><span class="comment">*</span></div>
<div class="line"><a id="l01029" name="l01029"></a><span class="lineno"> 1029</span><span class="comment">=      (270.0000,+66.5607) J2000 equatorial coordinates of J2000 ecliptic pole,</span></div>
<div class="line"><a id="l01030" name="l01030"></a><span class="lineno"> 1030</span><span class="comment">=      ( 90.0000,+66.5607) J2000 ecliptic coordinates of J2000 celestial pole.</span></div>
<div class="line"><a id="l01031" name="l01031"></a><span class="lineno"> 1031</span><span class="comment">*</span></div>
<div class="line"><a id="l01032" name="l01032"></a><span class="lineno"> 1032</span><span class="comment">=      ( 26.7315,+15.6441) supergalactic coordinates of B1950 celestial pole,</span></div>
<div class="line"><a id="l01033" name="l01033"></a><span class="lineno"> 1033</span><span class="comment">=      (283.1894,+15.6441) B1950 equatorial coordinates of supergalactic pole.</span></div>
<div class="line"><a id="l01034" name="l01034"></a><span class="lineno"> 1034</span><span class="comment">*</span></div>
<div class="line"><a id="l01035" name="l01035"></a><span class="lineno"> 1035</span><span class="comment">=      ( 26.4505,+15.7089) supergalactic coordinates of J2000 celestial pole,</span></div>
<div class="line"><a id="l01036" name="l01036"></a><span class="lineno"> 1036</span><span class="comment">=      (283.7542,+15.7089) J2000 equatorial coordinates of supergalactic pole.</span></div>
<div class="line"><a id="l01037" name="l01037"></a><span class="lineno"> 1037</span><span class="comment">*</span></div>
<div class="line"><a id="l01038" name="l01038"></a><span class="lineno"> 1038</span><span class="comment">*</span></div>
<div class="line"><a id="l01039" name="l01039"></a><span class="lineno"> 1039</span><span class="comment">* wcssptr() - Spectral axis translation</span></div>
<div class="line"><a id="l01040" name="l01040"></a><span class="lineno"> 1040</span><span class="comment">* -------------------------------------</span></div>
<div class="line"><a id="l01041" name="l01041"></a><span class="lineno"> 1041</span><span class="comment">* wcssptr() translates the spectral axis in a wcsprm struct.  For example, a</span></div>
<div class="line"><a id="l01042" name="l01042"></a><span class="lineno"> 1042</span><span class="comment">* &#39;FREQ&#39; axis may be translated into &#39;ZOPT-F2W&#39; and vice versa.</span></div>
<div class="line"><a id="l01043" name="l01043"></a><span class="lineno"> 1043</span><span class="comment">*</span></div>
<div class="line"><a id="l01044" name="l01044"></a><span class="lineno"> 1044</span><span class="comment">* PLEASE NOTE: Information in the wcsprm struct relating to the original</span></div>
<div class="line"><a id="l01045" name="l01045"></a><span class="lineno"> 1045</span><span class="comment">* coordinate system will be overwritten and therefore lost.  If this is</span></div>
<div class="line"><a id="l01046" name="l01046"></a><span class="lineno"> 1046</span><span class="comment">* undesirable, invoke wcssptr() on a copy of the struct made with wcssub().</span></div>
<div class="line"><a id="l01047" name="l01047"></a><span class="lineno"> 1047</span><span class="comment">* The wcsprm struct is reset on return with an explicit call to wcsset().</span></div>
<div class="line"><a id="l01048" name="l01048"></a><span class="lineno"> 1048</span><span class="comment">*</span></div>
<div class="line"><a id="l01049" name="l01049"></a><span class="lineno"> 1049</span><span class="comment">* Given and returned:</span></div>
<div class="line"><a id="l01050" name="l01050"></a><span class="lineno"> 1050</span><span class="comment">*   wcs       struct wcsprm*</span></div>
<div class="line"><a id="l01051" name="l01051"></a><span class="lineno"> 1051</span><span class="comment">*                       Coordinate transformation parameters.</span></div>
<div class="line"><a id="l01052" name="l01052"></a><span class="lineno"> 1052</span><span class="comment">*</span></div>
<div class="line"><a id="l01053" name="l01053"></a><span class="lineno"> 1053</span><span class="comment">*   i         int*      Index of the spectral axis (0-relative).  If given &lt; 0</span></div>
<div class="line"><a id="l01054" name="l01054"></a><span class="lineno"> 1054</span><span class="comment">*                       it will be set to the first spectral axis identified</span></div>
<div class="line"><a id="l01055" name="l01055"></a><span class="lineno"> 1055</span><span class="comment">*                       from the ctype[] keyvalues in the wcsprm struct.</span></div>
<div class="line"><a id="l01056" name="l01056"></a><span class="lineno"> 1056</span><span class="comment">*</span></div>
<div class="line"><a id="l01057" name="l01057"></a><span class="lineno"> 1057</span><span class="comment">*   ctype     char[9]   Desired spectral CTYPEia.  Wildcarding may be used as</span></div>
<div class="line"><a id="l01058" name="l01058"></a><span class="lineno"> 1058</span><span class="comment">*                       for the ctypeS2 argument to spctrn() as described in</span></div>
<div class="line"><a id="l01059" name="l01059"></a><span class="lineno"> 1059</span><span class="comment">*                       the prologue of spc.h, i.e. if the final three</span></div>
<div class="line"><a id="l01060" name="l01060"></a><span class="lineno"> 1060</span><span class="comment">*                       characters are specified as &quot;???&quot;, or if just the</span></div>
<div class="line"><a id="l01061" name="l01061"></a><span class="lineno"> 1061</span><span class="comment">*                       eighth character is specified as &#39;?&#39;, the correct</span></div>
<div class="line"><a id="l01062" name="l01062"></a><span class="lineno"> 1062</span><span class="comment">*                       algorithm code will be substituted and returned.</span></div>
<div class="line"><a id="l01063" name="l01063"></a><span class="lineno"> 1063</span><span class="comment">*</span></div>
<div class="line"><a id="l01064" name="l01064"></a><span class="lineno"> 1064</span><span class="comment">* Function return value:</span></div>
<div class="line"><a id="l01065" name="l01065"></a><span class="lineno"> 1065</span><span class="comment">*             int       Status return value:</span></div>
<div class="line"><a id="l01066" name="l01066"></a><span class="lineno"> 1066</span><span class="comment">*                         0: Success.</span></div>
<div class="line"><a id="l01067" name="l01067"></a><span class="lineno"> 1067</span><span class="comment">*                         1: Null wcsprm pointer passed.</span></div>
<div class="line"><a id="l01068" name="l01068"></a><span class="lineno"> 1068</span><span class="comment">*                         2: Memory allocation failed.</span></div>
<div class="line"><a id="l01069" name="l01069"></a><span class="lineno"> 1069</span><span class="comment">*                         3: Linear transformation matrix is singular.</span></div>
<div class="line"><a id="l01070" name="l01070"></a><span class="lineno"> 1070</span><span class="comment">*                         4: Inconsistent or unrecognized coordinate axis</span></div>
<div class="line"><a id="l01071" name="l01071"></a><span class="lineno"> 1071</span><span class="comment">*                            types.</span></div>
<div class="line"><a id="l01072" name="l01072"></a><span class="lineno"> 1072</span><span class="comment">*                         5: Invalid parameter value.</span></div>
<div class="line"><a id="l01073" name="l01073"></a><span class="lineno"> 1073</span><span class="comment">*                         6: Invalid coordinate transformation parameters.</span></div>
<div class="line"><a id="l01074" name="l01074"></a><span class="lineno"> 1074</span><span class="comment">*                         7: Ill-conditioned coordinate transformation</span></div>
<div class="line"><a id="l01075" name="l01075"></a><span class="lineno"> 1075</span><span class="comment">*                            parameters.</span></div>
<div class="line"><a id="l01076" name="l01076"></a><span class="lineno"> 1076</span><span class="comment">*                        12: Invalid subimage specification (no spectral</span></div>
<div class="line"><a id="l01077" name="l01077"></a><span class="lineno"> 1077</span><span class="comment">*                            axis).</span></div>
<div class="line"><a id="l01078" name="l01078"></a><span class="lineno"> 1078</span><span class="comment">*</span></div>
<div class="line"><a id="l01079" name="l01079"></a><span class="lineno"> 1079</span><span class="comment">*                       For returns &gt; 1, a detailed error message is set in</span></div>
<div class="line"><a id="l01080" name="l01080"></a><span class="lineno"> 1080</span><span class="comment">*                       wcsprm::err if enabled, see wcserr_enable().</span></div>
<div class="line"><a id="l01081" name="l01081"></a><span class="lineno"> 1081</span><span class="comment">*</span></div>
<div class="line"><a id="l01082" name="l01082"></a><span class="lineno"> 1082</span><span class="comment">*</span></div>
<div class="line"><a id="l01083" name="l01083"></a><span class="lineno"> 1083</span><span class="comment">* wcslib_version() - WCSLIB version number</span></div>
<div class="line"><a id="l01084" name="l01084"></a><span class="lineno"> 1084</span><span class="comment">* ----------------------------------------</span></div>
<div class="line"><a id="l01085" name="l01085"></a><span class="lineno"> 1085</span><span class="comment">* wcslib_version() returns the WCSLIB version number.</span></div>
<div class="line"><a id="l01086" name="l01086"></a><span class="lineno"> 1086</span><span class="comment">*</span></div>
<div class="line"><a id="l01087" name="l01087"></a><span class="lineno"> 1087</span><span class="comment">* The major version number changes when the ABI changes or when the license</span></div>
<div class="line"><a id="l01088" name="l01088"></a><span class="lineno"> 1088</span><span class="comment">* conditions change.  ABI changes typically result from a change to the</span></div>
<div class="line"><a id="l01089" name="l01089"></a><span class="lineno"> 1089</span><span class="comment">* contents of one of the structs.  The major version number is used to</span></div>
<div class="line"><a id="l01090" name="l01090"></a><span class="lineno"> 1090</span><span class="comment">* distinguish between incompatible versions of the sharable library.</span></div>
<div class="line"><a id="l01091" name="l01091"></a><span class="lineno"> 1091</span><span class="comment">*</span></div>
<div class="line"><a id="l01092" name="l01092"></a><span class="lineno"> 1092</span><span class="comment">* The minor version number changes with new functionality or bug fixes that do</span></div>
<div class="line"><a id="l01093" name="l01093"></a><span class="lineno"> 1093</span><span class="comment">* not involve a change in the ABI.</span></div>
<div class="line"><a id="l01094" name="l01094"></a><span class="lineno"> 1094</span><span class="comment">*</span></div>
<div class="line"><a id="l01095" name="l01095"></a><span class="lineno"> 1095</span><span class="comment">* The auxiliary version number (which is often absent) signals changes to the</span></div>
<div class="line"><a id="l01096" name="l01096"></a><span class="lineno"> 1096</span><span class="comment">* documentation, test suite, build procedures, or any other change that does</span></div>
<div class="line"><a id="l01097" name="l01097"></a><span class="lineno"> 1097</span><span class="comment">* not affect the compiled library.</span></div>
<div class="line"><a id="l01098" name="l01098"></a><span class="lineno"> 1098</span><span class="comment">*</span></div>
<div class="line"><a id="l01099" name="l01099"></a><span class="lineno"> 1099</span><span class="comment">* Returned:</span></div>
<div class="line"><a id="l01100" name="l01100"></a><span class="lineno"> 1100</span><span class="comment">*   vers[3]   int[3]    The broken-down version number:</span></div>
<div class="line"><a id="l01101" name="l01101"></a><span class="lineno"> 1101</span><span class="comment">*                         0: Major version number.</span></div>
<div class="line"><a id="l01102" name="l01102"></a><span class="lineno"> 1102</span><span class="comment">*                         1: Minor version number.</span></div>
<div class="line"><a id="l01103" name="l01103"></a><span class="lineno"> 1103</span><span class="comment">*                         2: Auxiliary version number (zero if absent).</span></div>
<div class="line"><a id="l01104" name="l01104"></a><span class="lineno"> 1104</span><span class="comment">*                       May be given as a null pointer if not required.</span></div>
<div class="line"><a id="l01105" name="l01105"></a><span class="lineno"> 1105</span><span class="comment">*</span></div>
<div class="line"><a id="l01106" name="l01106"></a><span class="lineno"> 1106</span><span class="comment">* Function return value:</span></div>
<div class="line"><a id="l01107" name="l01107"></a><span class="lineno"> 1107</span><span class="comment">*             char*     A null-terminated, statically allocated string</span></div>
<div class="line"><a id="l01108" name="l01108"></a><span class="lineno"> 1108</span><span class="comment">*                       containing the version number in the usual form, i.e.</span></div>
<div class="line"><a id="l01109" name="l01109"></a><span class="lineno"> 1109</span><span class="comment">*                       &quot;&lt;major&gt;.&lt;minor&gt;.&lt;auxiliary&gt;&quot;.</span></div>
<div class="line"><a id="l01110" name="l01110"></a><span class="lineno"> 1110</span><span class="comment">*</span></div>
<div class="line"><a id="l01111" name="l01111"></a><span class="lineno"> 1111</span><span class="comment">*</span></div>
<div class="line"><a id="l01112" name="l01112"></a><span class="lineno"> 1112</span><span class="comment">* wcsprm struct - Coordinate transformation parameters</span></div>
<div class="line"><a id="l01113" name="l01113"></a><span class="lineno"> 1113</span><span class="comment">* ----------------------------------------------------</span></div>
<div class="line"><a id="l01114" name="l01114"></a><span class="lineno"> 1114</span><span class="comment">* The wcsprm struct contains information required to transform world</span></div>
<div class="line"><a id="l01115" name="l01115"></a><span class="lineno"> 1115</span><span class="comment">* coordinates.  It consists of certain members that must be set by the user</span></div>
<div class="line"><a id="l01116" name="l01116"></a><span class="lineno"> 1116</span><span class="comment">* (&quot;given&quot;) and others that are set by the WCSLIB routines (&quot;returned&quot;).</span></div>
<div class="line"><a id="l01117" name="l01117"></a><span class="lineno"> 1117</span><span class="comment">* While the addresses of the arrays themselves may be set by wcsinit() if it</span></div>
<div class="line"><a id="l01118" name="l01118"></a><span class="lineno"> 1118</span><span class="comment">* (optionally) allocates memory, their contents must be set by the user.</span></div>
<div class="line"><a id="l01119" name="l01119"></a><span class="lineno"> 1119</span><span class="comment">*</span></div>
<div class="line"><a id="l01120" name="l01120"></a><span class="lineno"> 1120</span><span class="comment">* Some parameters that are given are not actually required for transforming</span></div>
<div class="line"><a id="l01121" name="l01121"></a><span class="lineno"> 1121</span><span class="comment">* coordinates.  These are described as &quot;auxiliary&quot;; the struct simply provides</span></div>
<div class="line"><a id="l01122" name="l01122"></a><span class="lineno"> 1122</span><span class="comment">* a place to store them, though they may be used by wcshdo() in constructing a</span></div>
<div class="line"><a id="l01123" name="l01123"></a><span class="lineno"> 1123</span><span class="comment">* FITS header from a wcsprm struct.  Some of the returned values are supplied</span></div>
<div class="line"><a id="l01124" name="l01124"></a><span class="lineno"> 1124</span><span class="comment">* for informational purposes and others are for internal use only as</span></div>
<div class="line"><a id="l01125" name="l01125"></a><span class="lineno"> 1125</span><span class="comment">* indicated.</span></div>
<div class="line"><a id="l01126" name="l01126"></a><span class="lineno"> 1126</span><span class="comment">*</span></div>
<div class="line"><a id="l01127" name="l01127"></a><span class="lineno"> 1127</span><span class="comment">* In practice, it is expected that a WCS parser would scan the FITS header to</span></div>
<div class="line"><a id="l01128" name="l01128"></a><span class="lineno"> 1128</span><span class="comment">* determine the number of coordinate axes.  It would then use wcsinit() to</span></div>
<div class="line"><a id="l01129" name="l01129"></a><span class="lineno"> 1129</span><span class="comment">* allocate memory for arrays in the wcsprm struct and set default values.</span></div>
<div class="line"><a id="l01130" name="l01130"></a><span class="lineno"> 1130</span><span class="comment">* Then as it reread the header and identified each WCS keyrecord it would load</span></div>
<div class="line"><a id="l01131" name="l01131"></a><span class="lineno"> 1131</span><span class="comment">* the value into the relevant wcsprm array element.  This is essentially what</span></div>
<div class="line"><a id="l01132" name="l01132"></a><span class="lineno"> 1132</span><span class="comment">* wcspih() does - refer to the prologue of wcshdr.h.  As the final step,</span></div>
<div class="line"><a id="l01133" name="l01133"></a><span class="lineno"> 1133</span><span class="comment">* wcsset() is invoked, either directly or indirectly, to set the derived</span></div>
<div class="line"><a id="l01134" name="l01134"></a><span class="lineno"> 1134</span><span class="comment">* members of the wcsprm struct.  wcsset() strips off trailing blanks in all</span></div>
<div class="line"><a id="l01135" name="l01135"></a><span class="lineno"> 1135</span><span class="comment">* string members and null-fills the character array.</span></div>
<div class="line"><a id="l01136" name="l01136"></a><span class="lineno"> 1136</span><span class="comment">*</span></div>
<div class="line"><a id="l01137" name="l01137"></a><span class="lineno"> 1137</span><span class="comment">*   int flag</span></div>
<div class="line"><a id="l01138" name="l01138"></a><span class="lineno"> 1138</span><span class="comment">*     (Given and returned) This flag must be set to zero whenever any of the</span></div>
<div class="line"><a id="l01139" name="l01139"></a><span class="lineno"> 1139</span><span class="comment">*     following wcsprm struct members are set or changed:</span></div>
<div class="line"><a id="l01140" name="l01140"></a><span class="lineno"> 1140</span><span class="comment">*</span></div>
<div class="line"><a id="l01141" name="l01141"></a><span class="lineno"> 1141</span><span class="comment">*       - wcsprm::naxis (q.v., not normally set by the user),</span></div>
<div class="line"><a id="l01142" name="l01142"></a><span class="lineno"> 1142</span><span class="comment">*       - wcsprm::crpix,</span></div>
<div class="line"><a id="l01143" name="l01143"></a><span class="lineno"> 1143</span><span class="comment">*       - wcsprm::pc,</span></div>
<div class="line"><a id="l01144" name="l01144"></a><span class="lineno"> 1144</span><span class="comment">*       - wcsprm::cdelt,</span></div>
<div class="line"><a id="l01145" name="l01145"></a><span class="lineno"> 1145</span><span class="comment">*       - wcsprm::crval,</span></div>
<div class="line"><a id="l01146" name="l01146"></a><span class="lineno"> 1146</span><span class="comment">*       - wcsprm::cunit,</span></div>
<div class="line"><a id="l01147" name="l01147"></a><span class="lineno"> 1147</span><span class="comment">*       - wcsprm::ctype,</span></div>
<div class="line"><a id="l01148" name="l01148"></a><span class="lineno"> 1148</span><span class="comment">*       - wcsprm::lonpole,</span></div>
<div class="line"><a id="l01149" name="l01149"></a><span class="lineno"> 1149</span><span class="comment">*       - wcsprm::latpole,</span></div>
<div class="line"><a id="l01150" name="l01150"></a><span class="lineno"> 1150</span><span class="comment">*       - wcsprm::restfrq,</span></div>
<div class="line"><a id="l01151" name="l01151"></a><span class="lineno"> 1151</span><span class="comment">*       - wcsprm::restwav,</span></div>
<div class="line"><a id="l01152" name="l01152"></a><span class="lineno"> 1152</span><span class="comment">*       - wcsprm::npv,</span></div>
<div class="line"><a id="l01153" name="l01153"></a><span class="lineno"> 1153</span><span class="comment">*       - wcsprm::pv,</span></div>
<div class="line"><a id="l01154" name="l01154"></a><span class="lineno"> 1154</span><span class="comment">*       - wcsprm::nps,</span></div>
<div class="line"><a id="l01155" name="l01155"></a><span class="lineno"> 1155</span><span class="comment">*       - wcsprm::ps,</span></div>
<div class="line"><a id="l01156" name="l01156"></a><span class="lineno"> 1156</span><span class="comment">*       - wcsprm::cd,</span></div>
<div class="line"><a id="l01157" name="l01157"></a><span class="lineno"> 1157</span><span class="comment">*       - wcsprm::crota,</span></div>
<div class="line"><a id="l01158" name="l01158"></a><span class="lineno"> 1158</span><span class="comment">*       - wcsprm::altlin,</span></div>
<div class="line"><a id="l01159" name="l01159"></a><span class="lineno"> 1159</span><span class="comment">*       - wcsprm::ntab,</span></div>
<div class="line"><a id="l01160" name="l01160"></a><span class="lineno"> 1160</span><span class="comment">*       - wcsprm::nwtb,</span></div>
<div class="line"><a id="l01161" name="l01161"></a><span class="lineno"> 1161</span><span class="comment">*       - wcsprm::tab,</span></div>
<div class="line"><a id="l01162" name="l01162"></a><span class="lineno"> 1162</span><span class="comment">*       - wcsprm::wtb.</span></div>
<div class="line"><a id="l01163" name="l01163"></a><span class="lineno"> 1163</span><span class="comment">*</span></div>
<div class="line"><a id="l01164" name="l01164"></a><span class="lineno"> 1164</span><span class="comment">*     This signals the initialization routine, wcsset(), to recompute the</span></div>
<div class="line"><a id="l01165" name="l01165"></a><span class="lineno"> 1165</span><span class="comment">*     returned members of the linprm, celprm, spcprm, and tabprm structs.</span></div>
<div class="line"><a id="l01166" name="l01166"></a><span class="lineno"> 1166</span><span class="comment">*     wcsset() will reset flag to indicate that this has been done.</span></div>
<div class="line"><a id="l01167" name="l01167"></a><span class="lineno"> 1167</span><span class="comment">*</span></div>
<div class="line"><a id="l01168" name="l01168"></a><span class="lineno"> 1168</span><span class="comment">*     PLEASE NOTE: flag should be set to -1 when wcsinit() is called for the</span></div>
<div class="line"><a id="l01169" name="l01169"></a><span class="lineno"> 1169</span><span class="comment">*     first time for a particular wcsprm struct in order to initialize memory</span></div>
<div class="line"><a id="l01170" name="l01170"></a><span class="lineno"> 1170</span><span class="comment">*     management.  It must ONLY be used on the first initialization otherwise</span></div>
<div class="line"><a id="l01171" name="l01171"></a><span class="lineno"> 1171</span><span class="comment">*     memory leaks may result.</span></div>
<div class="line"><a id="l01172" name="l01172"></a><span class="lineno"> 1172</span><span class="comment">*</span></div>
<div class="line"><a id="l01173" name="l01173"></a><span class="lineno"> 1173</span><span class="comment">*   int naxis</span></div>
<div class="line"><a id="l01174" name="l01174"></a><span class="lineno"> 1174</span><span class="comment">*     (Given or returned) Number of pixel and world coordinate elements.</span></div>
<div class="line"><a id="l01175" name="l01175"></a><span class="lineno"> 1175</span><span class="comment">*</span></div>
<div class="line"><a id="l01176" name="l01176"></a><span class="lineno"> 1176</span><span class="comment">*     If wcsinit() is used to initialize the linprm struct (as would normally</span></div>
<div class="line"><a id="l01177" name="l01177"></a><span class="lineno"> 1177</span><span class="comment">*     be the case) then it will set naxis from the value passed to it as a</span></div>
<div class="line"><a id="l01178" name="l01178"></a><span class="lineno"> 1178</span><span class="comment">*     function argument.  The user should not subsequently modify it.</span></div>
<div class="line"><a id="l01179" name="l01179"></a><span class="lineno"> 1179</span><span class="comment">*</span></div>
<div class="line"><a id="l01180" name="l01180"></a><span class="lineno"> 1180</span><span class="comment">*   double *crpix</span></div>
<div class="line"><a id="l01181" name="l01181"></a><span class="lineno"> 1181</span><span class="comment">*     (Given) Address of the first element of an array of double containing</span></div>
<div class="line"><a id="l01182" name="l01182"></a><span class="lineno"> 1182</span><span class="comment">*     the coordinate reference pixel, CRPIXja.</span></div>
<div class="line"><a id="l01183" name="l01183"></a><span class="lineno"> 1183</span><span class="comment">*</span></div>
<div class="line"><a id="l01184" name="l01184"></a><span class="lineno"> 1184</span><span class="comment">*   double *pc</span></div>
<div class="line"><a id="l01185" name="l01185"></a><span class="lineno"> 1185</span><span class="comment">*     (Given) Address of the first element of the PCi_ja (pixel coordinate)</span></div>
<div class="line"><a id="l01186" name="l01186"></a><span class="lineno"> 1186</span><span class="comment">*     transformation matrix.  The expected order is</span></div>
<div class="line"><a id="l01187" name="l01187"></a><span class="lineno"> 1187</span><span class="comment">*</span></div>
<div class="line"><a id="l01188" name="l01188"></a><span class="lineno"> 1188</span><span class="comment">=       struct wcsprm wcs;</span></div>
<div class="line"><a id="l01189" name="l01189"></a><span class="lineno"> 1189</span><span class="comment">=       wcs.pc = {PC1_1, PC1_2, PC2_1, PC2_2};</span></div>
<div class="line"><a id="l01190" name="l01190"></a><span class="lineno"> 1190</span><span class="comment">*</span></div>
<div class="line"><a id="l01191" name="l01191"></a><span class="lineno"> 1191</span><span class="comment">*     This may be constructed conveniently from a 2-D array via</span></div>
<div class="line"><a id="l01192" name="l01192"></a><span class="lineno"> 1192</span><span class="comment">*</span></div>
<div class="line"><a id="l01193" name="l01193"></a><span class="lineno"> 1193</span><span class="comment">=       double m[2][2] = {{PC1_1, PC1_2},</span></div>
<div class="line"><a id="l01194" name="l01194"></a><span class="lineno"> 1194</span><span class="comment">=                         {PC2_1, PC2_2}};</span></div>
<div class="line"><a id="l01195" name="l01195"></a><span class="lineno"> 1195</span><span class="comment">*</span></div>
<div class="line"><a id="l01196" name="l01196"></a><span class="lineno"> 1196</span><span class="comment">*     which is equivalent to</span></div>
<div class="line"><a id="l01197" name="l01197"></a><span class="lineno"> 1197</span><span class="comment">*</span></div>
<div class="line"><a id="l01198" name="l01198"></a><span class="lineno"> 1198</span><span class="comment">=       double m[2][2];</span></div>
<div class="line"><a id="l01199" name="l01199"></a><span class="lineno"> 1199</span><span class="comment">=       m[0][0] = PC1_1;</span></div>
<div class="line"><a id="l01200" name="l01200"></a><span class="lineno"> 1200</span><span class="comment">=       m[0][1] = PC1_2;</span></div>
<div class="line"><a id="l01201" name="l01201"></a><span class="lineno"> 1201</span><span class="comment">=       m[1][0] = PC2_1;</span></div>
<div class="line"><a id="l01202" name="l01202"></a><span class="lineno"> 1202</span><span class="comment">=       m[1][1] = PC2_2;</span></div>
<div class="line"><a id="l01203" name="l01203"></a><span class="lineno"> 1203</span><span class="comment">*</span></div>
<div class="line"><a id="l01204" name="l01204"></a><span class="lineno"> 1204</span><span class="comment">*     The storage order for this 2-D array is the same as for the 1-D array,</span></div>
<div class="line"><a id="l01205" name="l01205"></a><span class="lineno"> 1205</span><span class="comment">*     whence</span></div>
<div class="line"><a id="l01206" name="l01206"></a><span class="lineno"> 1206</span><span class="comment">*</span></div>
<div class="line"><a id="l01207" name="l01207"></a><span class="lineno"> 1207</span><span class="comment">=       wcs.pc = *m;</span></div>
<div class="line"><a id="l01208" name="l01208"></a><span class="lineno"> 1208</span><span class="comment">*</span></div>
<div class="line"><a id="l01209" name="l01209"></a><span class="lineno"> 1209</span><span class="comment">*     would be legitimate.</span></div>
<div class="line"><a id="l01210" name="l01210"></a><span class="lineno"> 1210</span><span class="comment">*</span></div>
<div class="line"><a id="l01211" name="l01211"></a><span class="lineno"> 1211</span><span class="comment">*   double *cdelt</span></div>
<div class="line"><a id="l01212" name="l01212"></a><span class="lineno"> 1212</span><span class="comment">*     (Given) Address of the first element of an array of double containing</span></div>
<div class="line"><a id="l01213" name="l01213"></a><span class="lineno"> 1213</span><span class="comment">*     the coordinate increments, CDELTia.</span></div>
<div class="line"><a id="l01214" name="l01214"></a><span class="lineno"> 1214</span><span class="comment">*</span></div>
<div class="line"><a id="l01215" name="l01215"></a><span class="lineno"> 1215</span><span class="comment">*   double *crval</span></div>
<div class="line"><a id="l01216" name="l01216"></a><span class="lineno"> 1216</span><span class="comment">*     (Given) Address of the first element of an array of double containing</span></div>
<div class="line"><a id="l01217" name="l01217"></a><span class="lineno"> 1217</span><span class="comment">*     the coordinate reference values, CRVALia.</span></div>
<div class="line"><a id="l01218" name="l01218"></a><span class="lineno"> 1218</span><span class="comment">*</span></div>
<div class="line"><a id="l01219" name="l01219"></a><span class="lineno"> 1219</span><span class="comment">*   char (*cunit)[72]</span></div>
<div class="line"><a id="l01220" name="l01220"></a><span class="lineno"> 1220</span><span class="comment">*     (Given) Address of the first element of an array of char[72] containing</span></div>
<div class="line"><a id="l01221" name="l01221"></a><span class="lineno"> 1221</span><span class="comment">*     the CUNITia keyvalues which define the units of measurement of the</span></div>
<div class="line"><a id="l01222" name="l01222"></a><span class="lineno"> 1222</span><span class="comment">*     CRVALia, CDELTia, and CDi_ja keywords.</span></div>
<div class="line"><a id="l01223" name="l01223"></a><span class="lineno"> 1223</span><span class="comment">*</span></div>
<div class="line"><a id="l01224" name="l01224"></a><span class="lineno"> 1224</span><span class="comment">*     As CUNITia is an optional header keyword, cunit[][72] may be left blank</span></div>
<div class="line"><a id="l01225" name="l01225"></a><span class="lineno"> 1225</span><span class="comment">*     but otherwise is expected to contain a standard units specification as</span></div>
<div class="line"><a id="l01226" name="l01226"></a><span class="lineno"> 1226</span><span class="comment">*     defined by WCS Paper I.  Utility function wcsutrn(), described in</span></div>
<div class="line"><a id="l01227" name="l01227"></a><span class="lineno"> 1227</span><span class="comment">*     wcsunits.h, is available to translate commonly used non-standard units</span></div>
<div class="line"><a id="l01228" name="l01228"></a><span class="lineno"> 1228</span><span class="comment">*     specifications but this must be done as a separate step before invoking</span></div>
<div class="line"><a id="l01229" name="l01229"></a><span class="lineno"> 1229</span><span class="comment">*     wcsset().</span></div>
<div class="line"><a id="l01230" name="l01230"></a><span class="lineno"> 1230</span><span class="comment">*</span></div>
<div class="line"><a id="l01231" name="l01231"></a><span class="lineno"> 1231</span><span class="comment">*     For celestial axes, if cunit[][72] is not blank, wcsset() uses</span></div>
<div class="line"><a id="l01232" name="l01232"></a><span class="lineno"> 1232</span><span class="comment">*     wcsunits() to parse it and scale cdelt[], crval[], and cd[][*] to</span></div>
<div class="line"><a id="l01233" name="l01233"></a><span class="lineno"> 1233</span><span class="comment">*     degrees.  It then resets cunit[][72] to &quot;deg&quot;.</span></div>
<div class="line"><a id="l01234" name="l01234"></a><span class="lineno"> 1234</span><span class="comment">*</span></div>
<div class="line"><a id="l01235" name="l01235"></a><span class="lineno"> 1235</span><span class="comment">*     For spectral axes, if cunit[][72] is not blank, wcsset() uses wcsunits()</span></div>
<div class="line"><a id="l01236" name="l01236"></a><span class="lineno"> 1236</span><span class="comment">*     to parse it and scale cdelt[], crval[], and cd[][*] to SI units.  It</span></div>
<div class="line"><a id="l01237" name="l01237"></a><span class="lineno"> 1237</span><span class="comment">*     then resets cunit[][72] accordingly.</span></div>
<div class="line"><a id="l01238" name="l01238"></a><span class="lineno"> 1238</span><span class="comment">*</span></div>
<div class="line"><a id="l01239" name="l01239"></a><span class="lineno"> 1239</span><span class="comment">*     wcsset() ignores cunit[][72] for other coordinate types; cunit[][72] may</span></div>
<div class="line"><a id="l01240" name="l01240"></a><span class="lineno"> 1240</span><span class="comment">*     be used to label coordinate values.</span></div>
<div class="line"><a id="l01241" name="l01241"></a><span class="lineno"> 1241</span><span class="comment">*</span></div>
<div class="line"><a id="l01242" name="l01242"></a><span class="lineno"> 1242</span><span class="comment">*     These variables accomodate the longest allowed string-valued FITS</span></div>
<div class="line"><a id="l01243" name="l01243"></a><span class="lineno"> 1243</span><span class="comment">*     keyword, being limited to 68 characters, plus the null-terminating</span></div>
<div class="line"><a id="l01244" name="l01244"></a><span class="lineno"> 1244</span><span class="comment">*     character.</span></div>
<div class="line"><a id="l01245" name="l01245"></a><span class="lineno"> 1245</span><span class="comment">*</span></div>
<div class="line"><a id="l01246" name="l01246"></a><span class="lineno"> 1246</span><span class="comment">*   char (*ctype)[72]</span></div>
<div class="line"><a id="l01247" name="l01247"></a><span class="lineno"> 1247</span><span class="comment">*     (Given) Address of the first element of an array of char[72] containing</span></div>
<div class="line"><a id="l01248" name="l01248"></a><span class="lineno"> 1248</span><span class="comment">*     the coordinate axis types, CTYPEia.</span></div>
<div class="line"><a id="l01249" name="l01249"></a><span class="lineno"> 1249</span><span class="comment">*</span></div>
<div class="line"><a id="l01250" name="l01250"></a><span class="lineno"> 1250</span><span class="comment">*     The ctype[][72] keyword values must be in upper case and there must be</span></div>
<div class="line"><a id="l01251" name="l01251"></a><span class="lineno"> 1251</span><span class="comment">*     zero or one pair of matched celestial axis types, and zero or one</span></div>
<div class="line"><a id="l01252" name="l01252"></a><span class="lineno"> 1252</span><span class="comment">*     spectral axis.  The ctype[][72] strings should be padded with blanks on</span></div>
<div class="line"><a id="l01253" name="l01253"></a><span class="lineno"> 1253</span><span class="comment">*     the right and null-terminated so that they are at least eight characters</span></div>
<div class="line"><a id="l01254" name="l01254"></a><span class="lineno"> 1254</span><span class="comment">*     in length.</span></div>
<div class="line"><a id="l01255" name="l01255"></a><span class="lineno"> 1255</span><span class="comment">*</span></div>
<div class="line"><a id="l01256" name="l01256"></a><span class="lineno"> 1256</span><span class="comment">*     These variables accomodate the longest allowed string-valued FITS</span></div>
<div class="line"><a id="l01257" name="l01257"></a><span class="lineno"> 1257</span><span class="comment">*     keyword, being limited to 68 characters, plus the null-terminating</span></div>
<div class="line"><a id="l01258" name="l01258"></a><span class="lineno"> 1258</span><span class="comment">*     character.</span></div>
<div class="line"><a id="l01259" name="l01259"></a><span class="lineno"> 1259</span><span class="comment">*</span></div>
<div class="line"><a id="l01260" name="l01260"></a><span class="lineno"> 1260</span><span class="comment">*   double lonpole</span></div>
<div class="line"><a id="l01261" name="l01261"></a><span class="lineno"> 1261</span><span class="comment">*     (Given and returned) The native longitude of the celestial pole, phi_p,</span></div>
<div class="line"><a id="l01262" name="l01262"></a><span class="lineno"> 1262</span><span class="comment">*     given by LONPOLEa [deg] or by PVi_2a [deg] attached to the longitude</span></div>
<div class="line"><a id="l01263" name="l01263"></a><span class="lineno"> 1263</span><span class="comment">*     axis which takes precedence if defined, and ...</span></div>
<div class="line"><a id="l01264" name="l01264"></a><span class="lineno"> 1264</span><span class="comment">*   double latpole</span></div>
<div class="line"><a id="l01265" name="l01265"></a><span class="lineno"> 1265</span><span class="comment">*     (Given and returned) ... the native latitude of the celestial pole,</span></div>
<div class="line"><a id="l01266" name="l01266"></a><span class="lineno"> 1266</span><span class="comment">*     theta_p, given by LATPOLEa [deg] or by PVi_3a [deg] attached to the</span></div>
<div class="line"><a id="l01267" name="l01267"></a><span class="lineno"> 1267</span><span class="comment">*     longitude axis which takes precedence if defined.</span></div>
<div class="line"><a id="l01268" name="l01268"></a><span class="lineno"> 1268</span><span class="comment">*</span></div>
<div class="line"><a id="l01269" name="l01269"></a><span class="lineno"> 1269</span><span class="comment">*     lonpole and latpole may be left to default to values set by wcsinit()</span></div>
<div class="line"><a id="l01270" name="l01270"></a><span class="lineno"> 1270</span><span class="comment">*     (see celprm::ref), but in any case they will be reset by wcsset() to</span></div>
<div class="line"><a id="l01271" name="l01271"></a><span class="lineno"> 1271</span><span class="comment">*     the values actually used.  Note therefore that if the wcsprm struct is</span></div>
<div class="line"><a id="l01272" name="l01272"></a><span class="lineno"> 1272</span><span class="comment">*     reused without resetting them, whether directly or via wcsinit(), they</span></div>
<div class="line"><a id="l01273" name="l01273"></a><span class="lineno"> 1273</span><span class="comment">*     will no longer have their default values.</span></div>
<div class="line"><a id="l01274" name="l01274"></a><span class="lineno"> 1274</span><span class="comment">*</span></div>
<div class="line"><a id="l01275" name="l01275"></a><span class="lineno"> 1275</span><span class="comment">*   double restfrq</span></div>
<div class="line"><a id="l01276" name="l01276"></a><span class="lineno"> 1276</span><span class="comment">*     (Given) The rest frequency [Hz], and/or ...</span></div>
<div class="line"><a id="l01277" name="l01277"></a><span class="lineno"> 1277</span><span class="comment">*   double restwav</span></div>
<div class="line"><a id="l01278" name="l01278"></a><span class="lineno"> 1278</span><span class="comment">*     (Given) ... the rest wavelength in vacuo [m], only one of which need be</span></div>
<div class="line"><a id="l01279" name="l01279"></a><span class="lineno"> 1279</span><span class="comment">*     given, the other should be set to zero.</span></div>
<div class="line"><a id="l01280" name="l01280"></a><span class="lineno"> 1280</span><span class="comment">*</span></div>
<div class="line"><a id="l01281" name="l01281"></a><span class="lineno"> 1281</span><span class="comment">*   int npv</span></div>
<div class="line"><a id="l01282" name="l01282"></a><span class="lineno"> 1282</span><span class="comment">*     (Given) The number of entries in the wcsprm::pv[] array.</span></div>
<div class="line"><a id="l01283" name="l01283"></a><span class="lineno"> 1283</span><span class="comment">*</span></div>
<div class="line"><a id="l01284" name="l01284"></a><span class="lineno"> 1284</span><span class="comment">*   int npvmax</span></div>
<div class="line"><a id="l01285" name="l01285"></a><span class="lineno"> 1285</span><span class="comment">*     (Given or returned) The length of the wcsprm::pv[] array.</span></div>
<div class="line"><a id="l01286" name="l01286"></a><span class="lineno"> 1286</span><span class="comment">*</span></div>
<div class="line"><a id="l01287" name="l01287"></a><span class="lineno"> 1287</span><span class="comment">*     npvmax will be set by wcsinit() if it allocates memory for wcsprm::pv[],</span></div>
<div class="line"><a id="l01288" name="l01288"></a><span class="lineno"> 1288</span><span class="comment">*     otherwise it must be set by the user.  See also wcsnpv().</span></div>
<div class="line"><a id="l01289" name="l01289"></a><span class="lineno"> 1289</span><span class="comment">*</span></div>
<div class="line"><a id="l01290" name="l01290"></a><span class="lineno"> 1290</span><span class="comment">*   struct pvcard *pv</span></div>
<div class="line"><a id="l01291" name="l01291"></a><span class="lineno"> 1291</span><span class="comment">*     (Given) Address of the first element of an array of length npvmax of</span></div>
<div class="line"><a id="l01292" name="l01292"></a><span class="lineno"> 1292</span><span class="comment">*     pvcard structs.</span></div>
<div class="line"><a id="l01293" name="l01293"></a><span class="lineno"> 1293</span><span class="comment">*</span></div>
<div class="line"><a id="l01294" name="l01294"></a><span class="lineno"> 1294</span><span class="comment">*     As a FITS header parser encounters each PVi_ma keyword it should load it</span></div>
<div class="line"><a id="l01295" name="l01295"></a><span class="lineno"> 1295</span><span class="comment">*     into a pvcard struct in the array and increment npv.  wcsset()</span></div>
<div class="line"><a id="l01296" name="l01296"></a><span class="lineno"> 1296</span><span class="comment">*     interprets these as required.</span></div>
<div class="line"><a id="l01297" name="l01297"></a><span class="lineno"> 1297</span><span class="comment">*</span></div>
<div class="line"><a id="l01298" name="l01298"></a><span class="lineno"> 1298</span><span class="comment">*     Note that, if they were not given, wcsset() resets the entries for</span></div>
<div class="line"><a id="l01299" name="l01299"></a><span class="lineno"> 1299</span><span class="comment">*     PVi_1a, PVi_2a, PVi_3a, and PVi_4a for longitude axis i to match</span></div>
<div class="line"><a id="l01300" name="l01300"></a><span class="lineno"> 1300</span><span class="comment">*     phi_0 and theta_0 (the native longitude and latitude of the reference</span></div>
<div class="line"><a id="l01301" name="l01301"></a><span class="lineno"> 1301</span><span class="comment">*     point), LONPOLEa and LATPOLEa respectively.</span></div>
<div class="line"><a id="l01302" name="l01302"></a><span class="lineno"> 1302</span><span class="comment">*</span></div>
<div class="line"><a id="l01303" name="l01303"></a><span class="lineno"> 1303</span><span class="comment">*   int nps</span></div>
<div class="line"><a id="l01304" name="l01304"></a><span class="lineno"> 1304</span><span class="comment">*     (Given) The number of entries in the wcsprm::ps[] array.</span></div>
<div class="line"><a id="l01305" name="l01305"></a><span class="lineno"> 1305</span><span class="comment">*</span></div>
<div class="line"><a id="l01306" name="l01306"></a><span class="lineno"> 1306</span><span class="comment">*   int npsmax</span></div>
<div class="line"><a id="l01307" name="l01307"></a><span class="lineno"> 1307</span><span class="comment">*     (Given or returned) The length of the wcsprm::ps[] array.</span></div>
<div class="line"><a id="l01308" name="l01308"></a><span class="lineno"> 1308</span><span class="comment">*</span></div>
<div class="line"><a id="l01309" name="l01309"></a><span class="lineno"> 1309</span><span class="comment">*     npsmax will be set by wcsinit() if it allocates memory for wcsprm::ps[],</span></div>
<div class="line"><a id="l01310" name="l01310"></a><span class="lineno"> 1310</span><span class="comment">*     otherwise it must be set by the user.  See also wcsnps().</span></div>
<div class="line"><a id="l01311" name="l01311"></a><span class="lineno"> 1311</span><span class="comment">*</span></div>
<div class="line"><a id="l01312" name="l01312"></a><span class="lineno"> 1312</span><span class="comment">*   struct pscard *ps</span></div>
<div class="line"><a id="l01313" name="l01313"></a><span class="lineno"> 1313</span><span class="comment">*     (Given) Address of the first element of an array of length npsmax of</span></div>
<div class="line"><a id="l01314" name="l01314"></a><span class="lineno"> 1314</span><span class="comment">*     pscard structs.</span></div>
<div class="line"><a id="l01315" name="l01315"></a><span class="lineno"> 1315</span><span class="comment">*</span></div>
<div class="line"><a id="l01316" name="l01316"></a><span class="lineno"> 1316</span><span class="comment">*     As a FITS header parser encounters each PSi_ma keyword it should load it</span></div>
<div class="line"><a id="l01317" name="l01317"></a><span class="lineno"> 1317</span><span class="comment">*     into a pscard struct in the array and increment nps.  wcsset()</span></div>
<div class="line"><a id="l01318" name="l01318"></a><span class="lineno"> 1318</span><span class="comment">*     interprets these as required (currently no PSi_ma keyvalues are</span></div>
<div class="line"><a id="l01319" name="l01319"></a><span class="lineno"> 1319</span><span class="comment">*     recognized).</span></div>
<div class="line"><a id="l01320" name="l01320"></a><span class="lineno"> 1320</span><span class="comment">*</span></div>
<div class="line"><a id="l01321" name="l01321"></a><span class="lineno"> 1321</span><span class="comment">*   double *cd</span></div>
<div class="line"><a id="l01322" name="l01322"></a><span class="lineno"> 1322</span><span class="comment">*     (Given) For historical compatibility, the wcsprm struct supports two</span></div>
<div class="line"><a id="l01323" name="l01323"></a><span class="lineno"> 1323</span><span class="comment">*     alternate specifications of the linear transformation matrix, those</span></div>
<div class="line"><a id="l01324" name="l01324"></a><span class="lineno"> 1324</span><span class="comment">*     associated with the CDi_ja keywords, and ...</span></div>
<div class="line"><a id="l01325" name="l01325"></a><span class="lineno"> 1325</span><span class="comment">*   double *crota</span></div>
<div class="line"><a id="l01326" name="l01326"></a><span class="lineno"> 1326</span><span class="comment">*     (Given) ... those associated with the CROTAi keywords.  Although these</span></div>
<div class="line"><a id="l01327" name="l01327"></a><span class="lineno"> 1327</span><span class="comment">*     may not formally co-exist with PCi_ja, the approach taken here is simply</span></div>
<div class="line"><a id="l01328" name="l01328"></a><span class="lineno"> 1328</span><span class="comment">*     to ignore them if given in conjunction with PCi_ja.</span></div>
<div class="line"><a id="l01329" name="l01329"></a><span class="lineno"> 1329</span><span class="comment">*</span></div>
<div class="line"><a id="l01330" name="l01330"></a><span class="lineno"> 1330</span><span class="comment">*   int altlin</span></div>
<div class="line"><a id="l01331" name="l01331"></a><span class="lineno"> 1331</span><span class="comment">*     (Given) altlin is a bit flag that denotes which of the PCi_ja, CDi_ja</span></div>
<div class="line"><a id="l01332" name="l01332"></a><span class="lineno"> 1332</span><span class="comment">*     and CROTAi keywords are present in the header:</span></div>
<div class="line"><a id="l01333" name="l01333"></a><span class="lineno"> 1333</span><span class="comment">*</span></div>
<div class="line"><a id="l01334" name="l01334"></a><span class="lineno"> 1334</span><span class="comment">*     - Bit 0: PCi_ja is present.</span></div>
<div class="line"><a id="l01335" name="l01335"></a><span class="lineno"> 1335</span><span class="comment">*</span></div>
<div class="line"><a id="l01336" name="l01336"></a><span class="lineno"> 1336</span><span class="comment">*     - Bit 1: CDi_ja is present.</span></div>
<div class="line"><a id="l01337" name="l01337"></a><span class="lineno"> 1337</span><span class="comment">*</span></div>
<div class="line"><a id="l01338" name="l01338"></a><span class="lineno"> 1338</span><span class="comment">*       Matrix elements in the IRAF convention are equivalent to the product</span></div>
<div class="line"><a id="l01339" name="l01339"></a><span class="lineno"> 1339</span><span class="comment">*       CDi_ja = CDELTia * PCi_ja, but the defaults differ from that of the</span></div>
<div class="line"><a id="l01340" name="l01340"></a><span class="lineno"> 1340</span><span class="comment">*       PCi_ja matrix.  If one or more CDi_ja keywords are present then all</span></div>
<div class="line"><a id="l01341" name="l01341"></a><span class="lineno"> 1341</span><span class="comment">*       unspecified CDi_ja default to zero.  If no CDi_ja (or CROTAi) keywords</span></div>
<div class="line"><a id="l01342" name="l01342"></a><span class="lineno"> 1342</span><span class="comment">*       are present, then the header is assumed to be in PCi_ja form whether</span></div>
<div class="line"><a id="l01343" name="l01343"></a><span class="lineno"> 1343</span><span class="comment">*       or not any PCi_ja keywords are present since this results in an</span></div>
<div class="line"><a id="l01344" name="l01344"></a><span class="lineno"> 1344</span><span class="comment">*       interpretation of CDELTia consistent with the original FITS</span></div>
<div class="line"><a id="l01345" name="l01345"></a><span class="lineno"> 1345</span><span class="comment">*       specification.</span></div>
<div class="line"><a id="l01346" name="l01346"></a><span class="lineno"> 1346</span><span class="comment">*</span></div>
<div class="line"><a id="l01347" name="l01347"></a><span class="lineno"> 1347</span><span class="comment">*       While CDi_ja may not formally co-exist with PCi_ja, it may co-exist</span></div>
<div class="line"><a id="l01348" name="l01348"></a><span class="lineno"> 1348</span><span class="comment">*       with CDELTia and CROTAi which are to be ignored.</span></div>
<div class="line"><a id="l01349" name="l01349"></a><span class="lineno"> 1349</span><span class="comment">*</span></div>
<div class="line"><a id="l01350" name="l01350"></a><span class="lineno"> 1350</span><span class="comment">*     - Bit 2: CROTAi is present.</span></div>
<div class="line"><a id="l01351" name="l01351"></a><span class="lineno"> 1351</span><span class="comment">*</span></div>
<div class="line"><a id="l01352" name="l01352"></a><span class="lineno"> 1352</span><span class="comment">*       In the AIPS convention, CROTAi may only be associated with the</span></div>
<div class="line"><a id="l01353" name="l01353"></a><span class="lineno"> 1353</span><span class="comment">*       latitude axis of a celestial axis pair.  It specifies a rotation in</span></div>
<div class="line"><a id="l01354" name="l01354"></a><span class="lineno"> 1354</span><span class="comment">*       the image plane that is applied AFTER the CDELTia; any other CROTAi</span></div>
<div class="line"><a id="l01355" name="l01355"></a><span class="lineno"> 1355</span><span class="comment">*       keywords are ignored.</span></div>
<div class="line"><a id="l01356" name="l01356"></a><span class="lineno"> 1356</span><span class="comment">*</span></div>
<div class="line"><a id="l01357" name="l01357"></a><span class="lineno"> 1357</span><span class="comment">*       CROTAi may not formally co-exist with PCi_ja.</span></div>
<div class="line"><a id="l01358" name="l01358"></a><span class="lineno"> 1358</span><span class="comment">*</span></div>
<div class="line"><a id="l01359" name="l01359"></a><span class="lineno"> 1359</span><span class="comment">*       CROTAi and CDELTia may formally co-exist with CDi_ja but if so are to</span></div>
<div class="line"><a id="l01360" name="l01360"></a><span class="lineno"> 1360</span><span class="comment">*       be ignored.</span></div>
<div class="line"><a id="l01361" name="l01361"></a><span class="lineno"> 1361</span><span class="comment">*</span></div>
<div class="line"><a id="l01362" name="l01362"></a><span class="lineno"> 1362</span><span class="comment">*     - Bit 3: PCi_ja + CDELTia was derived from CDi_ja by wcspcx().</span></div>
<div class="line"><a id="l01363" name="l01363"></a><span class="lineno"> 1363</span><span class="comment">*</span></div>
<div class="line"><a id="l01364" name="l01364"></a><span class="lineno"> 1364</span><span class="comment">*       This bit is set by wcspcx() when it derives PCi_ja and CDELTia from</span></div>
<div class="line"><a id="l01365" name="l01365"></a><span class="lineno"> 1365</span><span class="comment">*       CDi_ja via an orthonormal decomposition.  In particular, it signals</span></div>
<div class="line"><a id="l01366" name="l01366"></a><span class="lineno"> 1366</span><span class="comment">*       wcsset() not to replace PCi_ja by a copy of CDi_ja with CDELTia set</span></div>
<div class="line"><a id="l01367" name="l01367"></a><span class="lineno"> 1367</span><span class="comment">*       to unity.</span></div>
<div class="line"><a id="l01368" name="l01368"></a><span class="lineno"> 1368</span><span class="comment">*</span></div>
<div class="line"><a id="l01369" name="l01369"></a><span class="lineno"> 1369</span><span class="comment">*     CDi_ja and CROTAi keywords, if found, are to be stored in the wcsprm::cd</span></div>
<div class="line"><a id="l01370" name="l01370"></a><span class="lineno"> 1370</span><span class="comment">*     and wcsprm::crota arrays which are dimensioned similarly to wcsprm::pc</span></div>
<div class="line"><a id="l01371" name="l01371"></a><span class="lineno"> 1371</span><span class="comment">*     and wcsprm::cdelt.  FITS header parsers should use the following</span></div>
<div class="line"><a id="l01372" name="l01372"></a><span class="lineno"> 1372</span><span class="comment">*     procedure:</span></div>
<div class="line"><a id="l01373" name="l01373"></a><span class="lineno"> 1373</span><span class="comment">*</span></div>
<div class="line"><a id="l01374" name="l01374"></a><span class="lineno"> 1374</span><span class="comment">*     - Whenever a PCi_ja keyword is encountered: altlin |= 1;</span></div>
<div class="line"><a id="l01375" name="l01375"></a><span class="lineno"> 1375</span><span class="comment">*</span></div>
<div class="line"><a id="l01376" name="l01376"></a><span class="lineno"> 1376</span><span class="comment">*     - Whenever a CDi_ja keyword is encountered: altlin |= 2;</span></div>
<div class="line"><a id="l01377" name="l01377"></a><span class="lineno"> 1377</span><span class="comment">*</span></div>
<div class="line"><a id="l01378" name="l01378"></a><span class="lineno"> 1378</span><span class="comment">*     - Whenever a CROTAi keyword is encountered: altlin |= 4;</span></div>
<div class="line"><a id="l01379" name="l01379"></a><span class="lineno"> 1379</span><span class="comment">*</span></div>
<div class="line"><a id="l01380" name="l01380"></a><span class="lineno"> 1380</span><span class="comment">*     If none of these bits are set the PCi_ja representation results, i.e.</span></div>
<div class="line"><a id="l01381" name="l01381"></a><span class="lineno"> 1381</span><span class="comment">*     wcsprm::pc and wcsprm::cdelt will be used as given.</span></div>
<div class="line"><a id="l01382" name="l01382"></a><span class="lineno"> 1382</span><span class="comment">*</span></div>
<div class="line"><a id="l01383" name="l01383"></a><span class="lineno"> 1383</span><span class="comment">*     These alternate specifications of the linear transformation matrix are</span></div>
<div class="line"><a id="l01384" name="l01384"></a><span class="lineno"> 1384</span><span class="comment">*     translated immediately to PCi_ja by wcsset() and are invisible to the</span></div>
<div class="line"><a id="l01385" name="l01385"></a><span class="lineno"> 1385</span><span class="comment">*     lower-level WCSLIB routines.  In particular, unless bit 3 is also set,</span></div>
<div class="line"><a id="l01386" name="l01386"></a><span class="lineno"> 1386</span><span class="comment">*     wcsset() resets wcsprm::cdelt to unity if CDi_ja is present (and no</span></div>
<div class="line"><a id="l01387" name="l01387"></a><span class="lineno"> 1387</span><span class="comment">*     PCi_ja).</span></div>
<div class="line"><a id="l01388" name="l01388"></a><span class="lineno"> 1388</span><span class="comment">*</span></div>
<div class="line"><a id="l01389" name="l01389"></a><span class="lineno"> 1389</span><span class="comment">*     If CROTAi are present but none is associated with the latitude axis</span></div>
<div class="line"><a id="l01390" name="l01390"></a><span class="lineno"> 1390</span><span class="comment">*     (and no PCi_ja or CDi_ja), then wcsset() reverts to a unity PCi_ja</span></div>
<div class="line"><a id="l01391" name="l01391"></a><span class="lineno"> 1391</span><span class="comment">*     matrix.</span></div>
<div class="line"><a id="l01392" name="l01392"></a><span class="lineno"> 1392</span><span class="comment">*</span></div>
<div class="line"><a id="l01393" name="l01393"></a><span class="lineno"> 1393</span><span class="comment">*   int velref</span></div>
<div class="line"><a id="l01394" name="l01394"></a><span class="lineno"> 1394</span><span class="comment">*     (Given) AIPS velocity code VELREF, refer to spcaips().</span></div>
<div class="line"><a id="l01395" name="l01395"></a><span class="lineno"> 1395</span><span class="comment">*</span></div>
<div class="line"><a id="l01396" name="l01396"></a><span class="lineno"> 1396</span><span class="comment">*     It is not necessary to reset the wcsprm struct (via wcsset()) when</span></div>
<div class="line"><a id="l01397" name="l01397"></a><span class="lineno"> 1397</span><span class="comment">*     wcsprm::velref is changed.</span></div>
<div class="line"><a id="l01398" name="l01398"></a><span class="lineno"> 1398</span><span class="comment">*</span></div>
<div class="line"><a id="l01399" name="l01399"></a><span class="lineno"> 1399</span><span class="comment">*   char alt[4]</span></div>
<div class="line"><a id="l01400" name="l01400"></a><span class="lineno"> 1400</span><span class="comment">*     (Given, auxiliary) Character code for alternate coordinate descriptions</span></div>
<div class="line"><a id="l01401" name="l01401"></a><span class="lineno"> 1401</span><span class="comment">*     (i.e. the &#39;a&#39; in keyword names such as CTYPEia).  This is blank for the</span></div>
<div class="line"><a id="l01402" name="l01402"></a><span class="lineno"> 1402</span><span class="comment">*     primary coordinate description, or one of the 26 upper-case letters,</span></div>
<div class="line"><a id="l01403" name="l01403"></a><span class="lineno"> 1403</span><span class="comment">*     A-Z.</span></div>
<div class="line"><a id="l01404" name="l01404"></a><span class="lineno"> 1404</span><span class="comment">*</span></div>
<div class="line"><a id="l01405" name="l01405"></a><span class="lineno"> 1405</span><span class="comment">*     An array of four characters is provided for alignment purposes, only the</span></div>
<div class="line"><a id="l01406" name="l01406"></a><span class="lineno"> 1406</span><span class="comment">*     first is used.</span></div>
<div class="line"><a id="l01407" name="l01407"></a><span class="lineno"> 1407</span><span class="comment">*</span></div>
<div class="line"><a id="l01408" name="l01408"></a><span class="lineno"> 1408</span><span class="comment">*     It is not necessary to reset the wcsprm struct (via wcsset()) when</span></div>
<div class="line"><a id="l01409" name="l01409"></a><span class="lineno"> 1409</span><span class="comment">*     wcsprm::alt is changed.</span></div>
<div class="line"><a id="l01410" name="l01410"></a><span class="lineno"> 1410</span><span class="comment">*</span></div>
<div class="line"><a id="l01411" name="l01411"></a><span class="lineno"> 1411</span><span class="comment">*   int colnum</span></div>
<div class="line"><a id="l01412" name="l01412"></a><span class="lineno"> 1412</span><span class="comment">*     (Given, auxiliary) Where the coordinate representation is associated</span></div>
<div class="line"><a id="l01413" name="l01413"></a><span class="lineno"> 1413</span><span class="comment">*     with an image-array column in a FITS binary table, this variable may be</span></div>
<div class="line"><a id="l01414" name="l01414"></a><span class="lineno"> 1414</span><span class="comment">*     used to record the relevant column number.</span></div>
<div class="line"><a id="l01415" name="l01415"></a><span class="lineno"> 1415</span><span class="comment">*</span></div>
<div class="line"><a id="l01416" name="l01416"></a><span class="lineno"> 1416</span><span class="comment">*     It should be set to zero for an image header or pixel list.</span></div>
<div class="line"><a id="l01417" name="l01417"></a><span class="lineno"> 1417</span><span class="comment">*</span></div>
<div class="line"><a id="l01418" name="l01418"></a><span class="lineno"> 1418</span><span class="comment">*     It is not necessary to reset the wcsprm struct (via wcsset()) when</span></div>
<div class="line"><a id="l01419" name="l01419"></a><span class="lineno"> 1419</span><span class="comment">*     wcsprm::colnum is changed.</span></div>
<div class="line"><a id="l01420" name="l01420"></a><span class="lineno"> 1420</span><span class="comment">*</span></div>
<div class="line"><a id="l01421" name="l01421"></a><span class="lineno"> 1421</span><span class="comment">*   int *colax</span></div>
<div class="line"><a id="l01422" name="l01422"></a><span class="lineno"> 1422</span><span class="comment">*     (Given, auxiliary) Address of the first element of an array of int</span></div>
<div class="line"><a id="l01423" name="l01423"></a><span class="lineno"> 1423</span><span class="comment">*     recording the column numbers for each axis in a pixel list.</span></div>
<div class="line"><a id="l01424" name="l01424"></a><span class="lineno"> 1424</span><span class="comment">*</span></div>
<div class="line"><a id="l01425" name="l01425"></a><span class="lineno"> 1425</span><span class="comment">*     The array elements should be set to zero for an image header or image</span></div>
<div class="line"><a id="l01426" name="l01426"></a><span class="lineno"> 1426</span><span class="comment">*     array in a binary table.</span></div>
<div class="line"><a id="l01427" name="l01427"></a><span class="lineno"> 1427</span><span class="comment">*</span></div>
<div class="line"><a id="l01428" name="l01428"></a><span class="lineno"> 1428</span><span class="comment">*     It is not necessary to reset the wcsprm struct (via wcsset()) when</span></div>
<div class="line"><a id="l01429" name="l01429"></a><span class="lineno"> 1429</span><span class="comment">*     wcsprm::colax is changed.</span></div>
<div class="line"><a id="l01430" name="l01430"></a><span class="lineno"> 1430</span><span class="comment">*</span></div>
<div class="line"><a id="l01431" name="l01431"></a><span class="lineno"> 1431</span><span class="comment">*   char (*cname)[72]</span></div>
<div class="line"><a id="l01432" name="l01432"></a><span class="lineno"> 1432</span><span class="comment">*     (Given, auxiliary) The address of the first element of an array of</span></div>
<div class="line"><a id="l01433" name="l01433"></a><span class="lineno"> 1433</span><span class="comment">*     char[72] containing the coordinate axis names, CNAMEia.</span></div>
<div class="line"><a id="l01434" name="l01434"></a><span class="lineno"> 1434</span><span class="comment">*</span></div>
<div class="line"><a id="l01435" name="l01435"></a><span class="lineno"> 1435</span><span class="comment">*     These variables accomodate the longest allowed string-valued FITS</span></div>
<div class="line"><a id="l01436" name="l01436"></a><span class="lineno"> 1436</span><span class="comment">*     keyword, being limited to 68 characters, plus the null-terminating</span></div>
<div class="line"><a id="l01437" name="l01437"></a><span class="lineno"> 1437</span><span class="comment">*     character.</span></div>
<div class="line"><a id="l01438" name="l01438"></a><span class="lineno"> 1438</span><span class="comment">*</span></div>
<div class="line"><a id="l01439" name="l01439"></a><span class="lineno"> 1439</span><span class="comment">*     It is not necessary to reset the wcsprm struct (via wcsset()) when</span></div>
<div class="line"><a id="l01440" name="l01440"></a><span class="lineno"> 1440</span><span class="comment">*     wcsprm::cname is changed.</span></div>
<div class="line"><a id="l01441" name="l01441"></a><span class="lineno"> 1441</span><span class="comment">*</span></div>
<div class="line"><a id="l01442" name="l01442"></a><span class="lineno"> 1442</span><span class="comment">*   double *crder</span></div>
<div class="line"><a id="l01443" name="l01443"></a><span class="lineno"> 1443</span><span class="comment">*     (Given, auxiliary) Address of the first element of an array of double</span></div>
<div class="line"><a id="l01444" name="l01444"></a><span class="lineno"> 1444</span><span class="comment">*     recording the random error in the coordinate value, CRDERia.</span></div>
<div class="line"><a id="l01445" name="l01445"></a><span class="lineno"> 1445</span><span class="comment">*</span></div>
<div class="line"><a id="l01446" name="l01446"></a><span class="lineno"> 1446</span><span class="comment">*     It is not necessary to reset the wcsprm struct (via wcsset()) when</span></div>
<div class="line"><a id="l01447" name="l01447"></a><span class="lineno"> 1447</span><span class="comment">*     wcsprm::crder is changed.</span></div>
<div class="line"><a id="l01448" name="l01448"></a><span class="lineno"> 1448</span><span class="comment">*</span></div>
<div class="line"><a id="l01449" name="l01449"></a><span class="lineno"> 1449</span><span class="comment">*   double *csyer</span></div>
<div class="line"><a id="l01450" name="l01450"></a><span class="lineno"> 1450</span><span class="comment">*     (Given, auxiliary) Address of the first element of an array of double</span></div>
<div class="line"><a id="l01451" name="l01451"></a><span class="lineno"> 1451</span><span class="comment">*     recording the systematic error in the coordinate value, CSYERia.</span></div>
<div class="line"><a id="l01452" name="l01452"></a><span class="lineno"> 1452</span><span class="comment">*</span></div>
<div class="line"><a id="l01453" name="l01453"></a><span class="lineno"> 1453</span><span class="comment">*     It is not necessary to reset the wcsprm struct (via wcsset()) when</span></div>
<div class="line"><a id="l01454" name="l01454"></a><span class="lineno"> 1454</span><span class="comment">*     wcsprm::csyer is changed.</span></div>
<div class="line"><a id="l01455" name="l01455"></a><span class="lineno"> 1455</span><span class="comment">*</span></div>
<div class="line"><a id="l01456" name="l01456"></a><span class="lineno"> 1456</span><span class="comment">*   double *czphs</span></div>
<div class="line"><a id="l01457" name="l01457"></a><span class="lineno"> 1457</span><span class="comment">*     (Given, auxiliary) Address of the first element of an array of double</span></div>
<div class="line"><a id="l01458" name="l01458"></a><span class="lineno"> 1458</span><span class="comment">*     recording the time at the zero point of a phase axis, CZPHSia.</span></div>
<div class="line"><a id="l01459" name="l01459"></a><span class="lineno"> 1459</span><span class="comment">*</span></div>
<div class="line"><a id="l01460" name="l01460"></a><span class="lineno"> 1460</span><span class="comment">*     It is not necessary to reset the wcsprm struct (via wcsset()) when</span></div>
<div class="line"><a id="l01461" name="l01461"></a><span class="lineno"> 1461</span><span class="comment">*     wcsprm::czphs is changed.</span></div>
<div class="line"><a id="l01462" name="l01462"></a><span class="lineno"> 1462</span><span class="comment">*</span></div>
<div class="line"><a id="l01463" name="l01463"></a><span class="lineno"> 1463</span><span class="comment">*   double *cperi</span></div>
<div class="line"><a id="l01464" name="l01464"></a><span class="lineno"> 1464</span><span class="comment">*     (Given, auxiliary) Address of the first element of an array of double</span></div>
<div class="line"><a id="l01465" name="l01465"></a><span class="lineno"> 1465</span><span class="comment">*     recording the period of a phase axis, CPERIia.</span></div>
<div class="line"><a id="l01466" name="l01466"></a><span class="lineno"> 1466</span><span class="comment">*</span></div>
<div class="line"><a id="l01467" name="l01467"></a><span class="lineno"> 1467</span><span class="comment">*     It is not necessary to reset the wcsprm struct (via wcsset()) when</span></div>
<div class="line"><a id="l01468" name="l01468"></a><span class="lineno"> 1468</span><span class="comment">*     wcsprm::cperi is changed.</span></div>
<div class="line"><a id="l01469" name="l01469"></a><span class="lineno"> 1469</span><span class="comment">*</span></div>
<div class="line"><a id="l01470" name="l01470"></a><span class="lineno"> 1470</span><span class="comment">*   char wcsname[72]</span></div>
<div class="line"><a id="l01471" name="l01471"></a><span class="lineno"> 1471</span><span class="comment">*     (Given, auxiliary) The name given to the coordinate representation,</span></div>
<div class="line"><a id="l01472" name="l01472"></a><span class="lineno"> 1472</span><span class="comment">*     WCSNAMEa.  This variable accomodates the longest allowed string-valued</span></div>
<div class="line"><a id="l01473" name="l01473"></a><span class="lineno"> 1473</span><span class="comment">*     FITS keyword, being limited to 68 characters, plus the null-terminating</span></div>
<div class="line"><a id="l01474" name="l01474"></a><span class="lineno"> 1474</span><span class="comment">*     character.</span></div>
<div class="line"><a id="l01475" name="l01475"></a><span class="lineno"> 1475</span><span class="comment">*</span></div>
<div class="line"><a id="l01476" name="l01476"></a><span class="lineno"> 1476</span><span class="comment">*     It is not necessary to reset the wcsprm struct (via wcsset()) when</span></div>
<div class="line"><a id="l01477" name="l01477"></a><span class="lineno"> 1477</span><span class="comment">*     wcsprm::wcsname is changed.</span></div>
<div class="line"><a id="l01478" name="l01478"></a><span class="lineno"> 1478</span><span class="comment">*</span></div>
<div class="line"><a id="l01479" name="l01479"></a><span class="lineno"> 1479</span><span class="comment">*   char timesys[72]</span></div>
<div class="line"><a id="l01480" name="l01480"></a><span class="lineno"> 1480</span><span class="comment">*     (Given, auxiliary) TIMESYS keyvalue, being the time scale (UTC, TAI,</span></div>
<div class="line"><a id="l01481" name="l01481"></a><span class="lineno"> 1481</span><span class="comment">*     etc.) in which all other time-related auxiliary header values are</span></div>
<div class="line"><a id="l01482" name="l01482"></a><span class="lineno"> 1482</span><span class="comment">*     recorded.  Also defines the time scale for an image axis with CTYPEia</span></div>
<div class="line"><a id="l01483" name="l01483"></a><span class="lineno"> 1483</span><span class="comment">*     set to &#39;TIME&#39;.</span></div>
<div class="line"><a id="l01484" name="l01484"></a><span class="lineno"> 1484</span><span class="comment">*</span></div>
<div class="line"><a id="l01485" name="l01485"></a><span class="lineno"> 1485</span><span class="comment">*     It is not necessary to reset the wcsprm struct (via wcsset()) when</span></div>
<div class="line"><a id="l01486" name="l01486"></a><span class="lineno"> 1486</span><span class="comment">*     wcsprm::timesys is changed.</span></div>
<div class="line"><a id="l01487" name="l01487"></a><span class="lineno"> 1487</span><span class="comment">*</span></div>
<div class="line"><a id="l01488" name="l01488"></a><span class="lineno"> 1488</span><span class="comment">*   char trefpos[72]</span></div>
<div class="line"><a id="l01489" name="l01489"></a><span class="lineno"> 1489</span><span class="comment">*     (Given, auxiliary) TREFPOS keyvalue, being the location in space where</span></div>
<div class="line"><a id="l01490" name="l01490"></a><span class="lineno"> 1490</span><span class="comment">*     the recorded time is valid.</span></div>
<div class="line"><a id="l01491" name="l01491"></a><span class="lineno"> 1491</span><span class="comment">*</span></div>
<div class="line"><a id="l01492" name="l01492"></a><span class="lineno"> 1492</span><span class="comment">*     It is not necessary to reset the wcsprm struct (via wcsset()) when</span></div>
<div class="line"><a id="l01493" name="l01493"></a><span class="lineno"> 1493</span><span class="comment">*     wcsprm::trefpos is changed.</span></div>
<div class="line"><a id="l01494" name="l01494"></a><span class="lineno"> 1494</span><span class="comment">*</span></div>
<div class="line"><a id="l01495" name="l01495"></a><span class="lineno"> 1495</span><span class="comment">*   char trefdir[72]</span></div>
<div class="line"><a id="l01496" name="l01496"></a><span class="lineno"> 1496</span><span class="comment">*     (Given, auxiliary) TREFDIR keyvalue, being the reference direction used</span></div>
<div class="line"><a id="l01497" name="l01497"></a><span class="lineno"> 1497</span><span class="comment">*     in calculating a pathlength delay.</span></div>
<div class="line"><a id="l01498" name="l01498"></a><span class="lineno"> 1498</span><span class="comment">*</span></div>
<div class="line"><a id="l01499" name="l01499"></a><span class="lineno"> 1499</span><span class="comment">*     It is not necessary to reset the wcsprm struct (via wcsset()) when</span></div>
<div class="line"><a id="l01500" name="l01500"></a><span class="lineno"> 1500</span><span class="comment">*     wcsprm::trefdir is changed.</span></div>
<div class="line"><a id="l01501" name="l01501"></a><span class="lineno"> 1501</span><span class="comment">*</span></div>
<div class="line"><a id="l01502" name="l01502"></a><span class="lineno"> 1502</span><span class="comment">*   char plephem[72]</span></div>
<div class="line"><a id="l01503" name="l01503"></a><span class="lineno"> 1503</span><span class="comment">*     (Given, auxiliary) PLEPHEM keyvalue, being the Solar System ephemeris</span></div>
<div class="line"><a id="l01504" name="l01504"></a><span class="lineno"> 1504</span><span class="comment">*     used for calculating a pathlength delay.</span></div>
<div class="line"><a id="l01505" name="l01505"></a><span class="lineno"> 1505</span><span class="comment">*</span></div>
<div class="line"><a id="l01506" name="l01506"></a><span class="lineno"> 1506</span><span class="comment">*     It is not necessary to reset the wcsprm struct (via wcsset()) when</span></div>
<div class="line"><a id="l01507" name="l01507"></a><span class="lineno"> 1507</span><span class="comment">*     wcsprm::plephem is changed.</span></div>
<div class="line"><a id="l01508" name="l01508"></a><span class="lineno"> 1508</span><span class="comment">*</span></div>
<div class="line"><a id="l01509" name="l01509"></a><span class="lineno"> 1509</span><span class="comment">*   char timeunit[72]</span></div>
<div class="line"><a id="l01510" name="l01510"></a><span class="lineno"> 1510</span><span class="comment">*     (Given, auxiliary) TIMEUNIT keyvalue, being the time units in which</span></div>
<div class="line"><a id="l01511" name="l01511"></a><span class="lineno"> 1511</span><span class="comment">*     the following header values are expressed: TSTART, TSTOP, TIMEOFFS,</span></div>
<div class="line"><a id="l01512" name="l01512"></a><span class="lineno"> 1512</span><span class="comment">*     TIMSYER, TIMRDER, TIMEDEL.  It also provides the default value for</span></div>
<div class="line"><a id="l01513" name="l01513"></a><span class="lineno"> 1513</span><span class="comment">*     CUNITia for time axes.</span></div>
<div class="line"><a id="l01514" name="l01514"></a><span class="lineno"> 1514</span><span class="comment">*</span></div>
<div class="line"><a id="l01515" name="l01515"></a><span class="lineno"> 1515</span><span class="comment">*     It is not necessary to reset the wcsprm struct (via wcsset()) when</span></div>
<div class="line"><a id="l01516" name="l01516"></a><span class="lineno"> 1516</span><span class="comment">*     wcsprm::timeunit is changed.</span></div>
<div class="line"><a id="l01517" name="l01517"></a><span class="lineno"> 1517</span><span class="comment">*</span></div>
<div class="line"><a id="l01518" name="l01518"></a><span class="lineno"> 1518</span><span class="comment">*   char dateref[72]</span></div>
<div class="line"><a id="l01519" name="l01519"></a><span class="lineno"> 1519</span><span class="comment">*     (Given, auxiliary) DATEREF keyvalue, being the date of a reference epoch</span></div>
<div class="line"><a id="l01520" name="l01520"></a><span class="lineno"> 1520</span><span class="comment">*     relative to which other time measurements refer.</span></div>
<div class="line"><a id="l01521" name="l01521"></a><span class="lineno"> 1521</span><span class="comment">*</span></div>
<div class="line"><a id="l01522" name="l01522"></a><span class="lineno"> 1522</span><span class="comment">*     It is not necessary to reset the wcsprm struct (via wcsset()) when</span></div>
<div class="line"><a id="l01523" name="l01523"></a><span class="lineno"> 1523</span><span class="comment">*     wcsprm::dateref is changed.</span></div>
<div class="line"><a id="l01524" name="l01524"></a><span class="lineno"> 1524</span><span class="comment">*</span></div>
<div class="line"><a id="l01525" name="l01525"></a><span class="lineno"> 1525</span><span class="comment">*   double mjdref[2]</span></div>
<div class="line"><a id="l01526" name="l01526"></a><span class="lineno"> 1526</span><span class="comment">*     (Given, auxiliary) MJDREF keyvalue, equivalent to DATEREF expressed as</span></div>
<div class="line"><a id="l01527" name="l01527"></a><span class="lineno"> 1527</span><span class="comment">*     a Modified Julian Date (MJD = JD - 2400000.5).  The value is given as</span></div>
<div class="line"><a id="l01528" name="l01528"></a><span class="lineno"> 1528</span><span class="comment">*     the sum of the two-element vector, allowing increased precision.</span></div>
<div class="line"><a id="l01529" name="l01529"></a><span class="lineno"> 1529</span><span class="comment">*</span></div>
<div class="line"><a id="l01530" name="l01530"></a><span class="lineno"> 1530</span><span class="comment">*     It is not necessary to reset the wcsprm struct (via wcsset()) when</span></div>
<div class="line"><a id="l01531" name="l01531"></a><span class="lineno"> 1531</span><span class="comment">*     wcsprm::mjdref is changed.</span></div>
<div class="line"><a id="l01532" name="l01532"></a><span class="lineno"> 1532</span><span class="comment">*</span></div>
<div class="line"><a id="l01533" name="l01533"></a><span class="lineno"> 1533</span><span class="comment">*   double timeoffs</span></div>
<div class="line"><a id="l01534" name="l01534"></a><span class="lineno"> 1534</span><span class="comment">*     (Given, auxiliary) TIMEOFFS keyvalue, being a time offset, which may be</span></div>
<div class="line"><a id="l01535" name="l01535"></a><span class="lineno"> 1535</span><span class="comment">*     used, for example, to provide a uniform clock correction for times</span></div>
<div class="line"><a id="l01536" name="l01536"></a><span class="lineno"> 1536</span><span class="comment">*     referenced to DATEREF.</span></div>
<div class="line"><a id="l01537" name="l01537"></a><span class="lineno"> 1537</span><span class="comment">*</span></div>
<div class="line"><a id="l01538" name="l01538"></a><span class="lineno"> 1538</span><span class="comment">*     It is not necessary to reset the wcsprm struct (via wcsset()) when</span></div>
<div class="line"><a id="l01539" name="l01539"></a><span class="lineno"> 1539</span><span class="comment">*     wcsprm::timeoffs is changed.</span></div>
<div class="line"><a id="l01540" name="l01540"></a><span class="lineno"> 1540</span><span class="comment">*</span></div>
<div class="line"><a id="l01541" name="l01541"></a><span class="lineno"> 1541</span><span class="comment">*   char dateobs[72]</span></div>
<div class="line"><a id="l01542" name="l01542"></a><span class="lineno"> 1542</span><span class="comment">*     (Given, auxiliary) DATE-OBS keyvalue, being the date at the start of the</span></div>
<div class="line"><a id="l01543" name="l01543"></a><span class="lineno"> 1543</span><span class="comment">*     observation unless otherwise explained in the DATE-OBS keycomment, in</span></div>
<div class="line"><a id="l01544" name="l01544"></a><span class="lineno"> 1544</span><span class="comment">*     ISO format, yyyy-mm-ddThh:mm:ss.</span></div>
<div class="line"><a id="l01545" name="l01545"></a><span class="lineno"> 1545</span><span class="comment">*</span></div>
<div class="line"><a id="l01546" name="l01546"></a><span class="lineno"> 1546</span><span class="comment">*     It is not necessary to reset the wcsprm struct (via wcsset()) when</span></div>
<div class="line"><a id="l01547" name="l01547"></a><span class="lineno"> 1547</span><span class="comment">*     wcsprm::dateobs is changed.</span></div>
<div class="line"><a id="l01548" name="l01548"></a><span class="lineno"> 1548</span><span class="comment">*</span></div>
<div class="line"><a id="l01549" name="l01549"></a><span class="lineno"> 1549</span><span class="comment">*   char datebeg[72]</span></div>
<div class="line"><a id="l01550" name="l01550"></a><span class="lineno"> 1550</span><span class="comment">*     (Given, auxiliary) DATE-BEG keyvalue, being the date at the start of the</span></div>
<div class="line"><a id="l01551" name="l01551"></a><span class="lineno"> 1551</span><span class="comment">*     observation in ISO format, yyyy-mm-ddThh:mm:ss.</span></div>
<div class="line"><a id="l01552" name="l01552"></a><span class="lineno"> 1552</span><span class="comment">*</span></div>
<div class="line"><a id="l01553" name="l01553"></a><span class="lineno"> 1553</span><span class="comment">*     It is not necessary to reset the wcsprm struct (via wcsset()) when</span></div>
<div class="line"><a id="l01554" name="l01554"></a><span class="lineno"> 1554</span><span class="comment">*     wcsprm::datebeg is changed.</span></div>
<div class="line"><a id="l01555" name="l01555"></a><span class="lineno"> 1555</span><span class="comment">*</span></div>
<div class="line"><a id="l01556" name="l01556"></a><span class="lineno"> 1556</span><span class="comment">*   char dateavg[72]</span></div>
<div class="line"><a id="l01557" name="l01557"></a><span class="lineno"> 1557</span><span class="comment">*     (Given, auxiliary) DATE-AVG keyvalue, being the date at a representative</span></div>
<div class="line"><a id="l01558" name="l01558"></a><span class="lineno"> 1558</span><span class="comment">*     mid-point of the observation in ISO format, yyyy-mm-ddThh:mm:ss.</span></div>
<div class="line"><a id="l01559" name="l01559"></a><span class="lineno"> 1559</span><span class="comment">*</span></div>
<div class="line"><a id="l01560" name="l01560"></a><span class="lineno"> 1560</span><span class="comment">*     It is not necessary to reset the wcsprm struct (via wcsset()) when</span></div>
<div class="line"><a id="l01561" name="l01561"></a><span class="lineno"> 1561</span><span class="comment">*     wcsprm::dateavg is changed.</span></div>
<div class="line"><a id="l01562" name="l01562"></a><span class="lineno"> 1562</span><span class="comment">*</span></div>
<div class="line"><a id="l01563" name="l01563"></a><span class="lineno"> 1563</span><span class="comment">*   char dateend[72]</span></div>
<div class="line"><a id="l01564" name="l01564"></a><span class="lineno"> 1564</span><span class="comment">*     (Given, auxiliary) DATE-END keyvalue, baing the date at the end of the</span></div>
<div class="line"><a id="l01565" name="l01565"></a><span class="lineno"> 1565</span><span class="comment">*     observation in ISO format, yyyy-mm-ddThh:mm:ss.</span></div>
<div class="line"><a id="l01566" name="l01566"></a><span class="lineno"> 1566</span><span class="comment">*</span></div>
<div class="line"><a id="l01567" name="l01567"></a><span class="lineno"> 1567</span><span class="comment">*     It is not necessary to reset the wcsprm struct (via wcsset()) when</span></div>
<div class="line"><a id="l01568" name="l01568"></a><span class="lineno"> 1568</span><span class="comment">*     wcsprm::dateend is changed.</span></div>
<div class="line"><a id="l01569" name="l01569"></a><span class="lineno"> 1569</span><span class="comment">*</span></div>
<div class="line"><a id="l01570" name="l01570"></a><span class="lineno"> 1570</span><span class="comment">*   double mjdobs</span></div>
<div class="line"><a id="l01571" name="l01571"></a><span class="lineno"> 1571</span><span class="comment">*     (Given, auxiliary) MJD-OBS keyvalue, equivalent to DATE-OBS expressed</span></div>
<div class="line"><a id="l01572" name="l01572"></a><span class="lineno"> 1572</span><span class="comment">*     as a Modified Julian Date (MJD = JD - 2400000.5).</span></div>
<div class="line"><a id="l01573" name="l01573"></a><span class="lineno"> 1573</span><span class="comment">*</span></div>
<div class="line"><a id="l01574" name="l01574"></a><span class="lineno"> 1574</span><span class="comment">*     It is not necessary to reset the wcsprm struct (via wcsset()) when</span></div>
<div class="line"><a id="l01575" name="l01575"></a><span class="lineno"> 1575</span><span class="comment">*     wcsprm::mjdobs is changed.</span></div>
<div class="line"><a id="l01576" name="l01576"></a><span class="lineno"> 1576</span><span class="comment">*</span></div>
<div class="line"><a id="l01577" name="l01577"></a><span class="lineno"> 1577</span><span class="comment">*   double mjdbeg</span></div>
<div class="line"><a id="l01578" name="l01578"></a><span class="lineno"> 1578</span><span class="comment">*     (Given, auxiliary) MJD-BEG keyvalue, equivalent to DATE-BEG expressed</span></div>
<div class="line"><a id="l01579" name="l01579"></a><span class="lineno"> 1579</span><span class="comment">*     as a Modified Julian Date (MJD = JD - 2400000.5).</span></div>
<div class="line"><a id="l01580" name="l01580"></a><span class="lineno"> 1580</span><span class="comment">*</span></div>
<div class="line"><a id="l01581" name="l01581"></a><span class="lineno"> 1581</span><span class="comment">*     It is not necessary to reset the wcsprm struct (via wcsset()) when</span></div>
<div class="line"><a id="l01582" name="l01582"></a><span class="lineno"> 1582</span><span class="comment">*     wcsprm::mjdbeg is changed.</span></div>
<div class="line"><a id="l01583" name="l01583"></a><span class="lineno"> 1583</span><span class="comment">*</span></div>
<div class="line"><a id="l01584" name="l01584"></a><span class="lineno"> 1584</span><span class="comment">*   double mjdavg</span></div>
<div class="line"><a id="l01585" name="l01585"></a><span class="lineno"> 1585</span><span class="comment">*     (Given, auxiliary) MJD-AVG keyvalue, equivalent to DATE-AVG expressed</span></div>
<div class="line"><a id="l01586" name="l01586"></a><span class="lineno"> 1586</span><span class="comment">*     as a Modified Julian Date (MJD = JD - 2400000.5).</span></div>
<div class="line"><a id="l01587" name="l01587"></a><span class="lineno"> 1587</span><span class="comment">*</span></div>
<div class="line"><a id="l01588" name="l01588"></a><span class="lineno"> 1588</span><span class="comment">*     It is not necessary to reset the wcsprm struct (via wcsset()) when</span></div>
<div class="line"><a id="l01589" name="l01589"></a><span class="lineno"> 1589</span><span class="comment">*     wcsprm::mjdavg is changed.</span></div>
<div class="line"><a id="l01590" name="l01590"></a><span class="lineno"> 1590</span><span class="comment">*</span></div>
<div class="line"><a id="l01591" name="l01591"></a><span class="lineno"> 1591</span><span class="comment">*   double mjdend</span></div>
<div class="line"><a id="l01592" name="l01592"></a><span class="lineno"> 1592</span><span class="comment">*     (Given, auxiliary) MJD-END keyvalue, equivalent to DATE-END expressed</span></div>
<div class="line"><a id="l01593" name="l01593"></a><span class="lineno"> 1593</span><span class="comment">*     as a Modified Julian Date (MJD = JD - 2400000.5).</span></div>
<div class="line"><a id="l01594" name="l01594"></a><span class="lineno"> 1594</span><span class="comment">*</span></div>
<div class="line"><a id="l01595" name="l01595"></a><span class="lineno"> 1595</span><span class="comment">*     It is not necessary to reset the wcsprm struct (via wcsset()) when</span></div>
<div class="line"><a id="l01596" name="l01596"></a><span class="lineno"> 1596</span><span class="comment">*     wcsprm::mjdend is changed.</span></div>
<div class="line"><a id="l01597" name="l01597"></a><span class="lineno"> 1597</span><span class="comment">*</span></div>
<div class="line"><a id="l01598" name="l01598"></a><span class="lineno"> 1598</span><span class="comment">*   double jepoch</span></div>
<div class="line"><a id="l01599" name="l01599"></a><span class="lineno"> 1599</span><span class="comment">*     (Given, auxiliary) JEPOCH keyvalue, equivalent to DATE-OBS expressed</span></div>
<div class="line"><a id="l01600" name="l01600"></a><span class="lineno"> 1600</span><span class="comment">*     as a Julian epoch.</span></div>
<div class="line"><a id="l01601" name="l01601"></a><span class="lineno"> 1601</span><span class="comment">*</span></div>
<div class="line"><a id="l01602" name="l01602"></a><span class="lineno"> 1602</span><span class="comment">*     It is not necessary to reset the wcsprm struct (via wcsset()) when</span></div>
<div class="line"><a id="l01603" name="l01603"></a><span class="lineno"> 1603</span><span class="comment">*     wcsprm::jepoch is changed.</span></div>
<div class="line"><a id="l01604" name="l01604"></a><span class="lineno"> 1604</span><span class="comment">*</span></div>
<div class="line"><a id="l01605" name="l01605"></a><span class="lineno"> 1605</span><span class="comment">*   double bepoch</span></div>
<div class="line"><a id="l01606" name="l01606"></a><span class="lineno"> 1606</span><span class="comment">*     (Given, auxiliary) BEPOCH keyvalue, equivalent to DATE-OBS expressed</span></div>
<div class="line"><a id="l01607" name="l01607"></a><span class="lineno"> 1607</span><span class="comment">*     as a Besselian epoch</span></div>
<div class="line"><a id="l01608" name="l01608"></a><span class="lineno"> 1608</span><span class="comment">*</span></div>
<div class="line"><a id="l01609" name="l01609"></a><span class="lineno"> 1609</span><span class="comment">*     It is not necessary to reset the wcsprm struct (via wcsset()) when</span></div>
<div class="line"><a id="l01610" name="l01610"></a><span class="lineno"> 1610</span><span class="comment">*     wcsprm::bepoch is changed.</span></div>
<div class="line"><a id="l01611" name="l01611"></a><span class="lineno"> 1611</span><span class="comment">*</span></div>
<div class="line"><a id="l01612" name="l01612"></a><span class="lineno"> 1612</span><span class="comment">*   double tstart</span></div>
<div class="line"><a id="l01613" name="l01613"></a><span class="lineno"> 1613</span><span class="comment">*     (Given, auxiliary) TSTART keyvalue, equivalent to DATE-BEG expressed</span></div>
<div class="line"><a id="l01614" name="l01614"></a><span class="lineno"> 1614</span><span class="comment">*     as a time in units of TIMEUNIT relative to DATEREF+TIMEOFFS.</span></div>
<div class="line"><a id="l01615" name="l01615"></a><span class="lineno"> 1615</span><span class="comment">*</span></div>
<div class="line"><a id="l01616" name="l01616"></a><span class="lineno"> 1616</span><span class="comment">*     It is not necessary to reset the wcsprm struct (via wcsset()) when</span></div>
<div class="line"><a id="l01617" name="l01617"></a><span class="lineno"> 1617</span><span class="comment">*     wcsprm::tstart is changed.</span></div>
<div class="line"><a id="l01618" name="l01618"></a><span class="lineno"> 1618</span><span class="comment">*</span></div>
<div class="line"><a id="l01619" name="l01619"></a><span class="lineno"> 1619</span><span class="comment">*   double tstop</span></div>
<div class="line"><a id="l01620" name="l01620"></a><span class="lineno"> 1620</span><span class="comment">*     (Given, auxiliary) TSTOP keyvalue, equivalent to DATE-END expressed</span></div>
<div class="line"><a id="l01621" name="l01621"></a><span class="lineno"> 1621</span><span class="comment">*     as a time in units of TIMEUNIT relative to DATEREF+TIMEOFFS.</span></div>
<div class="line"><a id="l01622" name="l01622"></a><span class="lineno"> 1622</span><span class="comment">*</span></div>
<div class="line"><a id="l01623" name="l01623"></a><span class="lineno"> 1623</span><span class="comment">*     It is not necessary to reset the wcsprm struct (via wcsset()) when</span></div>
<div class="line"><a id="l01624" name="l01624"></a><span class="lineno"> 1624</span><span class="comment">*     wcsprm::tstop is changed.</span></div>
<div class="line"><a id="l01625" name="l01625"></a><span class="lineno"> 1625</span><span class="comment">*</span></div>
<div class="line"><a id="l01626" name="l01626"></a><span class="lineno"> 1626</span><span class="comment">*   double xposure</span></div>
<div class="line"><a id="l01627" name="l01627"></a><span class="lineno"> 1627</span><span class="comment">*     (Given, auxiliary) XPOSURE keyvalue, being the effective exposure time</span></div>
<div class="line"><a id="l01628" name="l01628"></a><span class="lineno"> 1628</span><span class="comment">*     in units of TIMEUNIT.</span></div>
<div class="line"><a id="l01629" name="l01629"></a><span class="lineno"> 1629</span><span class="comment">*</span></div>
<div class="line"><a id="l01630" name="l01630"></a><span class="lineno"> 1630</span><span class="comment">*     It is not necessary to reset the wcsprm struct (via wcsset()) when</span></div>
<div class="line"><a id="l01631" name="l01631"></a><span class="lineno"> 1631</span><span class="comment">*     wcsprm::xposure is changed.</span></div>
<div class="line"><a id="l01632" name="l01632"></a><span class="lineno"> 1632</span><span class="comment">*</span></div>
<div class="line"><a id="l01633" name="l01633"></a><span class="lineno"> 1633</span><span class="comment">*   double telapse</span></div>
<div class="line"><a id="l01634" name="l01634"></a><span class="lineno"> 1634</span><span class="comment">*     (Given, auxiliary) TELAPSE keyvalue, equivalent to the elapsed time</span></div>
<div class="line"><a id="l01635" name="l01635"></a><span class="lineno"> 1635</span><span class="comment">*     between DATE-BEG and DATE-END, in units of TIMEUNIT.</span></div>
<div class="line"><a id="l01636" name="l01636"></a><span class="lineno"> 1636</span><span class="comment">*</span></div>
<div class="line"><a id="l01637" name="l01637"></a><span class="lineno"> 1637</span><span class="comment">*     It is not necessary to reset the wcsprm struct (via wcsset()) when</span></div>
<div class="line"><a id="l01638" name="l01638"></a><span class="lineno"> 1638</span><span class="comment">*     wcsprm::telapse is changed.</span></div>
<div class="line"><a id="l01639" name="l01639"></a><span class="lineno"> 1639</span><span class="comment">*</span></div>
<div class="line"><a id="l01640" name="l01640"></a><span class="lineno"> 1640</span><span class="comment">*   double timsyer</span></div>
<div class="line"><a id="l01641" name="l01641"></a><span class="lineno"> 1641</span><span class="comment">*     (Given, auxiliary) TIMSYER keyvalue, being the absolute error of the</span></div>
<div class="line"><a id="l01642" name="l01642"></a><span class="lineno"> 1642</span><span class="comment">*     time values, in units of TIMEUNIT.</span></div>
<div class="line"><a id="l01643" name="l01643"></a><span class="lineno"> 1643</span><span class="comment">*</span></div>
<div class="line"><a id="l01644" name="l01644"></a><span class="lineno"> 1644</span><span class="comment">*     It is not necessary to reset the wcsprm struct (via wcsset()) when</span></div>
<div class="line"><a id="l01645" name="l01645"></a><span class="lineno"> 1645</span><span class="comment">*     wcsprm::timsyer is changed.</span></div>
<div class="line"><a id="l01646" name="l01646"></a><span class="lineno"> 1646</span><span class="comment">*</span></div>
<div class="line"><a id="l01647" name="l01647"></a><span class="lineno"> 1647</span><span class="comment">*   double timrder</span></div>
<div class="line"><a id="l01648" name="l01648"></a><span class="lineno"> 1648</span><span class="comment">*     (Given, auxiliary) TIMRDER keyvalue, being the accuracy of time stamps</span></div>
<div class="line"><a id="l01649" name="l01649"></a><span class="lineno"> 1649</span><span class="comment">*     relative to each other, in units of TIMEUNIT.</span></div>
<div class="line"><a id="l01650" name="l01650"></a><span class="lineno"> 1650</span><span class="comment">*</span></div>
<div class="line"><a id="l01651" name="l01651"></a><span class="lineno"> 1651</span><span class="comment">*     It is not necessary to reset the wcsprm struct (via wcsset()) when</span></div>
<div class="line"><a id="l01652" name="l01652"></a><span class="lineno"> 1652</span><span class="comment">*     wcsprm::timrder is changed.</span></div>
<div class="line"><a id="l01653" name="l01653"></a><span class="lineno"> 1653</span><span class="comment">*</span></div>
<div class="line"><a id="l01654" name="l01654"></a><span class="lineno"> 1654</span><span class="comment">*   double timedel</span></div>
<div class="line"><a id="l01655" name="l01655"></a><span class="lineno"> 1655</span><span class="comment">*     (Given, auxiliary) TIMEDEL keyvalue, being the resolution of the time</span></div>
<div class="line"><a id="l01656" name="l01656"></a><span class="lineno"> 1656</span><span class="comment">*     stamps.</span></div>
<div class="line"><a id="l01657" name="l01657"></a><span class="lineno"> 1657</span><span class="comment">*</span></div>
<div class="line"><a id="l01658" name="l01658"></a><span class="lineno"> 1658</span><span class="comment">*     It is not necessary to reset the wcsprm struct (via wcsset()) when</span></div>
<div class="line"><a id="l01659" name="l01659"></a><span class="lineno"> 1659</span><span class="comment">*     wcsprm::timedel is changed.</span></div>
<div class="line"><a id="l01660" name="l01660"></a><span class="lineno"> 1660</span><span class="comment">*</span></div>
<div class="line"><a id="l01661" name="l01661"></a><span class="lineno"> 1661</span><span class="comment">*   double timepixr</span></div>
<div class="line"><a id="l01662" name="l01662"></a><span class="lineno"> 1662</span><span class="comment">*     (Given, auxiliary) TIMEPIXR keyvalue, being the relative position of the</span></div>
<div class="line"><a id="l01663" name="l01663"></a><span class="lineno"> 1663</span><span class="comment">*     time stamps in binned time intervals, a value between 0.0 and 1.0.</span></div>
<div class="line"><a id="l01664" name="l01664"></a><span class="lineno"> 1664</span><span class="comment">*</span></div>
<div class="line"><a id="l01665" name="l01665"></a><span class="lineno"> 1665</span><span class="comment">*     It is not necessary to reset the wcsprm struct (via wcsset()) when</span></div>
<div class="line"><a id="l01666" name="l01666"></a><span class="lineno"> 1666</span><span class="comment">*     wcsprm::timepixr is changed.</span></div>
<div class="line"><a id="l01667" name="l01667"></a><span class="lineno"> 1667</span><span class="comment">*</span></div>
<div class="line"><a id="l01668" name="l01668"></a><span class="lineno"> 1668</span><span class="comment">*   double obsgeo[6]</span></div>
<div class="line"><a id="l01669" name="l01669"></a><span class="lineno"> 1669</span><span class="comment">*     (Given, auxiliary) Location of the observer in a standard terrestrial</span></div>
<div class="line"><a id="l01670" name="l01670"></a><span class="lineno"> 1670</span><span class="comment">*     reference frame.  The first three give ITRS Cartesian coordinates</span></div>
<div class="line"><a id="l01671" name="l01671"></a><span class="lineno"> 1671</span><span class="comment">*     OBSGEO-X [m],   OBSGEO-Y [m],   OBSGEO-Z [m], and the second three give</span></div>
<div class="line"><a id="l01672" name="l01672"></a><span class="lineno"> 1672</span><span class="comment">*     OBSGEO-L [deg], OBSGEO-B [deg], OBSGEO-H [m], which are related through</span></div>
<div class="line"><a id="l01673" name="l01673"></a><span class="lineno"> 1673</span><span class="comment">*     a standard transformation.</span></div>
<div class="line"><a id="l01674" name="l01674"></a><span class="lineno"> 1674</span><span class="comment">*</span></div>
<div class="line"><a id="l01675" name="l01675"></a><span class="lineno"> 1675</span><span class="comment">*     It is not necessary to reset the wcsprm struct (via wcsset()) when</span></div>
<div class="line"><a id="l01676" name="l01676"></a><span class="lineno"> 1676</span><span class="comment">*     wcsprm::obsgeo is changed.</span></div>
<div class="line"><a id="l01677" name="l01677"></a><span class="lineno"> 1677</span><span class="comment">*</span></div>
<div class="line"><a id="l01678" name="l01678"></a><span class="lineno"> 1678</span><span class="comment">*   char obsorbit[72]</span></div>
<div class="line"><a id="l01679" name="l01679"></a><span class="lineno"> 1679</span><span class="comment">*     (Given, auxiliary) OBSORBIT keyvalue, being the URI, URL, or name of an</span></div>
<div class="line"><a id="l01680" name="l01680"></a><span class="lineno"> 1680</span><span class="comment">*     orbit ephemeris file giving spacecraft coordinates relating to TREFPOS.</span></div>
<div class="line"><a id="l01681" name="l01681"></a><span class="lineno"> 1681</span><span class="comment">*</span></div>
<div class="line"><a id="l01682" name="l01682"></a><span class="lineno"> 1682</span><span class="comment">*     It is not necessary to reset the wcsprm struct (via wcsset()) when</span></div>
<div class="line"><a id="l01683" name="l01683"></a><span class="lineno"> 1683</span><span class="comment">*     wcsprm::obsorbit is changed.</span></div>
<div class="line"><a id="l01684" name="l01684"></a><span class="lineno"> 1684</span><span class="comment">*</span></div>
<div class="line"><a id="l01685" name="l01685"></a><span class="lineno"> 1685</span><span class="comment">*   char radesys[72]</span></div>
<div class="line"><a id="l01686" name="l01686"></a><span class="lineno"> 1686</span><span class="comment">*     (Given, auxiliary) The equatorial or ecliptic coordinate system type,</span></div>
<div class="line"><a id="l01687" name="l01687"></a><span class="lineno"> 1687</span><span class="comment">*     RADESYSa.</span></div>
<div class="line"><a id="l01688" name="l01688"></a><span class="lineno"> 1688</span><span class="comment">*</span></div>
<div class="line"><a id="l01689" name="l01689"></a><span class="lineno"> 1689</span><span class="comment">*     It is not necessary to reset the wcsprm struct (via wcsset()) when</span></div>
<div class="line"><a id="l01690" name="l01690"></a><span class="lineno"> 1690</span><span class="comment">*     wcsprm::radesys is changed.</span></div>
<div class="line"><a id="l01691" name="l01691"></a><span class="lineno"> 1691</span><span class="comment">*</span></div>
<div class="line"><a id="l01692" name="l01692"></a><span class="lineno"> 1692</span><span class="comment">*   double equinox</span></div>
<div class="line"><a id="l01693" name="l01693"></a><span class="lineno"> 1693</span><span class="comment">*     (Given, auxiliary) The equinox associated with dynamical equatorial or</span></div>
<div class="line"><a id="l01694" name="l01694"></a><span class="lineno"> 1694</span><span class="comment">*     ecliptic coordinate systems, EQUINOXa (or EPOCH in older headers).  Not</span></div>
<div class="line"><a id="l01695" name="l01695"></a><span class="lineno"> 1695</span><span class="comment">*     applicable to ICRS equatorial or ecliptic coordinates.</span></div>
<div class="line"><a id="l01696" name="l01696"></a><span class="lineno"> 1696</span><span class="comment">*</span></div>
<div class="line"><a id="l01697" name="l01697"></a><span class="lineno"> 1697</span><span class="comment">*     It is not necessary to reset the wcsprm struct (via wcsset()) when</span></div>
<div class="line"><a id="l01698" name="l01698"></a><span class="lineno"> 1698</span><span class="comment">*     wcsprm::equinox is changed.</span></div>
<div class="line"><a id="l01699" name="l01699"></a><span class="lineno"> 1699</span><span class="comment">*</span></div>
<div class="line"><a id="l01700" name="l01700"></a><span class="lineno"> 1700</span><span class="comment">*   char specsys[72]</span></div>
<div class="line"><a id="l01701" name="l01701"></a><span class="lineno"> 1701</span><span class="comment">*     (Given, auxiliary) Spectral reference frame (standard of rest),</span></div>
<div class="line"><a id="l01702" name="l01702"></a><span class="lineno"> 1702</span><span class="comment">*     SPECSYSa.</span></div>
<div class="line"><a id="l01703" name="l01703"></a><span class="lineno"> 1703</span><span class="comment">*</span></div>
<div class="line"><a id="l01704" name="l01704"></a><span class="lineno"> 1704</span><span class="comment">*     It is not necessary to reset the wcsprm struct (via wcsset()) when</span></div>
<div class="line"><a id="l01705" name="l01705"></a><span class="lineno"> 1705</span><span class="comment">*     wcsprm::specsys is changed.</span></div>
<div class="line"><a id="l01706" name="l01706"></a><span class="lineno"> 1706</span><span class="comment">*</span></div>
<div class="line"><a id="l01707" name="l01707"></a><span class="lineno"> 1707</span><span class="comment">*   char ssysobs[72]</span></div>
<div class="line"><a id="l01708" name="l01708"></a><span class="lineno"> 1708</span><span class="comment">*     (Given, auxiliary) The spectral reference frame in which there is no</span></div>
<div class="line"><a id="l01709" name="l01709"></a><span class="lineno"> 1709</span><span class="comment">*     differential variation in the spectral coordinate across the</span></div>
<div class="line"><a id="l01710" name="l01710"></a><span class="lineno"> 1710</span><span class="comment">*     field-of-view, SSYSOBSa.</span></div>
<div class="line"><a id="l01711" name="l01711"></a><span class="lineno"> 1711</span><span class="comment">*</span></div>
<div class="line"><a id="l01712" name="l01712"></a><span class="lineno"> 1712</span><span class="comment">*     It is not necessary to reset the wcsprm struct (via wcsset()) when</span></div>
<div class="line"><a id="l01713" name="l01713"></a><span class="lineno"> 1713</span><span class="comment">*     wcsprm::ssysobs is changed.</span></div>
<div class="line"><a id="l01714" name="l01714"></a><span class="lineno"> 1714</span><span class="comment">*</span></div>
<div class="line"><a id="l01715" name="l01715"></a><span class="lineno"> 1715</span><span class="comment">*   double velosys</span></div>
<div class="line"><a id="l01716" name="l01716"></a><span class="lineno"> 1716</span><span class="comment">*     (Given, auxiliary) The relative radial velocity [m/s] between the</span></div>
<div class="line"><a id="l01717" name="l01717"></a><span class="lineno"> 1717</span><span class="comment">*     observer and the selected standard of rest in the direction of the</span></div>
<div class="line"><a id="l01718" name="l01718"></a><span class="lineno"> 1718</span><span class="comment">*     celestial reference coordinate, VELOSYSa.</span></div>
<div class="line"><a id="l01719" name="l01719"></a><span class="lineno"> 1719</span><span class="comment">*</span></div>
<div class="line"><a id="l01720" name="l01720"></a><span class="lineno"> 1720</span><span class="comment">*     It is not necessary to reset the wcsprm struct (via wcsset()) when</span></div>
<div class="line"><a id="l01721" name="l01721"></a><span class="lineno"> 1721</span><span class="comment">*     wcsprm::velosys is changed.</span></div>
<div class="line"><a id="l01722" name="l01722"></a><span class="lineno"> 1722</span><span class="comment">*</span></div>
<div class="line"><a id="l01723" name="l01723"></a><span class="lineno"> 1723</span><span class="comment">*   double zsource</span></div>
<div class="line"><a id="l01724" name="l01724"></a><span class="lineno"> 1724</span><span class="comment">*     (Given, auxiliary) The redshift, ZSOURCEa, of the source.</span></div>
<div class="line"><a id="l01725" name="l01725"></a><span class="lineno"> 1725</span><span class="comment">*</span></div>
<div class="line"><a id="l01726" name="l01726"></a><span class="lineno"> 1726</span><span class="comment">*     It is not necessary to reset the wcsprm struct (via wcsset()) when</span></div>
<div class="line"><a id="l01727" name="l01727"></a><span class="lineno"> 1727</span><span class="comment">*     wcsprm::zsource is changed.</span></div>
<div class="line"><a id="l01728" name="l01728"></a><span class="lineno"> 1728</span><span class="comment">*</span></div>
<div class="line"><a id="l01729" name="l01729"></a><span class="lineno"> 1729</span><span class="comment">*   char ssyssrc[72]</span></div>
<div class="line"><a id="l01730" name="l01730"></a><span class="lineno"> 1730</span><span class="comment">*     (Given, auxiliary) The spectral reference frame (standard of rest),</span></div>
<div class="line"><a id="l01731" name="l01731"></a><span class="lineno"> 1731</span><span class="comment">*     SSYSSRCa, in which wcsprm::zsource was measured.</span></div>
<div class="line"><a id="l01732" name="l01732"></a><span class="lineno"> 1732</span><span class="comment">*</span></div>
<div class="line"><a id="l01733" name="l01733"></a><span class="lineno"> 1733</span><span class="comment">*     It is not necessary to reset the wcsprm struct (via wcsset()) when</span></div>
<div class="line"><a id="l01734" name="l01734"></a><span class="lineno"> 1734</span><span class="comment">*     wcsprm::ssyssrc is changed.</span></div>
<div class="line"><a id="l01735" name="l01735"></a><span class="lineno"> 1735</span><span class="comment">*</span></div>
<div class="line"><a id="l01736" name="l01736"></a><span class="lineno"> 1736</span><span class="comment">*   double velangl</span></div>
<div class="line"><a id="l01737" name="l01737"></a><span class="lineno"> 1737</span><span class="comment">*     (Given, auxiliary) The angle [deg] that should be used to decompose an</span></div>
<div class="line"><a id="l01738" name="l01738"></a><span class="lineno"> 1738</span><span class="comment">*     observed velocity into radial and transverse components.</span></div>
<div class="line"><a id="l01739" name="l01739"></a><span class="lineno"> 1739</span><span class="comment">*</span></div>
<div class="line"><a id="l01740" name="l01740"></a><span class="lineno"> 1740</span><span class="comment">*     It is not necessary to reset the wcsprm struct (via wcsset()) when</span></div>
<div class="line"><a id="l01741" name="l01741"></a><span class="lineno"> 1741</span><span class="comment">*     wcsprm::velangl is changed.</span></div>
<div class="line"><a id="l01742" name="l01742"></a><span class="lineno"> 1742</span><span class="comment">*</span></div>
<div class="line"><a id="l01743" name="l01743"></a><span class="lineno"> 1743</span><span class="comment">*   struct auxprm *aux</span></div>
<div class="line"><a id="l01744" name="l01744"></a><span class="lineno"> 1744</span><span class="comment">*     (Given, auxiliary) This struct holds auxiliary coordinate system</span></div>
<div class="line"><a id="l01745" name="l01745"></a><span class="lineno"> 1745</span><span class="comment">*     information of a specialist nature.  While these parameters may be</span></div>
<div class="line"><a id="l01746" name="l01746"></a><span class="lineno"> 1746</span><span class="comment">*     widely recognized within particular fields of astronomy, they differ</span></div>
<div class="line"><a id="l01747" name="l01747"></a><span class="lineno"> 1747</span><span class="comment">*     from the above auxiliary parameters in not being defined by any of the</span></div>
<div class="line"><a id="l01748" name="l01748"></a><span class="lineno"> 1748</span><span class="comment">*     FITS WCS standards.  Collecting them together in a separate struct that</span></div>
<div class="line"><a id="l01749" name="l01749"></a><span class="lineno"> 1749</span><span class="comment">*     is allocated only when required helps to control bloat in the size of</span></div>
<div class="line"><a id="l01750" name="l01750"></a><span class="lineno"> 1750</span><span class="comment">*     the wcsprm struct.</span></div>
<div class="line"><a id="l01751" name="l01751"></a><span class="lineno"> 1751</span><span class="comment">*</span></div>
<div class="line"><a id="l01752" name="l01752"></a><span class="lineno"> 1752</span><span class="comment">*   int ntab</span></div>
<div class="line"><a id="l01753" name="l01753"></a><span class="lineno"> 1753</span><span class="comment">*     (Given) See wcsprm::tab.</span></div>
<div class="line"><a id="l01754" name="l01754"></a><span class="lineno"> 1754</span><span class="comment">*</span></div>
<div class="line"><a id="l01755" name="l01755"></a><span class="lineno"> 1755</span><span class="comment">*   int nwtb</span></div>
<div class="line"><a id="l01756" name="l01756"></a><span class="lineno"> 1756</span><span class="comment">*     (Given) See wcsprm::wtb.</span></div>
<div class="line"><a id="l01757" name="l01757"></a><span class="lineno"> 1757</span><span class="comment">*</span></div>
<div class="line"><a id="l01758" name="l01758"></a><span class="lineno"> 1758</span><span class="comment">*   struct tabprm *tab</span></div>
<div class="line"><a id="l01759" name="l01759"></a><span class="lineno"> 1759</span><span class="comment">*     (Given) Address of the first element of an array of ntab tabprm structs</span></div>
<div class="line"><a id="l01760" name="l01760"></a><span class="lineno"> 1760</span><span class="comment">*     for which memory has been allocated.  These are used to store tabular</span></div>
<div class="line"><a id="l01761" name="l01761"></a><span class="lineno"> 1761</span><span class="comment">*     transformation parameters.</span></div>
<div class="line"><a id="l01762" name="l01762"></a><span class="lineno"> 1762</span><span class="comment">*</span></div>
<div class="line"><a id="l01763" name="l01763"></a><span class="lineno"> 1763</span><span class="comment">*     Although technically wcsprm::ntab and tab are &quot;given&quot;, they will</span></div>
<div class="line"><a id="l01764" name="l01764"></a><span class="lineno"> 1764</span><span class="comment">*     normally be set by invoking wcstab(), whether directly or indirectly.</span></div>
<div class="line"><a id="l01765" name="l01765"></a><span class="lineno"> 1765</span><span class="comment">*</span></div>
<div class="line"><a id="l01766" name="l01766"></a><span class="lineno"> 1766</span><span class="comment">*     The tabprm structs contain some members that must be supplied and others</span></div>
<div class="line"><a id="l01767" name="l01767"></a><span class="lineno"> 1767</span><span class="comment">*     that are derived.  The information to be supplied comes primarily from</span></div>
<div class="line"><a id="l01768" name="l01768"></a><span class="lineno"> 1768</span><span class="comment">*     arrays stored in one or more FITS binary table extensions.  These</span></div>
<div class="line"><a id="l01769" name="l01769"></a><span class="lineno"> 1769</span><span class="comment">*     arrays, referred to here as &quot;wcstab arrays&quot;, are themselves located by</span></div>
<div class="line"><a id="l01770" name="l01770"></a><span class="lineno"> 1770</span><span class="comment">*     parameters stored in the FITS image header.</span></div>
<div class="line"><a id="l01771" name="l01771"></a><span class="lineno"> 1771</span><span class="comment">*</span></div>
<div class="line"><a id="l01772" name="l01772"></a><span class="lineno"> 1772</span><span class="comment">*   struct wtbarr *wtb</span></div>
<div class="line"><a id="l01773" name="l01773"></a><span class="lineno"> 1773</span><span class="comment">*     (Given) Address of the first element of an array of nwtb wtbarr structs</span></div>
<div class="line"><a id="l01774" name="l01774"></a><span class="lineno"> 1774</span><span class="comment">*     for which memory has been allocated.  These are used in extracting</span></div>
<div class="line"><a id="l01775" name="l01775"></a><span class="lineno"> 1775</span><span class="comment">*     wcstab arrays from a FITS binary table.</span></div>
<div class="line"><a id="l01776" name="l01776"></a><span class="lineno"> 1776</span><span class="comment">*</span></div>
<div class="line"><a id="l01777" name="l01777"></a><span class="lineno"> 1777</span><span class="comment">*     Although technically wcsprm::nwtb and wtb are &quot;given&quot;, they will</span></div>
<div class="line"><a id="l01778" name="l01778"></a><span class="lineno"> 1778</span><span class="comment">*     normally be set by invoking wcstab(), whether directly or indirectly.</span></div>
<div class="line"><a id="l01779" name="l01779"></a><span class="lineno"> 1779</span><span class="comment">*</span></div>
<div class="line"><a id="l01780" name="l01780"></a><span class="lineno"> 1780</span><span class="comment">*   char lngtyp[8]</span></div>
<div class="line"><a id="l01781" name="l01781"></a><span class="lineno"> 1781</span><span class="comment">*     (Returned) Four-character WCS celestial longitude and ...</span></div>
<div class="line"><a id="l01782" name="l01782"></a><span class="lineno"> 1782</span><span class="comment">*   char lattyp[8]</span></div>
<div class="line"><a id="l01783" name="l01783"></a><span class="lineno"> 1783</span><span class="comment">*     (Returned) ... latitude axis types. e.g. &quot;RA&quot;, &quot;DEC&quot;, &quot;GLON&quot;, &quot;GLAT&quot;,</span></div>
<div class="line"><a id="l01784" name="l01784"></a><span class="lineno"> 1784</span><span class="comment">*     etc. extracted from &#39;RA--&#39;, &#39;DEC-&#39;, &#39;GLON&#39;, &#39;GLAT&#39;, etc. in the first</span></div>
<div class="line"><a id="l01785" name="l01785"></a><span class="lineno"> 1785</span><span class="comment">*     four characters of CTYPEia but with trailing dashes removed.  (Declared</span></div>
<div class="line"><a id="l01786" name="l01786"></a><span class="lineno"> 1786</span><span class="comment">*     as char[8] for alignment reasons.)</span></div>
<div class="line"><a id="l01787" name="l01787"></a><span class="lineno"> 1787</span><span class="comment">*</span></div>
<div class="line"><a id="l01788" name="l01788"></a><span class="lineno"> 1788</span><span class="comment">*   int lng</span></div>
<div class="line"><a id="l01789" name="l01789"></a><span class="lineno"> 1789</span><span class="comment">*     (Returned) Index for the longitude coordinate, and ...</span></div>
<div class="line"><a id="l01790" name="l01790"></a><span class="lineno"> 1790</span><span class="comment">*   int lat</span></div>
<div class="line"><a id="l01791" name="l01791"></a><span class="lineno"> 1791</span><span class="comment">*     (Returned) ... index for the latitude coordinate, and ...</span></div>
<div class="line"><a id="l01792" name="l01792"></a><span class="lineno"> 1792</span><span class="comment">*   int spec</span></div>
<div class="line"><a id="l01793" name="l01793"></a><span class="lineno"> 1793</span><span class="comment">*     (Returned) ... index for the spectral coordinate, and ...</span></div>
<div class="line"><a id="l01794" name="l01794"></a><span class="lineno"> 1794</span><span class="comment">*   int time</span></div>
<div class="line"><a id="l01795" name="l01795"></a><span class="lineno"> 1795</span><span class="comment">*     (Returned) ... index for the time coordinate in the imgcrd[][] and</span></div>
<div class="line"><a id="l01796" name="l01796"></a><span class="lineno"> 1796</span><span class="comment">*     world[][] arrays in the API of wcsp2s(), wcss2p() and wcsmix().</span></div>
<div class="line"><a id="l01797" name="l01797"></a><span class="lineno"> 1797</span><span class="comment">*</span></div>
<div class="line"><a id="l01798" name="l01798"></a><span class="lineno"> 1798</span><span class="comment">*     These may also serve as indices into the pixcrd[][] array provided that</span></div>
<div class="line"><a id="l01799" name="l01799"></a><span class="lineno"> 1799</span><span class="comment">*     the PCi_ja matrix does not transpose axes.</span></div>
<div class="line"><a id="l01800" name="l01800"></a><span class="lineno"> 1800</span><span class="comment">*</span></div>
<div class="line"><a id="l01801" name="l01801"></a><span class="lineno"> 1801</span><span class="comment">*   int cubeface</span></div>
<div class="line"><a id="l01802" name="l01802"></a><span class="lineno"> 1802</span><span class="comment">*     (Returned) Index into the pixcrd[][] array for the CUBEFACE axis.  This</span></div>
<div class="line"><a id="l01803" name="l01803"></a><span class="lineno"> 1803</span><span class="comment">*     is used for quadcube projections where the cube faces are stored on a</span></div>
<div class="line"><a id="l01804" name="l01804"></a><span class="lineno"> 1804</span><span class="comment">*     separate axis (see wcs.h).</span></div>
<div class="line"><a id="l01805" name="l01805"></a><span class="lineno"> 1805</span><span class="comment">*</span></div>
<div class="line"><a id="l01806" name="l01806"></a><span class="lineno"> 1806</span><span class="comment">*   int *types</span></div>
<div class="line"><a id="l01807" name="l01807"></a><span class="lineno"> 1807</span><span class="comment">*     (Returned) Address of the first element of an array of int containing a</span></div>
<div class="line"><a id="l01808" name="l01808"></a><span class="lineno"> 1808</span><span class="comment">*     four-digit type code for each axis.</span></div>
<div class="line"><a id="l01809" name="l01809"></a><span class="lineno"> 1809</span><span class="comment">*</span></div>
<div class="line"><a id="l01810" name="l01810"></a><span class="lineno"> 1810</span><span class="comment">*     - First digit (i.e. 1000s):</span></div>
<div class="line"><a id="l01811" name="l01811"></a><span class="lineno"> 1811</span><span class="comment">*       - 0: Non-specific coordinate type.</span></div>
<div class="line"><a id="l01812" name="l01812"></a><span class="lineno"> 1812</span><span class="comment">*       - 1: Stokes coordinate.</span></div>
<div class="line"><a id="l01813" name="l01813"></a><span class="lineno"> 1813</span><span class="comment">*       - 2: Celestial coordinate (including CUBEFACE).</span></div>
<div class="line"><a id="l01814" name="l01814"></a><span class="lineno"> 1814</span><span class="comment">*       - 3: Spectral coordinate.</span></div>
<div class="line"><a id="l01815" name="l01815"></a><span class="lineno"> 1815</span><span class="comment">*       - 4: Time coordinate.</span></div>
<div class="line"><a id="l01816" name="l01816"></a><span class="lineno"> 1816</span><span class="comment">*</span></div>
<div class="line"><a id="l01817" name="l01817"></a><span class="lineno"> 1817</span><span class="comment">*     - Second digit (i.e. 100s):</span></div>
<div class="line"><a id="l01818" name="l01818"></a><span class="lineno"> 1818</span><span class="comment">*       - 0: Linear axis.</span></div>
<div class="line"><a id="l01819" name="l01819"></a><span class="lineno"> 1819</span><span class="comment">*       - 1: Quantized axis (STOKES, CUBEFACE).</span></div>
<div class="line"><a id="l01820" name="l01820"></a><span class="lineno"> 1820</span><span class="comment">*       - 2: Non-linear celestial axis.</span></div>
<div class="line"><a id="l01821" name="l01821"></a><span class="lineno"> 1821</span><span class="comment">*       - 3: Non-linear spectral axis.</span></div>
<div class="line"><a id="l01822" name="l01822"></a><span class="lineno"> 1822</span><span class="comment">*       - 4: Logarithmic axis.</span></div>
<div class="line"><a id="l01823" name="l01823"></a><span class="lineno"> 1823</span><span class="comment">*       - 5: Tabular axis.</span></div>
<div class="line"><a id="l01824" name="l01824"></a><span class="lineno"> 1824</span><span class="comment">*</span></div>
<div class="line"><a id="l01825" name="l01825"></a><span class="lineno"> 1825</span><span class="comment">*     - Third digit (i.e. 10s):</span></div>
<div class="line"><a id="l01826" name="l01826"></a><span class="lineno"> 1826</span><span class="comment">*       - 0: Group number, e.g. lookup table number, being an index into the</span></div>
<div class="line"><a id="l01827" name="l01827"></a><span class="lineno"> 1827</span><span class="comment">*            tabprm array (see above).</span></div>
<div class="line"><a id="l01828" name="l01828"></a><span class="lineno"> 1828</span><span class="comment">*</span></div>
<div class="line"><a id="l01829" name="l01829"></a><span class="lineno"> 1829</span><span class="comment">*     - The fourth digit is used as a qualifier depending on the axis type.</span></div>
<div class="line"><a id="l01830" name="l01830"></a><span class="lineno"> 1830</span><span class="comment">*</span></div>
<div class="line"><a id="l01831" name="l01831"></a><span class="lineno"> 1831</span><span class="comment">*       - For celestial axes:</span></div>
<div class="line"><a id="l01832" name="l01832"></a><span class="lineno"> 1832</span><span class="comment">*         - 0: Longitude coordinate.</span></div>
<div class="line"><a id="l01833" name="l01833"></a><span class="lineno"> 1833</span><span class="comment">*         - 1: Latitude coordinate.</span></div>
<div class="line"><a id="l01834" name="l01834"></a><span class="lineno"> 1834</span><span class="comment">*         - 2: CUBEFACE number.</span></div>
<div class="line"><a id="l01835" name="l01835"></a><span class="lineno"> 1835</span><span class="comment">*</span></div>
<div class="line"><a id="l01836" name="l01836"></a><span class="lineno"> 1836</span><span class="comment">*       - For lookup tables: the axis number in a multidimensional table.</span></div>
<div class="line"><a id="l01837" name="l01837"></a><span class="lineno"> 1837</span><span class="comment">*</span></div>
<div class="line"><a id="l01838" name="l01838"></a><span class="lineno"> 1838</span><span class="comment">*     CTYPEia in &quot;4-3&quot; form with unrecognized algorithm code will have its</span></div>
<div class="line"><a id="l01839" name="l01839"></a><span class="lineno"> 1839</span><span class="comment">*     type set to -1 and generate an error.</span></div>
<div class="line"><a id="l01840" name="l01840"></a><span class="lineno"> 1840</span><span class="comment">*</span></div>
<div class="line"><a id="l01841" name="l01841"></a><span class="lineno"> 1841</span><span class="comment">*   struct linprm lin</span></div>
<div class="line"><a id="l01842" name="l01842"></a><span class="lineno"> 1842</span><span class="comment">*     (Returned) Linear transformation parameters (usage is described in the</span></div>
<div class="line"><a id="l01843" name="l01843"></a><span class="lineno"> 1843</span><span class="comment">*     prologue to lin.h).</span></div>
<div class="line"><a id="l01844" name="l01844"></a><span class="lineno"> 1844</span><span class="comment">*</span></div>
<div class="line"><a id="l01845" name="l01845"></a><span class="lineno"> 1845</span><span class="comment">*   struct celprm cel</span></div>
<div class="line"><a id="l01846" name="l01846"></a><span class="lineno"> 1846</span><span class="comment">*     (Returned) Celestial transformation parameters (usage is described in</span></div>
<div class="line"><a id="l01847" name="l01847"></a><span class="lineno"> 1847</span><span class="comment">*     the prologue to cel.h).</span></div>
<div class="line"><a id="l01848" name="l01848"></a><span class="lineno"> 1848</span><span class="comment">*</span></div>
<div class="line"><a id="l01849" name="l01849"></a><span class="lineno"> 1849</span><span class="comment">*   struct spcprm spc</span></div>
<div class="line"><a id="l01850" name="l01850"></a><span class="lineno"> 1850</span><span class="comment">*     (Returned) Spectral transformation parameters (usage is described in the</span></div>
<div class="line"><a id="l01851" name="l01851"></a><span class="lineno"> 1851</span><span class="comment">*     prologue to spc.h).</span></div>
<div class="line"><a id="l01852" name="l01852"></a><span class="lineno"> 1852</span><span class="comment">*</span></div>
<div class="line"><a id="l01853" name="l01853"></a><span class="lineno"> 1853</span><span class="comment">*   struct wcserr *err</span></div>
<div class="line"><a id="l01854" name="l01854"></a><span class="lineno"> 1854</span><span class="comment">*     (Returned) If enabled, when an error status is returned, this struct</span></div>
<div class="line"><a id="l01855" name="l01855"></a><span class="lineno"> 1855</span><span class="comment">*     contains detailed information about the error, see wcserr_enable().</span></div>
<div class="line"><a id="l01856" name="l01856"></a><span class="lineno"> 1856</span><span class="comment">*</span></div>
<div class="line"><a id="l01857" name="l01857"></a><span class="lineno"> 1857</span><span class="comment">*   int m_flag</span></div>
<div class="line"><a id="l01858" name="l01858"></a><span class="lineno"> 1858</span><span class="comment">*     (For internal use only.)</span></div>
<div class="line"><a id="l01859" name="l01859"></a><span class="lineno"> 1859</span><span class="comment">*   int m_naxis</span></div>
<div class="line"><a id="l01860" name="l01860"></a><span class="lineno"> 1860</span><span class="comment">*     (For internal use only.)</span></div>
<div class="line"><a id="l01861" name="l01861"></a><span class="lineno"> 1861</span><span class="comment">*   double *m_crpix</span></div>
<div class="line"><a id="l01862" name="l01862"></a><span class="lineno"> 1862</span><span class="comment">*     (For internal use only.)</span></div>
<div class="line"><a id="l01863" name="l01863"></a><span class="lineno"> 1863</span><span class="comment">*   double *m_pc</span></div>
<div class="line"><a id="l01864" name="l01864"></a><span class="lineno"> 1864</span><span class="comment">*     (For internal use only.)</span></div>
<div class="line"><a id="l01865" name="l01865"></a><span class="lineno"> 1865</span><span class="comment">*   double *m_cdelt</span></div>
<div class="line"><a id="l01866" name="l01866"></a><span class="lineno"> 1866</span><span class="comment">*     (For internal use only.)</span></div>
<div class="line"><a id="l01867" name="l01867"></a><span class="lineno"> 1867</span><span class="comment">*   double *m_crval</span></div>
<div class="line"><a id="l01868" name="l01868"></a><span class="lineno"> 1868</span><span class="comment">*     (For internal use only.)</span></div>
<div class="line"><a id="l01869" name="l01869"></a><span class="lineno"> 1869</span><span class="comment">*   char (*m_cunit)[72]</span></div>
<div class="line"><a id="l01870" name="l01870"></a><span class="lineno"> 1870</span><span class="comment">*     (For internal use only.)</span></div>
<div class="line"><a id="l01871" name="l01871"></a><span class="lineno"> 1871</span><span class="comment">*   char (*m_ctype)[72]</span></div>
<div class="line"><a id="l01872" name="l01872"></a><span class="lineno"> 1872</span><span class="comment">*     (For internal use only.)</span></div>
<div class="line"><a id="l01873" name="l01873"></a><span class="lineno"> 1873</span><span class="comment">*   struct pvcard *m_pv</span></div>
<div class="line"><a id="l01874" name="l01874"></a><span class="lineno"> 1874</span><span class="comment">*     (For internal use only.)</span></div>
<div class="line"><a id="l01875" name="l01875"></a><span class="lineno"> 1875</span><span class="comment">*   struct pscard *m_ps</span></div>
<div class="line"><a id="l01876" name="l01876"></a><span class="lineno"> 1876</span><span class="comment">*     (For internal use only.)</span></div>
<div class="line"><a id="l01877" name="l01877"></a><span class="lineno"> 1877</span><span class="comment">*   double *m_cd</span></div>
<div class="line"><a id="l01878" name="l01878"></a><span class="lineno"> 1878</span><span class="comment">*     (For internal use only.)</span></div>
<div class="line"><a id="l01879" name="l01879"></a><span class="lineno"> 1879</span><span class="comment">*   double *m_crota</span></div>
<div class="line"><a id="l01880" name="l01880"></a><span class="lineno"> 1880</span><span class="comment">*     (For internal use only.)</span></div>
<div class="line"><a id="l01881" name="l01881"></a><span class="lineno"> 1881</span><span class="comment">*   int *m_colax</span></div>
<div class="line"><a id="l01882" name="l01882"></a><span class="lineno"> 1882</span><span class="comment">*     (For internal use only.)</span></div>
<div class="line"><a id="l01883" name="l01883"></a><span class="lineno"> 1883</span><span class="comment">*   char (*m_cname)[72]</span></div>
<div class="line"><a id="l01884" name="l01884"></a><span class="lineno"> 1884</span><span class="comment">*     (For internal use only.)</span></div>
<div class="line"><a id="l01885" name="l01885"></a><span class="lineno"> 1885</span><span class="comment">*   double *m_crder</span></div>
<div class="line"><a id="l01886" name="l01886"></a><span class="lineno"> 1886</span><span class="comment">*     (For internal use only.)</span></div>
<div class="line"><a id="l01887" name="l01887"></a><span class="lineno"> 1887</span><span class="comment">*   double *m_csyer</span></div>
<div class="line"><a id="l01888" name="l01888"></a><span class="lineno"> 1888</span><span class="comment">*     (For internal use only.)</span></div>
<div class="line"><a id="l01889" name="l01889"></a><span class="lineno"> 1889</span><span class="comment">*   double *m_czphs</span></div>
<div class="line"><a id="l01890" name="l01890"></a><span class="lineno"> 1890</span><span class="comment">*     (For internal use only.)</span></div>
<div class="line"><a id="l01891" name="l01891"></a><span class="lineno"> 1891</span><span class="comment">*   double *m_cperi</span></div>
<div class="line"><a id="l01892" name="l01892"></a><span class="lineno"> 1892</span><span class="comment">*     (For internal use only.)</span></div>
<div class="line"><a id="l01893" name="l01893"></a><span class="lineno"> 1893</span><span class="comment">*   struct tabprm *m_tab</span></div>
<div class="line"><a id="l01894" name="l01894"></a><span class="lineno"> 1894</span><span class="comment">*     (For internal use only.)</span></div>
<div class="line"><a id="l01895" name="l01895"></a><span class="lineno"> 1895</span><span class="comment">*   struct wtbarr *m_wtb</span></div>
<div class="line"><a id="l01896" name="l01896"></a><span class="lineno"> 1896</span><span class="comment">*     (For internal use only.)</span></div>
<div class="line"><a id="l01897" name="l01897"></a><span class="lineno"> 1897</span><span class="comment">*</span></div>
<div class="line"><a id="l01898" name="l01898"></a><span class="lineno"> 1898</span><span class="comment">*</span></div>
<div class="line"><a id="l01899" name="l01899"></a><span class="lineno"> 1899</span><span class="comment">* pvcard struct - Store for PVi_ma keyrecords</span></div>
<div class="line"><a id="l01900" name="l01900"></a><span class="lineno"> 1900</span><span class="comment">* -------------------------------------------</span></div>
<div class="line"><a id="l01901" name="l01901"></a><span class="lineno"> 1901</span><span class="comment">* The pvcard struct is used to pass the parsed contents of PVi_ma keyrecords</span></div>
<div class="line"><a id="l01902" name="l01902"></a><span class="lineno"> 1902</span><span class="comment">* to wcsset() via the wcsprm struct.</span></div>
<div class="line"><a id="l01903" name="l01903"></a><span class="lineno"> 1903</span><span class="comment">*</span></div>
<div class="line"><a id="l01904" name="l01904"></a><span class="lineno"> 1904</span><span class="comment">* All members of this struct are to be set by the user.</span></div>
<div class="line"><a id="l01905" name="l01905"></a><span class="lineno"> 1905</span><span class="comment">*</span></div>
<div class="line"><a id="l01906" name="l01906"></a><span class="lineno"> 1906</span><span class="comment">*   int i</span></div>
<div class="line"><a id="l01907" name="l01907"></a><span class="lineno"> 1907</span><span class="comment">*     (Given) Axis number (1-relative), as in the FITS PVi_ma keyword.  If</span></div>
<div class="line"><a id="l01908" name="l01908"></a><span class="lineno"> 1908</span><span class="comment">*     i == 0, wcsset() will replace it with the latitude axis number.</span></div>
<div class="line"><a id="l01909" name="l01909"></a><span class="lineno"> 1909</span><span class="comment">*</span></div>
<div class="line"><a id="l01910" name="l01910"></a><span class="lineno"> 1910</span><span class="comment">*   int m</span></div>
<div class="line"><a id="l01911" name="l01911"></a><span class="lineno"> 1911</span><span class="comment">*     (Given) Parameter number (non-negative), as in the FITS PVi_ma keyword.</span></div>
<div class="line"><a id="l01912" name="l01912"></a><span class="lineno"> 1912</span><span class="comment">*</span></div>
<div class="line"><a id="l01913" name="l01913"></a><span class="lineno"> 1913</span><span class="comment">*   double value</span></div>
<div class="line"><a id="l01914" name="l01914"></a><span class="lineno"> 1914</span><span class="comment">*     (Given) Parameter value.</span></div>
<div class="line"><a id="l01915" name="l01915"></a><span class="lineno"> 1915</span><span class="comment">*</span></div>
<div class="line"><a id="l01916" name="l01916"></a><span class="lineno"> 1916</span><span class="comment">*</span></div>
<div class="line"><a id="l01917" name="l01917"></a><span class="lineno"> 1917</span><span class="comment">* pscard struct - Store for PSi_ma keyrecords</span></div>
<div class="line"><a id="l01918" name="l01918"></a><span class="lineno"> 1918</span><span class="comment">* -------------------------------------------</span></div>
<div class="line"><a id="l01919" name="l01919"></a><span class="lineno"> 1919</span><span class="comment">* The pscard struct is used to pass the parsed contents of PSi_ma keyrecords</span></div>
<div class="line"><a id="l01920" name="l01920"></a><span class="lineno"> 1920</span><span class="comment">* to wcsset() via the wcsprm struct.</span></div>
<div class="line"><a id="l01921" name="l01921"></a><span class="lineno"> 1921</span><span class="comment">*</span></div>
<div class="line"><a id="l01922" name="l01922"></a><span class="lineno"> 1922</span><span class="comment">* All members of this struct are to be set by the user.</span></div>
<div class="line"><a id="l01923" name="l01923"></a><span class="lineno"> 1923</span><span class="comment">*</span></div>
<div class="line"><a id="l01924" name="l01924"></a><span class="lineno"> 1924</span><span class="comment">*   int i</span></div>
<div class="line"><a id="l01925" name="l01925"></a><span class="lineno"> 1925</span><span class="comment">*     (Given) Axis number (1-relative), as in the FITS PSi_ma keyword.</span></div>
<div class="line"><a id="l01926" name="l01926"></a><span class="lineno"> 1926</span><span class="comment">*</span></div>
<div class="line"><a id="l01927" name="l01927"></a><span class="lineno"> 1927</span><span class="comment">*   int m</span></div>
<div class="line"><a id="l01928" name="l01928"></a><span class="lineno"> 1928</span><span class="comment">*     (Given) Parameter number (non-negative), as in the FITS PSi_ma keyword.</span></div>
<div class="line"><a id="l01929" name="l01929"></a><span class="lineno"> 1929</span><span class="comment">*</span></div>
<div class="line"><a id="l01930" name="l01930"></a><span class="lineno"> 1930</span><span class="comment">*   char value[72]</span></div>
<div class="line"><a id="l01931" name="l01931"></a><span class="lineno"> 1931</span><span class="comment">*     (Given) Parameter value.</span></div>
<div class="line"><a id="l01932" name="l01932"></a><span class="lineno"> 1932</span><span class="comment">*</span></div>
<div class="line"><a id="l01933" name="l01933"></a><span class="lineno"> 1933</span><span class="comment">*</span></div>
<div class="line"><a id="l01934" name="l01934"></a><span class="lineno"> 1934</span><span class="comment">* auxprm struct - Additional auxiliary parameters</span></div>
<div class="line"><a id="l01935" name="l01935"></a><span class="lineno"> 1935</span><span class="comment">* -----------------------------------------------</span></div>
<div class="line"><a id="l01936" name="l01936"></a><span class="lineno"> 1936</span><span class="comment">* The auxprm struct holds auxiliary coordinate system information of a</span></div>
<div class="line"><a id="l01937" name="l01937"></a><span class="lineno"> 1937</span><span class="comment">* specialist nature.  It is anticipated that this struct will expand in future</span></div>
<div class="line"><a id="l01938" name="l01938"></a><span class="lineno"> 1938</span><span class="comment">* to accomodate additional parameters.</span></div>
<div class="line"><a id="l01939" name="l01939"></a><span class="lineno"> 1939</span><span class="comment">*</span></div>
<div class="line"><a id="l01940" name="l01940"></a><span class="lineno"> 1940</span><span class="comment">* All members of this struct are to be set by the user.</span></div>
<div class="line"><a id="l01941" name="l01941"></a><span class="lineno"> 1941</span><span class="comment">*</span></div>
<div class="line"><a id="l01942" name="l01942"></a><span class="lineno"> 1942</span><span class="comment">*   double rsun_ref</span></div>
<div class="line"><a id="l01943" name="l01943"></a><span class="lineno"> 1943</span><span class="comment">*     (Given, auxiliary) Reference radius of the Sun used in coordinate</span></div>
<div class="line"><a id="l01944" name="l01944"></a><span class="lineno"> 1944</span><span class="comment">*     calculations (m).</span></div>
<div class="line"><a id="l01945" name="l01945"></a><span class="lineno"> 1945</span><span class="comment">*</span></div>
<div class="line"><a id="l01946" name="l01946"></a><span class="lineno"> 1946</span><span class="comment">*   double dsun_obs</span></div>
<div class="line"><a id="l01947" name="l01947"></a><span class="lineno"> 1947</span><span class="comment">*     (Given, auxiliary) Distance between the centre of the Sun and the</span></div>
<div class="line"><a id="l01948" name="l01948"></a><span class="lineno"> 1948</span><span class="comment">*     observer (m).</span></div>
<div class="line"><a id="l01949" name="l01949"></a><span class="lineno"> 1949</span><span class="comment">*</span></div>
<div class="line"><a id="l01950" name="l01950"></a><span class="lineno"> 1950</span><span class="comment">*   double crln_obs</span></div>
<div class="line"><a id="l01951" name="l01951"></a><span class="lineno"> 1951</span><span class="comment">*     (Given, auxiliary) Carrington heliographic longitude of the observer</span></div>
<div class="line"><a id="l01952" name="l01952"></a><span class="lineno"> 1952</span><span class="comment">*     (deg).</span></div>
<div class="line"><a id="l01953" name="l01953"></a><span class="lineno"> 1953</span><span class="comment">*</span></div>
<div class="line"><a id="l01954" name="l01954"></a><span class="lineno"> 1954</span><span class="comment">*   double hgln_obs</span></div>
<div class="line"><a id="l01955" name="l01955"></a><span class="lineno"> 1955</span><span class="comment">*     (Given, auxiliary) Stonyhurst heliographic longitude of the observer</span></div>
<div class="line"><a id="l01956" name="l01956"></a><span class="lineno"> 1956</span><span class="comment">*     (deg).</span></div>
<div class="line"><a id="l01957" name="l01957"></a><span class="lineno"> 1957</span><span class="comment">*</span></div>
<div class="line"><a id="l01958" name="l01958"></a><span class="lineno"> 1958</span><span class="comment">*   double hglt_obs</span></div>
<div class="line"><a id="l01959" name="l01959"></a><span class="lineno"> 1959</span><span class="comment">*     (Given, auxiliary) Heliographic latitude (Carrington or Stonyhurst) of</span></div>
<div class="line"><a id="l01960" name="l01960"></a><span class="lineno"> 1960</span><span class="comment">*     the observer (deg).</span></div>
<div class="line"><a id="l01961" name="l01961"></a><span class="lineno"> 1961</span><span class="comment">*</span></div>
<div class="line"><a id="l01962" name="l01962"></a><span class="lineno"> 1962</span><span class="comment">*   double a_radius</span></div>
<div class="line"><a id="l01963" name="l01963"></a><span class="lineno"> 1963</span><span class="comment">*     Length of the semi-major axis of a triaxial ellipsoid approximating the</span></div>
<div class="line"><a id="l01964" name="l01964"></a><span class="lineno"> 1964</span><span class="comment">*     shape of a body (e.g. planet) in the solar system (m).</span></div>
<div class="line"><a id="l01965" name="l01965"></a><span class="lineno"> 1965</span><span class="comment">*</span></div>
<div class="line"><a id="l01966" name="l01966"></a><span class="lineno"> 1966</span><span class="comment">*   double b_radius</span></div>
<div class="line"><a id="l01967" name="l01967"></a><span class="lineno"> 1967</span><span class="comment">*     Length of the intermediate axis, normal to the semi-major and semi-minor</span></div>
<div class="line"><a id="l01968" name="l01968"></a><span class="lineno"> 1968</span><span class="comment">*     axes, of a triaxial ellipsoid approximating the shape of a body (m).</span></div>
<div class="line"><a id="l01969" name="l01969"></a><span class="lineno"> 1969</span><span class="comment">*</span></div>
<div class="line"><a id="l01970" name="l01970"></a><span class="lineno"> 1970</span><span class="comment">*   double c_radius</span></div>
<div class="line"><a id="l01971" name="l01971"></a><span class="lineno"> 1971</span><span class="comment">*     Length of the semi-minor axis, normal to the semi-major axis, of a</span></div>
<div class="line"><a id="l01972" name="l01972"></a><span class="lineno"> 1972</span><span class="comment">*     triaxial ellipsoid approximating the shape of a body (m).</span></div>
<div class="line"><a id="l01973" name="l01973"></a><span class="lineno"> 1973</span><span class="comment">*</span></div>
<div class="line"><a id="l01974" name="l01974"></a><span class="lineno"> 1974</span><span class="comment">*   double blon_obs</span></div>
<div class="line"><a id="l01975" name="l01975"></a><span class="lineno"> 1975</span><span class="comment">*     Bodycentric longitude of the observer in the coordinate system fixed to</span></div>
<div class="line"><a id="l01976" name="l01976"></a><span class="lineno"> 1976</span><span class="comment">*     the planet or other solar system body (deg, in range 0 to 360).</span></div>
<div class="line"><a id="l01977" name="l01977"></a><span class="lineno"> 1977</span><span class="comment">*</span></div>
<div class="line"><a id="l01978" name="l01978"></a><span class="lineno"> 1978</span><span class="comment">*   double blat_obs</span></div>
<div class="line"><a id="l01979" name="l01979"></a><span class="lineno"> 1979</span><span class="comment">*     Bodycentric latitude of the observer in the coordinate system fixed to</span></div>
<div class="line"><a id="l01980" name="l01980"></a><span class="lineno"> 1980</span><span class="comment">*     the planet or other solar system body (deg).</span></div>
<div class="line"><a id="l01981" name="l01981"></a><span class="lineno"> 1981</span><span class="comment">*</span></div>
<div class="line"><a id="l01982" name="l01982"></a><span class="lineno"> 1982</span><span class="comment">*   double bdis_obs</span></div>
<div class="line"><a id="l01983" name="l01983"></a><span class="lineno"> 1983</span><span class="comment">*     Bodycentric distance of the observer (m).</span></div>
<div class="line"><a id="l01984" name="l01984"></a><span class="lineno"> 1984</span><span class="comment">*</span></div>
<div class="line"><a id="l01985" name="l01985"></a><span class="lineno"> 1985</span><span class="comment">* Global variable: const char *wcs_errmsg[] - Status return messages</span></div>
<div class="line"><a id="l01986" name="l01986"></a><span class="lineno"> 1986</span><span class="comment">* ------------------------------------------------------------------</span></div>
<div class="line"><a id="l01987" name="l01987"></a><span class="lineno"> 1987</span><span class="comment">* Error messages to match the status value returned from each function.</span></div>
<div class="line"><a id="l01988" name="l01988"></a><span class="lineno"> 1988</span><span class="comment">*</span></div>
<div class="line"><a id="l01989" name="l01989"></a><span class="lineno"> 1989</span><span class="comment">*===========================================================================*/</span></div>
<div class="line"><a id="l01990" name="l01990"></a><span class="lineno"> 1990</span> </div>
<div class="line"><a id="l01991" name="l01991"></a><span class="lineno"> 1991</span><span class="preprocessor">#ifndef WCSLIB_WCS</span></div>
<div class="line"><a id="l01992" name="l01992"></a><span class="lineno"> 1992</span><span class="preprocessor">#define WCSLIB_WCS</span></div>
<div class="line"><a id="l01993" name="l01993"></a><span class="lineno"> 1993</span> </div>
<div class="line"><a id="l01994" name="l01994"></a><span class="lineno"> 1994</span><span class="preprocessor">#include &quot;<a class="code" href="lin_8h.html">lin.h</a>&quot;</span></div>
<div class="line"><a id="l01995" name="l01995"></a><span class="lineno"> 1995</span><span class="preprocessor">#include &quot;<a class="code" href="cel_8h.html">cel.h</a>&quot;</span></div>
<div class="line"><a id="l01996" name="l01996"></a><span class="lineno"> 1996</span><span class="preprocessor">#include &quot;<a class="code" href="spc_8h.html">spc.h</a>&quot;</span></div>
<div class="line"><a id="l01997" name="l01997"></a><span class="lineno"> 1997</span> </div>
<div class="line"><a id="l01998" name="l01998"></a><span class="lineno"> 1998</span><span class="preprocessor">#ifdef __cplusplus</span></div>
<div class="line"><a id="l01999" name="l01999"></a><span class="lineno"> 1999</span><span class="keyword">extern</span> <span class="stringliteral">&quot;C&quot;</span> {</div>
<div class="line"><a id="l02000" name="l02000"></a><span class="lineno"> 2000</span><span class="preprocessor">#define wtbarr wtbarr_s         </span><span class="comment">// See prologue of wtbarr.h.</span></div>
<div class="line"><a id="l02001" name="l02001"></a><span class="lineno"> 2001</span><span class="preprocessor">#endif</span></div>
<div class="line"><a id="l02002" name="l02002"></a><span class="lineno"> 2002</span> </div>
<div class="line"><a id="l02003" name="l02003"></a><span class="lineno"><a class="line" href="wcs_8h.html#a0653c98b8a1bee5755740ae3f4854094"> 2003</a></span><span class="preprocessor">#define WCSSUB_LONGITUDE 0x1001</span></div>
<div class="line"><a id="l02004" name="l02004"></a><span class="lineno"><a class="line" href="wcs_8h.html#a5d377c202850ee0eaf44b3e989d0736e"> 2004</a></span><span class="preprocessor">#define WCSSUB_LATITUDE  0x1002</span></div>
<div class="line"><a id="l02005" name="l02005"></a><span class="lineno"><a class="line" href="wcs_8h.html#a22bbac394b025c4cfc7bd73b6d6e3962"> 2005</a></span><span class="preprocessor">#define WCSSUB_CUBEFACE  0x1004</span></div>
<div class="line"><a id="l02006" name="l02006"></a><span class="lineno"><a class="line" href="wcs_8h.html#ab9885b02031ff7aa7b094f4a1edee2cd"> 2006</a></span><span class="preprocessor">#define WCSSUB_CELESTIAL 0x1007</span></div>
<div class="line"><a id="l02007" name="l02007"></a><span class="lineno"><a class="line" href="wcs_8h.html#a4b2dfca2e80fe80ba85dc830cd9c377b"> 2007</a></span><span class="preprocessor">#define WCSSUB_SPECTRAL  0x1008</span></div>
<div class="line"><a id="l02008" name="l02008"></a><span class="lineno"><a class="line" href="wcs_8h.html#a6ba6d2640572b12a11e3558fa75a01ed"> 2008</a></span><span class="preprocessor">#define WCSSUB_STOKES    0x1010</span></div>
<div class="line"><a id="l02009" name="l02009"></a><span class="lineno"><a class="line" href="wcs_8h.html#aac7a03c3bcf06926891a1badaa1e52e8"> 2009</a></span><span class="preprocessor">#define WCSSUB_TIME      0x1020</span></div>
<div class="line"><a id="l02010" name="l02010"></a><span class="lineno"> 2010</span> </div>
<div class="line"><a id="l02011" name="l02011"></a><span class="lineno"> 2011</span> </div>
<div class="line"><a id="l02012" name="l02012"></a><span class="lineno"><a class="line" href="wcs_8h.html#a232a0e8d0de3d599955e6eaef74067bc"> 2012</a></span><span class="preprocessor">#define WCSCOMPARE_ANCILLARY 0x0001</span></div>
<div class="line"><a id="l02013" name="l02013"></a><span class="lineno"><a class="line" href="wcs_8h.html#a22cc4f926c4cd495e45dfb773a6498d3"> 2013</a></span><span class="preprocessor">#define WCSCOMPARE_TILING    0x0002</span></div>
<div class="line"><a id="l02014" name="l02014"></a><span class="lineno"><a class="line" href="wcs_8h.html#a49672bfc5329d584fae143b6ddb6dc1d"> 2014</a></span><span class="preprocessor">#define WCSCOMPARE_CRPIX     0x0004</span></div>
<div class="line"><a id="l02015" name="l02015"></a><span class="lineno"> 2015</span> </div>
<div class="line"><a id="l02016" name="l02016"></a><span class="lineno"> 2016</span> </div>
<div class="line"><a id="l02017" name="l02017"></a><span class="lineno"> 2017</span><span class="keyword">extern</span> <span class="keyword">const</span> <span class="keywordtype">char</span> *<a class="code hl_variable" href="wcs_8h.html#a819013c42cbcb3c00603539c1d2aae2b">wcs_errmsg</a>[];</div>
<div class="line"><a id="l02018" name="l02018"></a><span class="lineno"> 2018</span> </div>
<div class="foldopen" id="foldopen02019" data-start="{" data-end="};">
<div class="line"><a id="l02019" name="l02019"></a><span class="lineno"><a class="line" href="wcs_8h.html#a158615aa1622d8feedd228795ff9a25f"> 2019</a></span><span class="keyword">enum</span> <a class="code hl_enumeration" href="wcs_8h.html#a158615aa1622d8feedd228795ff9a25f">wcs_errmsg_enum</a> {</div>
<div class="line"><a id="l02020" name="l02020"></a><span class="lineno"><a class="line" href="wcs_8h.html#a158615aa1622d8feedd228795ff9a25fa8b87c21d4a2cab41d4eea0a95378fca8"> 2020</a></span>  <a class="code hl_enumvalue" href="wcs_8h.html#a158615aa1622d8feedd228795ff9a25fa8b87c21d4a2cab41d4eea0a95378fca8">WCSERR_SUCCESS</a>         =  0,  <span class="comment">// Success.</span></div>
<div class="line"><a id="l02021" name="l02021"></a><span class="lineno"><a class="line" href="wcs_8h.html#a158615aa1622d8feedd228795ff9a25fac51c733d8a719dd698f9e96e9a4fa83f"> 2021</a></span>  <a class="code hl_enumvalue" href="wcs_8h.html#a158615aa1622d8feedd228795ff9a25fac51c733d8a719dd698f9e96e9a4fa83f">WCSERR_NULL_POINTER</a>    =  1,  <span class="comment">// Null wcsprm pointer passed.</span></div>
<div class="line"><a id="l02022" name="l02022"></a><span class="lineno"><a class="line" href="wcs_8h.html#a158615aa1622d8feedd228795ff9a25fa5c58d5530bc7577a70185376c15180af"> 2022</a></span>  <a class="code hl_enumvalue" href="wcs_8h.html#a158615aa1622d8feedd228795ff9a25fa5c58d5530bc7577a70185376c15180af">WCSERR_MEMORY</a>          =  2,  <span class="comment">// Memory allocation failed.</span></div>
<div class="line"><a id="l02023" name="l02023"></a><span class="lineno"><a class="line" href="wcs_8h.html#a158615aa1622d8feedd228795ff9a25fa2904278d916c820236347783312a7ce0"> 2023</a></span>  <a class="code hl_enumvalue" href="wcs_8h.html#a158615aa1622d8feedd228795ff9a25fa2904278d916c820236347783312a7ce0">WCSERR_SINGULAR_MTX</a>    =  3,  <span class="comment">// Linear transformation matrix is singular.</span></div>
<div class="line"><a id="l02024" name="l02024"></a><span class="lineno"><a class="line" href="wcs_8h.html#a158615aa1622d8feedd228795ff9a25fa598db0fcc4961aa3c5e0a296bec2b313"> 2024</a></span>  <a class="code hl_enumvalue" href="wcs_8h.html#a158615aa1622d8feedd228795ff9a25fa598db0fcc4961aa3c5e0a296bec2b313">WCSERR_BAD_CTYPE</a>       =  4,  <span class="comment">// Inconsistent or unrecognized coordinate</span></div>
<div class="line"><a id="l02025" name="l02025"></a><span class="lineno"> 2025</span>                                <span class="comment">// axis type.</span></div>
<div class="line"><a id="l02026" name="l02026"></a><span class="lineno"><a class="line" href="wcs_8h.html#a158615aa1622d8feedd228795ff9a25fafe9ed842ea8f525c7b8fed2f60015dd9"> 2026</a></span>  <a class="code hl_enumvalue" href="wcs_8h.html#a158615aa1622d8feedd228795ff9a25fafe9ed842ea8f525c7b8fed2f60015dd9">WCSERR_BAD_PARAM</a>       =  5,  <span class="comment">// Invalid parameter value.</span></div>
<div class="line"><a id="l02027" name="l02027"></a><span class="lineno"><a class="line" href="wcs_8h.html#a158615aa1622d8feedd228795ff9a25fa71cb7eaa633d9e0f560555a016f1f007"> 2027</a></span>  <a class="code hl_enumvalue" href="wcs_8h.html#a158615aa1622d8feedd228795ff9a25fa71cb7eaa633d9e0f560555a016f1f007">WCSERR_BAD_COORD_TRANS</a> =  6,  <span class="comment">// Unrecognized coordinate transformation</span></div>
<div class="line"><a id="l02028" name="l02028"></a><span class="lineno"> 2028</span>                                <span class="comment">// parameter.</span></div>
<div class="line"><a id="l02029" name="l02029"></a><span class="lineno"><a class="line" href="wcs_8h.html#a158615aa1622d8feedd228795ff9a25fadfa2a8cf8021827378091315b8e0a020"> 2029</a></span>  <a class="code hl_enumvalue" href="wcs_8h.html#a158615aa1622d8feedd228795ff9a25fadfa2a8cf8021827378091315b8e0a020">WCSERR_ILL_COORD_TRANS</a> =  7,  <span class="comment">// Ill-conditioned coordinate transformation</span></div>
<div class="line"><a id="l02030" name="l02030"></a><span class="lineno"> 2030</span>                                <span class="comment">// parameter.</span></div>
<div class="line"><a id="l02031" name="l02031"></a><span class="lineno"><a class="line" href="wcs_8h.html#a158615aa1622d8feedd228795ff9a25fa08306533cf0c7555dad662e82e8a4a69"> 2031</a></span>  <a class="code hl_enumvalue" href="wcs_8h.html#a158615aa1622d8feedd228795ff9a25fa08306533cf0c7555dad662e82e8a4a69">WCSERR_BAD_PIX</a>         =  8,  <span class="comment">// One or more of the pixel coordinates were</span></div>
<div class="line"><a id="l02032" name="l02032"></a><span class="lineno"> 2032</span>                                <span class="comment">// invalid.</span></div>
<div class="line"><a id="l02033" name="l02033"></a><span class="lineno"><a class="line" href="wcs_8h.html#a158615aa1622d8feedd228795ff9a25fa03824b7b5c22e5f0cc91363eb695a804"> 2033</a></span>  <a class="code hl_enumvalue" href="wcs_8h.html#a158615aa1622d8feedd228795ff9a25fa03824b7b5c22e5f0cc91363eb695a804">WCSERR_BAD_WORLD</a>       =  9,  <span class="comment">// One or more of the world coordinates were</span></div>
<div class="line"><a id="l02034" name="l02034"></a><span class="lineno"> 2034</span>                                <span class="comment">// invalid.</span></div>
<div class="line"><a id="l02035" name="l02035"></a><span class="lineno"><a class="line" href="wcs_8h.html#a158615aa1622d8feedd228795ff9a25fa5d662102c172495df1f9bb03cedd701d"> 2035</a></span>  <a class="code hl_enumvalue" href="wcs_8h.html#a158615aa1622d8feedd228795ff9a25fa5d662102c172495df1f9bb03cedd701d">WCSERR_BAD_WORLD_COORD</a> = 10,  <span class="comment">// Invalid world coordinate.</span></div>
<div class="line"><a id="l02036" name="l02036"></a><span class="lineno"><a class="line" href="wcs_8h.html#a158615aa1622d8feedd228795ff9a25fa832122bb304560f92df91e391d55948a"> 2036</a></span>  <a class="code hl_enumvalue" href="wcs_8h.html#a158615aa1622d8feedd228795ff9a25fa832122bb304560f92df91e391d55948a">WCSERR_NO_SOLUTION</a>     = 11,  <span class="comment">// No solution found in the specified</span></div>
<div class="line"><a id="l02037" name="l02037"></a><span class="lineno"> 2037</span>                                <span class="comment">// interval.</span></div>
<div class="line"><a id="l02038" name="l02038"></a><span class="lineno"><a class="line" href="wcs_8h.html#a158615aa1622d8feedd228795ff9a25fa88e600163f719a759d3569bf1548109e"> 2038</a></span>  <a class="code hl_enumvalue" href="wcs_8h.html#a158615aa1622d8feedd228795ff9a25fa88e600163f719a759d3569bf1548109e">WCSERR_BAD_SUBIMAGE</a>    = 12,  <span class="comment">// Invalid subimage specification.</span></div>
<div class="line"><a id="l02039" name="l02039"></a><span class="lineno"><a class="line" href="wcs_8h.html#a158615aa1622d8feedd228795ff9a25fa37c8aa0aedc12c63df08f39cb7177ff7"> 2039</a></span>  <a class="code hl_enumvalue" href="wcs_8h.html#a158615aa1622d8feedd228795ff9a25fa37c8aa0aedc12c63df08f39cb7177ff7">WCSERR_NON_SEPARABLE</a>   = 13,  <span class="comment">// Non-separable subimage coordinate system.</span></div>
<div class="line"><a id="l02040" name="l02040"></a><span class="lineno"> 2040</span>  <a class="code hl_enumvalue" href="wcs_8h.html#a158615aa1622d8feedd228795ff9a25fab4762a0c9a51284be7259a14ab63496b">WCSERR_UNSET</a>           = 14   <span class="comment">// wcsprm struct is unset.</span></div>
<div class="line"><a id="l02041" name="l02041"></a><span class="lineno"><a class="line" href="wcs_8h.html#a158615aa1622d8feedd228795ff9a25fab4762a0c9a51284be7259a14ab63496b"> 2041</a></span>};</div>
</div>
<div class="line"><a id="l02042" name="l02042"></a><span class="lineno"> 2042</span> </div>
<div class="line"><a id="l02043" name="l02043"></a><span class="lineno"> 2043</span> </div>
<div class="line"><a id="l02044" name="l02044"></a><span class="lineno"> 2044</span><span class="comment">// Struct used for storing PVi_ma keywords.</span></div>
<div class="foldopen" id="foldopen02045" data-start="{" data-end="};">
<div class="line"><a id="l02045" name="l02045"></a><span class="lineno"><a class="line" href="structpvcard.html"> 2045</a></span><span class="keyword">struct </span><a class="code hl_struct" href="structpvcard.html">pvcard</a> {</div>
<div class="line"><a id="l02046" name="l02046"></a><span class="lineno"><a class="line" href="structpvcard.html#a88fa516543184eaffe6bd2c57946d9a7"> 2046</a></span>  <span class="keywordtype">int</span> <a class="code hl_variable" href="structpvcard.html#a88fa516543184eaffe6bd2c57946d9a7">i</a>;                        <span class="comment">// Axis number, as in PVi_ma (1-relative).</span></div>
<div class="line"><a id="l02047" name="l02047"></a><span class="lineno"><a class="line" href="structpvcard.html#af011f1972d6d345540f36a5c08a30d1f"> 2047</a></span>  <span class="keywordtype">int</span> <a class="code hl_variable" href="structpvcard.html#af011f1972d6d345540f36a5c08a30d1f">m</a>;                        <span class="comment">// Parameter number, ditto  (0-relative).</span></div>
<div class="line"><a id="l02048" name="l02048"></a><span class="lineno"><a class="line" href="structpvcard.html#a5c97562bbadb55b8a2db59d9c7878059"> 2048</a></span>  <span class="keywordtype">double</span> <a class="code hl_variable" href="structpvcard.html#a5c97562bbadb55b8a2db59d9c7878059">value</a>;                 <span class="comment">// Parameter value.</span></div>
<div class="line"><a id="l02049" name="l02049"></a><span class="lineno"> 2049</span>};</div>
</div>
<div class="line"><a id="l02050" name="l02050"></a><span class="lineno"> 2050</span> </div>
<div class="line"><a id="l02051" name="l02051"></a><span class="lineno"> 2051</span><span class="comment">// Size of the pvcard struct in int units, used by the Fortran wrappers.</span></div>
<div class="line"><a id="l02052" name="l02052"></a><span class="lineno"><a class="line" href="wcs_8h.html#a1566e29507c2ebab2367e00b2411a3ec"> 2052</a></span><span class="preprocessor">#define PVLEN (sizeof(struct pvcard)/sizeof(int))</span></div>
<div class="line"><a id="l02053" name="l02053"></a><span class="lineno"> 2053</span> </div>
<div class="line"><a id="l02054" name="l02054"></a><span class="lineno"> 2054</span><span class="comment">// Struct used for storing PSi_ma keywords.</span></div>
<div class="foldopen" id="foldopen02055" data-start="{" data-end="};">
<div class="line"><a id="l02055" name="l02055"></a><span class="lineno"><a class="line" href="structpscard.html"> 2055</a></span><span class="keyword">struct </span><a class="code hl_struct" href="structpscard.html">pscard</a> {</div>
<div class="line"><a id="l02056" name="l02056"></a><span class="lineno"><a class="line" href="structpscard.html#a37a06c885cf73736f2eb5e78bd1034a1"> 2056</a></span>  <span class="keywordtype">int</span> <a class="code hl_variable" href="structpscard.html#a37a06c885cf73736f2eb5e78bd1034a1">i</a>;                        <span class="comment">// Axis number, as in PSi_ma (1-relative).</span></div>
<div class="line"><a id="l02057" name="l02057"></a><span class="lineno"><a class="line" href="structpscard.html#a71912f084bc3cadeb0758756a723071a"> 2057</a></span>  <span class="keywordtype">int</span> <a class="code hl_variable" href="structpscard.html#a71912f084bc3cadeb0758756a723071a">m</a>;                        <span class="comment">// Parameter number, ditto  (0-relative).</span></div>
<div class="line"><a id="l02058" name="l02058"></a><span class="lineno"><a class="line" href="structpscard.html#a9986f2ace84978f6cc543224b57592c9"> 2058</a></span>  <span class="keywordtype">char</span> <a class="code hl_variable" href="structpscard.html#a9986f2ace84978f6cc543224b57592c9">value</a>[72];               <span class="comment">// Parameter value.</span></div>
<div class="line"><a id="l02059" name="l02059"></a><span class="lineno"> 2059</span>};</div>
</div>
<div class="line"><a id="l02060" name="l02060"></a><span class="lineno"> 2060</span> </div>
<div class="line"><a id="l02061" name="l02061"></a><span class="lineno"> 2061</span><span class="comment">// Size of the pscard struct in int units, used by the Fortran wrappers.</span></div>
<div class="line"><a id="l02062" name="l02062"></a><span class="lineno"><a class="line" href="wcs_8h.html#a62456c216a0945640783a5c3c68a4777"> 2062</a></span><span class="preprocessor">#define PSLEN (sizeof(struct pscard)/sizeof(int))</span></div>
<div class="line"><a id="l02063" name="l02063"></a><span class="lineno"> 2063</span> </div>
<div class="line"><a id="l02064" name="l02064"></a><span class="lineno"> 2064</span><span class="comment">// Struct used to hold additional auxiliary parameters.</span></div>
<div class="foldopen" id="foldopen02065" data-start="{" data-end="};">
<div class="line"><a id="l02065" name="l02065"></a><span class="lineno"><a class="line" href="structauxprm.html"> 2065</a></span><span class="keyword">struct </span><a class="code hl_struct" href="structauxprm.html">auxprm</a> {</div>
<div class="line"><a id="l02066" name="l02066"></a><span class="lineno"><a class="line" href="structauxprm.html#ae90fd56f574beaf8a3c5d7136bfb4a01"> 2066</a></span>  <span class="keywordtype">double</span> <a class="code hl_variable" href="structauxprm.html#ae90fd56f574beaf8a3c5d7136bfb4a01">rsun_ref</a>;              <span class="comment">// Solar radius.</span></div>
<div class="line"><a id="l02067" name="l02067"></a><span class="lineno"><a class="line" href="structauxprm.html#a0319d8103f0f0a166715e74e329ded2d"> 2067</a></span>  <span class="keywordtype">double</span> <a class="code hl_variable" href="structauxprm.html#a0319d8103f0f0a166715e74e329ded2d">dsun_obs</a>;              <span class="comment">// Distance from Sun centre to observer.</span></div>
<div class="line"><a id="l02068" name="l02068"></a><span class="lineno"><a class="line" href="structauxprm.html#a8b058da5ec51c0521776cf96ce3a987a"> 2068</a></span>  <span class="keywordtype">double</span> <a class="code hl_variable" href="structauxprm.html#a8b058da5ec51c0521776cf96ce3a987a">crln_obs</a>;              <span class="comment">// Carrington heliographic lng of observer.</span></div>
<div class="line"><a id="l02069" name="l02069"></a><span class="lineno"><a class="line" href="structauxprm.html#a817ab87c5da2299e795cc260ad563436"> 2069</a></span>  <span class="keywordtype">double</span> <a class="code hl_variable" href="structauxprm.html#a817ab87c5da2299e795cc260ad563436">hgln_obs</a>;              <span class="comment">// Stonyhurst heliographic lng of observer.</span></div>
<div class="line"><a id="l02070" name="l02070"></a><span class="lineno"><a class="line" href="structauxprm.html#a5a596e2c4371fa92d04b64a4be6207ae"> 2070</a></span>  <span class="keywordtype">double</span> <a class="code hl_variable" href="structauxprm.html#a5a596e2c4371fa92d04b64a4be6207ae">hglt_obs</a>;              <span class="comment">// Heliographic latitude of observer.</span></div>
<div class="line"><a id="l02071" name="l02071"></a><span class="lineno"> 2071</span> </div>
<div class="line"><a id="l02072" name="l02072"></a><span class="lineno"><a class="line" href="structauxprm.html#ad4ca1436fb83cefcbdbe3f985a515552"> 2072</a></span>  <span class="keywordtype">double</span> <a class="code hl_variable" href="structauxprm.html#ad4ca1436fb83cefcbdbe3f985a515552">a_radius</a>;              <span class="comment">// Semi-major axis of solar system body.</span></div>
<div class="line"><a id="l02073" name="l02073"></a><span class="lineno"><a class="line" href="structauxprm.html#aa12b84a421a5d852c469fada87d3149b"> 2073</a></span>  <span class="keywordtype">double</span> <a class="code hl_variable" href="structauxprm.html#aa12b84a421a5d852c469fada87d3149b">b_radius</a>;              <span class="comment">// Semi-intermediate axis of solar system body.</span></div>
<div class="line"><a id="l02074" name="l02074"></a><span class="lineno"><a class="line" href="structauxprm.html#a6de4cfed899ff4db5225ccc4d44b5fd7"> 2074</a></span>  <span class="keywordtype">double</span> <a class="code hl_variable" href="structauxprm.html#a6de4cfed899ff4db5225ccc4d44b5fd7">c_radius</a>;              <span class="comment">// Semi-minor axis of solar system body.</span></div>
<div class="line"><a id="l02075" name="l02075"></a><span class="lineno"><a class="line" href="structauxprm.html#abf9924ec2b288ba8f548bfc6b72b0321"> 2075</a></span>  <span class="keywordtype">double</span> <a class="code hl_variable" href="structauxprm.html#abf9924ec2b288ba8f548bfc6b72b0321">blon_obs</a>;              <span class="comment">// Bodycentric longitude of observer.</span></div>
<div class="line"><a id="l02076" name="l02076"></a><span class="lineno"><a class="line" href="structauxprm.html#af4d7e22bc28d11d46a9bdbf5e48561ea"> 2076</a></span>  <span class="keywordtype">double</span> <a class="code hl_variable" href="structauxprm.html#af4d7e22bc28d11d46a9bdbf5e48561ea">blat_obs</a>;              <span class="comment">// Bodycentric latitude of observer.</span></div>
<div class="line"><a id="l02077" name="l02077"></a><span class="lineno"><a class="line" href="structauxprm.html#af14345ab9fa7b6767d00dffee303a42c"> 2077</a></span>  <span class="keywordtype">double</span> <a class="code hl_variable" href="structauxprm.html#af14345ab9fa7b6767d00dffee303a42c">bdis_obs</a>;              <span class="comment">// Bodycentric distance of observer.</span></div>
<div class="line"><a id="l02078" name="l02078"></a><span class="lineno"><a class="line" href="structauxprm.html#a87eb38047efbafe866142ea915bab39d"> 2078</a></span>  <span class="keywordtype">double</span> <a class="code hl_variable" href="structauxprm.html#a87eb38047efbafe866142ea915bab39d">dummy</a>[2];              <span class="comment">// Reserved for future use.</span></div>
<div class="line"><a id="l02079" name="l02079"></a><span class="lineno"> 2079</span>};</div>
</div>
<div class="line"><a id="l02080" name="l02080"></a><span class="lineno"> 2080</span> </div>
<div class="line"><a id="l02081" name="l02081"></a><span class="lineno"> 2081</span><span class="comment">// Size of the auxprm struct in int units, used by the Fortran wrappers.</span></div>
<div class="line"><a id="l02082" name="l02082"></a><span class="lineno"><a class="line" href="wcs_8h.html#afdf336f35dd8793657bcd63fd1e53836"> 2082</a></span><span class="preprocessor">#define AUXLEN (sizeof(struct auxprm)/sizeof(int))</span></div>
<div class="line"><a id="l02083" name="l02083"></a><span class="lineno"> 2083</span> </div>
<div class="line"><a id="l02084" name="l02084"></a><span class="lineno"> 2084</span> </div>
<div class="foldopen" id="foldopen02085" data-start="{" data-end="};">
<div class="line"><a id="l02085" name="l02085"></a><span class="lineno"><a class="line" href="structwcsprm.html"> 2085</a></span><span class="keyword">struct </span><a class="code hl_struct" href="structwcsprm.html">wcsprm</a> {</div>
<div class="line"><a id="l02086" name="l02086"></a><span class="lineno"> 2086</span>  <span class="comment">// Initialization flag (see the prologue above).</span></div>
<div class="line"><a id="l02087" name="l02087"></a><span class="lineno"> 2087</span>  <span class="comment">//--------------------------------------------------------------------------</span></div>
<div class="line"><a id="l02088" name="l02088"></a><span class="lineno"><a class="line" href="structwcsprm.html#a35bff8de85e5a8892e1b68db69ca7a68"> 2088</a></span>  <span class="keywordtype">int</span>    <a class="code hl_variable" href="structwcsprm.html#a35bff8de85e5a8892e1b68db69ca7a68">flag</a>;                  <span class="comment">// Set to zero to force initialization.</span></div>
<div class="line"><a id="l02089" name="l02089"></a><span class="lineno"> 2089</span> </div>
<div class="line"><a id="l02090" name="l02090"></a><span class="lineno"> 2090</span>  <span class="comment">// FITS header keyvalues to be provided (see the prologue above).</span></div>
<div class="line"><a id="l02091" name="l02091"></a><span class="lineno"> 2091</span>  <span class="comment">//--------------------------------------------------------------------------</span></div>
<div class="line"><a id="l02092" name="l02092"></a><span class="lineno"><a class="line" href="structwcsprm.html#a70cac2976524a5f0a6aeb2b3fcb95834"> 2092</a></span>  <span class="keywordtype">int</span>    <a class="code hl_variable" href="structwcsprm.html#a70cac2976524a5f0a6aeb2b3fcb95834">naxis</a>;                 <span class="comment">// Number of axes (pixel and coordinate).</span></div>
<div class="line"><a id="l02093" name="l02093"></a><span class="lineno"><a class="line" href="structwcsprm.html#aadad828f07e3affd1511e533b00da19f"> 2093</a></span>  <span class="keywordtype">double</span> *<a class="code hl_variable" href="structwcsprm.html#aadad828f07e3affd1511e533b00da19f">crpix</a>;                <span class="comment">// CRPIXja keyvalues for each pixel axis.</span></div>
<div class="line"><a id="l02094" name="l02094"></a><span class="lineno"><a class="line" href="structwcsprm.html#a3495a5b0ef529706ec9a0af5c3163d63"> 2094</a></span>  <span class="keywordtype">double</span> *<a class="code hl_variable" href="structwcsprm.html#a3495a5b0ef529706ec9a0af5c3163d63">pc</a>;                   <span class="comment">// PCi_ja  linear transformation matrix.</span></div>
<div class="line"><a id="l02095" name="l02095"></a><span class="lineno"><a class="line" href="structwcsprm.html#ade355cdce054938cfa36e06ef9c51446"> 2095</a></span>  <span class="keywordtype">double</span> *<a class="code hl_variable" href="structwcsprm.html#ade355cdce054938cfa36e06ef9c51446">cdelt</a>;                <span class="comment">// CDELTia keyvalues for each coord axis.</span></div>
<div class="line"><a id="l02096" name="l02096"></a><span class="lineno"><a class="line" href="structwcsprm.html#a7a0a1ce2432cef9377f70367ea1fd18c"> 2096</a></span>  <span class="keywordtype">double</span> *<a class="code hl_variable" href="structwcsprm.html#a7a0a1ce2432cef9377f70367ea1fd18c">crval</a>;                <span class="comment">// CRVALia keyvalues for each coord axis.</span></div>
<div class="line"><a id="l02097" name="l02097"></a><span class="lineno"> 2097</span> </div>
<div class="line"><a id="l02098" name="l02098"></a><span class="lineno"><a class="line" href="structwcsprm.html#aa0ae3f3605566be2e85e51e5b52c3b52"> 2098</a></span>  char   (*<a class="code hl_variable" href="structwcsprm.html#aa0ae3f3605566be2e85e51e5b52c3b52">cunit</a>)[72];          <span class="comment">// CUNITia keyvalues for each coord axis.</span></div>
<div class="line"><a id="l02099" name="l02099"></a><span class="lineno"><a class="line" href="structwcsprm.html#ae1f462606974e1324cd38f143eda691e"> 2099</a></span>  char   (*<a class="code hl_variable" href="structwcsprm.html#ae1f462606974e1324cd38f143eda691e">ctype</a>)[72];          <span class="comment">// CTYPEia keyvalues for each coord axis.</span></div>
<div class="line"><a id="l02100" name="l02100"></a><span class="lineno"> 2100</span> </div>
<div class="line"><a id="l02101" name="l02101"></a><span class="lineno"><a class="line" href="structwcsprm.html#af8f679749574250cb9ba09e1f05fab5d"> 2101</a></span>  <span class="keywordtype">double</span> <a class="code hl_variable" href="structwcsprm.html#af8f679749574250cb9ba09e1f05fab5d">lonpole</a>;               <span class="comment">// LONPOLEa keyvalue.</span></div>
<div class="line"><a id="l02102" name="l02102"></a><span class="lineno"><a class="line" href="structwcsprm.html#a5e04127eb71da6e1350467a7a6d236f5"> 2102</a></span>  <span class="keywordtype">double</span> <a class="code hl_variable" href="structwcsprm.html#a5e04127eb71da6e1350467a7a6d236f5">latpole</a>;               <span class="comment">// LATPOLEa keyvalue.</span></div>
<div class="line"><a id="l02103" name="l02103"></a><span class="lineno"> 2103</span> </div>
<div class="line"><a id="l02104" name="l02104"></a><span class="lineno"><a class="line" href="structwcsprm.html#ada1b98589c0127d34766b4c6b5d6cb41"> 2104</a></span>  <span class="keywordtype">double</span> <a class="code hl_variable" href="structwcsprm.html#ada1b98589c0127d34766b4c6b5d6cb41">restfrq</a>;               <span class="comment">// RESTFRQa keyvalue.</span></div>
<div class="line"><a id="l02105" name="l02105"></a><span class="lineno"><a class="line" href="structwcsprm.html#a5d0b60efc55a61525b9beb26ead4859e"> 2105</a></span>  <span class="keywordtype">double</span> <a class="code hl_variable" href="structwcsprm.html#a5d0b60efc55a61525b9beb26ead4859e">restwav</a>;               <span class="comment">// RESTWAVa keyvalue.</span></div>
<div class="line"><a id="l02106" name="l02106"></a><span class="lineno"> 2106</span> </div>
<div class="line"><a id="l02107" name="l02107"></a><span class="lineno"><a class="line" href="structwcsprm.html#a0e31f1eef036258c2957da9b985945dd"> 2107</a></span>  <span class="keywordtype">int</span>    <a class="code hl_variable" href="structwcsprm.html#a0e31f1eef036258c2957da9b985945dd">npv</a>;                   <span class="comment">// Number of PVi_ma keywords, and the</span></div>
<div class="line"><a id="l02108" name="l02108"></a><span class="lineno"><a class="line" href="structwcsprm.html#a912eed291f15134e8cfb8750acc6c4bc"> 2108</a></span>  <span class="keywordtype">int</span>    <a class="code hl_variable" href="structwcsprm.html#a912eed291f15134e8cfb8750acc6c4bc">npvmax</a>;                <span class="comment">// number for which space was allocated.</span></div>
<div class="line"><a id="l02109" name="l02109"></a><span class="lineno"><a class="line" href="structwcsprm.html#a04fbd6ed1b338e225f2291523e64be2c"> 2109</a></span>  <span class="keyword">struct </span><a class="code hl_struct" href="structpvcard.html">pvcard</a> *<a class="code hl_variable" href="structwcsprm.html#a04fbd6ed1b338e225f2291523e64be2c">pv</a>;            <span class="comment">// PVi_ma keywords for each i and m.</span></div>
<div class="line"><a id="l02110" name="l02110"></a><span class="lineno"> 2110</span> </div>
<div class="line"><a id="l02111" name="l02111"></a><span class="lineno"><a class="line" href="structwcsprm.html#a4c89dafecd036e169f96cb84d53ace65"> 2111</a></span>  <span class="keywordtype">int</span>    <a class="code hl_variable" href="structwcsprm.html#a4c89dafecd036e169f96cb84d53ace65">nps</a>;                   <span class="comment">// Number of PSi_ma keywords, and the</span></div>
<div class="line"><a id="l02112" name="l02112"></a><span class="lineno"><a class="line" href="structwcsprm.html#a42052d557bdef2c5640a6d19b6d9ed8b"> 2112</a></span>  <span class="keywordtype">int</span>    <a class="code hl_variable" href="structwcsprm.html#a42052d557bdef2c5640a6d19b6d9ed8b">npsmax</a>;                <span class="comment">// number for which space was allocated.</span></div>
<div class="line"><a id="l02113" name="l02113"></a><span class="lineno"><a class="line" href="structwcsprm.html#a9eca2fcc30058310d020181ae16bf256"> 2113</a></span>  <span class="keyword">struct </span><a class="code hl_struct" href="structpscard.html">pscard</a> *<a class="code hl_variable" href="structwcsprm.html#a9eca2fcc30058310d020181ae16bf256">ps</a>;            <span class="comment">// PSi_ma keywords for each i and m.</span></div>
<div class="line"><a id="l02114" name="l02114"></a><span class="lineno"> 2114</span> </div>
<div class="line"><a id="l02115" name="l02115"></a><span class="lineno"> 2115</span>  <span class="comment">// Alternative header keyvalues (see the prologue above).</span></div>
<div class="line"><a id="l02116" name="l02116"></a><span class="lineno"> 2116</span>  <span class="comment">//--------------------------------------------------------------------------</span></div>
<div class="line"><a id="l02117" name="l02117"></a><span class="lineno"><a class="line" href="structwcsprm.html#afd2f31d782b3becce4ca2f9b495ec0b1"> 2117</a></span>  <span class="keywordtype">double</span> *<a class="code hl_variable" href="structwcsprm.html#afd2f31d782b3becce4ca2f9b495ec0b1">cd</a>;                   <span class="comment">// CDi_ja linear transformation matrix.</span></div>
<div class="line"><a id="l02118" name="l02118"></a><span class="lineno"><a class="line" href="structwcsprm.html#af124a4259475ea355ced38e73a05363a"> 2118</a></span>  <span class="keywordtype">double</span> *<a class="code hl_variable" href="structwcsprm.html#af124a4259475ea355ced38e73a05363a">crota</a>;                <span class="comment">// CROTAi keyvalues for each coord axis.</span></div>
<div class="line"><a id="l02119" name="l02119"></a><span class="lineno"><a class="line" href="structwcsprm.html#a8b3a65921acc0dabfa4efd19a003ea6e"> 2119</a></span>  <span class="keywordtype">int</span>    <a class="code hl_variable" href="structwcsprm.html#a8b3a65921acc0dabfa4efd19a003ea6e">altlin</a>;                <span class="comment">// Alternative representations</span></div>
<div class="line"><a id="l02120" name="l02120"></a><span class="lineno"> 2120</span>                                <span class="comment">//   Bit 0: PCi_ja is present,</span></div>
<div class="line"><a id="l02121" name="l02121"></a><span class="lineno"> 2121</span>                                <span class="comment">//   Bit 1: CDi_ja is present,</span></div>
<div class="line"><a id="l02122" name="l02122"></a><span class="lineno"> 2122</span>                                <span class="comment">//   Bit 2: CROTAi is present.</span></div>
<div class="line"><a id="l02123" name="l02123"></a><span class="lineno"><a class="line" href="structwcsprm.html#ac3c9c869bef4e4850dfd9762b33ce908"> 2123</a></span>  <span class="keywordtype">int</span>    <a class="code hl_variable" href="structwcsprm.html#ac3c9c869bef4e4850dfd9762b33ce908">velref</a>;                <span class="comment">// AIPS velocity code, VELREF.</span></div>
<div class="line"><a id="l02124" name="l02124"></a><span class="lineno"> 2124</span> </div>
<div class="line"><a id="l02125" name="l02125"></a><span class="lineno"> 2125</span>  <span class="comment">// Auxiliary coordinate system information of a general nature.  Not</span></div>
<div class="line"><a id="l02126" name="l02126"></a><span class="lineno"> 2126</span>  <span class="comment">// used by WCSLIB.  Refer to the prologue comments above for a brief</span></div>
<div class="line"><a id="l02127" name="l02127"></a><span class="lineno"> 2127</span>  <span class="comment">// explanation of these values.</span></div>
<div class="line"><a id="l02128" name="l02128"></a><span class="lineno"><a class="line" href="structwcsprm.html#ae7609283351ea46484690f873f8ea9c3"> 2128</a></span>  <span class="keywordtype">char</span>   <a class="code hl_variable" href="structwcsprm.html#ae7609283351ea46484690f873f8ea9c3">alt</a>[4];</div>
<div class="line"><a id="l02129" name="l02129"></a><span class="lineno"><a class="line" href="structwcsprm.html#a9ee8fb568ca75874bab00825b768f8ca"> 2129</a></span>  <span class="keywordtype">int</span>    <a class="code hl_variable" href="structwcsprm.html#a9ee8fb568ca75874bab00825b768f8ca">colnum</a>;</div>
<div class="line"><a id="l02130" name="l02130"></a><span class="lineno"><a class="line" href="structwcsprm.html#a7320fc64e7705cc7495eba07482b5c55"> 2130</a></span>  <span class="keywordtype">int</span>    *<a class="code hl_variable" href="structwcsprm.html#a7320fc64e7705cc7495eba07482b5c55">colax</a>;</div>
<div class="line"><a id="l02131" name="l02131"></a><span class="lineno"> 2131</span>                                <span class="comment">// Auxiliary coordinate axis information.</span></div>
<div class="line"><a id="l02132" name="l02132"></a><span class="lineno"><a class="line" href="structwcsprm.html#a922f0f57b8c35cad3d01ceedeba01d4b"> 2132</a></span>  char   (*<a class="code hl_variable" href="structwcsprm.html#a922f0f57b8c35cad3d01ceedeba01d4b">cname</a>)[72];</div>
<div class="line"><a id="l02133" name="l02133"></a><span class="lineno"><a class="line" href="structwcsprm.html#a49eee6450b1a646d3fe01b8965a63af4"> 2133</a></span>  <span class="keywordtype">double</span> *<a class="code hl_variable" href="structwcsprm.html#a49eee6450b1a646d3fe01b8965a63af4">crder</a>;</div>
<div class="line"><a id="l02134" name="l02134"></a><span class="lineno"><a class="line" href="structwcsprm.html#a15485177ea8bbacefc29a5a5cba98c8f"> 2134</a></span>  <span class="keywordtype">double</span> *<a class="code hl_variable" href="structwcsprm.html#a15485177ea8bbacefc29a5a5cba98c8f">csyer</a>;</div>
<div class="line"><a id="l02135" name="l02135"></a><span class="lineno"><a class="line" href="structwcsprm.html#a09002a13836c82c58d8faa06188f692b"> 2135</a></span>  <span class="keywordtype">double</span> *<a class="code hl_variable" href="structwcsprm.html#a09002a13836c82c58d8faa06188f692b">czphs</a>;</div>
<div class="line"><a id="l02136" name="l02136"></a><span class="lineno"><a class="line" href="structwcsprm.html#a17fd7510a626a8b4b3d2985c9f270ac6"> 2136</a></span>  <span class="keywordtype">double</span> *<a class="code hl_variable" href="structwcsprm.html#a17fd7510a626a8b4b3d2985c9f270ac6">cperi</a>;</div>
<div class="line"><a id="l02137" name="l02137"></a><span class="lineno"> 2137</span> </div>
<div class="line"><a id="l02138" name="l02138"></a><span class="lineno"><a class="line" href="structwcsprm.html#a2166fb650f937d8870711d8be5986b66"> 2138</a></span>  <span class="keywordtype">char</span>   <a class="code hl_variable" href="structwcsprm.html#a2166fb650f937d8870711d8be5986b66">wcsname</a>[72];</div>
<div class="line"><a id="l02139" name="l02139"></a><span class="lineno"> 2139</span>                                <span class="comment">// Time reference system and measurement.</span></div>
<div class="line"><a id="l02140" name="l02140"></a><span class="lineno"><a class="line" href="structwcsprm.html#aa8473a613e48249f5e81508cb3f3ac74"> 2140</a></span>  <span class="keywordtype">char</span>   <a class="code hl_variable" href="structwcsprm.html#a04771d9d83256b63c86c29d6fa717d81">timesys</a>[72], <a class="code hl_variable" href="structwcsprm.html#a0f9f8f2c66ff8a89c27894405db543f0">trefpos</a>[72], <a class="code hl_variable" href="structwcsprm.html#aa5573ea695b8aac6cdec2ac3dcc279c1">trefdir</a>[72], <a class="code hl_variable" href="structwcsprm.html#aa8473a613e48249f5e81508cb3f3ac74">plephem</a>[72];</div>
<div class="line"><a id="l02141" name="l02141"></a><span class="lineno"><a class="line" href="structwcsprm.html#a01c8f1c9c125c939b43ba05d4caec907"> 2141</a></span>  <span class="keywordtype">char</span>   <a class="code hl_variable" href="structwcsprm.html#a01c8f1c9c125c939b43ba05d4caec907">timeunit</a>[72];</div>
<div class="line"><a id="l02142" name="l02142"></a><span class="lineno"><a class="line" href="structwcsprm.html#a056ffc4826e7a7ba59909fe5063dfa0b"> 2142</a></span>  <span class="keywordtype">char</span>   <a class="code hl_variable" href="structwcsprm.html#a056ffc4826e7a7ba59909fe5063dfa0b">dateref</a>[72];</div>
<div class="line"><a id="l02143" name="l02143"></a><span class="lineno"><a class="line" href="structwcsprm.html#aa482719872f17f60934b2e7d746174eb"> 2143</a></span>  <span class="keywordtype">double</span> <a class="code hl_variable" href="structwcsprm.html#aa482719872f17f60934b2e7d746174eb">mjdref</a>[2];</div>
<div class="line"><a id="l02144" name="l02144"></a><span class="lineno"><a class="line" href="structwcsprm.html#a49223f3649aa823d1c1564d930cd29b4"> 2144</a></span>  <span class="keywordtype">double</span> <a class="code hl_variable" href="structwcsprm.html#a49223f3649aa823d1c1564d930cd29b4">timeoffs</a>;</div>
<div class="line"><a id="l02145" name="l02145"></a><span class="lineno"> 2145</span>                                <span class="comment">// Data timestamps and durations.</span></div>
<div class="line"><a id="l02146" name="l02146"></a><span class="lineno"><a class="line" href="structwcsprm.html#ae6b40e2adeb31414871c7cae68619d63"> 2146</a></span>  <span class="keywordtype">char</span>   <a class="code hl_variable" href="structwcsprm.html#aad387ccbd7847672b5dc2223d9124120">dateobs</a>[72], <a class="code hl_variable" href="structwcsprm.html#a9f9ec0f8abfa8af01ac97541cade3881">datebeg</a>[72], <a class="code hl_variable" href="structwcsprm.html#ae6b40e2adeb31414871c7cae68619d63">dateavg</a>[72], <a class="code hl_variable" href="structwcsprm.html#ad1f07e7ae6746a993beed50e58eb6d59">dateend</a>[72];</div>
<div class="line"><a id="l02147" name="l02147"></a><span class="lineno"><a class="line" href="structwcsprm.html#a0730c37f09502eb364f4e7d7addb8ab8"> 2147</a></span>  <span class="keywordtype">double</span> <a class="code hl_variable" href="structwcsprm.html#ac0cb013b1505fb7abd4167ac0db0e0aa">mjdobs</a>, <a class="code hl_variable" href="structwcsprm.html#aa02a4e561a7a106ae8b8adbb17da0393">mjdbeg</a>, <a class="code hl_variable" href="structwcsprm.html#a0730c37f09502eb364f4e7d7addb8ab8">mjdavg</a>, <a class="code hl_variable" href="structwcsprm.html#a186ddcff0e5d4ee56ef904a4c125aaaf">mjdend</a>;</div>
<div class="line"><a id="l02148" name="l02148"></a><span class="lineno"><a class="line" href="structwcsprm.html#aa2fdffbfdcae25f5dc0c93b857a6d911"> 2148</a></span>  <span class="keywordtype">double</span> <a class="code hl_variable" href="structwcsprm.html#a92923310bdeb7b8591baad9a389e23bd">jepoch</a>, <a class="code hl_variable" href="structwcsprm.html#aa2fdffbfdcae25f5dc0c93b857a6d911">bepoch</a>;</div>
<div class="line"><a id="l02149" name="l02149"></a><span class="lineno"><a class="line" href="structwcsprm.html#a14c69ea4611d9e56222fce7b60556e1f"> 2149</a></span>  <span class="keywordtype">double</span> <a class="code hl_variable" href="structwcsprm.html#a14c69ea4611d9e56222fce7b60556e1f">tstart</a>, <a class="code hl_variable" href="structwcsprm.html#a80635f607f3d15a30e27ee38e9467fdd">tstop</a>;</div>
<div class="line"><a id="l02150" name="l02150"></a><span class="lineno"><a class="line" href="structwcsprm.html#a11cb29962481731befa01a35bcaf381d"> 2150</a></span>  <span class="keywordtype">double</span> <a class="code hl_variable" href="structwcsprm.html#ac1b0235591049211a642f24d5be7fac5">xposure</a>, <a class="code hl_variable" href="structwcsprm.html#a11cb29962481731befa01a35bcaf381d">telapse</a>;</div>
<div class="line"><a id="l02151" name="l02151"></a><span class="lineno"> 2151</span>                                <span class="comment">// Timing accuracy.</span></div>
<div class="line"><a id="l02152" name="l02152"></a><span class="lineno"><a class="line" href="structwcsprm.html#a0e67fa114fa224d5a675473f0f6b36c7"> 2152</a></span>  <span class="keywordtype">double</span> <a class="code hl_variable" href="structwcsprm.html#a858a50d4a65f43dabe8128e0be4acca9">timsyer</a>, <a class="code hl_variable" href="structwcsprm.html#a0e67fa114fa224d5a675473f0f6b36c7">timrder</a>;</div>
<div class="line"><a id="l02153" name="l02153"></a><span class="lineno"><a class="line" href="structwcsprm.html#ae8681605fee24a802560a5bb31f768d0"> 2153</a></span>  <span class="keywordtype">double</span> <a class="code hl_variable" href="structwcsprm.html#ae8681605fee24a802560a5bb31f768d0">timedel</a>, <a class="code hl_variable" href="structwcsprm.html#a51ad344a52d5dec796968b71629f946c">timepixr</a>;</div>
<div class="line"><a id="l02154" name="l02154"></a><span class="lineno"> 2154</span>                                <span class="comment">// Spatial &amp; celestial reference frame.</span></div>
<div class="line"><a id="l02155" name="l02155"></a><span class="lineno"><a class="line" href="structwcsprm.html#a834ff0b9f00cc0bb83a2e2aeca1fe767"> 2155</a></span>  <span class="keywordtype">double</span> <a class="code hl_variable" href="structwcsprm.html#a834ff0b9f00cc0bb83a2e2aeca1fe767">obsgeo</a>[6];</div>
<div class="line"><a id="l02156" name="l02156"></a><span class="lineno"><a class="line" href="structwcsprm.html#ae1d3fe09a3c2da7366cefc2627491836"> 2156</a></span>  <span class="keywordtype">char</span>   <a class="code hl_variable" href="structwcsprm.html#ae1d3fe09a3c2da7366cefc2627491836">obsorbit</a>[72];</div>
<div class="line"><a id="l02157" name="l02157"></a><span class="lineno"><a class="line" href="structwcsprm.html#a65801f93622504672ee3faf8f2110e48"> 2157</a></span>  <span class="keywordtype">char</span>   <a class="code hl_variable" href="structwcsprm.html#a65801f93622504672ee3faf8f2110e48">radesys</a>[72];</div>
<div class="line"><a id="l02158" name="l02158"></a><span class="lineno"><a class="line" href="structwcsprm.html#a88b55f6c8d122f3ff63532de85698864"> 2158</a></span>  <span class="keywordtype">double</span> <a class="code hl_variable" href="structwcsprm.html#a88b55f6c8d122f3ff63532de85698864">equinox</a>;</div>
<div class="line"><a id="l02159" name="l02159"></a><span class="lineno"><a class="line" href="structwcsprm.html#ac089e5d0e3191255ceaea7f8591b27ea"> 2159</a></span>  <span class="keywordtype">char</span>   <a class="code hl_variable" href="structwcsprm.html#ac089e5d0e3191255ceaea7f8591b27ea">specsys</a>[72];</div>
<div class="line"><a id="l02160" name="l02160"></a><span class="lineno"><a class="line" href="structwcsprm.html#a9eac54f497e1244c8106dd3ebba12223"> 2160</a></span>  <span class="keywordtype">char</span>   <a class="code hl_variable" href="structwcsprm.html#a9eac54f497e1244c8106dd3ebba12223">ssysobs</a>[72];</div>
<div class="line"><a id="l02161" name="l02161"></a><span class="lineno"><a class="line" href="structwcsprm.html#af300da5a94594a9769ab312bb56dde83"> 2161</a></span>  <span class="keywordtype">double</span> <a class="code hl_variable" href="structwcsprm.html#af300da5a94594a9769ab312bb56dde83">velosys</a>;</div>
<div class="line"><a id="l02162" name="l02162"></a><span class="lineno"><a class="line" href="structwcsprm.html#a0936d10c2ac93d13d096b1711ac639a1"> 2162</a></span>  <span class="keywordtype">double</span> <a class="code hl_variable" href="structwcsprm.html#a0936d10c2ac93d13d096b1711ac639a1">zsource</a>;</div>
<div class="line"><a id="l02163" name="l02163"></a><span class="lineno"><a class="line" href="structwcsprm.html#a8715975565c8bbd0c562a32eee40fd20"> 2163</a></span>  <span class="keywordtype">char</span>   <a class="code hl_variable" href="structwcsprm.html#a8715975565c8bbd0c562a32eee40fd20">ssyssrc</a>[72];</div>
<div class="line"><a id="l02164" name="l02164"></a><span class="lineno"><a class="line" href="structwcsprm.html#a9fd60ce9e6bc31df07ed02ce64b48be4"> 2164</a></span>  <span class="keywordtype">double</span> <a class="code hl_variable" href="structwcsprm.html#a9fd60ce9e6bc31df07ed02ce64b48be4">velangl</a>;</div>
<div class="line"><a id="l02165" name="l02165"></a><span class="lineno"> 2165</span> </div>
<div class="line"><a id="l02166" name="l02166"></a><span class="lineno"> 2166</span>  <span class="comment">// Additional auxiliary coordinate system information of a specialist</span></div>
<div class="line"><a id="l02167" name="l02167"></a><span class="lineno"> 2167</span>  <span class="comment">// nature.  Not used by WCSLIB.  Refer to the prologue comments above.</span></div>
<div class="line"><a id="l02168" name="l02168"></a><span class="lineno"><a class="line" href="structwcsprm.html#a37e8287a522df0f03c4c051f7a11d402"> 2168</a></span>  <span class="keyword">struct </span><a class="code hl_struct" href="structauxprm.html">auxprm</a> *<a class="code hl_variable" href="structwcsprm.html#a37e8287a522df0f03c4c051f7a11d402">aux</a>;</div>
<div class="line"><a id="l02169" name="l02169"></a><span class="lineno"> 2169</span> </div>
<div class="line"><a id="l02170" name="l02170"></a><span class="lineno"> 2170</span>  <span class="comment">// Coordinate lookup tables (see the prologue above).</span></div>
<div class="line"><a id="l02171" name="l02171"></a><span class="lineno"> 2171</span>  <span class="comment">//--------------------------------------------------------------------------</span></div>
<div class="line"><a id="l02172" name="l02172"></a><span class="lineno"><a class="line" href="structwcsprm.html#a94c26ce331cc876d63baeeada9820241"> 2172</a></span>  <span class="keywordtype">int</span>    <a class="code hl_variable" href="structwcsprm.html#a94c26ce331cc876d63baeeada9820241">ntab</a>;                  <span class="comment">// Number of separate tables.</span></div>
<div class="line"><a id="l02173" name="l02173"></a><span class="lineno"><a class="line" href="structwcsprm.html#a8625c0a6ff99c754566c46c2372df801"> 2173</a></span>  <span class="keywordtype">int</span>    <a class="code hl_variable" href="structwcsprm.html#a8625c0a6ff99c754566c46c2372df801">nwtb</a>;                  <span class="comment">// Number of wtbarr structs.</span></div>
<div class="line"><a id="l02174" name="l02174"></a><span class="lineno"><a class="line" href="structwcsprm.html#a292133b2b7143b969a3af6a3f2cf3709"> 2174</a></span>  <span class="keyword">struct </span><a class="code hl_struct" href="structtabprm.html">tabprm</a> *<a class="code hl_variable" href="structwcsprm.html#a292133b2b7143b969a3af6a3f2cf3709">tab</a>;           <span class="comment">// Tabular transformation parameters.</span></div>
<div class="line"><a id="l02175" name="l02175"></a><span class="lineno"><a class="line" href="structwcsprm.html#a9063e8d0c956e9eae7f7d6f3608b9ed2"> 2175</a></span>  <span class="keyword">struct </span><a class="code hl_struct" href="structwtbarr.html">wtbarr</a> *<a class="code hl_variable" href="structwcsprm.html#a9063e8d0c956e9eae7f7d6f3608b9ed2">wtb</a>;           <span class="comment">// Array of wtbarr structs.</span></div>
<div class="line"><a id="l02176" name="l02176"></a><span class="lineno"> 2176</span> </div>
<div class="line"><a id="l02177" name="l02177"></a><span class="lineno"> 2177</span>  <span class="comment">//--------------------------------------------------------------------------</span></div>
<div class="line"><a id="l02178" name="l02178"></a><span class="lineno"> 2178</span>  <span class="comment">// Information derived from the FITS header keyvalues by wcsset().</span></div>
<div class="line"><a id="l02179" name="l02179"></a><span class="lineno"> 2179</span>  <span class="comment">//--------------------------------------------------------------------------</span></div>
<div class="line"><a id="l02180" name="l02180"></a><span class="lineno"><a class="line" href="structwcsprm.html#ae352318ce3202dab1b5db8b9ceec7703"> 2180</a></span>  <span class="keywordtype">char</span>   <a class="code hl_variable" href="structwcsprm.html#a5b56e1b378a6ae9f8dfff5c364f0653c">lngtyp</a>[8], <a class="code hl_variable" href="structwcsprm.html#ae352318ce3202dab1b5db8b9ceec7703">lattyp</a>[8];  <span class="comment">// Celestial axis types, e.g. RA, DEC.</span></div>
<div class="line"><a id="l02181" name="l02181"></a><span class="lineno"><a class="line" href="structwcsprm.html#ab7f7173e6d2b1b8028a3275bdd751e79"> 2181</a></span>  <span class="keywordtype">int</span>    <a class="code hl_variable" href="structwcsprm.html#a08098820949433d1336841d32d0b62b5">lng</a>, <a class="code hl_variable" href="structwcsprm.html#ab7f7173e6d2b1b8028a3275bdd751e79">lat</a>, <a class="code hl_variable" href="structwcsprm.html#ab9729795155b8f37afd80784fb70068b">spec</a>, <a class="code hl_variable" href="structwcsprm.html#aa4fcafeaedae6f7636ab9e22ec9e5c7a">time</a>;  <span class="comment">// Longitude, latitude, spectral, and time</span></div>
<div class="line"><a id="l02182" name="l02182"></a><span class="lineno"> 2182</span>                                <span class="comment">// axis indices (0-relative).</span></div>
<div class="line"><a id="l02183" name="l02183"></a><span class="lineno"><a class="line" href="structwcsprm.html#ade8495d3ca5047eeadba5934d0bb2708"> 2183</a></span>  <span class="keywordtype">int</span>    <a class="code hl_variable" href="structwcsprm.html#ade8495d3ca5047eeadba5934d0bb2708">cubeface</a>;              <span class="comment">// True if there is a CUBEFACE axis.</span></div>
<div class="line"><a id="l02184" name="l02184"></a><span class="lineno"><a class="line" href="structwcsprm.html#af0617abe8547c5861d30001da2a9121b"> 2184</a></span>  <span class="keywordtype">int</span>    <a class="code hl_variable" href="structwcsprm.html#af0617abe8547c5861d30001da2a9121b">dummy</a>;                 <span class="comment">// Dummy for alignment purposes.</span></div>
<div class="line"><a id="l02185" name="l02185"></a><span class="lineno"><a class="line" href="structwcsprm.html#ab63cdcf6ff8febd1b40d0e044ca7d7ef"> 2185</a></span>  <span class="keywordtype">int</span>    *<a class="code hl_variable" href="structwcsprm.html#ab63cdcf6ff8febd1b40d0e044ca7d7ef">types</a>;                <span class="comment">// Coordinate type codes for each axis.</span></div>
<div class="line"><a id="l02186" name="l02186"></a><span class="lineno"> 2186</span> </div>
<div class="line"><a id="l02187" name="l02187"></a><span class="lineno"><a class="line" href="structwcsprm.html#a3224bd06f8f4d2d7d398533eb44a49e8"> 2187</a></span>  <span class="keyword">struct </span><a class="code hl_struct" href="structlinprm.html">linprm</a> <a class="code hl_variable" href="structwcsprm.html#a3224bd06f8f4d2d7d398533eb44a49e8">lin</a>;            <span class="comment">//    Linear transformation parameters.</span></div>
<div class="line"><a id="l02188" name="l02188"></a><span class="lineno"><a class="line" href="structwcsprm.html#ac8391dd770637dbb841067996b7777ba"> 2188</a></span>  <span class="keyword">struct </span><a class="code hl_struct" href="structcelprm.html">celprm</a> <a class="code hl_variable" href="structwcsprm.html#ac8391dd770637dbb841067996b7777ba">cel</a>;            <span class="comment">// Celestial transformation parameters.</span></div>
<div class="line"><a id="l02189" name="l02189"></a><span class="lineno"><a class="line" href="structwcsprm.html#ae83952aec7c1ac76c090bc89bf4eeea7"> 2189</a></span>  <span class="keyword">struct </span><a class="code hl_struct" href="structspcprm.html">spcprm</a> <a class="code hl_variable" href="structwcsprm.html#ae83952aec7c1ac76c090bc89bf4eeea7">spc</a>;            <span class="comment">//  Spectral transformation parameters.</span></div>
<div class="line"><a id="l02190" name="l02190"></a><span class="lineno"> 2190</span> </div>
<div class="line"><a id="l02191" name="l02191"></a><span class="lineno"> 2191</span>  <span class="comment">//--------------------------------------------------------------------------</span></div>
<div class="line"><a id="l02192" name="l02192"></a><span class="lineno"> 2192</span>  <span class="comment">//             THE REMAINDER OF THE WCSPRM STRUCT IS PRIVATE.</span></div>
<div class="line"><a id="l02193" name="l02193"></a><span class="lineno"> 2193</span>  <span class="comment">//--------------------------------------------------------------------------</span></div>
<div class="line"><a id="l02194" name="l02194"></a><span class="lineno"> 2194</span> </div>
<div class="line"><a id="l02195" name="l02195"></a><span class="lineno"> 2195</span>  <span class="comment">// Error handling, if enabled.</span></div>
<div class="line"><a id="l02196" name="l02196"></a><span class="lineno"> 2196</span>  <span class="comment">//--------------------------------------------------------------------------</span></div>
<div class="line"><a id="l02197" name="l02197"></a><span class="lineno"><a class="line" href="structwcsprm.html#af54ce939604be183231f0ee006e2f8ed"> 2197</a></span>  <span class="keyword">struct </span><a class="code hl_struct" href="structwcserr.html">wcserr</a> *<a class="code hl_variable" href="structwcsprm.html#af54ce939604be183231f0ee006e2f8ed">err</a>;</div>
<div class="line"><a id="l02198" name="l02198"></a><span class="lineno"> 2198</span> </div>
<div class="line"><a id="l02199" name="l02199"></a><span class="lineno"> 2199</span>  <span class="comment">// Memory management.</span></div>
<div class="line"><a id="l02200" name="l02200"></a><span class="lineno"> 2200</span>  <span class="comment">//--------------------------------------------------------------------------</span></div>
<div class="line"><a id="l02201" name="l02201"></a><span class="lineno"><a class="line" href="structwcsprm.html#a5780880281f2f9d085d2e06919b7647a"> 2201</a></span>  <span class="keywordtype">int</span>    <a class="code hl_variable" href="structwcsprm.html#a5780880281f2f9d085d2e06919b7647a">m_flag</a>, <a class="code hl_variable" href="structwcsprm.html#a5ed753e401cda620a04adfb4ebfb8e0d">m_naxis</a>;</div>
<div class="line"><a id="l02202" name="l02202"></a><span class="lineno"><a class="line" href="structwcsprm.html#a42e0ff2da3b0c1ca0a9509f787ed1951"> 2202</a></span>  <span class="keywordtype">double</span> *<a class="code hl_variable" href="structwcsprm.html#a164e3852bcd2dea8b5f73e1dff79ddf5">m_crpix</a>, *<a class="code hl_variable" href="structwcsprm.html#a6778d31ec5a2ee643dc5f0a8af630b03">m_pc</a>, *<a class="code hl_variable" href="structwcsprm.html#a42e0ff2da3b0c1ca0a9509f787ed1951">m_cdelt</a>, *<a class="code hl_variable" href="structwcsprm.html#a5072893bd9beddb33967697d501acdce">m_crval</a>;</div>
<div class="line"><a id="l02203" name="l02203"></a><span class="lineno"><a class="line" href="structwcsprm.html#aee7f71c872491b25e1d1440e5dfa8153"> 2203</a></span>  char  (*<a class="code hl_variable" href="structwcsprm.html#af1cb3e68560d1ac42c620cfe3900af95">m_cunit</a>)[72], (*m_ctype)[72];</div>
<div class="line"><a id="l02204" name="l02204"></a><span class="lineno"><a class="line" href="structwcsprm.html#a6a3fa7adc304567271c5cc0eda3ac986"> 2204</a></span>  <span class="keyword">struct </span><a class="code hl_struct" href="structpvcard.html">pvcard</a> *<a class="code hl_variable" href="structwcsprm.html#a6a3fa7adc304567271c5cc0eda3ac986">m_pv</a>;</div>
<div class="line"><a id="l02205" name="l02205"></a><span class="lineno"><a class="line" href="structwcsprm.html#a042875def8cab8354c5b2c40ab9fa374"> 2205</a></span>  <span class="keyword">struct </span><a class="code hl_struct" href="structpscard.html">pscard</a> *<a class="code hl_variable" href="structwcsprm.html#a042875def8cab8354c5b2c40ab9fa374">m_ps</a>;</div>
<div class="line"><a id="l02206" name="l02206"></a><span class="lineno"><a class="line" href="structwcsprm.html#a7a88af56c4c978c6d4213ae1f4bec87a"> 2206</a></span>  <span class="keywordtype">double</span> *<a class="code hl_variable" href="structwcsprm.html#a7a88af56c4c978c6d4213ae1f4bec87a">m_cd</a>, *<a class="code hl_variable" href="structwcsprm.html#a5444415c94c7ab0226788f5efe93221d">m_crota</a>;</div>
<div class="line"><a id="l02207" name="l02207"></a><span class="lineno"><a class="line" href="structwcsprm.html#a4ed527b90d49e8365c1b727f7bec29c7"> 2207</a></span>  <span class="keywordtype">int</span>    *<a class="code hl_variable" href="structwcsprm.html#a4ed527b90d49e8365c1b727f7bec29c7">m_colax</a>;</div>
<div class="line"><a id="l02208" name="l02208"></a><span class="lineno"><a class="line" href="structwcsprm.html#a092c11d209ecdd16bb79858c68e4d582"> 2208</a></span>  char  (*<a class="code hl_variable" href="structwcsprm.html#a092c11d209ecdd16bb79858c68e4d582">m_cname</a>)[72];</div>
<div class="line"><a id="l02209" name="l02209"></a><span class="lineno"><a class="line" href="structwcsprm.html#a54862a297e2fb951a72efa7ac5841a21"> 2209</a></span>  <span class="keywordtype">double</span> *<a class="code hl_variable" href="structwcsprm.html#a0d15534535c7f9308c9daa2cceff29e7">m_crder</a>, *<a class="code hl_variable" href="structwcsprm.html#a13fab263ca03f35844fdaca289b7dfac">m_csyer</a>, *<a class="code hl_variable" href="structwcsprm.html#a7134300080d93ba780b8db3bb5ee02ce">m_czphs</a>, *<a class="code hl_variable" href="structwcsprm.html#a54862a297e2fb951a72efa7ac5841a21">m_cperi</a>;</div>
<div class="line"><a id="l02210" name="l02210"></a><span class="lineno"><a class="line" href="structwcsprm.html#ad354d9754c757b31810a3751ea67b5d3"> 2210</a></span>  <span class="keyword">struct </span><a class="code hl_struct" href="structauxprm.html">auxprm</a> *<a class="code hl_variable" href="structwcsprm.html#ad354d9754c757b31810a3751ea67b5d3">m_aux</a>;</div>
<div class="line"><a id="l02211" name="l02211"></a><span class="lineno"><a class="line" href="structwcsprm.html#ae09d5bf005e3bd7ee880353e8816ceb8"> 2211</a></span>  <span class="keyword">struct </span><a class="code hl_struct" href="structtabprm.html">tabprm</a> *<a class="code hl_variable" href="structwcsprm.html#ae09d5bf005e3bd7ee880353e8816ceb8">m_tab</a>;</div>
<div class="line"><a id="l02212" name="l02212"></a><span class="lineno"><a class="line" href="structwcsprm.html#ace7e0986c79d73bd3a0613034b71974f"> 2212</a></span>  <span class="keyword">struct </span><a class="code hl_struct" href="structwtbarr.html">wtbarr</a> *<a class="code hl_variable" href="structwcsprm.html#ace7e0986c79d73bd3a0613034b71974f">m_wtb</a>;</div>
<div class="line"><a id="l02213" name="l02213"></a><span class="lineno"> 2213</span>};</div>
</div>
<div class="line"><a id="l02214" name="l02214"></a><span class="lineno"> 2214</span> </div>
<div class="line"><a id="l02215" name="l02215"></a><span class="lineno"> 2215</span><span class="comment">// Size of the wcsprm struct in int units, used by the Fortran wrappers.</span></div>
<div class="line"><a id="l02216" name="l02216"></a><span class="lineno"><a class="line" href="wcs_8h.html#a6852f6dd2883c82296f1108b897d337e"> 2216</a></span><span class="preprocessor">#define WCSLEN (sizeof(struct wcsprm)/sizeof(int))</span></div>
<div class="line"><a id="l02217" name="l02217"></a><span class="lineno"> 2217</span> </div>
<div class="line"><a id="l02218" name="l02218"></a><span class="lineno"> 2218</span> </div>
<div class="line"><a id="l02219" name="l02219"></a><span class="lineno"><a class="line" href="wcs_8h.html#a42b2578d76ace7ca6114d82b7ae46a89"> 2219</a></span><span class="keywordtype">int</span> <a class="code hl_function" href="wcs_8h.html#a42b2578d76ace7ca6114d82b7ae46a89">wcsnpv</a>(<span class="keywordtype">int</span> n);</div>
<div class="line"><a id="l02220" name="l02220"></a><span class="lineno"> 2220</span> </div>
<div class="line"><a id="l02221" name="l02221"></a><span class="lineno"><a class="line" href="wcs_8h.html#ae790c9ce6c9b7a4845cf1c3c97b1e97a"> 2221</a></span><span class="keywordtype">int</span> <a class="code hl_function" href="wcs_8h.html#ae790c9ce6c9b7a4845cf1c3c97b1e97a">wcsnps</a>(<span class="keywordtype">int</span> n);</div>
<div class="line"><a id="l02222" name="l02222"></a><span class="lineno"> 2222</span> </div>
<div class="line"><a id="l02223" name="l02223"></a><span class="lineno"><a class="line" href="wcs_8h.html#a2afc8255fde0965dddaa374463666d45"> 2223</a></span><span class="keywordtype">int</span> <a class="code hl_function" href="wcs_8h.html#a2afc8255fde0965dddaa374463666d45">wcsini</a>(<span class="keywordtype">int</span> alloc, <span class="keywordtype">int</span> naxis, <span class="keyword">struct</span> <a class="code hl_struct" href="structwcsprm.html">wcsprm</a> *wcs);</div>
<div class="line"><a id="l02224" name="l02224"></a><span class="lineno"> 2224</span> </div>
<div class="line"><a id="l02225" name="l02225"></a><span class="lineno"><a class="line" href="wcs_8h.html#aab11243b60b10065fc85347bb3efa912"> 2225</a></span><span class="keywordtype">int</span> <a class="code hl_function" href="wcs_8h.html#aab11243b60b10065fc85347bb3efa912">wcsinit</a>(<span class="keywordtype">int</span> alloc, <span class="keywordtype">int</span> naxis, <span class="keyword">struct</span> <a class="code hl_struct" href="structwcsprm.html">wcsprm</a> *wcs, <span class="keywordtype">int</span> npvmax, <span class="keywordtype">int</span> npsmax,</div>
<div class="line"><a id="l02226" name="l02226"></a><span class="lineno"> 2226</span>            <span class="keywordtype">int</span> ndpmax);</div>
<div class="line"><a id="l02227" name="l02227"></a><span class="lineno"> 2227</span> </div>
<div class="line"><a id="l02228" name="l02228"></a><span class="lineno"><a class="line" href="wcs_8h.html#aa5ab4a67a8bcdad28a07b02d0c3b3c6a"> 2228</a></span><span class="keywordtype">int</span> <a class="code hl_function" href="wcs_8h.html#aa5ab4a67a8bcdad28a07b02d0c3b3c6a">wcsauxi</a>(<span class="keywordtype">int</span> alloc, <span class="keyword">struct</span> <a class="code hl_struct" href="structwcsprm.html">wcsprm</a> *wcs);</div>
<div class="line"><a id="l02229" name="l02229"></a><span class="lineno"> 2229</span> </div>
<div class="line"><a id="l02230" name="l02230"></a><span class="lineno"><a class="line" href="wcs_8h.html#a864c99fef9f3eee29085ce42d0ee0d64"> 2230</a></span><span class="keywordtype">int</span> <a class="code hl_function" href="wcs_8h.html#a864c99fef9f3eee29085ce42d0ee0d64">wcssub</a>(<span class="keywordtype">int</span> alloc, <span class="keyword">const</span> <span class="keyword">struct</span> <a class="code hl_struct" href="structwcsprm.html">wcsprm</a> *wcssrc, <span class="keywordtype">int</span> *nsub, <span class="keywordtype">int</span> axes[],</div>
<div class="line"><a id="l02231" name="l02231"></a><span class="lineno"> 2231</span>           <span class="keyword">struct</span> <a class="code hl_struct" href="structwcsprm.html">wcsprm</a> *wcsdst);</div>
<div class="line"><a id="l02232" name="l02232"></a><span class="lineno"> 2232</span> </div>
<div class="line"><a id="l02233" name="l02233"></a><span class="lineno"><a class="line" href="wcs_8h.html#a78d5d27f74218723acde6d3aa232c4a5"> 2233</a></span><span class="keywordtype">int</span> <a class="code hl_function" href="wcs_8h.html#a78d5d27f74218723acde6d3aa232c4a5">wcscompare</a>(<span class="keywordtype">int</span> cmp, <span class="keywordtype">double</span> tol, <span class="keyword">const</span> <span class="keyword">struct</span> <a class="code hl_struct" href="structwcsprm.html">wcsprm</a> *wcs1,</div>
<div class="line"><a id="l02234" name="l02234"></a><span class="lineno"> 2234</span>               <span class="keyword">const</span> <span class="keyword">struct</span> <a class="code hl_struct" href="structwcsprm.html">wcsprm</a> *wcs2, <span class="keywordtype">int</span> *equal);</div>
<div class="line"><a id="l02235" name="l02235"></a><span class="lineno"> 2235</span> </div>
<div class="line"><a id="l02236" name="l02236"></a><span class="lineno"><a class="line" href="wcs_8h.html#a4ab38bc642c4656f62c43acf84a849f1"> 2236</a></span><span class="keywordtype">int</span> <a class="code hl_function" href="wcs_8h.html#a4ab38bc642c4656f62c43acf84a849f1">wcsfree</a>(<span class="keyword">struct</span> <a class="code hl_struct" href="structwcsprm.html">wcsprm</a> *wcs);</div>
<div class="line"><a id="l02237" name="l02237"></a><span class="lineno"> 2237</span> </div>
<div class="line"><a id="l02238" name="l02238"></a><span class="lineno"><a class="line" href="wcs_8h.html#aabfe985b365a14d529d43fc6a4c6fe9b"> 2238</a></span><span class="keywordtype">int</span> <a class="code hl_function" href="wcs_8h.html#aabfe985b365a14d529d43fc6a4c6fe9b">wcstrim</a>(<span class="keyword">struct</span> <a class="code hl_struct" href="structwcsprm.html">wcsprm</a> *wcs);</div>
<div class="line"><a id="l02239" name="l02239"></a><span class="lineno"> 2239</span> </div>
<div class="line"><a id="l02240" name="l02240"></a><span class="lineno"><a class="line" href="wcs_8h.html#a3a0875a1f9479f6929ad129b0200d09b"> 2240</a></span><span class="keywordtype">int</span> <a class="code hl_function" href="wcs_8h.html#a3a0875a1f9479f6929ad129b0200d09b">wcssize</a>(<span class="keyword">const</span> <span class="keyword">struct</span> <a class="code hl_struct" href="structwcsprm.html">wcsprm</a> *wcs, <span class="keywordtype">int</span> sizes[2]);</div>
<div class="line"><a id="l02241" name="l02241"></a><span class="lineno"> 2241</span> </div>
<div class="line"><a id="l02242" name="l02242"></a><span class="lineno"><a class="line" href="wcs_8h.html#a4c84e6786212077fbecc0fc883656dcb"> 2242</a></span><span class="keywordtype">int</span> <a class="code hl_function" href="wcs_8h.html#a4c84e6786212077fbecc0fc883656dcb">auxsize</a>(<span class="keyword">const</span> <span class="keyword">struct</span> <a class="code hl_struct" href="structauxprm.html">auxprm</a> *aux, <span class="keywordtype">int</span> sizes[2]);</div>
<div class="line"><a id="l02243" name="l02243"></a><span class="lineno"> 2243</span> </div>
<div class="line"><a id="l02244" name="l02244"></a><span class="lineno"><a class="line" href="wcs_8h.html#ab9aeb8cf1afb1bfb22e989580d90fca8"> 2244</a></span><span class="keywordtype">int</span> <a class="code hl_function" href="wcs_8h.html#ab9aeb8cf1afb1bfb22e989580d90fca8">wcsprt</a>(<span class="keyword">const</span> <span class="keyword">struct</span> <a class="code hl_struct" href="structwcsprm.html">wcsprm</a> *wcs);</div>
<div class="line"><a id="l02245" name="l02245"></a><span class="lineno"> 2245</span> </div>
<div class="line"><a id="l02246" name="l02246"></a><span class="lineno"><a class="line" href="wcs_8h.html#a8fe5dcd9927240dc0348b850ee662367"> 2246</a></span><span class="keywordtype">int</span> <a class="code hl_function" href="wcs_8h.html#a8fe5dcd9927240dc0348b850ee662367">wcsperr</a>(<span class="keyword">const</span> <span class="keyword">struct</span> <a class="code hl_struct" href="structwcsprm.html">wcsprm</a> *wcs, <span class="keyword">const</span> <span class="keywordtype">char</span> *prefix);</div>
<div class="line"><a id="l02247" name="l02247"></a><span class="lineno"> 2247</span> </div>
<div class="line"><a id="l02248" name="l02248"></a><span class="lineno"><a class="line" href="wcs_8h.html#af226d8537fbc578d63f1ba5601078398"> 2248</a></span><span class="keywordtype">int</span> <a class="code hl_function" href="wcs_8h.html#af226d8537fbc578d63f1ba5601078398">wcsbchk</a>(<span class="keyword">struct</span> <a class="code hl_struct" href="structwcsprm.html">wcsprm</a> *wcs, <span class="keywordtype">int</span> bounds);</div>
<div class="line"><a id="l02249" name="l02249"></a><span class="lineno"> 2249</span> </div>
<div class="line"><a id="l02250" name="l02250"></a><span class="lineno"><a class="line" href="wcs_8h.html#ae5cc3f5d249755583403cdf54d2ebb91"> 2250</a></span><span class="keywordtype">int</span> <a class="code hl_function" href="wcs_8h.html#ae5cc3f5d249755583403cdf54d2ebb91">wcsset</a>(<span class="keyword">struct</span> <a class="code hl_struct" href="structwcsprm.html">wcsprm</a> *wcs);</div>
<div class="line"><a id="l02251" name="l02251"></a><span class="lineno"> 2251</span> </div>
<div class="line"><a id="l02252" name="l02252"></a><span class="lineno"><a class="line" href="wcs_8h.html#a27d3dd209db3e76cf4c50f48c01ba986"> 2252</a></span><span class="keywordtype">int</span> <a class="code hl_function" href="wcs_8h.html#a27d3dd209db3e76cf4c50f48c01ba986">wcsp2s</a>(<span class="keyword">struct</span> <a class="code hl_struct" href="structwcsprm.html">wcsprm</a> *wcs, <span class="keywordtype">int</span> ncoord, <span class="keywordtype">int</span> nelem, <span class="keyword">const</span> <span class="keywordtype">double</span> pixcrd[],</div>
<div class="line"><a id="l02253" name="l02253"></a><span class="lineno"> 2253</span>           <span class="keywordtype">double</span> imgcrd[], <span class="keywordtype">double</span> phi[], <span class="keywordtype">double</span> theta[], <span class="keywordtype">double</span> world[],</div>
<div class="line"><a id="l02254" name="l02254"></a><span class="lineno"> 2254</span>           <span class="keywordtype">int</span> stat[]);</div>
<div class="line"><a id="l02255" name="l02255"></a><span class="lineno"> 2255</span> </div>
<div class="line"><a id="l02256" name="l02256"></a><span class="lineno"><a class="line" href="wcs_8h.html#a60673d05a3513659ac848a9cb3d0cb07"> 2256</a></span><span class="keywordtype">int</span> <a class="code hl_function" href="wcs_8h.html#a60673d05a3513659ac848a9cb3d0cb07">wcss2p</a>(<span class="keyword">struct</span> <a class="code hl_struct" href="structwcsprm.html">wcsprm</a> *wcs, <span class="keywordtype">int</span> ncoord, <span class="keywordtype">int</span> nelem, <span class="keyword">const</span> <span class="keywordtype">double</span> world[],</div>
<div class="line"><a id="l02257" name="l02257"></a><span class="lineno"> 2257</span>           <span class="keywordtype">double</span> phi[], <span class="keywordtype">double</span> theta[], <span class="keywordtype">double</span> imgcrd[], <span class="keywordtype">double</span> pixcrd[],</div>
<div class="line"><a id="l02258" name="l02258"></a><span class="lineno"> 2258</span>           <span class="keywordtype">int</span> stat[]);</div>
<div class="line"><a id="l02259" name="l02259"></a><span class="lineno"> 2259</span> </div>
<div class="line"><a id="l02260" name="l02260"></a><span class="lineno"><a class="line" href="wcs_8h.html#a1c1971f6d8e8667a1f5acb4bebd65c6f"> 2260</a></span><span class="keywordtype">int</span> <a class="code hl_function" href="wcs_8h.html#a1c1971f6d8e8667a1f5acb4bebd65c6f">wcsmix</a>(<span class="keyword">struct</span> <a class="code hl_struct" href="structwcsprm.html">wcsprm</a> *wcs, <span class="keywordtype">int</span> mixpix, <span class="keywordtype">int</span> mixcel, <span class="keyword">const</span> <span class="keywordtype">double</span> vspan[2],</div>
<div class="line"><a id="l02261" name="l02261"></a><span class="lineno"> 2261</span>           <span class="keywordtype">double</span> vstep, <span class="keywordtype">int</span> viter, <span class="keywordtype">double</span> world[], <span class="keywordtype">double</span> phi[],</div>
<div class="line"><a id="l02262" name="l02262"></a><span class="lineno"> 2262</span>           <span class="keywordtype">double</span> theta[], <span class="keywordtype">double</span> imgcrd[], <span class="keywordtype">double</span> pixcrd[]);</div>
<div class="line"><a id="l02263" name="l02263"></a><span class="lineno"> 2263</span> </div>
<div class="line"><a id="l02264" name="l02264"></a><span class="lineno"><a class="line" href="wcs_8h.html#a7b788938019a60c322d5cb82df7068d4"> 2264</a></span><span class="keywordtype">int</span> <a class="code hl_function" href="wcs_8h.html#a7b788938019a60c322d5cb82df7068d4">wcsccs</a>(<span class="keyword">struct</span> <a class="code hl_struct" href="structwcsprm.html">wcsprm</a> *wcs, <span class="keywordtype">double</span> lng2p1, <span class="keywordtype">double</span> lat2p1, <span class="keywordtype">double</span> lng1p2,</div>
<div class="line"><a id="l02265" name="l02265"></a><span class="lineno"> 2265</span>           <span class="keyword">const</span> <span class="keywordtype">char</span> *clng, <span class="keyword">const</span> <span class="keywordtype">char</span> *clat, <span class="keyword">const</span> <span class="keywordtype">char</span> *radesys,</div>
<div class="line"><a id="l02266" name="l02266"></a><span class="lineno"> 2266</span>           <span class="keywordtype">double</span> equinox, <span class="keyword">const</span> <span class="keywordtype">char</span> *alt);</div>
<div class="line"><a id="l02267" name="l02267"></a><span class="lineno"> 2267</span> </div>
<div class="line"><a id="l02268" name="l02268"></a><span class="lineno"><a class="line" href="wcs_8h.html#a57975833fe0588eb7c7b6d79f13a7693"> 2268</a></span><span class="keywordtype">int</span> <a class="code hl_function" href="wcs_8h.html#a57975833fe0588eb7c7b6d79f13a7693">wcssptr</a>(<span class="keyword">struct</span> <a class="code hl_struct" href="structwcsprm.html">wcsprm</a> *wcs, <span class="keywordtype">int</span> *<a class="code hl_variable" href="structwtbarr.html#a8743b84c99b4b5e7ab7bf0653507a180">i</a>, <span class="keywordtype">char</span> ctype[9]);</div>
<div class="line"><a id="l02269" name="l02269"></a><span class="lineno"> 2269</span> </div>
<div class="line"><a id="l02270" name="l02270"></a><span class="lineno"><a class="line" href="wcs_8h.html#ad875ce4317d85c893f64afe10ab1630e"> 2270</a></span><span class="keyword">const</span> <span class="keywordtype">char</span>* <a class="code hl_function" href="wcs_8h.html#ad875ce4317d85c893f64afe10ab1630e">wcslib_version</a>(<span class="keywordtype">int</span> vers[3]);</div>
<div class="line"><a id="l02271" name="l02271"></a><span class="lineno"> 2271</span> </div>
<div class="line"><a id="l02272" name="l02272"></a><span class="lineno"> 2272</span><span class="comment">// Defined mainly for backwards compatibility, use wcssub() instead.</span></div>
<div class="line"><a id="l02273" name="l02273"></a><span class="lineno"><a class="line" href="wcs_8h.html#ac55946dadc53ac592cb686275902ae7b"> 2273</a></span><span class="preprocessor">#define wcscopy(alloc, wcssrc, wcsdst) wcssub(alloc, wcssrc, 0x0, 0x0, wcsdst)</span></div>
<div class="line"><a id="l02274" name="l02274"></a><span class="lineno"> 2274</span> </div>
<div class="line"><a id="l02275" name="l02275"></a><span class="lineno"> 2275</span> </div>
<div class="line"><a id="l02276" name="l02276"></a><span class="lineno"> 2276</span><span class="comment">// Deprecated.</span></div>
<div class="line"><a id="l02277" name="l02277"></a><span class="lineno"><a class="line" href="wcs_8h.html#a1bcf49cfe1ed1bb2bc4c930f98d808fa"> 2277</a></span><span class="preprocessor">#define wcsini_errmsg wcs_errmsg</span></div>
<div class="line"><a id="l02278" name="l02278"></a><span class="lineno"><a class="line" href="wcs_8h.html#a465ef3c77aaf546324dae0692e6de7fe"> 2278</a></span><span class="preprocessor">#define wcssub_errmsg wcs_errmsg</span></div>
<div class="line"><a id="l02279" name="l02279"></a><span class="lineno"><a class="line" href="wcs_8h.html#ae1738854472218541bda531653ef2709"> 2279</a></span><span class="preprocessor">#define wcscopy_errmsg wcs_errmsg</span></div>
<div class="line"><a id="l02280" name="l02280"></a><span class="lineno"><a class="line" href="wcs_8h.html#a3d64b57cec404114c75bd25a562e8053"> 2280</a></span><span class="preprocessor">#define wcsfree_errmsg wcs_errmsg</span></div>
<div class="line"><a id="l02281" name="l02281"></a><span class="lineno"><a class="line" href="wcs_8h.html#a8f5c31a6983b17abbe2fead61550d55c"> 2281</a></span><span class="preprocessor">#define wcsprt_errmsg wcs_errmsg</span></div>
<div class="line"><a id="l02282" name="l02282"></a><span class="lineno"><a class="line" href="wcs_8h.html#a84a67c964e212bbf004c264b3ca70fee"> 2282</a></span><span class="preprocessor">#define wcsset_errmsg wcs_errmsg</span></div>
<div class="line"><a id="l02283" name="l02283"></a><span class="lineno"><a class="line" href="wcs_8h.html#ade3959355dc9d0987e7ccc4070795c38"> 2283</a></span><span class="preprocessor">#define wcsp2s_errmsg wcs_errmsg</span></div>
<div class="line"><a id="l02284" name="l02284"></a><span class="lineno"><a class="line" href="wcs_8h.html#a37c4884cf58baf25b2984ec3bccb80a5"> 2284</a></span><span class="preprocessor">#define wcss2p_errmsg wcs_errmsg</span></div>
<div class="line"><a id="l02285" name="l02285"></a><span class="lineno"><a class="line" href="wcs_8h.html#acfbadc770489b6b5186b95eaa35467f1"> 2285</a></span><span class="preprocessor">#define wcsmix_errmsg wcs_errmsg</span></div>
<div class="line"><a id="l02286" name="l02286"></a><span class="lineno"> 2286</span> </div>
<div class="line"><a id="l02287" name="l02287"></a><span class="lineno"> 2287</span><span class="preprocessor">#ifdef __cplusplus</span></div>
<div class="line"><a id="l02288" name="l02288"></a><span class="lineno"> 2288</span><span class="preprocessor">#undef wtbarr</span></div>
<div class="line"><a id="l02289" name="l02289"></a><span class="lineno"> 2289</span>}</div>
<div class="line"><a id="l02290" name="l02290"></a><span class="lineno"> 2290</span><span class="preprocessor">#endif</span></div>
<div class="line"><a id="l02291" name="l02291"></a><span class="lineno"> 2291</span> </div>
<div class="line"><a id="l02292" name="l02292"></a><span class="lineno"> 2292</span><span class="preprocessor">#endif </span><span class="comment">// WCSLIB_WCS</span></div>
<div class="ttc" id="acel_8h_html"><div class="ttname"><a href="cel_8h.html">cel.h</a></div></div>
<div class="ttc" id="alin_8h_html"><div class="ttname"><a href="lin_8h.html">lin.h</a></div></div>
<div class="ttc" id="aspc_8h_html"><div class="ttname"><a href="spc_8h.html">spc.h</a></div></div>
<div class="ttc" id="astructauxprm_html"><div class="ttname"><a href="structauxprm.html">auxprm</a></div><div class="ttdoc">Additional auxiliary parameters.</div><div class="ttdef"><b>Definition</b> wcs.h:2065</div></div>
<div class="ttc" id="astructauxprm_html_a0319d8103f0f0a166715e74e329ded2d"><div class="ttname"><a href="structauxprm.html#a0319d8103f0f0a166715e74e329ded2d">auxprm::dsun_obs</a></div><div class="ttdeci">double dsun_obs</div><div class="ttdef"><b>Definition</b> wcs.h:2067</div></div>
<div class="ttc" id="astructauxprm_html_a5a596e2c4371fa92d04b64a4be6207ae"><div class="ttname"><a href="structauxprm.html#a5a596e2c4371fa92d04b64a4be6207ae">auxprm::hglt_obs</a></div><div class="ttdeci">double hglt_obs</div><div class="ttdef"><b>Definition</b> wcs.h:2070</div></div>
<div class="ttc" id="astructauxprm_html_a6de4cfed899ff4db5225ccc4d44b5fd7"><div class="ttname"><a href="structauxprm.html#a6de4cfed899ff4db5225ccc4d44b5fd7">auxprm::c_radius</a></div><div class="ttdeci">double c_radius</div><div class="ttdef"><b>Definition</b> wcs.h:2074</div></div>
<div class="ttc" id="astructauxprm_html_a817ab87c5da2299e795cc260ad563436"><div class="ttname"><a href="structauxprm.html#a817ab87c5da2299e795cc260ad563436">auxprm::hgln_obs</a></div><div class="ttdeci">double hgln_obs</div><div class="ttdef"><b>Definition</b> wcs.h:2069</div></div>
<div class="ttc" id="astructauxprm_html_a87eb38047efbafe866142ea915bab39d"><div class="ttname"><a href="structauxprm.html#a87eb38047efbafe866142ea915bab39d">auxprm::dummy</a></div><div class="ttdeci">double dummy[2]</div><div class="ttdef"><b>Definition</b> wcs.h:2078</div></div>
<div class="ttc" id="astructauxprm_html_a8b058da5ec51c0521776cf96ce3a987a"><div class="ttname"><a href="structauxprm.html#a8b058da5ec51c0521776cf96ce3a987a">auxprm::crln_obs</a></div><div class="ttdeci">double crln_obs</div><div class="ttdef"><b>Definition</b> wcs.h:2068</div></div>
<div class="ttc" id="astructauxprm_html_aa12b84a421a5d852c469fada87d3149b"><div class="ttname"><a href="structauxprm.html#aa12b84a421a5d852c469fada87d3149b">auxprm::b_radius</a></div><div class="ttdeci">double b_radius</div><div class="ttdef"><b>Definition</b> wcs.h:2073</div></div>
<div class="ttc" id="astructauxprm_html_abf9924ec2b288ba8f548bfc6b72b0321"><div class="ttname"><a href="structauxprm.html#abf9924ec2b288ba8f548bfc6b72b0321">auxprm::blon_obs</a></div><div class="ttdeci">double blon_obs</div><div class="ttdef"><b>Definition</b> wcs.h:2075</div></div>
<div class="ttc" id="astructauxprm_html_ad4ca1436fb83cefcbdbe3f985a515552"><div class="ttname"><a href="structauxprm.html#ad4ca1436fb83cefcbdbe3f985a515552">auxprm::a_radius</a></div><div class="ttdeci">double a_radius</div><div class="ttdef"><b>Definition</b> wcs.h:2072</div></div>
<div class="ttc" id="astructauxprm_html_ae90fd56f574beaf8a3c5d7136bfb4a01"><div class="ttname"><a href="structauxprm.html#ae90fd56f574beaf8a3c5d7136bfb4a01">auxprm::rsun_ref</a></div><div class="ttdeci">double rsun_ref</div><div class="ttdef"><b>Definition</b> wcs.h:2066</div></div>
<div class="ttc" id="astructauxprm_html_af14345ab9fa7b6767d00dffee303a42c"><div class="ttname"><a href="structauxprm.html#af14345ab9fa7b6767d00dffee303a42c">auxprm::bdis_obs</a></div><div class="ttdeci">double bdis_obs</div><div class="ttdef"><b>Definition</b> wcs.h:2077</div></div>
<div class="ttc" id="astructauxprm_html_af4d7e22bc28d11d46a9bdbf5e48561ea"><div class="ttname"><a href="structauxprm.html#af4d7e22bc28d11d46a9bdbf5e48561ea">auxprm::blat_obs</a></div><div class="ttdeci">double blat_obs</div><div class="ttdef"><b>Definition</b> wcs.h:2076</div></div>
<div class="ttc" id="astructcelprm_html"><div class="ttname"><a href="structcelprm.html">celprm</a></div><div class="ttdoc">Celestial transformation parameters.</div><div class="ttdef"><b>Definition</b> cel.h:423</div></div>
<div class="ttc" id="astructlinprm_html"><div class="ttname"><a href="structlinprm.html">linprm</a></div><div class="ttdoc">Linear transformation parameters.</div><div class="ttdef"><b>Definition</b> lin.h:680</div></div>
<div class="ttc" id="astructpscard_html"><div class="ttname"><a href="structpscard.html">pscard</a></div><div class="ttdoc">Store for PSi_ma keyrecords.</div><div class="ttdef"><b>Definition</b> wcs.h:2055</div></div>
<div class="ttc" id="astructpscard_html_a37a06c885cf73736f2eb5e78bd1034a1"><div class="ttname"><a href="structpscard.html#a37a06c885cf73736f2eb5e78bd1034a1">pscard::i</a></div><div class="ttdeci">int i</div><div class="ttdef"><b>Definition</b> wcs.h:2056</div></div>
<div class="ttc" id="astructpscard_html_a71912f084bc3cadeb0758756a723071a"><div class="ttname"><a href="structpscard.html#a71912f084bc3cadeb0758756a723071a">pscard::m</a></div><div class="ttdeci">int m</div><div class="ttdef"><b>Definition</b> wcs.h:2057</div></div>
<div class="ttc" id="astructpscard_html_a9986f2ace84978f6cc543224b57592c9"><div class="ttname"><a href="structpscard.html#a9986f2ace84978f6cc543224b57592c9">pscard::value</a></div><div class="ttdeci">char value[72]</div><div class="ttdef"><b>Definition</b> wcs.h:2058</div></div>
<div class="ttc" id="astructpvcard_html"><div class="ttname"><a href="structpvcard.html">pvcard</a></div><div class="ttdoc">Store for PVi_ma keyrecords.</div><div class="ttdef"><b>Definition</b> wcs.h:2045</div></div>
<div class="ttc" id="astructpvcard_html_a5c97562bbadb55b8a2db59d9c7878059"><div class="ttname"><a href="structpvcard.html#a5c97562bbadb55b8a2db59d9c7878059">pvcard::value</a></div><div class="ttdeci">double value</div><div class="ttdef"><b>Definition</b> wcs.h:2048</div></div>
<div class="ttc" id="astructpvcard_html_a88fa516543184eaffe6bd2c57946d9a7"><div class="ttname"><a href="structpvcard.html#a88fa516543184eaffe6bd2c57946d9a7">pvcard::i</a></div><div class="ttdeci">int i</div><div class="ttdef"><b>Definition</b> wcs.h:2046</div></div>
<div class="ttc" id="astructpvcard_html_af011f1972d6d345540f36a5c08a30d1f"><div class="ttname"><a href="structpvcard.html#af011f1972d6d345540f36a5c08a30d1f">pvcard::m</a></div><div class="ttdeci">int m</div><div class="ttdef"><b>Definition</b> wcs.h:2047</div></div>
<div class="ttc" id="astructspcprm_html"><div class="ttname"><a href="structspcprm.html">spcprm</a></div><div class="ttdoc">Spectral transformation parameters.</div><div class="ttdef"><b>Definition</b> spc.h:832</div></div>
<div class="ttc" id="astructtabprm_html"><div class="ttname"><a href="structtabprm.html">tabprm</a></div><div class="ttdoc">Tabular transformation parameters.</div><div class="ttdef"><b>Definition</b> tab.h:573</div></div>
<div class="ttc" id="astructwcserr_html"><div class="ttname"><a href="structwcserr.html">wcserr</a></div><div class="ttdoc">Error message handling.</div><div class="ttdef"><b>Definition</b> wcserr.h:243</div></div>
<div class="ttc" id="astructwcsprm_html"><div class="ttname"><a href="structwcsprm.html">wcsprm</a></div><div class="ttdoc">Coordinate transformation parameters.</div><div class="ttdef"><b>Definition</b> wcs.h:2085</div></div>
<div class="ttc" id="astructwcsprm_html_a01c8f1c9c125c939b43ba05d4caec907"><div class="ttname"><a href="structwcsprm.html#a01c8f1c9c125c939b43ba05d4caec907">wcsprm::timeunit</a></div><div class="ttdeci">char timeunit[72]</div><div class="ttdef"><b>Definition</b> wcs.h:2141</div></div>
<div class="ttc" id="astructwcsprm_html_a042875def8cab8354c5b2c40ab9fa374"><div class="ttname"><a href="structwcsprm.html#a042875def8cab8354c5b2c40ab9fa374">wcsprm::m_ps</a></div><div class="ttdeci">struct pscard * m_ps</div><div class="ttdef"><b>Definition</b> wcs.h:2205</div></div>
<div class="ttc" id="astructwcsprm_html_a04771d9d83256b63c86c29d6fa717d81"><div class="ttname"><a href="structwcsprm.html#a04771d9d83256b63c86c29d6fa717d81">wcsprm::timesys</a></div><div class="ttdeci">char timesys[72]</div><div class="ttdef"><b>Definition</b> wcs.h:2140</div></div>
<div class="ttc" id="astructwcsprm_html_a04fbd6ed1b338e225f2291523e64be2c"><div class="ttname"><a href="structwcsprm.html#a04fbd6ed1b338e225f2291523e64be2c">wcsprm::pv</a></div><div class="ttdeci">struct pvcard * pv</div><div class="ttdef"><b>Definition</b> wcs.h:2109</div></div>
<div class="ttc" id="astructwcsprm_html_a056ffc4826e7a7ba59909fe5063dfa0b"><div class="ttname"><a href="structwcsprm.html#a056ffc4826e7a7ba59909fe5063dfa0b">wcsprm::dateref</a></div><div class="ttdeci">char dateref[72]</div><div class="ttdef"><b>Definition</b> wcs.h:2142</div></div>
<div class="ttc" id="astructwcsprm_html_a0730c37f09502eb364f4e7d7addb8ab8"><div class="ttname"><a href="structwcsprm.html#a0730c37f09502eb364f4e7d7addb8ab8">wcsprm::mjdavg</a></div><div class="ttdeci">double mjdavg</div><div class="ttdef"><b>Definition</b> wcs.h:2147</div></div>
<div class="ttc" id="astructwcsprm_html_a08098820949433d1336841d32d0b62b5"><div class="ttname"><a href="structwcsprm.html#a08098820949433d1336841d32d0b62b5">wcsprm::lng</a></div><div class="ttdeci">int lng</div><div class="ttdef"><b>Definition</b> wcs.h:2181</div></div>
<div class="ttc" id="astructwcsprm_html_a09002a13836c82c58d8faa06188f692b"><div class="ttname"><a href="structwcsprm.html#a09002a13836c82c58d8faa06188f692b">wcsprm::czphs</a></div><div class="ttdeci">double * czphs</div><div class="ttdef"><b>Definition</b> wcs.h:2135</div></div>
<div class="ttc" id="astructwcsprm_html_a092c11d209ecdd16bb79858c68e4d582"><div class="ttname"><a href="structwcsprm.html#a092c11d209ecdd16bb79858c68e4d582">wcsprm::m_cname</a></div><div class="ttdeci">char(* m_cname)[72]</div><div class="ttdef"><b>Definition</b> wcs.h:2208</div></div>
<div class="ttc" id="astructwcsprm_html_a0936d10c2ac93d13d096b1711ac639a1"><div class="ttname"><a href="structwcsprm.html#a0936d10c2ac93d13d096b1711ac639a1">wcsprm::zsource</a></div><div class="ttdeci">double zsource</div><div class="ttdef"><b>Definition</b> wcs.h:2162</div></div>
<div class="ttc" id="astructwcsprm_html_a0d15534535c7f9308c9daa2cceff29e7"><div class="ttname"><a href="structwcsprm.html#a0d15534535c7f9308c9daa2cceff29e7">wcsprm::m_crder</a></div><div class="ttdeci">double * m_crder</div><div class="ttdef"><b>Definition</b> wcs.h:2209</div></div>
<div class="ttc" id="astructwcsprm_html_a0e31f1eef036258c2957da9b985945dd"><div class="ttname"><a href="structwcsprm.html#a0e31f1eef036258c2957da9b985945dd">wcsprm::npv</a></div><div class="ttdeci">int npv</div><div class="ttdef"><b>Definition</b> wcs.h:2107</div></div>
<div class="ttc" id="astructwcsprm_html_a0e67fa114fa224d5a675473f0f6b36c7"><div class="ttname"><a href="structwcsprm.html#a0e67fa114fa224d5a675473f0f6b36c7">wcsprm::timrder</a></div><div class="ttdeci">double timrder</div><div class="ttdef"><b>Definition</b> wcs.h:2152</div></div>
<div class="ttc" id="astructwcsprm_html_a0f9f8f2c66ff8a89c27894405db543f0"><div class="ttname"><a href="structwcsprm.html#a0f9f8f2c66ff8a89c27894405db543f0">wcsprm::trefpos</a></div><div class="ttdeci">char trefpos[72]</div><div class="ttdef"><b>Definition</b> wcs.h:2140</div></div>
<div class="ttc" id="astructwcsprm_html_a11cb29962481731befa01a35bcaf381d"><div class="ttname"><a href="structwcsprm.html#a11cb29962481731befa01a35bcaf381d">wcsprm::telapse</a></div><div class="ttdeci">double telapse</div><div class="ttdef"><b>Definition</b> wcs.h:2150</div></div>
<div class="ttc" id="astructwcsprm_html_a13fab263ca03f35844fdaca289b7dfac"><div class="ttname"><a href="structwcsprm.html#a13fab263ca03f35844fdaca289b7dfac">wcsprm::m_csyer</a></div><div class="ttdeci">double * m_csyer</div><div class="ttdef"><b>Definition</b> wcs.h:2209</div></div>
<div class="ttc" id="astructwcsprm_html_a14c69ea4611d9e56222fce7b60556e1f"><div class="ttname"><a href="structwcsprm.html#a14c69ea4611d9e56222fce7b60556e1f">wcsprm::tstart</a></div><div class="ttdeci">double tstart</div><div class="ttdef"><b>Definition</b> wcs.h:2149</div></div>
<div class="ttc" id="astructwcsprm_html_a15485177ea8bbacefc29a5a5cba98c8f"><div class="ttname"><a href="structwcsprm.html#a15485177ea8bbacefc29a5a5cba98c8f">wcsprm::csyer</a></div><div class="ttdeci">double * csyer</div><div class="ttdef"><b>Definition</b> wcs.h:2134</div></div>
<div class="ttc" id="astructwcsprm_html_a164e3852bcd2dea8b5f73e1dff79ddf5"><div class="ttname"><a href="structwcsprm.html#a164e3852bcd2dea8b5f73e1dff79ddf5">wcsprm::m_crpix</a></div><div class="ttdeci">double * m_crpix</div><div class="ttdef"><b>Definition</b> wcs.h:2202</div></div>
<div class="ttc" id="astructwcsprm_html_a17fd7510a626a8b4b3d2985c9f270ac6"><div class="ttname"><a href="structwcsprm.html#a17fd7510a626a8b4b3d2985c9f270ac6">wcsprm::cperi</a></div><div class="ttdeci">double * cperi</div><div class="ttdef"><b>Definition</b> wcs.h:2136</div></div>
<div class="ttc" id="astructwcsprm_html_a186ddcff0e5d4ee56ef904a4c125aaaf"><div class="ttname"><a href="structwcsprm.html#a186ddcff0e5d4ee56ef904a4c125aaaf">wcsprm::mjdend</a></div><div class="ttdeci">double mjdend</div><div class="ttdef"><b>Definition</b> wcs.h:2147</div></div>
<div class="ttc" id="astructwcsprm_html_a2166fb650f937d8870711d8be5986b66"><div class="ttname"><a href="structwcsprm.html#a2166fb650f937d8870711d8be5986b66">wcsprm::wcsname</a></div><div class="ttdeci">char wcsname[72]</div><div class="ttdef"><b>Definition</b> wcs.h:2138</div></div>
<div class="ttc" id="astructwcsprm_html_a292133b2b7143b969a3af6a3f2cf3709"><div class="ttname"><a href="structwcsprm.html#a292133b2b7143b969a3af6a3f2cf3709">wcsprm::tab</a></div><div class="ttdeci">struct tabprm * tab</div><div class="ttdef"><b>Definition</b> wcs.h:2174</div></div>
<div class="ttc" id="astructwcsprm_html_a3224bd06f8f4d2d7d398533eb44a49e8"><div class="ttname"><a href="structwcsprm.html#a3224bd06f8f4d2d7d398533eb44a49e8">wcsprm::lin</a></div><div class="ttdeci">struct linprm lin</div><div class="ttdef"><b>Definition</b> wcs.h:2187</div></div>
<div class="ttc" id="astructwcsprm_html_a3495a5b0ef529706ec9a0af5c3163d63"><div class="ttname"><a href="structwcsprm.html#a3495a5b0ef529706ec9a0af5c3163d63">wcsprm::pc</a></div><div class="ttdeci">double * pc</div><div class="ttdef"><b>Definition</b> wcs.h:2094</div></div>
<div class="ttc" id="astructwcsprm_html_a35bff8de85e5a8892e1b68db69ca7a68"><div class="ttname"><a href="structwcsprm.html#a35bff8de85e5a8892e1b68db69ca7a68">wcsprm::flag</a></div><div class="ttdeci">int flag</div><div class="ttdef"><b>Definition</b> wcs.h:2088</div></div>
<div class="ttc" id="astructwcsprm_html_a37e8287a522df0f03c4c051f7a11d402"><div class="ttname"><a href="structwcsprm.html#a37e8287a522df0f03c4c051f7a11d402">wcsprm::aux</a></div><div class="ttdeci">struct auxprm * aux</div><div class="ttdef"><b>Definition</b> wcs.h:2168</div></div>
<div class="ttc" id="astructwcsprm_html_a42052d557bdef2c5640a6d19b6d9ed8b"><div class="ttname"><a href="structwcsprm.html#a42052d557bdef2c5640a6d19b6d9ed8b">wcsprm::npsmax</a></div><div class="ttdeci">int npsmax</div><div class="ttdef"><b>Definition</b> wcs.h:2112</div></div>
<div class="ttc" id="astructwcsprm_html_a42e0ff2da3b0c1ca0a9509f787ed1951"><div class="ttname"><a href="structwcsprm.html#a42e0ff2da3b0c1ca0a9509f787ed1951">wcsprm::m_cdelt</a></div><div class="ttdeci">double * m_cdelt</div><div class="ttdef"><b>Definition</b> wcs.h:2202</div></div>
<div class="ttc" id="astructwcsprm_html_a49223f3649aa823d1c1564d930cd29b4"><div class="ttname"><a href="structwcsprm.html#a49223f3649aa823d1c1564d930cd29b4">wcsprm::timeoffs</a></div><div class="ttdeci">double timeoffs</div><div class="ttdef"><b>Definition</b> wcs.h:2144</div></div>
<div class="ttc" id="astructwcsprm_html_a49eee6450b1a646d3fe01b8965a63af4"><div class="ttname"><a href="structwcsprm.html#a49eee6450b1a646d3fe01b8965a63af4">wcsprm::crder</a></div><div class="ttdeci">double * crder</div><div class="ttdef"><b>Definition</b> wcs.h:2133</div></div>
<div class="ttc" id="astructwcsprm_html_a4c89dafecd036e169f96cb84d53ace65"><div class="ttname"><a href="structwcsprm.html#a4c89dafecd036e169f96cb84d53ace65">wcsprm::nps</a></div><div class="ttdeci">int nps</div><div class="ttdef"><b>Definition</b> wcs.h:2111</div></div>
<div class="ttc" id="astructwcsprm_html_a4ed527b90d49e8365c1b727f7bec29c7"><div class="ttname"><a href="structwcsprm.html#a4ed527b90d49e8365c1b727f7bec29c7">wcsprm::m_colax</a></div><div class="ttdeci">int * m_colax</div><div class="ttdef"><b>Definition</b> wcs.h:2207</div></div>
<div class="ttc" id="astructwcsprm_html_a5072893bd9beddb33967697d501acdce"><div class="ttname"><a href="structwcsprm.html#a5072893bd9beddb33967697d501acdce">wcsprm::m_crval</a></div><div class="ttdeci">double * m_crval</div><div class="ttdef"><b>Definition</b> wcs.h:2202</div></div>
<div class="ttc" id="astructwcsprm_html_a51ad344a52d5dec796968b71629f946c"><div class="ttname"><a href="structwcsprm.html#a51ad344a52d5dec796968b71629f946c">wcsprm::timepixr</a></div><div class="ttdeci">double timepixr</div><div class="ttdef"><b>Definition</b> wcs.h:2153</div></div>
<div class="ttc" id="astructwcsprm_html_a5444415c94c7ab0226788f5efe93221d"><div class="ttname"><a href="structwcsprm.html#a5444415c94c7ab0226788f5efe93221d">wcsprm::m_crota</a></div><div class="ttdeci">double * m_crota</div><div class="ttdef"><b>Definition</b> wcs.h:2206</div></div>
<div class="ttc" id="astructwcsprm_html_a54862a297e2fb951a72efa7ac5841a21"><div class="ttname"><a href="structwcsprm.html#a54862a297e2fb951a72efa7ac5841a21">wcsprm::m_cperi</a></div><div class="ttdeci">double * m_cperi</div><div class="ttdef"><b>Definition</b> wcs.h:2209</div></div>
<div class="ttc" id="astructwcsprm_html_a5780880281f2f9d085d2e06919b7647a"><div class="ttname"><a href="structwcsprm.html#a5780880281f2f9d085d2e06919b7647a">wcsprm::m_flag</a></div><div class="ttdeci">int m_flag</div><div class="ttdef"><b>Definition</b> wcs.h:2201</div></div>
<div class="ttc" id="astructwcsprm_html_a5b56e1b378a6ae9f8dfff5c364f0653c"><div class="ttname"><a href="structwcsprm.html#a5b56e1b378a6ae9f8dfff5c364f0653c">wcsprm::lngtyp</a></div><div class="ttdeci">char lngtyp[8]</div><div class="ttdef"><b>Definition</b> wcs.h:2180</div></div>
<div class="ttc" id="astructwcsprm_html_a5d0b60efc55a61525b9beb26ead4859e"><div class="ttname"><a href="structwcsprm.html#a5d0b60efc55a61525b9beb26ead4859e">wcsprm::restwav</a></div><div class="ttdeci">double restwav</div><div class="ttdef"><b>Definition</b> wcs.h:2105</div></div>
<div class="ttc" id="astructwcsprm_html_a5e04127eb71da6e1350467a7a6d236f5"><div class="ttname"><a href="structwcsprm.html#a5e04127eb71da6e1350467a7a6d236f5">wcsprm::latpole</a></div><div class="ttdeci">double latpole</div><div class="ttdef"><b>Definition</b> wcs.h:2102</div></div>
<div class="ttc" id="astructwcsprm_html_a5ed753e401cda620a04adfb4ebfb8e0d"><div class="ttname"><a href="structwcsprm.html#a5ed753e401cda620a04adfb4ebfb8e0d">wcsprm::m_naxis</a></div><div class="ttdeci">int m_naxis</div><div class="ttdef"><b>Definition</b> wcs.h:2201</div></div>
<div class="ttc" id="astructwcsprm_html_a65801f93622504672ee3faf8f2110e48"><div class="ttname"><a href="structwcsprm.html#a65801f93622504672ee3faf8f2110e48">wcsprm::radesys</a></div><div class="ttdeci">char radesys[72]</div><div class="ttdef"><b>Definition</b> wcs.h:2157</div></div>
<div class="ttc" id="astructwcsprm_html_a6778d31ec5a2ee643dc5f0a8af630b03"><div class="ttname"><a href="structwcsprm.html#a6778d31ec5a2ee643dc5f0a8af630b03">wcsprm::m_pc</a></div><div class="ttdeci">double * m_pc</div><div class="ttdef"><b>Definition</b> wcs.h:2202</div></div>
<div class="ttc" id="astructwcsprm_html_a6a3fa7adc304567271c5cc0eda3ac986"><div class="ttname"><a href="structwcsprm.html#a6a3fa7adc304567271c5cc0eda3ac986">wcsprm::m_pv</a></div><div class="ttdeci">struct pvcard * m_pv</div><div class="ttdef"><b>Definition</b> wcs.h:2204</div></div>
<div class="ttc" id="astructwcsprm_html_a70cac2976524a5f0a6aeb2b3fcb95834"><div class="ttname"><a href="structwcsprm.html#a70cac2976524a5f0a6aeb2b3fcb95834">wcsprm::naxis</a></div><div class="ttdeci">int naxis</div><div class="ttdef"><b>Definition</b> wcs.h:2092</div></div>
<div class="ttc" id="astructwcsprm_html_a7134300080d93ba780b8db3bb5ee02ce"><div class="ttname"><a href="structwcsprm.html#a7134300080d93ba780b8db3bb5ee02ce">wcsprm::m_czphs</a></div><div class="ttdeci">double * m_czphs</div><div class="ttdef"><b>Definition</b> wcs.h:2209</div></div>
<div class="ttc" id="astructwcsprm_html_a7320fc64e7705cc7495eba07482b5c55"><div class="ttname"><a href="structwcsprm.html#a7320fc64e7705cc7495eba07482b5c55">wcsprm::colax</a></div><div class="ttdeci">int * colax</div><div class="ttdef"><b>Definition</b> wcs.h:2130</div></div>
<div class="ttc" id="astructwcsprm_html_a7a0a1ce2432cef9377f70367ea1fd18c"><div class="ttname"><a href="structwcsprm.html#a7a0a1ce2432cef9377f70367ea1fd18c">wcsprm::crval</a></div><div class="ttdeci">double * crval</div><div class="ttdef"><b>Definition</b> wcs.h:2096</div></div>
<div class="ttc" id="astructwcsprm_html_a7a88af56c4c978c6d4213ae1f4bec87a"><div class="ttname"><a href="structwcsprm.html#a7a88af56c4c978c6d4213ae1f4bec87a">wcsprm::m_cd</a></div><div class="ttdeci">double * m_cd</div><div class="ttdef"><b>Definition</b> wcs.h:2206</div></div>
<div class="ttc" id="astructwcsprm_html_a80635f607f3d15a30e27ee38e9467fdd"><div class="ttname"><a href="structwcsprm.html#a80635f607f3d15a30e27ee38e9467fdd">wcsprm::tstop</a></div><div class="ttdeci">double tstop</div><div class="ttdef"><b>Definition</b> wcs.h:2149</div></div>
<div class="ttc" id="astructwcsprm_html_a834ff0b9f00cc0bb83a2e2aeca1fe767"><div class="ttname"><a href="structwcsprm.html#a834ff0b9f00cc0bb83a2e2aeca1fe767">wcsprm::obsgeo</a></div><div class="ttdeci">double obsgeo[6]</div><div class="ttdef"><b>Definition</b> wcs.h:2155</div></div>
<div class="ttc" id="astructwcsprm_html_a858a50d4a65f43dabe8128e0be4acca9"><div class="ttname"><a href="structwcsprm.html#a858a50d4a65f43dabe8128e0be4acca9">wcsprm::timsyer</a></div><div class="ttdeci">double timsyer</div><div class="ttdef"><b>Definition</b> wcs.h:2152</div></div>
<div class="ttc" id="astructwcsprm_html_a8625c0a6ff99c754566c46c2372df801"><div class="ttname"><a href="structwcsprm.html#a8625c0a6ff99c754566c46c2372df801">wcsprm::nwtb</a></div><div class="ttdeci">int nwtb</div><div class="ttdef"><b>Definition</b> wcs.h:2173</div></div>
<div class="ttc" id="astructwcsprm_html_a8715975565c8bbd0c562a32eee40fd20"><div class="ttname"><a href="structwcsprm.html#a8715975565c8bbd0c562a32eee40fd20">wcsprm::ssyssrc</a></div><div class="ttdeci">char ssyssrc[72]</div><div class="ttdef"><b>Definition</b> wcs.h:2163</div></div>
<div class="ttc" id="astructwcsprm_html_a88b55f6c8d122f3ff63532de85698864"><div class="ttname"><a href="structwcsprm.html#a88b55f6c8d122f3ff63532de85698864">wcsprm::equinox</a></div><div class="ttdeci">double equinox</div><div class="ttdef"><b>Definition</b> wcs.h:2158</div></div>
<div class="ttc" id="astructwcsprm_html_a8b3a65921acc0dabfa4efd19a003ea6e"><div class="ttname"><a href="structwcsprm.html#a8b3a65921acc0dabfa4efd19a003ea6e">wcsprm::altlin</a></div><div class="ttdeci">int altlin</div><div class="ttdef"><b>Definition</b> wcs.h:2119</div></div>
<div class="ttc" id="astructwcsprm_html_a9063e8d0c956e9eae7f7d6f3608b9ed2"><div class="ttname"><a href="structwcsprm.html#a9063e8d0c956e9eae7f7d6f3608b9ed2">wcsprm::wtb</a></div><div class="ttdeci">struct wtbarr * wtb</div><div class="ttdef"><b>Definition</b> wcs.h:2175</div></div>
<div class="ttc" id="astructwcsprm_html_a912eed291f15134e8cfb8750acc6c4bc"><div class="ttname"><a href="structwcsprm.html#a912eed291f15134e8cfb8750acc6c4bc">wcsprm::npvmax</a></div><div class="ttdeci">int npvmax</div><div class="ttdef"><b>Definition</b> wcs.h:2108</div></div>
<div class="ttc" id="astructwcsprm_html_a922f0f57b8c35cad3d01ceedeba01d4b"><div class="ttname"><a href="structwcsprm.html#a922f0f57b8c35cad3d01ceedeba01d4b">wcsprm::cname</a></div><div class="ttdeci">char(* cname)[72]</div><div class="ttdef"><b>Definition</b> wcs.h:2132</div></div>
<div class="ttc" id="astructwcsprm_html_a92923310bdeb7b8591baad9a389e23bd"><div class="ttname"><a href="structwcsprm.html#a92923310bdeb7b8591baad9a389e23bd">wcsprm::jepoch</a></div><div class="ttdeci">double jepoch</div><div class="ttdef"><b>Definition</b> wcs.h:2148</div></div>
<div class="ttc" id="astructwcsprm_html_a94c26ce331cc876d63baeeada9820241"><div class="ttname"><a href="structwcsprm.html#a94c26ce331cc876d63baeeada9820241">wcsprm::ntab</a></div><div class="ttdeci">int ntab</div><div class="ttdef"><b>Definition</b> wcs.h:2172</div></div>
<div class="ttc" id="astructwcsprm_html_a9eac54f497e1244c8106dd3ebba12223"><div class="ttname"><a href="structwcsprm.html#a9eac54f497e1244c8106dd3ebba12223">wcsprm::ssysobs</a></div><div class="ttdeci">char ssysobs[72]</div><div class="ttdef"><b>Definition</b> wcs.h:2160</div></div>
<div class="ttc" id="astructwcsprm_html_a9eca2fcc30058310d020181ae16bf256"><div class="ttname"><a href="structwcsprm.html#a9eca2fcc30058310d020181ae16bf256">wcsprm::ps</a></div><div class="ttdeci">struct pscard * ps</div><div class="ttdef"><b>Definition</b> wcs.h:2113</div></div>
<div class="ttc" id="astructwcsprm_html_a9ee8fb568ca75874bab00825b768f8ca"><div class="ttname"><a href="structwcsprm.html#a9ee8fb568ca75874bab00825b768f8ca">wcsprm::colnum</a></div><div class="ttdeci">int colnum</div><div class="ttdef"><b>Definition</b> wcs.h:2129</div></div>
<div class="ttc" id="astructwcsprm_html_a9f9ec0f8abfa8af01ac97541cade3881"><div class="ttname"><a href="structwcsprm.html#a9f9ec0f8abfa8af01ac97541cade3881">wcsprm::datebeg</a></div><div class="ttdeci">char datebeg[72]</div><div class="ttdef"><b>Definition</b> wcs.h:2146</div></div>
<div class="ttc" id="astructwcsprm_html_a9fd60ce9e6bc31df07ed02ce64b48be4"><div class="ttname"><a href="structwcsprm.html#a9fd60ce9e6bc31df07ed02ce64b48be4">wcsprm::velangl</a></div><div class="ttdeci">double velangl</div><div class="ttdef"><b>Definition</b> wcs.h:2164</div></div>
<div class="ttc" id="astructwcsprm_html_aa02a4e561a7a106ae8b8adbb17da0393"><div class="ttname"><a href="structwcsprm.html#aa02a4e561a7a106ae8b8adbb17da0393">wcsprm::mjdbeg</a></div><div class="ttdeci">double mjdbeg</div><div class="ttdef"><b>Definition</b> wcs.h:2147</div></div>
<div class="ttc" id="astructwcsprm_html_aa0ae3f3605566be2e85e51e5b52c3b52"><div class="ttname"><a href="structwcsprm.html#aa0ae3f3605566be2e85e51e5b52c3b52">wcsprm::cunit</a></div><div class="ttdeci">char(* cunit)[72]</div><div class="ttdef"><b>Definition</b> wcs.h:2098</div></div>
<div class="ttc" id="astructwcsprm_html_aa2fdffbfdcae25f5dc0c93b857a6d911"><div class="ttname"><a href="structwcsprm.html#aa2fdffbfdcae25f5dc0c93b857a6d911">wcsprm::bepoch</a></div><div class="ttdeci">double bepoch</div><div class="ttdef"><b>Definition</b> wcs.h:2148</div></div>
<div class="ttc" id="astructwcsprm_html_aa482719872f17f60934b2e7d746174eb"><div class="ttname"><a href="structwcsprm.html#aa482719872f17f60934b2e7d746174eb">wcsprm::mjdref</a></div><div class="ttdeci">double mjdref[2]</div><div class="ttdef"><b>Definition</b> wcs.h:2143</div></div>
<div class="ttc" id="astructwcsprm_html_aa4fcafeaedae6f7636ab9e22ec9e5c7a"><div class="ttname"><a href="structwcsprm.html#aa4fcafeaedae6f7636ab9e22ec9e5c7a">wcsprm::time</a></div><div class="ttdeci">int time</div><div class="ttdef"><b>Definition</b> wcs.h:2181</div></div>
<div class="ttc" id="astructwcsprm_html_aa5573ea695b8aac6cdec2ac3dcc279c1"><div class="ttname"><a href="structwcsprm.html#aa5573ea695b8aac6cdec2ac3dcc279c1">wcsprm::trefdir</a></div><div class="ttdeci">char trefdir[72]</div><div class="ttdef"><b>Definition</b> wcs.h:2140</div></div>
<div class="ttc" id="astructwcsprm_html_aa8473a613e48249f5e81508cb3f3ac74"><div class="ttname"><a href="structwcsprm.html#aa8473a613e48249f5e81508cb3f3ac74">wcsprm::plephem</a></div><div class="ttdeci">char plephem[72]</div><div class="ttdef"><b>Definition</b> wcs.h:2140</div></div>
<div class="ttc" id="astructwcsprm_html_aad387ccbd7847672b5dc2223d9124120"><div class="ttname"><a href="structwcsprm.html#aad387ccbd7847672b5dc2223d9124120">wcsprm::dateobs</a></div><div class="ttdeci">char dateobs[72]</div><div class="ttdef"><b>Definition</b> wcs.h:2146</div></div>
<div class="ttc" id="astructwcsprm_html_aadad828f07e3affd1511e533b00da19f"><div class="ttname"><a href="structwcsprm.html#aadad828f07e3affd1511e533b00da19f">wcsprm::crpix</a></div><div class="ttdeci">double * crpix</div><div class="ttdef"><b>Definition</b> wcs.h:2093</div></div>
<div class="ttc" id="astructwcsprm_html_ab63cdcf6ff8febd1b40d0e044ca7d7ef"><div class="ttname"><a href="structwcsprm.html#ab63cdcf6ff8febd1b40d0e044ca7d7ef">wcsprm::types</a></div><div class="ttdeci">int * types</div><div class="ttdef"><b>Definition</b> wcs.h:2185</div></div>
<div class="ttc" id="astructwcsprm_html_ab7f7173e6d2b1b8028a3275bdd751e79"><div class="ttname"><a href="structwcsprm.html#ab7f7173e6d2b1b8028a3275bdd751e79">wcsprm::lat</a></div><div class="ttdeci">int lat</div><div class="ttdef"><b>Definition</b> wcs.h:2181</div></div>
<div class="ttc" id="astructwcsprm_html_ab9729795155b8f37afd80784fb70068b"><div class="ttname"><a href="structwcsprm.html#ab9729795155b8f37afd80784fb70068b">wcsprm::spec</a></div><div class="ttdeci">int spec</div><div class="ttdef"><b>Definition</b> wcs.h:2181</div></div>
<div class="ttc" id="astructwcsprm_html_ac089e5d0e3191255ceaea7f8591b27ea"><div class="ttname"><a href="structwcsprm.html#ac089e5d0e3191255ceaea7f8591b27ea">wcsprm::specsys</a></div><div class="ttdeci">char specsys[72]</div><div class="ttdef"><b>Definition</b> wcs.h:2159</div></div>
<div class="ttc" id="astructwcsprm_html_ac0cb013b1505fb7abd4167ac0db0e0aa"><div class="ttname"><a href="structwcsprm.html#ac0cb013b1505fb7abd4167ac0db0e0aa">wcsprm::mjdobs</a></div><div class="ttdeci">double mjdobs</div><div class="ttdef"><b>Definition</b> wcs.h:2147</div></div>
<div class="ttc" id="astructwcsprm_html_ac1b0235591049211a642f24d5be7fac5"><div class="ttname"><a href="structwcsprm.html#ac1b0235591049211a642f24d5be7fac5">wcsprm::xposure</a></div><div class="ttdeci">double xposure</div><div class="ttdef"><b>Definition</b> wcs.h:2150</div></div>
<div class="ttc" id="astructwcsprm_html_ac3c9c869bef4e4850dfd9762b33ce908"><div class="ttname"><a href="structwcsprm.html#ac3c9c869bef4e4850dfd9762b33ce908">wcsprm::velref</a></div><div class="ttdeci">int velref</div><div class="ttdef"><b>Definition</b> wcs.h:2123</div></div>
<div class="ttc" id="astructwcsprm_html_ac8391dd770637dbb841067996b7777ba"><div class="ttname"><a href="structwcsprm.html#ac8391dd770637dbb841067996b7777ba">wcsprm::cel</a></div><div class="ttdeci">struct celprm cel</div><div class="ttdef"><b>Definition</b> wcs.h:2188</div></div>
<div class="ttc" id="astructwcsprm_html_ace7e0986c79d73bd3a0613034b71974f"><div class="ttname"><a href="structwcsprm.html#ace7e0986c79d73bd3a0613034b71974f">wcsprm::m_wtb</a></div><div class="ttdeci">struct wtbarr * m_wtb</div><div class="ttdef"><b>Definition</b> wcs.h:2212</div></div>
<div class="ttc" id="astructwcsprm_html_ad1f07e7ae6746a993beed50e58eb6d59"><div class="ttname"><a href="structwcsprm.html#ad1f07e7ae6746a993beed50e58eb6d59">wcsprm::dateend</a></div><div class="ttdeci">char dateend[72]</div><div class="ttdef"><b>Definition</b> wcs.h:2146</div></div>
<div class="ttc" id="astructwcsprm_html_ad354d9754c757b31810a3751ea67b5d3"><div class="ttname"><a href="structwcsprm.html#ad354d9754c757b31810a3751ea67b5d3">wcsprm::m_aux</a></div><div class="ttdeci">struct auxprm * m_aux</div><div class="ttdef"><b>Definition</b> wcs.h:2210</div></div>
<div class="ttc" id="astructwcsprm_html_ada1b98589c0127d34766b4c6b5d6cb41"><div class="ttname"><a href="structwcsprm.html#ada1b98589c0127d34766b4c6b5d6cb41">wcsprm::restfrq</a></div><div class="ttdeci">double restfrq</div><div class="ttdef"><b>Definition</b> wcs.h:2104</div></div>
<div class="ttc" id="astructwcsprm_html_ade355cdce054938cfa36e06ef9c51446"><div class="ttname"><a href="structwcsprm.html#ade355cdce054938cfa36e06ef9c51446">wcsprm::cdelt</a></div><div class="ttdeci">double * cdelt</div><div class="ttdef"><b>Definition</b> wcs.h:2095</div></div>
<div class="ttc" id="astructwcsprm_html_ade8495d3ca5047eeadba5934d0bb2708"><div class="ttname"><a href="structwcsprm.html#ade8495d3ca5047eeadba5934d0bb2708">wcsprm::cubeface</a></div><div class="ttdeci">int cubeface</div><div class="ttdef"><b>Definition</b> wcs.h:2183</div></div>
<div class="ttc" id="astructwcsprm_html_ae09d5bf005e3bd7ee880353e8816ceb8"><div class="ttname"><a href="structwcsprm.html#ae09d5bf005e3bd7ee880353e8816ceb8">wcsprm::m_tab</a></div><div class="ttdeci">struct tabprm * m_tab</div><div class="ttdef"><b>Definition</b> wcs.h:2211</div></div>
<div class="ttc" id="astructwcsprm_html_ae1d3fe09a3c2da7366cefc2627491836"><div class="ttname"><a href="structwcsprm.html#ae1d3fe09a3c2da7366cefc2627491836">wcsprm::obsorbit</a></div><div class="ttdeci">char obsorbit[72]</div><div class="ttdef"><b>Definition</b> wcs.h:2156</div></div>
<div class="ttc" id="astructwcsprm_html_ae1f462606974e1324cd38f143eda691e"><div class="ttname"><a href="structwcsprm.html#ae1f462606974e1324cd38f143eda691e">wcsprm::ctype</a></div><div class="ttdeci">char(* ctype)[72]</div><div class="ttdef"><b>Definition</b> wcs.h:2099</div></div>
<div class="ttc" id="astructwcsprm_html_ae352318ce3202dab1b5db8b9ceec7703"><div class="ttname"><a href="structwcsprm.html#ae352318ce3202dab1b5db8b9ceec7703">wcsprm::lattyp</a></div><div class="ttdeci">char lattyp[8]</div><div class="ttdef"><b>Definition</b> wcs.h:2180</div></div>
<div class="ttc" id="astructwcsprm_html_ae6b40e2adeb31414871c7cae68619d63"><div class="ttname"><a href="structwcsprm.html#ae6b40e2adeb31414871c7cae68619d63">wcsprm::dateavg</a></div><div class="ttdeci">char dateavg[72]</div><div class="ttdef"><b>Definition</b> wcs.h:2146</div></div>
<div class="ttc" id="astructwcsprm_html_ae7609283351ea46484690f873f8ea9c3"><div class="ttname"><a href="structwcsprm.html#ae7609283351ea46484690f873f8ea9c3">wcsprm::alt</a></div><div class="ttdeci">char alt[4]</div><div class="ttdef"><b>Definition</b> wcs.h:2128</div></div>
<div class="ttc" id="astructwcsprm_html_ae83952aec7c1ac76c090bc89bf4eeea7"><div class="ttname"><a href="structwcsprm.html#ae83952aec7c1ac76c090bc89bf4eeea7">wcsprm::spc</a></div><div class="ttdeci">struct spcprm spc</div><div class="ttdef"><b>Definition</b> wcs.h:2189</div></div>
<div class="ttc" id="astructwcsprm_html_ae8681605fee24a802560a5bb31f768d0"><div class="ttname"><a href="structwcsprm.html#ae8681605fee24a802560a5bb31f768d0">wcsprm::timedel</a></div><div class="ttdeci">double timedel</div><div class="ttdef"><b>Definition</b> wcs.h:2153</div></div>
<div class="ttc" id="astructwcsprm_html_af0617abe8547c5861d30001da2a9121b"><div class="ttname"><a href="structwcsprm.html#af0617abe8547c5861d30001da2a9121b">wcsprm::dummy</a></div><div class="ttdeci">int dummy</div><div class="ttdef"><b>Definition</b> wcs.h:2184</div></div>
<div class="ttc" id="astructwcsprm_html_af124a4259475ea355ced38e73a05363a"><div class="ttname"><a href="structwcsprm.html#af124a4259475ea355ced38e73a05363a">wcsprm::crota</a></div><div class="ttdeci">double * crota</div><div class="ttdef"><b>Definition</b> wcs.h:2118</div></div>
<div class="ttc" id="astructwcsprm_html_af1cb3e68560d1ac42c620cfe3900af95"><div class="ttname"><a href="structwcsprm.html#af1cb3e68560d1ac42c620cfe3900af95">wcsprm::m_cunit</a></div><div class="ttdeci">char(* m_cunit)[72]</div><div class="ttdef"><b>Definition</b> wcs.h:2203</div></div>
<div class="ttc" id="astructwcsprm_html_af300da5a94594a9769ab312bb56dde83"><div class="ttname"><a href="structwcsprm.html#af300da5a94594a9769ab312bb56dde83">wcsprm::velosys</a></div><div class="ttdeci">double velosys</div><div class="ttdef"><b>Definition</b> wcs.h:2161</div></div>
<div class="ttc" id="astructwcsprm_html_af54ce939604be183231f0ee006e2f8ed"><div class="ttname"><a href="structwcsprm.html#af54ce939604be183231f0ee006e2f8ed">wcsprm::err</a></div><div class="ttdeci">struct wcserr * err</div><div class="ttdef"><b>Definition</b> wcs.h:2197</div></div>
<div class="ttc" id="astructwcsprm_html_af8f679749574250cb9ba09e1f05fab5d"><div class="ttname"><a href="structwcsprm.html#af8f679749574250cb9ba09e1f05fab5d">wcsprm::lonpole</a></div><div class="ttdeci">double lonpole</div><div class="ttdef"><b>Definition</b> wcs.h:2101</div></div>
<div class="ttc" id="astructwcsprm_html_afd2f31d782b3becce4ca2f9b495ec0b1"><div class="ttname"><a href="structwcsprm.html#afd2f31d782b3becce4ca2f9b495ec0b1">wcsprm::cd</a></div><div class="ttdeci">double * cd</div><div class="ttdef"><b>Definition</b> wcs.h:2117</div></div>
<div class="ttc" id="astructwtbarr_html"><div class="ttname"><a href="structwtbarr.html">wtbarr</a></div><div class="ttdoc">Extraction of coordinate lookup tables from BINTABLE.</div><div class="ttdef"><b>Definition</b> getwcstab.h:167</div></div>
<div class="ttc" id="astructwtbarr_html_a8743b84c99b4b5e7ab7bf0653507a180"><div class="ttname"><a href="structwtbarr.html#a8743b84c99b4b5e7ab7bf0653507a180">wtbarr::i</a></div><div class="ttdeci">int i</div><div class="ttdef"><b>Definition</b> getwcstab.h:168</div></div>
<div class="ttc" id="awcs_8h_html_a158615aa1622d8feedd228795ff9a25f"><div class="ttname"><a href="wcs_8h.html#a158615aa1622d8feedd228795ff9a25f">wcs_errmsg_enum</a></div><div class="ttdeci">wcs_errmsg_enum</div><div class="ttdef"><b>Definition</b> wcs.h:2019</div></div>
<div class="ttc" id="awcs_8h_html_a158615aa1622d8feedd228795ff9a25fa03824b7b5c22e5f0cc91363eb695a804"><div class="ttname"><a href="wcs_8h.html#a158615aa1622d8feedd228795ff9a25fa03824b7b5c22e5f0cc91363eb695a804">WCSERR_BAD_WORLD</a></div><div class="ttdeci">@ WCSERR_BAD_WORLD</div><div class="ttdef"><b>Definition</b> wcs.h:2033</div></div>
<div class="ttc" id="awcs_8h_html_a158615aa1622d8feedd228795ff9a25fa08306533cf0c7555dad662e82e8a4a69"><div class="ttname"><a href="wcs_8h.html#a158615aa1622d8feedd228795ff9a25fa08306533cf0c7555dad662e82e8a4a69">WCSERR_BAD_PIX</a></div><div class="ttdeci">@ WCSERR_BAD_PIX</div><div class="ttdef"><b>Definition</b> wcs.h:2031</div></div>
<div class="ttc" id="awcs_8h_html_a158615aa1622d8feedd228795ff9a25fa2904278d916c820236347783312a7ce0"><div class="ttname"><a href="wcs_8h.html#a158615aa1622d8feedd228795ff9a25fa2904278d916c820236347783312a7ce0">WCSERR_SINGULAR_MTX</a></div><div class="ttdeci">@ WCSERR_SINGULAR_MTX</div><div class="ttdef"><b>Definition</b> wcs.h:2023</div></div>
<div class="ttc" id="awcs_8h_html_a158615aa1622d8feedd228795ff9a25fa37c8aa0aedc12c63df08f39cb7177ff7"><div class="ttname"><a href="wcs_8h.html#a158615aa1622d8feedd228795ff9a25fa37c8aa0aedc12c63df08f39cb7177ff7">WCSERR_NON_SEPARABLE</a></div><div class="ttdeci">@ WCSERR_NON_SEPARABLE</div><div class="ttdef"><b>Definition</b> wcs.h:2039</div></div>
<div class="ttc" id="awcs_8h_html_a158615aa1622d8feedd228795ff9a25fa598db0fcc4961aa3c5e0a296bec2b313"><div class="ttname"><a href="wcs_8h.html#a158615aa1622d8feedd228795ff9a25fa598db0fcc4961aa3c5e0a296bec2b313">WCSERR_BAD_CTYPE</a></div><div class="ttdeci">@ WCSERR_BAD_CTYPE</div><div class="ttdef"><b>Definition</b> wcs.h:2024</div></div>
<div class="ttc" id="awcs_8h_html_a158615aa1622d8feedd228795ff9a25fa5c58d5530bc7577a70185376c15180af"><div class="ttname"><a href="wcs_8h.html#a158615aa1622d8feedd228795ff9a25fa5c58d5530bc7577a70185376c15180af">WCSERR_MEMORY</a></div><div class="ttdeci">@ WCSERR_MEMORY</div><div class="ttdef"><b>Definition</b> wcs.h:2022</div></div>
<div class="ttc" id="awcs_8h_html_a158615aa1622d8feedd228795ff9a25fa5d662102c172495df1f9bb03cedd701d"><div class="ttname"><a href="wcs_8h.html#a158615aa1622d8feedd228795ff9a25fa5d662102c172495df1f9bb03cedd701d">WCSERR_BAD_WORLD_COORD</a></div><div class="ttdeci">@ WCSERR_BAD_WORLD_COORD</div><div class="ttdef"><b>Definition</b> wcs.h:2035</div></div>
<div class="ttc" id="awcs_8h_html_a158615aa1622d8feedd228795ff9a25fa71cb7eaa633d9e0f560555a016f1f007"><div class="ttname"><a href="wcs_8h.html#a158615aa1622d8feedd228795ff9a25fa71cb7eaa633d9e0f560555a016f1f007">WCSERR_BAD_COORD_TRANS</a></div><div class="ttdeci">@ WCSERR_BAD_COORD_TRANS</div><div class="ttdef"><b>Definition</b> wcs.h:2027</div></div>
<div class="ttc" id="awcs_8h_html_a158615aa1622d8feedd228795ff9a25fa832122bb304560f92df91e391d55948a"><div class="ttname"><a href="wcs_8h.html#a158615aa1622d8feedd228795ff9a25fa832122bb304560f92df91e391d55948a">WCSERR_NO_SOLUTION</a></div><div class="ttdeci">@ WCSERR_NO_SOLUTION</div><div class="ttdef"><b>Definition</b> wcs.h:2036</div></div>
<div class="ttc" id="awcs_8h_html_a158615aa1622d8feedd228795ff9a25fa88e600163f719a759d3569bf1548109e"><div class="ttname"><a href="wcs_8h.html#a158615aa1622d8feedd228795ff9a25fa88e600163f719a759d3569bf1548109e">WCSERR_BAD_SUBIMAGE</a></div><div class="ttdeci">@ WCSERR_BAD_SUBIMAGE</div><div class="ttdef"><b>Definition</b> wcs.h:2038</div></div>
<div class="ttc" id="awcs_8h_html_a158615aa1622d8feedd228795ff9a25fa8b87c21d4a2cab41d4eea0a95378fca8"><div class="ttname"><a href="wcs_8h.html#a158615aa1622d8feedd228795ff9a25fa8b87c21d4a2cab41d4eea0a95378fca8">WCSERR_SUCCESS</a></div><div class="ttdeci">@ WCSERR_SUCCESS</div><div class="ttdef"><b>Definition</b> wcs.h:2020</div></div>
<div class="ttc" id="awcs_8h_html_a158615aa1622d8feedd228795ff9a25fab4762a0c9a51284be7259a14ab63496b"><div class="ttname"><a href="wcs_8h.html#a158615aa1622d8feedd228795ff9a25fab4762a0c9a51284be7259a14ab63496b">WCSERR_UNSET</a></div><div class="ttdeci">@ WCSERR_UNSET</div><div class="ttdef"><b>Definition</b> wcs.h:2040</div></div>
<div class="ttc" id="awcs_8h_html_a158615aa1622d8feedd228795ff9a25fac51c733d8a719dd698f9e96e9a4fa83f"><div class="ttname"><a href="wcs_8h.html#a158615aa1622d8feedd228795ff9a25fac51c733d8a719dd698f9e96e9a4fa83f">WCSERR_NULL_POINTER</a></div><div class="ttdeci">@ WCSERR_NULL_POINTER</div><div class="ttdef"><b>Definition</b> wcs.h:2021</div></div>
<div class="ttc" id="awcs_8h_html_a158615aa1622d8feedd228795ff9a25fadfa2a8cf8021827378091315b8e0a020"><div class="ttname"><a href="wcs_8h.html#a158615aa1622d8feedd228795ff9a25fadfa2a8cf8021827378091315b8e0a020">WCSERR_ILL_COORD_TRANS</a></div><div class="ttdeci">@ WCSERR_ILL_COORD_TRANS</div><div class="ttdef"><b>Definition</b> wcs.h:2029</div></div>
<div class="ttc" id="awcs_8h_html_a158615aa1622d8feedd228795ff9a25fafe9ed842ea8f525c7b8fed2f60015dd9"><div class="ttname"><a href="wcs_8h.html#a158615aa1622d8feedd228795ff9a25fafe9ed842ea8f525c7b8fed2f60015dd9">WCSERR_BAD_PARAM</a></div><div class="ttdeci">@ WCSERR_BAD_PARAM</div><div class="ttdef"><b>Definition</b> wcs.h:2026</div></div>
<div class="ttc" id="awcs_8h_html_a1c1971f6d8e8667a1f5acb4bebd65c6f"><div class="ttname"><a href="wcs_8h.html#a1c1971f6d8e8667a1f5acb4bebd65c6f">wcsmix</a></div><div class="ttdeci">int wcsmix(struct wcsprm *wcs, int mixpix, int mixcel, const double vspan[2], double vstep, int viter, double world[], double phi[], double theta[], double imgcrd[], double pixcrd[])</div><div class="ttdoc">Hybrid coordinate transformation.</div></div>
<div class="ttc" id="awcs_8h_html_a27d3dd209db3e76cf4c50f48c01ba986"><div class="ttname"><a href="wcs_8h.html#a27d3dd209db3e76cf4c50f48c01ba986">wcsp2s</a></div><div class="ttdeci">int wcsp2s(struct wcsprm *wcs, int ncoord, int nelem, const double pixcrd[], double imgcrd[], double phi[], double theta[], double world[], int stat[])</div><div class="ttdoc">Pixel-to-world transformation.</div></div>
<div class="ttc" id="awcs_8h_html_a2afc8255fde0965dddaa374463666d45"><div class="ttname"><a href="wcs_8h.html#a2afc8255fde0965dddaa374463666d45">wcsini</a></div><div class="ttdeci">int wcsini(int alloc, int naxis, struct wcsprm *wcs)</div><div class="ttdoc">Default constructor for the wcsprm struct.</div></div>
<div class="ttc" id="awcs_8h_html_a3a0875a1f9479f6929ad129b0200d09b"><div class="ttname"><a href="wcs_8h.html#a3a0875a1f9479f6929ad129b0200d09b">wcssize</a></div><div class="ttdeci">int wcssize(const struct wcsprm *wcs, int sizes[2])</div><div class="ttdoc">Compute the size of a wcsprm struct.</div></div>
<div class="ttc" id="awcs_8h_html_a42b2578d76ace7ca6114d82b7ae46a89"><div class="ttname"><a href="wcs_8h.html#a42b2578d76ace7ca6114d82b7ae46a89">wcsnpv</a></div><div class="ttdeci">int wcsnpv(int n)</div><div class="ttdoc">Memory allocation for PVi_ma.</div></div>
<div class="ttc" id="awcs_8h_html_a4ab38bc642c4656f62c43acf84a849f1"><div class="ttname"><a href="wcs_8h.html#a4ab38bc642c4656f62c43acf84a849f1">wcsfree</a></div><div class="ttdeci">int wcsfree(struct wcsprm *wcs)</div><div class="ttdoc">Destructor for the wcsprm struct.</div></div>
<div class="ttc" id="awcs_8h_html_a4c84e6786212077fbecc0fc883656dcb"><div class="ttname"><a href="wcs_8h.html#a4c84e6786212077fbecc0fc883656dcb">auxsize</a></div><div class="ttdeci">int auxsize(const struct auxprm *aux, int sizes[2])</div><div class="ttdoc">Compute the size of a auxprm struct.</div></div>
<div class="ttc" id="awcs_8h_html_a57975833fe0588eb7c7b6d79f13a7693"><div class="ttname"><a href="wcs_8h.html#a57975833fe0588eb7c7b6d79f13a7693">wcssptr</a></div><div class="ttdeci">int wcssptr(struct wcsprm *wcs, int *i, char ctype[9])</div><div class="ttdoc">Spectral axis translation.</div></div>
<div class="ttc" id="awcs_8h_html_a60673d05a3513659ac848a9cb3d0cb07"><div class="ttname"><a href="wcs_8h.html#a60673d05a3513659ac848a9cb3d0cb07">wcss2p</a></div><div class="ttdeci">int wcss2p(struct wcsprm *wcs, int ncoord, int nelem, const double world[], double phi[], double theta[], double imgcrd[], double pixcrd[], int stat[])</div><div class="ttdoc">World-to-pixel transformation.</div></div>
<div class="ttc" id="awcs_8h_html_a78d5d27f74218723acde6d3aa232c4a5"><div class="ttname"><a href="wcs_8h.html#a78d5d27f74218723acde6d3aa232c4a5">wcscompare</a></div><div class="ttdeci">int wcscompare(int cmp, double tol, const struct wcsprm *wcs1, const struct wcsprm *wcs2, int *equal)</div><div class="ttdoc">Compare two wcsprm structs for equality.</div></div>
<div class="ttc" id="awcs_8h_html_a7b788938019a60c322d5cb82df7068d4"><div class="ttname"><a href="wcs_8h.html#a7b788938019a60c322d5cb82df7068d4">wcsccs</a></div><div class="ttdeci">int wcsccs(struct wcsprm *wcs, double lng2p1, double lat2p1, double lng1p2, const char *clng, const char *clat, const char *radesys, double equinox, const char *alt)</div><div class="ttdoc">Change celestial coordinate system.</div></div>
<div class="ttc" id="awcs_8h_html_a819013c42cbcb3c00603539c1d2aae2b"><div class="ttname"><a href="wcs_8h.html#a819013c42cbcb3c00603539c1d2aae2b">wcs_errmsg</a></div><div class="ttdeci">const char * wcs_errmsg[]</div></div>
<div class="ttc" id="awcs_8h_html_a864c99fef9f3eee29085ce42d0ee0d64"><div class="ttname"><a href="wcs_8h.html#a864c99fef9f3eee29085ce42d0ee0d64">wcssub</a></div><div class="ttdeci">int wcssub(int alloc, const struct wcsprm *wcssrc, int *nsub, int axes[], struct wcsprm *wcsdst)</div><div class="ttdoc">Subimage extraction routine for the wcsprm struct.</div></div>
<div class="ttc" id="awcs_8h_html_a8fe5dcd9927240dc0348b850ee662367"><div class="ttname"><a href="wcs_8h.html#a8fe5dcd9927240dc0348b850ee662367">wcsperr</a></div><div class="ttdeci">int wcsperr(const struct wcsprm *wcs, const char *prefix)</div><div class="ttdoc">Print error messages from a wcsprm struct.</div></div>
<div class="ttc" id="awcs_8h_html_aa5ab4a67a8bcdad28a07b02d0c3b3c6a"><div class="ttname"><a href="wcs_8h.html#aa5ab4a67a8bcdad28a07b02d0c3b3c6a">wcsauxi</a></div><div class="ttdeci">int wcsauxi(int alloc, struct wcsprm *wcs)</div><div class="ttdoc">Default constructor for the auxprm struct.</div></div>
<div class="ttc" id="awcs_8h_html_aab11243b60b10065fc85347bb3efa912"><div class="ttname"><a href="wcs_8h.html#aab11243b60b10065fc85347bb3efa912">wcsinit</a></div><div class="ttdeci">int wcsinit(int alloc, int naxis, struct wcsprm *wcs, int npvmax, int npsmax, int ndpmax)</div><div class="ttdoc">Default constructor for the wcsprm struct.</div></div>
<div class="ttc" id="awcs_8h_html_aabfe985b365a14d529d43fc6a4c6fe9b"><div class="ttname"><a href="wcs_8h.html#aabfe985b365a14d529d43fc6a4c6fe9b">wcstrim</a></div><div class="ttdeci">int wcstrim(struct wcsprm *wcs)</div><div class="ttdoc">Free unused arrays in the wcsprm struct.</div></div>
<div class="ttc" id="awcs_8h_html_ab9aeb8cf1afb1bfb22e989580d90fca8"><div class="ttname"><a href="wcs_8h.html#ab9aeb8cf1afb1bfb22e989580d90fca8">wcsprt</a></div><div class="ttdeci">int wcsprt(const struct wcsprm *wcs)</div><div class="ttdoc">Print routine for the wcsprm struct.</div></div>
<div class="ttc" id="awcs_8h_html_ad875ce4317d85c893f64afe10ab1630e"><div class="ttname"><a href="wcs_8h.html#ad875ce4317d85c893f64afe10ab1630e">wcslib_version</a></div><div class="ttdeci">const char * wcslib_version(int vers[3])</div></div>
<div class="ttc" id="awcs_8h_html_ae5cc3f5d249755583403cdf54d2ebb91"><div class="ttname"><a href="wcs_8h.html#ae5cc3f5d249755583403cdf54d2ebb91">wcsset</a></div><div class="ttdeci">int wcsset(struct wcsprm *wcs)</div><div class="ttdoc">Setup routine for the wcsprm struct.</div></div>
<div class="ttc" id="awcs_8h_html_ae790c9ce6c9b7a4845cf1c3c97b1e97a"><div class="ttname"><a href="wcs_8h.html#ae790c9ce6c9b7a4845cf1c3c97b1e97a">wcsnps</a></div><div class="ttdeci">int wcsnps(int n)</div><div class="ttdoc">Memory allocation for PSi_ma.</div></div>
<div class="ttc" id="awcs_8h_html_af226d8537fbc578d63f1ba5601078398"><div class="ttname"><a href="wcs_8h.html#af226d8537fbc578d63f1ba5601078398">wcsbchk</a></div><div class="ttdeci">int wcsbchk(struct wcsprm *wcs, int bounds)</div><div class="ttdoc">Enable/disable bounds checking.</div></div>
</div><!-- fragment --></div><!-- contents -->
<!-- start footer part -->
<hr class="footer"/><address class="footer"><small>
Generated on Wed Nov 29 2023 19:09:57 for WCSLIB by&#160;<a href="https://www.doxygen.org/index.html"><img class="footer" src="doxygen.svg" width="104" height="31" alt="doxygen"/></a> 1.9.8
</small></address>
</body>
</html>