aboutsummaryrefslogtreecommitdiff
path: root/math/slalib/doc/pv2ue.hlp
blob: 776f877a13742fb4a2b795de64b1783963a4be25 (plain) (blame)
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
.help pv2ue Jun99 "Slalib Package"
.nf

      SUBROUTINE slPVUE (PV, DATE, PMASS, U, JSTAT)

     - - - - - -
      P V U E
     - - - - - -

  Construct a universal element set based on an instantaneous position
  and velocity.

  Given:
     PV        d(6)   heliocentric x,y,z,xdot,ydot,zdot of date,
                      (AU,AU/s; Note 1)
     DATE      d      date (TT Modified Julian Date = JD-2400000.5)
     PMASS     d      mass of the planet (Sun=1; Note 2)

  Returned:
     U         d(13)  universal orbital elements (Note 3)

                 (1)  combined mass (M+m)
                 (2)  total energy of the orbit (alpha)
                 (3)  reference (osculating) epoch (t0)
               (4-6)  position at reference epoch (r0)
               (7-9)  velocity at reference epoch (v0)
                (10)  heliocentric distance at reference epoch
                (11)  r0.v0
                (12)  date (t)
                (13)  universal eccentric anomaly (psi) of date, approx

     JSTAT     i      status:  0 = OK
                              -1 = illegal PMASS
                              -2 = too close to Sun
                              -3 = too slow

  Notes

  1  The PV 6-vector can be with respect to any chosen inertial frame,
     and the resulting universal-element set will be with respect to
     the same frame.  A common choice will be mean equator and ecliptic
     of epoch J2000.

  2  The mass, PMASS, is important only for the larger planets.  For
     most purposes (e.g. asteroids) use 0D0.  Values less than zero
     are illegal.

  3  The "universal" 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 "universal eccentric anomaly" at a given
     date and (v) that date.

  Reference:  Everhart, E. & Pitkin, E.T., Am.J.Phys. 51, 712, 1983.

  P.T.Wallace   Starlink   18 March 1999

  Copyright (C) 1999 Rutherford Appleton Laboratory
  Copyright (C) 1995 Association of Universities for Research in Astronomy Inc.

.fi
.endhelp