fr.cnes.sirius.patrius.bodies

Interface IAUPole

All Superinterfaces:

Serializable

All Known Implementing Classes:

UserIAUPole

public interface IAUPole
extends Serializable

Interface for IAU pole and primer meridian orientations.

This interface defines methods compliant with the report of the IAU/IAG Working Group on Cartographic Coordinates and Rotational Elements of the Planets and Satellites (WGCCRE). These definitions are common for all recent versions of this report published every three years.

The precise values of pole direction and W angle coefficients may vary from publication year as models are adjusted. The latest value of constants for implementing this interface can be found in the working group site.

Author:

Luc Maisonobe

See Also:

CelestialBodyFactory

Method Summary

Modifier and Type	Method and Description
Vector3D	getPole(AbsoluteDate date) Get the body North pole direction with respect to a reference frame.
Vector3D	getPole(AbsoluteDate date, IAUPoleModelType iauPoleType) Get the body North pole direction with respect to a reference frame.
Vector3D	getPoleDerivative(AbsoluteDate date) Get the body North pole direction derivative with respect to a reference frame.
Vector3D	getPoleDerivative(AbsoluteDate date, IAUPoleModelType iauPoleType) Get the body North pole direction derivative with respect to a reference frame.
double	getPrimeMeridianAngle(AbsoluteDate date) Get the prime meridian angle.
double	getPrimeMeridianAngle(AbsoluteDate date, IAUPoleModelType iauPoleType) Get the prime meridian angle.
double	getPrimeMeridianAngleDerivative(AbsoluteDate date) Get the prime meridian angle derivative.
double	getPrimeMeridianAngleDerivative(AbsoluteDate date, IAUPoleModelType iauPoleType) Get the prime meridian angle derivative.
String	toString() Returns a string representation of the body and its attributes.

Method Detail

getPole

Vector3D getPole(AbsoluteDate date)

Get the body North pole direction with respect to a reference frame. It takes into account constant, secular and harmonics terms (conversion from ICRF to true equator).

Parameters:

date - current date

Returns:

body North pole direction with respect to a reference frame

getPole

Vector3D getPole(AbsoluteDate date,
                 IAUPoleModelType iauPoleType)

Get the body North pole direction with respect to a reference frame.

Parameters:

date - current date

iauPoleType - IAUPole data to take into account for ICRF/inertial/mean equator/true equator transformation

Returns:

body North pole direction with respect to a reference frame

getPrimeMeridianAngle

double getPrimeMeridianAngle(AbsoluteDate date)

Get the prime meridian angle.

The prime meridian angle is the angle between the Q node and the prime meridian. Represents the body rotation.

It takes into account constant, secular and harmonics terms (conversion from ICRF to true rotating).

Parameters:

date - current date

Returns:

prime meridian vector

getPrimeMeridianAngle

double getPrimeMeridianAngle(AbsoluteDate date,
                             IAUPoleModelType iauPoleType)

Get the prime meridian angle.

The prime meridian angle is the angle between the Q node and the prime meridian. Represents the body rotation.

Parameters:

date - current date

iauPoleType - IAUPole data to take into account for ICRF/inertial/mean rotating/true rotating transformation

Returns:

prime meridian vector

getPoleDerivative

Vector3D getPoleDerivative(AbsoluteDate date)

Get the body North pole direction derivative with respect to a reference frame. It takes into account constant, secular and harmonics terms (conversion from ICRF to true equator).

Parameters:

date - current date

Returns:

body North pole direction derivative with respect to a reference frame

getPoleDerivative

Vector3D getPoleDerivative(AbsoluteDate date,
                           IAUPoleModelType iauPoleType)

Get the body North pole direction derivative with respect to a reference frame. It takes into account constant, secular and harmonics terms (conversion from ICRF to true equator).

Parameters:

date - current date

iauPoleType - IAUPole data to take into account for ICRF/inertial/mean equator/true equator transformation

Returns:

body North pole direction derivative with respect to a reference frame

getPrimeMeridianAngleDerivative

double getPrimeMeridianAngleDerivative(AbsoluteDate date)

Get the prime meridian angle derivative.

The prime meridian angle is the angle between the Q node and the prime meridian. Represents the body rotation.

It takes into account constant, secular and harmonics terms (conversion from ICRF to true rotating).

Parameters:

date - current date

Returns:

prime meridian angle derivative

getPrimeMeridianAngleDerivative

double getPrimeMeridianAngleDerivative(AbsoluteDate date,
                                       IAUPoleModelType iauPoleType)

Get the prime meridian angle derivative.

The prime meridian angle is the angle between the Q node and the prime meridian. Represents the body rotation.

Parameters:

date - current date

iauPoleType - IAUPole data to take into account for ICRF/inertial/mean rotating/true rotating transformation

Returns:

prime meridian angle derivative

toString

String toString()

Returns a string representation of the body and its attributes.

Overrides:

toString in class Object

Returns:

a string representation of the body and its attributes