fr.cnes.sirius.patrius.attitudes

Class AbstractGroundPointing

java.lang.Object

fr.cnes.sirius.patrius.attitudes.AbstractAttitudeLaw

fr.cnes.sirius.patrius.attitudes.AbstractGroundPointing

All Implemented Interfaces:

AttitudeLaw, AttitudeProvider, Serializable

Direct Known Subclasses:

AbstractGroundPointingWrapper, BodyCenterGroundPointing, LofOffsetPointing, NadirPointing, TargetGroundPointing

public abstract class AbstractGroundPointing
extends AbstractAttitudeLaw

Base class for ground pointing attitude providers.

This class is a basic model for different kind of ground pointing attitude providers, such as : body center pointing, nadir pointing, target pointing, etc...

The object GroundPointing is guaranteed to be immutable.

Author:

Véronique Pommier-Maurussane

See Also:

AttitudeProvider, Serialized Form

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	AbstractGroundPointing(BodyShape shapeIn) Default constructor.
protected	AbstractGroundPointing(BodyShape shapeIn, Vector3D losInSatFrameVec, Vector3D losNormalInSatFrameVec) Simple constructor.

Method Summary

Modifier and Type	Method and Description
Attitude	getAttitude(PVCoordinatesProvider pvProv, AbsoluteDate date, Frame frame) Compute the attitude corresponding to an orbital state.
Frame	getBodyFrame() Get the body frame.
BodyShape	getBodyShape() Get the body shape.
protected abstract Vector3D	getTargetPoint(PVCoordinatesProvider pvProv, AbsoluteDate date, Frame frame) Compute the target point in specified frame.
protected TimeStampedPVCoordinates	getTargetPV(PVCoordinatesProvider pvProv, AbsoluteDate date, Frame frame) Compute the target point position/velocity in specified frame.

Methods inherited from class fr.cnes.sirius.patrius.attitudes.AbstractAttitudeLaw

getAttitude, getSpinDerivativesComputation, setSpinDerivativesComputation

Methods inherited from class java.lang.Object

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

Constructor Detail

AbstractGroundPointing

protected AbstractGroundPointing(BodyShape shapeIn)

Default constructor. Build a new instance with arbitrary default elements.

By default, the satellite frame is set as :

• LOS axis : K
• LOS normal axis : J

Parameters:

shapeIn - the body shape

AbstractGroundPointing

protected AbstractGroundPointing(BodyShape shapeIn,
                                 Vector3D losInSatFrameVec,
                                 Vector3D losNormalInSatFrameVec)

Simple constructor. Build a new instance with specified LOS axis in satellite frame.

Parameters:

shapeIn - the body shape

losInSatFrameVec - LOS in satellite frame axis

losNormalInSatFrameVec - LOS normal axis in satellite frame

Method Detail

getAttitude

public Attitude getAttitude(PVCoordinatesProvider pvProv,
                            AbsoluteDate date,
                            Frame frame)
                     throws PatriusException

Compute the attitude corresponding to an orbital state.

Parameters:

pvProv - local position-velocity provider around current date

date - current date

frame - reference frame from which attitude is computed

Returns:

attitude attitude on the specified date and position-velocity state

Throws:

PatriusException - if attitude cannot be computed

getTargetPoint

protected abstract Vector3D getTargetPoint(PVCoordinatesProvider pvProv,
                                           AbsoluteDate date,
                                           Frame frame)
                                    throws PatriusException

Compute the target point in specified frame.

Parameters:

pvProv - provider for PV coordinates

date - date at which target point is requested

frame - frame in which observed ground point should be provided

Returns:

observed ground point position in specified frame

Throws:

PatriusException - if some specific error occurs, such as no target reached

getTargetPV

protected TimeStampedPVCoordinates getTargetPV(PVCoordinatesProvider pvProv,
                                               AbsoluteDate date,
                                               Frame frame)
                                        throws PatriusException

Compute the target point position/velocity in specified frame.

The default implementation use a simple centered two points finite differences scheme, it may be replaced by more accurate models in specialized implementations.

In the case where the point is computed at a date corresponding to the lower/upper bound of the ephemeris, the finite differences scheme used is either 1st order forward or backward.

The calculated intersection velocity corresponds to the "virtual" intersection point velocity between the satellite los and the Earth, not the velocity of the physical point.

Parameters:

pvProv - provider for PV coordinates

date - date at which target point is requested

frame - frame in which observed ground point should be provided

Returns:

observed ground point position/velocity in specified frame

Throws:

PatriusException - if some specific error occurs, such as no target reached

getBodyFrame

public final Frame getBodyFrame()

Get the body frame.

Returns:

body frame

getBodyShape

public final BodyShape getBodyShape()

Get the body shape.

Returns:

body shape