/usr/share/doc/libstarlink-pal-doc/node73.html is in libstarlink-pal-doc 0.3.0-3.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 | <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<!--Converted with LaTeX2HTML 2008 (1.71)
original version by: Nikos Drakos, CBLU, University of Leeds
* revised and updated by: Marcus Hennecke, Ross Moore, Herb Swan
* with significant contributions from:
Jens Lippmann, Marek Rouchal, Martin Wilck and others -->
<HTML>
<HEAD>
<TITLE>palUe2pv palUe2pv
- Heliocentric position and velocity of a planet, asteroid or comet, from universal elements
</TITLE>
<META NAME="description" CONTENT="palUe2pv palUe2pv
- Heliocentric position and velocity of a planet, asteroid or comet, from universal elements
">
<META NAME="keywords" CONTENT="sun267">
<META NAME="resource-type" CONTENT="document">
<META NAME="distribution" CONTENT="global">
<META NAME="Generator" CONTENT="LaTeX2HTML v2008">
<META HTTP-EQUIV="Content-Style-Type" CONTENT="text/css">
<LINK REL="STYLESHEET" HREF="sun267.css">
<LINK REL="previous" HREF="node72.html">
<LINK REL="up" HREF="node3.html">
<LINK REL="next" HREF="node74.html">
</HEAD>
<BODY >
<DIV CLASS="navigation"><!--Navigation Panel-->
<A NAME="tex2html873"
HREF="node74.html">
<IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next"
SRC="/usr/share/latex2html/icons/next.png"></A>
<A NAME="tex2html871"
HREF="node3.html">
<IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up"
SRC="/usr/share/latex2html/icons/up.png"></A>
<A NAME="tex2html867"
HREF="node72.html">
<IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous"
SRC="/usr/share/latex2html/icons/prev.png"></A>
<BR>
<B> Next:</B> <A NAME="tex2html874"
HREF="node74.html">About this document ...</A>
<B> Up:</B> <A NAME="tex2html872"
HREF="node3.html">Function Descriptions</A>
<B> Previous:</B> <A NAME="tex2html868"
HREF="node72.html">palUe2el palUe2el - Universal</A>
<BR>
<BR></DIV>
<!--End of Navigation Panel-->
<H2><A NAME="SECTION000370000000000000000"></A><A NAME="____palUe2pv_"></A>
<BR>
palUe2pv
palUe2pv
- Heliocentric position and velocity of a planet, asteroid or comet, from universal elements
</H2>
<DL>
<DT><STRONG>Description:</STRONG></DT>
<DD><DL>
<DD>Heliocentric position and velocity of a planet, asteroid or comet,
starting from orbital elements in the <TT>"</TT>universal variables<TT>"</TT> form.
</DD>
</DL>
<BR>
</DD>
<DT><STRONG>Invocation:</STRONG></DT>
<DD><DL>
<DD><TT> void palUe2pv( double date, double u[13], double pv[6], int <SPAN CLASS="MATH"><IMG
WIDTH="13" HEIGHT="18" ALIGN="BOTTOM" BORDER="0"
SRC="img1.png"
ALT="$*$"></SPAN>jstat );
</TT>
</DD>
</DL>
<BR>
</DD>
<DT><STRONG>Arguments:</STRONG></DT>
<DD>
<BR> <DL>
<DT><STRONG>
date = double (Given)
</STRONG></DT>
<DD>
TT Modified Julian date (JD-2400000.5).
</DD>
<DT><STRONG>
u = double [13] (Given & Returned)
</STRONG></DT>
<DD>
Universal orbital elements (updated, see note 1)
given (0) combined mass (M<SPAN CLASS="MATH"><IMG
WIDTH="18" HEIGHT="31" ALIGN="MIDDLE" BORDER="0"
SRC="img2.png"
ALT="$+$"></SPAN>m)
<TT>"</TT> (1) total energy of the orbit (alpha)
<TT>"</TT> (2) reference (osculating) epoch (t0)
<TT>"</TT> (3-5) position at reference epoch (r0)
<TT>"</TT> (6-8) velocity at reference epoch (v0)
<TT>"</TT> (9) heliocentric distance at reference epoch
<TT>"</TT> (10) r0.v0
returned (11) date (t)
<TT>"</TT> (12) universal eccentric anomaly (psi) of date
</DD>
<DT><STRONG>
jstat = int <SPAN CLASS="MATH"><IMG
WIDTH="13" HEIGHT="18" ALIGN="BOTTOM" BORDER="0"
SRC="img1.png"
ALT="$*$"></SPAN> (Returned)
</STRONG></DT>
<DD>
status: 0 = OK
<UL>
<LI>1 = radius vector zero
<P>
</LI>
<LI>2 = failed to converge
</LI>
</UL>
<BR>
</DD>
</DL>
<BR>
</DD>
<DT><STRONG>Notes:</STRONG></DT>
<DD><UL>
<LI>The <TT>"</TT>universal<TT>"</TT> elements are those which define the orbit for the
purposes of the method of universal variables (see reference).
They consist of the combined mass of the two bodies, an epoch,
and the position and velocity vectors (arbitrary reference frame)
at that epoch. The parameter set used here includes also various
quantities that can, in fact, be derived from the other
information. This approach is taken to avoiding unnecessary
computation and loss of accuracy. The supplementary quantities
are (i) alpha, which is proportional to the total energy of the
orbit, (ii) the heliocentric distance at epoch, (iii) the
outwards component of the velocity at the given epoch, (iv) an
estimate of psi, the <TT>"</TT>universal eccentric anomaly<TT>"</TT> at a given
date and (v) that date.
<P>
</LI>
<LI>The companion routine is palEl2ue. This takes the conventional
orbital elements and transforms them into the set of numbers
needed by the present routine. A single prediction requires one
one call to palEl2ue followed by one call to the present routine;
for convenience, the two calls are packaged as the routine
sla_PLANEL. Multiple predictions may be made by again
calling palEl2ue once, but then calling the present routine
multiple times, which is faster than multiple calls to palPlanel.
<P>
</LI>
<LI>It is not obligatory to use palEl2ue to obtain the parameters.
However, it should be noted that because palEl2ue performs its
own validation, no checks on the contents of the array U are made
by the present routine.
in the TT timescale (formerly Ephemeris Time, ET) and is a
Modified Julian Date (JD-2400000.5).
units (solar masses, AU and canonical days). The position and
velocity are not sensitive to the choice of reference frame. The
palEl2ue routine in fact produces coordinates with respect to the
J2000 equator and equinox.
<P>
</LI>
<LI>The algorithm was originally adapted from the EPHSLA program of
D.H.P.Jones (private communication, 1996). The method is based
on Stumpff<TT>'</TT>s Universal Variables.
<P>
</LI>
<LI>Reference: Everhart, E. & Pitkin, E.T., Am.J.Phys. 51, 712, 1983.
</LI>
</UL>
<BR>
</DD>
</DL>
<P>
<DIV CLASS="navigation"><HR>
<!--Navigation Panel-->
<A NAME="tex2html873"
HREF="node74.html">
<IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next"
SRC="/usr/share/latex2html/icons/next.png"></A>
<A NAME="tex2html871"
HREF="node3.html">
<IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up"
SRC="/usr/share/latex2html/icons/up.png"></A>
<A NAME="tex2html867"
HREF="node72.html">
<IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous"
SRC="/usr/share/latex2html/icons/prev.png"></A>
<BR>
<B> Next:</B> <A NAME="tex2html874"
HREF="node74.html">About this document ...</A>
<B> Up:</B> <A NAME="tex2html872"
HREF="node3.html">Function Descriptions</A>
<B> Previous:</B> <A NAME="tex2html868"
HREF="node72.html">palUe2el palUe2el - Universal</A></DIV>
<!--End of Navigation Panel-->
</BODY>
</HTML>
|