[automated site update]

apidoc/html/index.html

@@ -259,7 +259,7 @@ <h3><a class="anchor" id="autotoc_md45"></a>
 <div class="ttc" id="anovas_8h_html_a208120c5fa3e12853eb37cb99d3e27be"><div class="ttname"><a href="novas_8h.html#a208120c5fa3e12853eb37cb99d3e27be">novas_origin</a></div><div class="ttdeci">novas_origin</div><div class="ttdef"><b>Definition</b> novas.h:531</div></div>
 </div><!-- fragment --><p>and then then apply it in your application as:</p>
 <div class="fragment"><div class="line"><a class="code hl_function" href="novas_8c.html#a6097083c438a8d1872c2e00a66360030">set_ephem_provider</a>(my_ephem_provider);</div>
-<div class="ttc" id="anovas_8c_html_a6097083c438a8d1872c2e00a66360030"><div class="ttname"><a href="novas_8c.html#a6097083c438a8d1872c2e00a66360030">set_ephem_provider</a></div><div class="ttdeci">int set_ephem_provider(novas_ephem_provider func)</div><div class="ttdef"><b>Definition</b> novas.c:5700</div></div>
+<div class="ttc" id="anovas_8c_html_a6097083c438a8d1872c2e00a66360030"><div class="ttname"><a href="novas_8c.html#a6097083c438a8d1872c2e00a66360030">set_ephem_provider</a></div><div class="ttdeci">int set_ephem_provider(novas_ephem_provider func)</div><div class="ttdef"><b>Definition</b> novas.c:5703</div></div>
 </div><!-- fragment --><p>While it requires some minimal changes to the old code, the advantage of this preferred approach is (a) that you do not need to re-build the library with the <code>DEFAULT_SOLSYS</code> and <code>DEFAULT_READEPH</code> options disabled, and (b) you can switch between different planet and ephemeris calculator functions at will, during runtime.</p>
 <hr  />
 <p><a class="anchor" id="examples"></a> </p>
@@ -295,6 +295,7 @@ <h3><a class="anchor" id="autotoc_md48"></a>
 </table>
 <p>See the various enums and constants defined in <code><a class="el" href="novas_8h.html">novas.h</a></code>, as well as the descriptions on the various NOVAS routines on how they are appropriate for the old and new methodologies respectively. Figure 1 also shows the relation of the various old and new coordinate systems and the (Super)NOVAS functions for converting among them.</p>
 <p>In NOVAS, the barycentric BCRS and the geocentric GCRS systems are effectively synonymous to ICRS, since the origin for positions and for velocities, in any reference system, is determined by the <code>observer</code> location, while aberration and gravitational deflection is included for apparent places only (as seen from the observer location).</p>
+<p>Older catalogs, such as B1950 (FK4) or B1900 are just special cases of MOD (mean-of-date) coordinates for the B1950 and B1900 epochs, respectively.</p>
 <p>TIRS (Intermediate Terrestrial Reference System) is not explicitly referenced in SuperNOVAS. But it can be thought of as a special case of ITRS (International Terrestrial Reference System) with DUT1 (= UT1-UTC), the polar offsets (<em>dx</em>, <em>dy</em>) all set to zero.</p>
 <p>WGS84 has been superseded by ITRS for higher accuracy definitions of Earth-based locations. WGS84 matches ITRS to the 10m level globally, but it does not account for continental drifts and crustal motion. In (Super)NOVAS all Earth-fixed coordinates are effectively assumed as ITRS, whether explicitly or implicitly. There is nothing WGS84-specific in the implementation.</p>
 <table class="markdownTable">
@@ -316,15 +317,15 @@ <h4><a class="anchor" id="autotoc_md50"></a>
 <div class="line"><span class="comment">// 16h26m20.1918s, -26d19m23.138s (B1950), proper motion -12.11, -23.30 mas/year, </span></div>
 <div class="line"><span class="comment">// parallax 5.89 mas, radial velocity -3.4 km/s.</span></div>
 <div class="line"><a class="code hl_function" href="novas_8c.html#a9950f7973fc3b5d40b0d0a9f4eceddac">make_cat_entry</a>(<span class="stringliteral">&quot;Antares&quot;</span>, <span class="stringliteral">&quot;FK4&quot;</span>, 1, 16.43894213, -26.323094, -12.11, -23.30, 5.89, -3.4, &amp;star);</div>
-<div class="ttc" id="anovas_8c_html_a9950f7973fc3b5d40b0d0a9f4eceddac"><div class="ttname"><a href="novas_8c.html#a9950f7973fc3b5d40b0d0a9f4eceddac">make_cat_entry</a></div><div class="ttdeci">short make_cat_entry(const char *star_name, const char *catalog, long cat_num, double ra, double dec, double pm_ra, double pm_dec, double parallax, double rad_vel, cat_entry *star)</div><div class="ttdef"><b>Definition</b> novas.c:6668</div></div>
+<div class="ttc" id="anovas_8c_html_a9950f7973fc3b5d40b0d0a9f4eceddac"><div class="ttname"><a href="novas_8c.html#a9950f7973fc3b5d40b0d0a9f4eceddac">make_cat_entry</a></div><div class="ttdeci">short make_cat_entry(const char *star_name, const char *catalog, long cat_num, double ra, double dec, double pm_ra, double pm_dec, double parallax, double rad_vel, cat_entry *star)</div><div class="ttdef"><b>Definition</b> novas.c:6671</div></div>
 <div class="ttc" id="astructcat__entry_html"><div class="ttname"><a href="structcat__entry.html">cat_entry</a></div><div class="ttdef"><b>Definition</b> novas.h:691</div></div>
 </div><!-- fragment --><p>We must convert these coordinates to the now standard ICRS system for calculations in SuperNOVAS, first by calculating equivalent J2000 coordinates, by applying the proper motion and the appropriate precession. Then, we apply a small adjustment to convert from J2000 to ICRS coordinates.</p>
 <div class="fragment"><div class="line"><span class="comment">// First change the catalog coordinates (in place) to the J2000 (FK5) system... </span></div>
 <div class="line"><a class="code hl_function" href="novas_8c.html#abe0c6e6fc60a49efa88c365aef8cdc50">transform_cat</a>(<a class="code hl_enumvalue" href="novas_8h.html#ace5e59ce1564bf6c61946c290bb05367a882f5d97444df44485d360ce298843b1">CHANGE_EPOCH</a>, <a class="code hl_define" href="novas_8h.html#a3785083ae52bbbc1e749dbedd7e5d85e">NOVAS_JD_B1950</a>, &amp;star, <a class="code hl_define" href="novas_8h.html#a31bf4a08940bfa3e97ae6a1abee80422">NOVAS_JD_J2000</a>, <span class="stringliteral">&quot;FK5&quot;</span>, &amp;star);</div>
 <div class="line"> </div>
 <div class="line"><span class="comment">// Then convert J2000 coordinates to ICRS (also in place). Here the dates don&#39;t matter...</span></div>
 <div class="line"><a class="code hl_function" href="novas_8c.html#abe0c6e6fc60a49efa88c365aef8cdc50">transform_cat</a>(<a class="code hl_enumvalue" href="novas_8h.html#ace5e59ce1564bf6c61946c290bb05367a84da44f7510d8c99353b1b1c6bb4faf8">CHANGE_J2000_TO_ICRS</a>, 0.0, &amp;star, 0.0, <span class="stringliteral">&quot;ICRS&quot;</span>, &amp;star);</div>
-<div class="ttc" id="anovas_8c_html_abe0c6e6fc60a49efa88c365aef8cdc50"><div class="ttname"><a href="novas_8c.html#abe0c6e6fc60a49efa88c365aef8cdc50">transform_cat</a></div><div class="ttdeci">short transform_cat(enum novas_transform_type option, double jd_tt_in, const cat_entry *in, double jd_tt_out, const char *out_id, cat_entry *out)</div><div class="ttdef"><b>Definition</b> novas.c:6176</div></div>
+<div class="ttc" id="anovas_8c_html_abe0c6e6fc60a49efa88c365aef8cdc50"><div class="ttname"><a href="novas_8c.html#abe0c6e6fc60a49efa88c365aef8cdc50">transform_cat</a></div><div class="ttdeci">short transform_cat(enum novas_transform_type option, double jd_tt_in, const cat_entry *in, double jd_tt_out, const char *out_id, cat_entry *out)</div><div class="ttdef"><b>Definition</b> novas.c:6179</div></div>
 <div class="ttc" id="anovas_8h_html_a31bf4a08940bfa3e97ae6a1abee80422"><div class="ttname"><a href="novas_8h.html#a31bf4a08940bfa3e97ae6a1abee80422">NOVAS_JD_J2000</a></div><div class="ttdeci">#define NOVAS_JD_J2000</div><div class="ttdoc">[day] Julian date at J2000</div><div class="ttdef"><b>Definition</b> novas.h:106</div></div>
 <div class="ttc" id="anovas_8h_html_a3785083ae52bbbc1e749dbedd7e5d85e"><div class="ttname"><a href="novas_8h.html#a3785083ae52bbbc1e749dbedd7e5d85e">NOVAS_JD_B1950</a></div><div class="ttdeci">#define NOVAS_JD_B1950</div><div class="ttdoc">[day] Julian date at B1950</div><div class="ttdef"><b>Definition</b> novas.h:112</div></div>
 <div class="ttc" id="anovas_8h_html_ace5e59ce1564bf6c61946c290bb05367a84da44f7510d8c99353b1b1c6bb4faf8"><div class="ttname"><a href="novas_8h.html#ace5e59ce1564bf6c61946c290bb05367a84da44f7510d8c99353b1b1c6bb4faf8">CHANGE_J2000_TO_ICRS</a></div><div class="ttdeci">@ CHANGE_J2000_TO_ICRS</div><div class="ttdef"><b>Definition</b> novas.h:570</div></div>
@@ -349,7 +350,7 @@ <h4><a class="anchor" id="autotoc_md50"></a>
 <div class="line"><span class="comment">// Specify the location we are observing from</span></div>
 <div class="line"><span class="comment">// 50.7374 deg N, 7.0982 deg E, 60m elevation</span></div>
 <div class="line"><a class="code hl_function" href="novas_8c.html#a00d9f6909923cd3e559c8f011ff9b794">make_observer_on_surface</a>(50.7374, 7.0982, 60.0, 0.0, 0.0, &amp;obs);</div>
-<div class="ttc" id="anovas_8c_html_a00d9f6909923cd3e559c8f011ff9b794"><div class="ttname"><a href="novas_8c.html#a00d9f6909923cd3e559c8f011ff9b794">make_observer_on_surface</a></div><div class="ttdeci">int make_observer_on_surface(double latitude, double longitude, double height, double temperature, double pressure, observer *obs)</div><div class="ttdef"><b>Definition</b> novas.c:6926</div></div>
+<div class="ttc" id="anovas_8c_html_a00d9f6909923cd3e559c8f011ff9b794"><div class="ttname"><a href="novas_8c.html#a00d9f6909923cd3e559c8f011ff9b794">make_observer_on_surface</a></div><div class="ttdeci">int make_observer_on_surface(double latitude, double longitude, double height, double temperature, double pressure, observer *obs)</div><div class="ttdef"><b>Definition</b> novas.c:6929</div></div>
 <div class="ttc" id="astructobserver_html"><div class="ttname"><a href="structobserver.html">observer</a></div><div class="ttdef"><b>Definition</b> novas.h:998</div></div>
 </div><!-- fragment --><p>Similarly, you can also specify observers in Earth orbit, in Sun orbit, at the geocenter, or at the Solar-system barycenter.</p>
 <h4><a class="anchor" id="autotoc_md52"></a>
@@ -449,7 +450,7 @@ <h3><a class="anchor" id="autotoc_md56"></a>
 <div class="line"><span class="comment">// Ceres will be handled by the generic ephemeris provider function, which let&#39;s say </span></div>
 <div class="line"><span class="comment">// uses the NAIF ID of 2000001</span></div>
 <div class="line"><a class="code hl_function" href="super_8c.html#aa22303f98df2d63edf6d8452ff3a43b2">make_ephem_object</a>(<span class="stringliteral">&quot;Ceres&quot;</span>, 2000001, &amp;ceres);</div>
-<div class="ttc" id="anovas_8c_html_a618bbba887b9bc9e7df878234c66c215"><div class="ttname"><a href="novas_8c.html#a618bbba887b9bc9e7df878234c66c215">make_planet</a></div><div class="ttdeci">int make_planet(enum novas_planet num, object *planet)</div><div class="ttdef"><b>Definition</b> novas.c:6816</div></div>
+<div class="ttc" id="anovas_8c_html_a618bbba887b9bc9e7df878234c66c215"><div class="ttname"><a href="novas_8c.html#a618bbba887b9bc9e7df878234c66c215">make_planet</a></div><div class="ttdeci">int make_planet(enum novas_planet num, object *planet)</div><div class="ttdef"><b>Definition</b> novas.c:6819</div></div>
 <div class="ttc" id="anovas_8h_html_a219df36b21dc4476656e708d14d08045a479f3eb097c0aeb4ac7dc3ae2e6c376e"><div class="ttname"><a href="novas_8h.html#a219df36b21dc4476656e708d14d08045a479f3eb097c0aeb4ac7dc3ae2e6c376e">NOVAS_MARS</a></div><div class="ttdeci">@ NOVAS_MARS</div><div class="ttdoc">Major planet number for the Mars in NOVAS.</div><div class="ttdef"><b>Definition</b> novas.h:275</div></div>
 <div class="ttc" id="asuper_8c_html_aa22303f98df2d63edf6d8452ff3a43b2"><div class="ttname"><a href="super_8c.html#aa22303f98df2d63edf6d8452ff3a43b2">make_ephem_object</a></div><div class="ttdeci">int make_ephem_object(const char *name, long num, object *body)</div><div class="ttdef"><b>Definition</b> super.c:1034</div></div>
 </div><!-- fragment --><p>As of version 1.2 you can also define solar system sources with orbital elements (such as the most up-to-date ones provided by the <a href="https://minorplanetcenter.net/data">Minor Planet Center</a> for asteroids, comets, etc.):</p>