org.orekit.attitudes

Class GroundPointingWrapper

java.lang.Object

org.orekit.attitudes.GroundPointing

org.orekit.attitudes.GroundPointingWrapper

All Implemented Interfaces:

Serializable, AttitudeProvider, AttitudeProviderModifier

Direct Known Subclasses:

YawCompensation, YawSteering

public abstract class GroundPointingWrapper
extends GroundPointing
implements AttitudeProviderModifier

This class leverages common parts for compensation modes around ground pointing attitudes.

Author:

Véronique Pommier-Maurussane, Luc Maisonobe

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
GroundPointingWrapper(GroundPointing groundPointingLaw) Creates a new instance.

Method Summary

Methods

Modifier and Type	Method and Description
Attitude	getAttitude(PVCoordinatesProvider pvProv, AbsoluteDate date, Frame frame) Compute the attitude corresponding to an orbital state.
Attitude	getBaseState(PVCoordinatesProvider pvProv, AbsoluteDate date, Frame frame) Compute the base system state at given date, without compensation.
abstract Rotation	getCompensation(PVCoordinatesProvider pvProv, AbsoluteDate date, Frame frame, Attitude base) Compute the compensation rotation at given date.
GroundPointing	getGroundPointingLaw() Deprecated. as of 6.0, replaced by getUnderlyingAttitudeProvider()
protected Vector3D	getTargetPoint(PVCoordinatesProvider pvProv, AbsoluteDate date, Frame frame) Compute the target point in specified frame.
protected PVCoordinates	getTargetPV(PVCoordinatesProvider pvProv, AbsoluteDate date, Frame frame) Compute the target point position/velocity in specified frame.
AttitudeProvider	getUnderlyingAttitudeProvider() Get the underlying (ground pointing) attitude provider.

Methods inherited from class org.orekit.attitudes.GroundPointing

getBodyFrame

Methods inherited from class java.lang.Object

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

Constructor Detail

GroundPointingWrapper

public GroundPointingWrapper(GroundPointing groundPointingLaw)

Creates a new instance.

Parameters:

groundPointingLaw - ground pointing attitude provider without compensation

Method Detail

getGroundPointingLaw

@Deprecated
public GroundPointing getGroundPointingLaw()

Deprecated. as of 6.0, replaced by getUnderlyingAttitudeProvider()

Get the underlying ground pointing law.

Returns:

underlying ground pointing law.

See Also:

getUnderlyingAttitudeProvider()

getUnderlyingAttitudeProvider

public AttitudeProvider getUnderlyingAttitudeProvider()

Get the underlying (ground pointing) attitude provider.

Specified by:

getUnderlyingAttitudeProvider in interface AttitudeProviderModifier

Returns:

underlying attitude provider, which in this case is a GroundPointing instance

getTargetPoint

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

Compute the target point in specified frame.

Specified by:

getTargetPoint in class GroundPointing

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:

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

getTargetPV

protected PVCoordinates getTargetPV(PVCoordinatesProvider pvProv,
                        AbsoluteDate date,
                        Frame frame)
                             throws OrekitException

Compute the target point position/velocity in specified frame.

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

Overrides:

getTargetPV in class GroundPointing

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:

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

getBaseState

public Attitude getBaseState(PVCoordinatesProvider pvProv,
                    AbsoluteDate date,
                    Frame frame)
                      throws OrekitException

Compute the base system state at given date, without compensation.

Parameters:

pvProv - provider for PV coordinates

date - date at which state is requested

frame - reference frame from which attitude is computed

Returns:

satellite base attitude state, i.e without compensation.

Throws:

OrekitException - if some specific error occurs

getAttitude

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

Compute the attitude corresponding to an orbital state.

Specified by:

getAttitude in interface AttitudeProvider

Overrides:

getAttitude in class GroundPointing

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:

OrekitException - if attitude cannot be computed

getCompensation

public abstract Rotation getCompensation(PVCoordinatesProvider pvProv,
                       AbsoluteDate date,
                       Frame frame,
                       Attitude base)
                                  throws OrekitException

Compute the compensation rotation at given date.

Parameters:

pvProv - provider for PV coordinates

date - date at which rotation is requested

frame - reference frame from which attitude is computed

base - base satellite attitude in given frame.

Returns:

compensation rotation at date, i.e rotation between non compensated attitude state and compensated state.

Throws:

OrekitException - if some specific error occurs