fr.cnes.sirius.patrius.attitudes

Class NadirPointing

java.lang.Object

fr.cnes.sirius.patrius.attitudes.AbstractAttitudeLaw

fr.cnes.sirius.patrius.attitudes.AbstractGroundPointing

fr.cnes.sirius.patrius.attitudes.NadirPointing

All Implemented Interfaces:

AttitudeLaw, AttitudeProvider, Serializable

public class NadirPointing
extends AbstractGroundPointing

This class handles nadir pointing attitude provider.

This class represents the attitude provider where (by default) the satellite z axis is pointing to the vertical of the ground point under satellite.

The object NadirPointing is guaranteed to be immutable.

Author:

Véronique Pommier-Maurussane

See Also:

GroundPointing, Serialized Form

Constructor Summary

Constructors

Constructor and Description
NadirPointing(BodyShape shape) Creates new instance.
NadirPointing(BodyShape shape, Vector3D losInSatFrameVec, Vector3D losNormalInSatFrameVec) Constructor.

Method Summary

Modifier and Type	Method and Description
protected Vector3D	getTargetPoint(PVCoordinatesProvider pvProv, AbsoluteDate date, Frame frame) Compute the target point in specified frame.
TimeStampedPVCoordinates	getTargetPV(PVCoordinatesProvider pvProv, AbsoluteDate date, Frame frame) Compute the target point position/velocity in specified frame.
String	toString()

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

getAttitude, getBodyFrame, getBodyShape

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, wait, wait, wait

Constructor Detail

NadirPointing

public NadirPointing(BodyShape shape)

Creates new instance.

Parameters:

shape - Body shape

NadirPointing

public NadirPointing(BodyShape shape,
                     Vector3D losInSatFrameVec,
                     Vector3D losNormalInSatFrameVec)

Constructor. Create a NadirPointing attitude provider with specified los axis in satellite frame.

Parameters:

shape - Body shape

losInSatFrameVec - LOS in satellite frame axis

losNormalInSatFrameVec - LOS normal axis in satellite frame

Method Detail

getTargetPV

public 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.

Overrides:

getTargetPV in class AbstractGroundPointing

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

getTargetPoint

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

Compute the target point in specified frame.

Specified by:

getTargetPoint in class AbstractGroundPointing

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

toString

public String toString()

Overrides:

toString in class Object