fr.cnes.sirius.patrius.bodies

Enum LLHCoordinatesSystem

java.lang.Object

java.lang.Enum<LLHCoordinatesSystem>

fr.cnes.sirius.patrius.bodies.LLHCoordinatesSystem

All Implemented Interfaces:

Serializable, Comparable<LLHCoordinatesSystem>

public enum LLHCoordinatesSystem
extends Enum<LLHCoordinatesSystem>

This enumerate define the handled LLH (Latitude/Longitude/Height) coordinates systems.
Each coordinates system is defined by:

• A lat/long coordinates system
• An height coordinate system

Author:

Alice Latourte

Enum Constant Summary

Enum Constants

Enum Constant and Description
BODYCENTRIC_NORMAL Bodycentric latitude/longitude, and normal height.
BODYCENTRIC_RADIAL Bodycentric latitude/longitude, and radial height.
ELLIPSODETIC Ellipsodetic latitude/longitude and normal height: applicable to ellipsoid shapes only.

Method Summary

Modifier and Type	Method and Description
double[]	computeLLHRates(BodyShape bodyShape, PVCoordinates pv, Frame frame, AbsoluteDate date) Computes the rates in LLH coordinates (longitude, latitude, height) from the provided PVCoordinates and date using finite differences.
String	getHeightSystemLabel() Getter for the label for the managed height coordinate system.
String	getLatLongSystemLabel() Getter for the label for the managed lat/long coordinates system.
double[][]	jacobianFromCartesian(BodyPoint point) Compute the jacobian from the cartesian system to the LLHCoordinate system.
double[][]	jacobianToCartesian(BodyPoint point) Compute the jacobian from the LLHCoordinate system to the cartesian system.
static LLHCoordinatesSystem	valueOf(String name) Returns the enum constant of this type with the specified name.
static LLHCoordinatesSystem[]	values() Returns an array containing the constants of this enum type, in the order they are declared.

Methods inherited from class java.lang.Enum

clone, compareTo, equals, finalize, getDeclaringClass, hashCode, name, ordinal, toString, valueOf

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Enum Constant Detail

ELLIPSODETIC

public static final LLHCoordinatesSystem ELLIPSODETIC

Ellipsodetic latitude/longitude and normal height: applicable to ellipsoid shapes only.

BODYCENTRIC_RADIAL

public static final LLHCoordinatesSystem BODYCENTRIC_RADIAL

Bodycentric latitude/longitude, and radial height.

BODYCENTRIC_NORMAL

public static final LLHCoordinatesSystem BODYCENTRIC_NORMAL

Bodycentric latitude/longitude, and normal height.

Method Detail

values

public static LLHCoordinatesSystem[] values()

Returns an array containing the constants of this enum type, in the order they are declared. This method may be used to iterate over the constants as follows:

for (LLHCoordinatesSystem c : LLHCoordinatesSystem.values())
    System.out.println(c);

Returns:

an array containing the constants of this enum type, in the order they are declared

valueOf

public static LLHCoordinatesSystem valueOf(String name)

Returns the enum constant of this type with the specified name. The string must match exactly an identifier used to declare an enum constant in this type. (Extraneous whitespace characters are not permitted.)

Parameters:

name - the name of the enum constant to be returned.

Returns:

the enum constant with the specified name

Throws:

IllegalArgumentException - if this enum type has no constant with the specified name

NullPointerException - if the argument is null

getLatLongSystemLabel

public final String getLatLongSystemLabel()

Getter for the label for the managed lat/long coordinates system.

Returns:

the label for the managed lat/long coordinates system

getHeightSystemLabel

public final String getHeightSystemLabel()

Getter for the label for the managed height coordinate system.

Returns:

the label for the managed height coordinate system

jacobianToCartesian

public double[][] jacobianToCartesian(BodyPoint point)

Compute the jacobian from the LLHCoordinate system to the cartesian system.

Parameters:

point - The pivot point for the jacobian computation

Returns:

the jacobian with the following columns: latitude, longitude, height

jacobianFromCartesian

public double[][] jacobianFromCartesian(BodyPoint point)
                                 throws PatriusException

Compute the jacobian from the cartesian system to the LLHCoordinate system.

Parameters:

point - The pivot point for the jacobian computation

Returns:

the jacobian with the following rows: latitude, longitude, height

Throws:

PatriusException - if point cannot be converted to body frame
if the point is close to one of the poles or if the altitude of the point is "too negative"

computeLLHRates

public double[] computeLLHRates(BodyShape bodyShape,
                                PVCoordinates pv,
                                Frame frame,
                                AbsoluteDate date)
                         throws PatriusException

Computes the rates in LLH coordinates (longitude, latitude, height) from the provided PVCoordinates and date using finite differences. This method is valid for all types of ellipsoids.

The step size for the finite differences is 0.01 s, which minimizes the error for the OneAxisEllipsoid (Earth) case with an orbit at 700 km of altitude.

Parameters:

bodyShape - Input body shape.

pv - Input position and velocity of spacecraft.

frame - Frame in which the input PV is expressed.

date - Date at which the frame conversion must be computed.

Returns:

A vector of double precision numbers containing the time derivatives for longitude, latitude, and height, in rad/s, rad/s, and m/s respectively.

Throws:

PatriusException