Module JNISpice
Package spice.basic

Class GeodeticCoordinates


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

    "Geodetic" is the term used in SPICE for the "planetodetic" coordinate system.

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

    Longitude increases in the counterclockwise sense about the +Z axis. 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

      • re

        private double re
      • altitude

        private double altitude
      • f

        private double f
      • latitude

        private double latitude
      • longitude

        private double longitude
    • Constructor Detail

      • GeodeticCoordinates

        public GeodeticCoordinates()
        No-arguments constructor.
      • GeodeticCoordinates

        public GeodeticCoordinates​(GeodeticCoordinates coords)
        Copy constructor.

        This method creates a deep copy.

        Parameters:
        coords - GeodeticCoordinates
      • GeodeticCoordinates

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

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

      • 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
      • getGeoRecJacobian

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

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