fr.cnes.sirius.patrius.stela.bodies

Class MeeusMoonStela

java.lang.Object

fr.cnes.sirius.patrius.bodies.AbstractCelestialBody

fr.cnes.sirius.patrius.stela.bodies.MeeusMoonStela

All Implemented Interfaces:

CelestialBody, PVCoordinatesProvider, Serializable

public class MeeusMoonStela
extends AbstractCelestialBody

This class implements the Moon ephemerides according to the algorithm of Meeus, it only provides the position. Note that it is not possible to build this Moon from the CelestialBodyFactory.

See Stela's implementation of this model

This class contains methods to store AbstractCelestialBody.getInertialEquatorFrame() to integration frame (CIRF) transform to speed up computation during the integration process. As this transform varies slowly through time, it has been demonstrated it is not necessary to recompute it every time. Warning: these methods should not be used in a stand-alone use (unless you known what you are doing). There are two methods:

• updateTransform(AbsoluteDate, Frame): store transform from AbstractCelestialBody.getInertialEquatorFrame() to provided frame at provided date.
• resetTransform(): reset stored transform

Note that pole information allowing to define inertially-centered frame and rotating frame are defined in IAUPoleFactory since Meeus model does not provide the information.

Since:

1.3

Author:

Cedric Dental

See Also:

CelestialBody, Serialized Form

Concurrency :

immutable

Field Summary

Fields inherited from class fr.cnes.sirius.patrius.bodies.AbstractCelestialBody

CONSTANT_ROTATING_FRAME_NAME, ICRF_FRAME_NAME, INERTIAL_EQUATOR_FRAME_NAME, MEAN_EQUATOR_FRAME_NAME, MEAN_ROTATING_FRAME_NAME, TRUE_EQUATOR_FRAME_NAME, TRUE_ROTATING_FRAME_NAME

Constructor Summary

Constructors

Constructor and Description
MeeusMoonStela(double inEarthRadius) Simple constructor.

Method Summary

Modifier and Type	Method and Description
Frame	getNativeFrame(AbsoluteDate date, Frame frame) Get the native frame, i.e.
PVCoordinates	getPVCoordinates(AbsoluteDate date, Frame frame) Get the PVCoordinates of the body in the selected frame.
static void	resetTransform() Reset cached transform.
String	toString() Returns a string representation of the body and its attributes.
static void	updateTransform(AbsoluteDate date, Frame frame) Update cached transform from FramesFactory.getMOD(boolean) to provided frame.

Methods inherited from class fr.cnes.sirius.patrius.bodies.AbstractCelestialBody

getAttractionModel, getConstantRotatingFrame, getGM, getIAUPole, getICRF, getInertialEquatorFrame, getMeanEquatorFrame, getMeanRotatingFrame, getName, getShape, getTrueEquatorFrame, getTrueRotatingFrame, setAttractionModel, setGM, setIAUPole, setShape

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

MeeusMoonStela

public MeeusMoonStela(double inEarthRadius)
               throws PatriusException

Simple constructor.

Parameters:

inEarthRadius - the Earth Radius

Throws:

PatriusException - if data embedded in the library cannot be read

Method Detail

getPVCoordinates

public PVCoordinates getPVCoordinates(AbsoluteDate date,
                                      Frame frame)
                               throws PatriusException

Get the PVCoordinates of the body in the selected frame.

Specified by:

getPVCoordinates in interface PVCoordinatesProvider

Specified by:

getPVCoordinates in class AbstractCelestialBody

Parameters:

date - current date

frame - the frame where to define the position

Returns:

position/velocity of the body (m and m/s)

Throws:

PatriusException - if position cannot be computed in given frame

getNativeFrame

public Frame getNativeFrame(AbsoluteDate date,
                            Frame frame)
                     throws PatriusException

Get the native frame, i.e. the raw frame in which PVCoordinates are expressed before transformation to user output frame. This native frame can be dependent on date and frame.

Parameters:

date - a date

frame - a frame

Returns:

the native frame

Throws:

PatriusException - thrown if native frame is undefined or unknown

updateTransform

public static void updateTransform(AbsoluteDate date,
                                   Frame frame)
                            throws PatriusException

Update cached transform from FramesFactory.getMOD(boolean) to provided frame. Once called, this transform will always be used when calling getPVCoordinates(AbsoluteDate, Frame) unless a call to resetTransform() has been made

Parameters:

date - a date

frame - a frame

Throws:

PatriusException - thrown if transformation computation failed

resetTransform

public static void resetTransform()

Reset cached transform.

toString

public String toString()

Returns a string representation of the body and its attributes.

Specified by:

toString in interface CelestialBody

Overrides:

toString in class AbstractCelestialBody

Returns:

a string representation of the body and its attributes