- java.lang.Object
-
- spice.basic.Coordinates
-
- 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 Modifier and Type Field Description private double
altitude
private double
f
private double
latitude
private double
longitude
private double
re
-
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
Constructors Constructor Description 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.Angular units are radians.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
Modifier and Type Method Description 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.
-
-
-
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
- doublef
- doublelatitude
- doublere
- doublealtitude
- 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
- Vector3f
- doublere
- 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
-
toRectangular
public Vector3 toRectangular() throws SpiceException
Convert this instance to rectangular coordinates.- Specified by:
toRectangular
in classCoordinates
- Returns:
- Vector3
- Throws:
SpiceException
- exception
-
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
- Vector3f
- doublere
- double- Returns:
- Matrix33
- Throws:
SpiceException
- exception
-
-