Module JNISpice
Package spice.basic

Class PlanetographicCoordinates


  • public class PlanetographicCoordinates
    extends Coordinates
    Class PlanetographicCoordinates represents sets of coordinates expressed in the planetographic system: positions are specified by longitude, latitude, and altitude.

    Planetographic coordinates are defined using a reference spheroid. The spheroid may be oblate, prolate, or a sphere.

    By default, for objects other than the Earth, Moon, and Sun, planetographic longitude is defined such that, for a distant, fixed observer, the sub-observer point's longitude increases with time. For the Earth, Moon and Sun, longitude is positive East by default. The default sense of planetographic longitude for a given body can be overridden via kernel pool assignments; see Particulars for details.

    Planetographic latitude of a point is the angle between the X-Y plane and the line normal to the reference spheroid that passes through the point and the closest point on the reference spheroid to the point.

    Version 1.0.0 28-NOV-2009 (NJB)

    • Field Detail

      • body

        private Body body
      • re

        private double re
      • altitude

        private double altitude
      • f

        private double f
      • latitude

        private double latitude
      • longitude

        private double longitude
    • Constructor Detail

      • PlanetographicCoordinates

        public PlanetographicCoordinates()
        No-arguments constructor.
      • PlanetographicCoordinates

        public PlanetographicCoordinates​(Body body,
                                         double longitude,
                                         double latitude,
                                         double altitude,
                                         double re,
                                         double f)
                                  throws SpiceException
        Construct a PlanetographicCoordinates instance from a Body, an equatorial radius, flattening coefficient, altitude, longitude, and latitude.Angular units are radians.
        Parameters:
        body - Body
        f - double
        longitude - double
        re - double
        latitude - double
        altitude - double
        Throws:
        SpiceException - exception
      • PlanetographicCoordinates

        public PlanetographicCoordinates​(Body body,
                                         Vector3 v,
                                         double re,
                                         double f)
                                  throws SpiceException
        Construct a PlanetographicCoordinates instance from a Body, a 3-vector, and reference spheroid parameters.
        Parameters:
        body - Body
        f - double
        v - Vector3
        re - double
        Throws:
        SpiceException - exception
    • Method Detail

      • getBody

        public Body getBody()
                     throws SpiceException
        Return central body with with this coordinate instance is associated.
        Returns:
        Body
        Throws:
        SpiceException - exception
      • getLongitude

        public double getLongitude()
        Return longitude in radians.
        Returns:
        double
      • getLatitude

        public double getLatitude()
        Return latitude in radians.
        Returns:
        double
      • getAltitude

        public double getAltitude()
        Return altitude.
        Returns:
        double
      • getEquatorialRadius

        public double getEquatorialRadius()
        Return the equatorial radius of the reference spheroid.
        Returns:
        double
      • getFlatteningCoefficient

        public double getFlatteningCoefficient()
        Return the flattening coefficient of the reference spheroid.
        Returns:
        double
      • getPgrRecJacobian

        public Matrix33 getPgrRecJacobian()
                                   throws SpiceException
        Return the Jacobian matrix of the planetographic-to-rectangular coordinate transformation at the point specified by this instance.
        Returns:
        Matrix33
        Throws:
        SpiceException - exception
      • getRecPgrJacobian

        public static Matrix33 getRecPgrJacobian​(Body body,
                                                 Vector3 v,
                                                 double re,
                                                 double f)
                                          throws SpiceException
        Return the Jacobian matrix of the rectangular-to-planetographic coordinate transformation at the point specified by a Body, a 3-vector and reference spheroid parameters.
        Parameters:
        body - Body
        f - double
        v - Vector3
        re - double
        Returns:
        Matrix33
        Throws:
        SpiceException - exception