Module JNISpice
Package spice.basic

Class 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)

    • Constructor Detail

      • OsculatingElementsExtended

        public OsculatingElementsExtended​(OsculatingElementsExtended elts)
        Copy constructor.This constructor creates a deep copy.
        Parameters:
        elts - OsculatingElementsExtended
      • 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
           
        Parameters:
        state - StateVector
        mu - double
        t - Time
        Throws:
        SpiceException - exception
    • 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
        Returns:
        double[]
      • getTrueAnomaly

        public double getTrueAnomaly()
                              throws SpiceException
        Return true anomaly.

        Units are radians.

        Returns:
        double
        Throws:
        SpiceException - exception
      • 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.

        Returns:
        double
        Throws:
        SpiceException - exception
      • getPeriod

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

        Units are seconds.

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

        Returns:
        double
        Throws:
        SpiceException - exception