JNISpice
version 2.0.0

spice.basic
Class OsculatingElementsExtended

java.lang.Object
  extended by spice.basic.OsculatingElements
      extended by spice.basic.OsculatingElementsExtended

public class OsculatingElementsExtended
extends OsculatingElements

Class OsculatingElementsExtended provides methods for conversion between state vectors and osculating elements. The class also supports two-body propagation of osculating elements or state vectors.

This class provides the true anomaly and, when these values are computable, the orbital semi-major axis and period.

The full set of elements is:

   RP      Perifocal distance.
   ECC     Eccentricity.
   INC     Inclination.
   LNODE   Longitude of the ascending node.
   ARGP    Argument of periapsis.
   M0      Mean anomaly at epoch.
   T0      Epoch.
   MU      Gravitational parameter.
   NU      True anomaly.
   A       Semi-major axis.
   TAU     Orbital period.

Distance units are km. Angular units are radians. Time units
are seconds.

Methods for retrieving the first eight elements shown above are inherited from the superclass OsculatingElements.

Version 1.0.0 25-JAN-2017 (NJB)


Field Summary
 
Fields inherited from class spice.basic.OsculatingElements
eltArray, IDX_ARGP, IDX_ECC, IDX_INC, IDX_LNODE, IDX_M0, IDX_MU, IDX_RP, IDX_T0, NELTS
 
Constructor Summary
OsculatingElementsExtended(OsculatingElementsExtended elts)
          Copy constructor.
OsculatingElementsExtended(StateVector state, Time t, double mu)
          Create osculating elements from a StateVector, a Time, and a gravitational parameter (GM).
 
Method Summary
 double getPeriod()
          Return the orbital period.
 double getSemiMajorAxis()
          Return the orbital semi-major axis.
 double getTrueAnomaly()
          Return true anomaly.
 double[] toArray()
          Extract elements to an array of type double.
 
Methods inherited from class spice.basic.OsculatingElements
getArgumentOfPeriapsis, getEccentricity, getEpoch, getGM, getInclination, getLongitudeOfNode, getMeanAnomaly, getPerifocalDistance, propagate, propagate
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

OsculatingElementsExtended

public OsculatingElementsExtended(OsculatingElementsExtended elts)
Copy constructor. This constructor creates a deep copy.


OsculatingElementsExtended

public OsculatingElementsExtended(StateVector state,
                                  Time t,
                                  double mu)
                           throws SpiceException
Create osculating elements from a StateVector, a Time, and a gravitational parameter (GM).

The GM value `mu' is expressed in units of

         3      2
       km  / sec
   

Throws:
SpiceException
Method Detail

toArray

public double[] toArray()
Extract elements to an array of type double.

The full set of elements is:

   RP      Perifocal distance.
   ECC     Eccentricity.
   INC     Inclination.
   LNODE   Longitude of the ascending node.
   ARGP    Argument of periapsis.
   M0      Mean anomaly at epoch.
   T0      Epoch.
   MU      Gravitational parameter.
   NU      True anomaly.
   A       Semi-major axis.
   TAU     Orbital period.

Distance units are km. Angular units are radians. Time units
are seconds.

Overrides:
toArray in class OsculatingElements

getTrueAnomaly

public double getTrueAnomaly()
                      throws SpiceException
Return true anomaly.

Units are radians.

Throws:
SpiceException

getSemiMajorAxis

public double getSemiMajorAxis()
                        throws SpiceException
Return the orbital semi-major axis.

Units are km.

This method throws an exception if the semi-major axis cannot be computed.

Throws:
SpiceException

getPeriod

public double getPeriod()
                 throws SpiceException
Return the orbital period.

Units are seconds.

This method throws an exception if the period cannot be computed.

Throws:
SpiceException

JNISpice
version 2.0.0

JNISpice Alpha Test Version 2.0.0 28-JAN-2017 (NJB)