You are here: Home USNO Astronomical Applications Software Products NOVAS NOVAS Python novas.compat.solsys

novas.compat.solsys

novas.compat.solsys.html — HTML, 10 kB (10814 bytes)

File contents

<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<html><head><title>Python: module novas.compat.solsys</title>
</head><body bgcolor="#f0f0f8">

<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
<tr bgcolor="#7799ee">
<td valign=bottom>&nbsp;<br>
<font color="#ffffff" face="helvetica, arial">&nbsp;<br><big><big><strong>novas.compat.solsys</strong></big></big></font></td
></tr></table>
<p>
<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
<tr bgcolor="#eeaa77">
<td colspan=3 valign=bottom>&nbsp;<br>
<font color="#ffffff" face="helvetica, arial"><big><strong>Functions</strong></big></font></td></tr>
    
<tr><td bgcolor="#eeaa77"><tt>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</tt></td><td>&nbsp;</td>
<td width="100%"><dl><dt><a name="-POINTER"><strong>POINTER</strong></a>(...)</dt></dl>
 <dl><dt><a name="-addressof"><strong>addressof</strong></a>(...)</dt><dd><tt><a href="#-addressof">addressof</a>(C&nbsp;instance)&nbsp;-&gt;&nbsp;integer<br>
Return&nbsp;the&nbsp;address&nbsp;of&nbsp;the&nbsp;C&nbsp;instance&nbsp;internal&nbsp;buffer</tt></dd></dl>
 <dl><dt><a name="-alignment"><strong>alignment</strong></a>(...)</dt><dd><tt><a href="#-alignment">alignment</a>(C&nbsp;type)&nbsp;-&gt;&nbsp;integer<br>
<a href="#-alignment">alignment</a>(C&nbsp;instance)&nbsp;-&gt;&nbsp;integer<br>
Return&nbsp;the&nbsp;alignment&nbsp;requirements&nbsp;of&nbsp;a&nbsp;C&nbsp;instance</tt></dd></dl>
 <dl><dt><a name="-byref"><strong>byref</strong></a>(...)</dt><dd><tt><a href="#-byref">byref</a>(C&nbsp;instance[,&nbsp;offset=0])&nbsp;-&gt;&nbsp;byref-object<br>
Return&nbsp;a&nbsp;pointer&nbsp;lookalike&nbsp;to&nbsp;a&nbsp;C&nbsp;instance,&nbsp;only&nbsp;usable<br>
as&nbsp;function&nbsp;argument</tt></dd></dl>
 <dl><dt><a name="-get_errno"><strong>get_errno</strong></a>(...)</dt></dl>
 <dl><dt><a name="-pointer"><strong>pointer</strong></a>(...)</dt></dl>
 <dl><dt><a name="-resize"><strong>resize</strong></a>(...)</dt><dd><tt>Resize&nbsp;the&nbsp;memory&nbsp;buffer&nbsp;of&nbsp;a&nbsp;ctypes&nbsp;instance</tt></dd></dl>
 <dl><dt><a name="-set_conversion_mode"><strong>set_conversion_mode</strong></a>(...)</dt><dd><tt><a href="#-set_conversion_mode">set_conversion_mode</a>(encoding,&nbsp;errors)&nbsp;-&gt;&nbsp;(previous-encoding,&nbsp;previous-errors)<br>
&nbsp;<br>
Set&nbsp;the&nbsp;encoding&nbsp;and&nbsp;error&nbsp;handling&nbsp;ctypes&nbsp;uses&nbsp;when&nbsp;converting<br>
between&nbsp;unicode&nbsp;and&nbsp;strings.&nbsp;&nbsp;Returns&nbsp;the&nbsp;previous&nbsp;values.</tt></dd></dl>
 <dl><dt><a name="-set_errno"><strong>set_errno</strong></a>(...)</dt></dl>
 <dl><dt><a name="-sizeof"><strong>sizeof</strong></a>(...)</dt><dd><tt><a href="#-sizeof">sizeof</a>(C&nbsp;type)&nbsp;-&gt;&nbsp;integer<br>
<a href="#-sizeof">sizeof</a>(C&nbsp;instance)&nbsp;-&gt;&nbsp;integer<br>
Return&nbsp;the&nbsp;size&nbsp;in&nbsp;bytes&nbsp;of&nbsp;a&nbsp;C&nbsp;instance</tt></dd></dl>
 <dl><dt><a name="-solarsystem"><strong>solarsystem</strong></a>(tjd, body, origin)</dt><dd><tt>&nbsp;&nbsp;&nbsp;&nbsp;Provides&nbsp;an&nbsp;interface&nbsp;between&nbsp;the&nbsp;JPL&nbsp;direct-access&nbsp;solar&nbsp;system<br>
ephemerides&nbsp;and&nbsp;NOVAS-C.<br>
&nbsp;<br>
Parameters<br>
----------<br>
tjd&nbsp;:&nbsp;float<br>
&nbsp;&nbsp;&nbsp;&nbsp;Julian&nbsp;date&nbsp;of&nbsp;the&nbsp;desired&nbsp;time,&nbsp;on&nbsp;the&nbsp;TDB&nbsp;time&nbsp;scale.<br>
body&nbsp;:&nbsp;integer<br>
&nbsp;&nbsp;&nbsp;&nbsp;Body&nbsp;identification&nbsp;number&nbsp;for&nbsp;the&nbsp;solar&nbsp;system&nbsp;object&nbsp;of<br>
&nbsp;&nbsp;&nbsp;&nbsp;interest;&nbsp;Mercury&nbsp;=&nbsp;1,&nbsp;...,&nbsp;Pluto&nbsp;=&nbsp;9,&nbsp;Sun&nbsp;=&nbsp;10,&nbsp;Moon&nbsp;=&nbsp;11.<br>
origin&nbsp;:&nbsp;integer<br>
&nbsp;&nbsp;&nbsp;&nbsp;Origin&nbsp;code<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;=&nbsp;0&nbsp;...&nbsp;solar&nbsp;system&nbsp;barycenter<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;=&nbsp;1&nbsp;...&nbsp;center&nbsp;of&nbsp;mass&nbsp;of&nbsp;the&nbsp;Sun<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;=&nbsp;2&nbsp;...&nbsp;center&nbsp;of&nbsp;Earth<br>
&nbsp;<br>
Returns<br>
-------<br>
position&nbsp;:&nbsp;tuple&nbsp;of&nbsp;floats,&nbsp;of&nbsp;length&nbsp;3<br>
&nbsp;&nbsp;&nbsp;&nbsp;Position&nbsp;vector&nbsp;of&nbsp;'body'&nbsp;at&nbsp;'tjd';&nbsp;equatorial&nbsp;rectangular<br>
&nbsp;&nbsp;&nbsp;&nbsp;coordinates&nbsp;in&nbsp;AU&nbsp;referred&nbsp;to&nbsp;the&nbsp;ICRS.<br>
velocity&nbsp;:&nbsp;tuple&nbsp;of&nbsp;floats,&nbsp;of&nbsp;length&nbsp;3<br>
&nbsp;&nbsp;&nbsp;&nbsp;Velocity&nbsp;vector&nbsp;of&nbsp;'body'&nbsp;at&nbsp;'tjd';&nbsp;equatorial&nbsp;rectangular<br>
&nbsp;&nbsp;&nbsp;&nbsp;system&nbsp;referred&nbsp;to&nbsp;the&nbsp;ICRS,&nbsp;in&nbsp;AU/day.<br>
&nbsp;<br>
Notes<br>
-----<br>
..&nbsp;[N1]&nbsp;This&nbsp;function&nbsp;and&nbsp;function&nbsp;'planet_ephemeris'&nbsp;were&nbsp;designed<br>
&nbsp;&nbsp;&nbsp;&nbsp;to&nbsp;work&nbsp;with&nbsp;the&nbsp;1997&nbsp;version&nbsp;of&nbsp;the&nbsp;JPL&nbsp;ephemerides,&nbsp;as&nbsp;noted<br>
&nbsp;&nbsp;&nbsp;&nbsp;in&nbsp;the&nbsp;references.<br>
..&nbsp;[N2]&nbsp;The&nbsp;user&nbsp;must&nbsp;have&nbsp;a&nbsp;JPL&nbsp;binary&nbsp;ephemeris&nbsp;file&nbsp;(see&nbsp;package<br>
&nbsp;&nbsp;&nbsp;&nbsp;README)&nbsp;and&nbsp;open&nbsp;the&nbsp;file&nbsp;using&nbsp;function&nbsp;'ephem_open'&nbsp;prior&nbsp;to<br>
&nbsp;&nbsp;&nbsp;&nbsp;calling&nbsp;this&nbsp;function.<br>
..&nbsp;[N3]&nbsp;This&nbsp;function&nbsp;places&nbsp;the&nbsp;entire&nbsp;Julian&nbsp;date&nbsp;in&nbsp;the&nbsp;first<br>
&nbsp;&nbsp;&nbsp;&nbsp;element&nbsp;of&nbsp;the&nbsp;input&nbsp;time&nbsp;to&nbsp;'planet_ephemeris'.&nbsp;This&nbsp;is<br>
&nbsp;&nbsp;&nbsp;&nbsp;adequate&nbsp;for&nbsp;all&nbsp;but&nbsp;the&nbsp;highest&nbsp;precision&nbsp;applications.&nbsp;For<br>
&nbsp;&nbsp;&nbsp;&nbsp;highest&nbsp;precision,&nbsp;use&nbsp;function&nbsp;'solarsystem_hp'.<br>
&nbsp;<br>
References<br>
----------<br>
..&nbsp;[R1]&nbsp;JPL.&nbsp;2007,&nbsp;"JPL&nbsp;Planetary&nbsp;and&nbsp;Lunar&nbsp;Ephemerides:&nbsp;Export<br>
&nbsp;&nbsp;&nbsp;&nbsp;Information,"&nbsp;(Pasadena,&nbsp;CA:&nbsp;JPL)<br>
&nbsp;&nbsp;&nbsp;&nbsp;<a href="http://ssd.jpl.nasa.gov/?planet_eph_export">http://ssd.jpl.nasa.gov/?planet_eph_export</a>.<br>
..&nbsp;[R2]&nbsp;Kaplan,&nbsp;G.&nbsp;H.&nbsp;"NOVAS:&nbsp;Naval&nbsp;Observatory&nbsp;Vector&nbsp;Astrometry<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Subroutines";&nbsp;USNO&nbsp;internal&nbsp;document&nbsp;dated&nbsp;20&nbsp;Oct&nbsp;1988;<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;revised&nbsp;15&nbsp;Mar&nbsp;1990.</tt></dd></dl>
 <dl><dt><a name="-solarsystem_hp"><strong>solarsystem_hp</strong></a>(tjd, body, origin)</dt><dd><tt>&nbsp;&nbsp;&nbsp;&nbsp;Provides&nbsp;an&nbsp;interface&nbsp;between&nbsp;the&nbsp;JPL&nbsp;direct-access&nbsp;solar&nbsp;system<br>
&nbsp;&nbsp;ephemerides&nbsp;and&nbsp;NOVAS-C&nbsp;for&nbsp;highest&nbsp;precision&nbsp;applications.<br>
&nbsp;<br>
Parameters<br>
----------<br>
tjd&nbsp;:&nbsp;tuple&nbsp;of&nbsp;floats,&nbsp;of&nbsp;length&nbsp;2<br>
&nbsp;&nbsp;&nbsp;&nbsp;Two-element&nbsp;tuple&nbsp;containing&nbsp;the&nbsp;Julian&nbsp;date,&nbsp;which&nbsp;may&nbsp;be&nbsp;split<br>
&nbsp;&nbsp;&nbsp;&nbsp;any&nbsp;way&nbsp;(although&nbsp;the&nbsp;first&nbsp;element&nbsp;is&nbsp;usually&nbsp;the&nbsp;"integer"<br>
&nbsp;&nbsp;&nbsp;&nbsp;part,&nbsp;and&nbsp;the&nbsp;second&nbsp;element&nbsp;is&nbsp;the&nbsp;"fractional"&nbsp;part).&nbsp;Julian<br>
&nbsp;&nbsp;&nbsp;&nbsp;date&nbsp;is&nbsp;on&nbsp;the&nbsp;TDB&nbsp;or&nbsp;"T_eph"&nbsp;time&nbsp;scale.<br>
body&nbsp;:&nbsp;integer<br>
&nbsp;&nbsp;&nbsp;&nbsp;Body&nbsp;identification&nbsp;number&nbsp;for&nbsp;the&nbsp;solar&nbsp;system&nbsp;object&nbsp;of<br>
&nbsp;&nbsp;&nbsp;&nbsp;interest;&nbsp;Mercury&nbsp;=&nbsp;1,&nbsp;...,&nbsp;Pluto&nbsp;=&nbsp;9,&nbsp;Sun&nbsp;=&nbsp;10,&nbsp;Moon&nbsp;=&nbsp;11.<br>
origin&nbsp;:&nbsp;integer<br>
&nbsp;&nbsp;&nbsp;&nbsp;Origin&nbsp;code<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;=&nbsp;0&nbsp;...&nbsp;solar&nbsp;system&nbsp;barycenter<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;=&nbsp;1&nbsp;...&nbsp;center&nbsp;of&nbsp;mass&nbsp;of&nbsp;the&nbsp;Sun<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;=&nbsp;2&nbsp;...&nbsp;center&nbsp;of&nbsp;Earth<br>
&nbsp;<br>
Returns<br>
-------<br>
position&nbsp;:&nbsp;tuple&nbsp;of&nbsp;floats,&nbsp;of&nbsp;length&nbsp;3<br>
&nbsp;&nbsp;&nbsp;&nbsp;Position&nbsp;vector&nbsp;of&nbsp;'body'&nbsp;at&nbsp;'tjd';&nbsp;equatorial&nbsp;rectangular<br>
&nbsp;&nbsp;&nbsp;&nbsp;coordinates&nbsp;in&nbsp;AU&nbsp;referred&nbsp;to&nbsp;the&nbsp;ICRS.<br>
velocity&nbsp;:&nbsp;tuple&nbsp;of&nbsp;floats,&nbsp;of&nbsp;length&nbsp;3<br>
&nbsp;&nbsp;&nbsp;&nbsp;Velocity&nbsp;vector&nbsp;of&nbsp;'body'&nbsp;at&nbsp;'tjd';&nbsp;equatorial&nbsp;rectangular<br>
&nbsp;&nbsp;&nbsp;&nbsp;system&nbsp;referred&nbsp;to&nbsp;the&nbsp;ICRS,&nbsp;in&nbsp;AU/day.<br>
&nbsp;<br>
Notes<br>
-----<br>
..&nbsp;[N1]&nbsp;This&nbsp;function&nbsp;and&nbsp;function&nbsp;'planet_ephemeris'&nbsp;were&nbsp;designed<br>
&nbsp;&nbsp;&nbsp;&nbsp;to&nbsp;work&nbsp;with&nbsp;the&nbsp;1997&nbsp;version&nbsp;of&nbsp;the&nbsp;JPL&nbsp;ephemerides,&nbsp;as&nbsp;noted<br>
&nbsp;&nbsp;&nbsp;&nbsp;in&nbsp;the&nbsp;references.<br>
..&nbsp;[N2]&nbsp;The&nbsp;user&nbsp;must&nbsp;have&nbsp;a&nbsp;JPL&nbsp;binary&nbsp;ephemeris&nbsp;file&nbsp;(see&nbsp;package<br>
&nbsp;&nbsp;&nbsp;&nbsp;README)&nbsp;and&nbsp;open&nbsp;the&nbsp;file&nbsp;using&nbsp;function&nbsp;'ephem_open'&nbsp;prior&nbsp;to<br>
&nbsp;&nbsp;&nbsp;&nbsp;calling&nbsp;this&nbsp;function.<br>
..&nbsp;[N3]&nbsp;This&nbsp;function&nbsp;supports&nbsp;the&nbsp;"split"&nbsp;Julian&nbsp;date&nbsp;feature&nbsp;of<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;function&nbsp;'planet_ephemeris'&nbsp;for&nbsp;highest&nbsp;precision.&nbsp;&nbsp;For&nbsp;usual<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;applications,&nbsp;use&nbsp;function&nbsp;'solarsystem'.<br>
&nbsp;<br>
References<br>
----------<br>
..&nbsp;[R1]&nbsp;JPL.&nbsp;2007,&nbsp;"JPL&nbsp;Planetary&nbsp;and&nbsp;Lunar&nbsp;Ephemerides:&nbsp;Export<br>
&nbsp;&nbsp;&nbsp;&nbsp;Information,"&nbsp;(Pasadena,&nbsp;CA:&nbsp;JPL)<br>
&nbsp;&nbsp;&nbsp;&nbsp;<a href="http://ssd.jpl.nasa.gov/?planet_eph_export">http://ssd.jpl.nasa.gov/?planet_eph_export</a>.<br>
..&nbsp;[R2]&nbsp;Kaplan,&nbsp;G.&nbsp;H.&nbsp;"NOVAS:&nbsp;Naval&nbsp;Observatory&nbsp;Vector&nbsp;Astrometry<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Subroutines";&nbsp;USNO&nbsp;internal&nbsp;document&nbsp;dated&nbsp;20&nbsp;Oct&nbsp;1988;<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;revised&nbsp;15&nbsp;Mar&nbsp;1990.</tt></dd></dl>
</td></tr></table>
</body></html>
USNO Master Clock Time
Javascript must be Enabled