JNISpice
version 2.0.0

spice.basic
Class GeodeticCoordinates

java.lang.Object
  extended by spice.basic.Coordinates
      extended by spice.basic.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 Summary
 
Fields inherited from class spice.basic.Coordinates
ALTITUDE, COLATITUDE, CYLINDRICAL, DECLINATION, GEODETIC, LATITUDE, LATITUDINAL, LONGITUDE, PLANETOGRAPHIC, RA, RADEC, RADIUS, RANGE, RECTANGULAR, SPHERICAL, X, Y, Z
 
Constructor Summary
GeodeticCoordinates()
          No-arguments constructor.
GeodeticCoordinates(double longitude, double latitude, double altitude, double re, double f)
          Construct a GeodeticCoordinates instance from an equatorial radius, flattening coefficient, altitude, longitude, and latitude.
GeodeticCoordinates(GeodeticCoordinates coords)
          Copy constructor.
GeodeticCoordinates(Vector3 v, double re, double f)
          Construct a GeodeticCoordinates instance from a 3-vector and reference spheroid parameters.
 
Method Summary
 double getAltitude()
          Return altitude.
 double getEquatorialRadius()
          Return the equatorial radius of the reference spheroid.
 double getFlatteningCoefficient()
          Return the flattening coefficient of the reference spheroid.
 Matrix33 getGeoRecJacobian()
          Return the Jacobian matrix of the geodetic-to-rectangular coordinate transformation at the point specified by this instance.
 double getLatitude()
          Return latitude in radians.
 double getLongitude()
          Return longitude in radians.
static Matrix33 getRecGeoJacobian(Vector3 v, double re, double f)
          Return the Jacobian matrix of the rectangular-to-geodetic coordinate transformation at the point specified by a 3-vector and reference spheroid parameters.
 Vector3 toRectangular()
          Convert this instance to rectangular coordinates.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

GeodeticCoordinates

public GeodeticCoordinates()
No-arguments constructor.


GeodeticCoordinates

public GeodeticCoordinates(GeodeticCoordinates coords)
Copy constructor.

This method creates a deep copy.


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.

Throws:
SpiceException

GeodeticCoordinates

public GeodeticCoordinates(Vector3 v,
                           double re,
                           double f)
                    throws SpiceException
Construct a GeodeticCoordinates instance from a 3-vector and reference spheroid parameters.

Throws:
SpiceException
Method Detail

getLongitude

public double getLongitude()
Return longitude in radians.


getLatitude

public double getLatitude()
Return latitude in radians.


getAltitude

public double getAltitude()
Return altitude.


getEquatorialRadius

public double getEquatorialRadius()
Return the equatorial radius of the reference spheroid.


getFlatteningCoefficient

public double getFlatteningCoefficient()
Return the flattening coefficient of the reference spheroid.


toRectangular

public Vector3 toRectangular()
                      throws SpiceException
Convert this instance to rectangular coordinates.

Specified by:
toRectangular in class Coordinates
Throws:
SpiceException

getGeoRecJacobian

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

Throws:
SpiceException

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.

Throws:
SpiceException

JNISpice
version 2.0.0

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