fr.cnes.sirius.patrius.attitudes

Class TargetGroundPointing

java.lang.Object

fr.cnes.sirius.patrius.attitudes.AbstractAttitudeLaw

fr.cnes.sirius.patrius.attitudes.AbstractGroundPointing

fr.cnes.sirius.patrius.attitudes.TargetGroundPointing

All Implemented Interfaces:

AttitudeLaw, AttitudeProvider, Serializable

public class TargetGroundPointing
extends AbstractGroundPointing

This class handles target pointing attitude provider; while the class TargetPointing does not guarantee the target point belongs to the body surface, this class always provides a ground point target.

By default, the satellite z axis is pointing to a ground point target.

Since:

2.0

Version:

$Id: TargetGroundPointing.java 18065 2017-10-02 16:42:02Z bignon $

Author:

Tiziana Sabatini

See Also:

GroundPointing, TargetPointing, Serialized Form

Concurrency :

immutable

Constructor Summary

Constructors

Constructor and Description
TargetGroundPointing(BodyShape shape, GeodeticPoint targetGeoIn) Creates a new instance from body shape and target expressed in geodetic coordinates.
TargetGroundPointing(BodyShape shape, GeodeticPoint targetGeoIn, Vector3D losInSatFrameVec, Vector3D losNormalInSatFrameVec) Creates a new instance from body shape and target expressed in geodetic coordinates with specified los axis in satellite frame.
TargetGroundPointing(BodyShape shape, GeodeticPoint targetGeoIn, Vector3D losInSatFrameVec, Vector3D losNormalInSatFrameVec, double targetVelocityDeltaT) Creates a new instance from body shape and target expressed in geodetic coordinates with specified los axis in satellite frame.
TargetGroundPointing(BodyShape shape, Vector3D targetIn) Creates a new instance from body shape and target expressed in cartesian coordinates.
TargetGroundPointing(BodyShape shape, Vector3D targetIn, Vector3D losInSatFrameVec, Vector3D losNormalInSatFrameVec) Creates a new instance from body shape and target expressed in cartesian coordinates with specified los axis in satellite frame.
TargetGroundPointing(BodyShape shape, Vector3D targetIn, Vector3D losInSatFrameVec, Vector3D losNormalInSatFrameVec, double targetVelocityDeltaT) Creates a new instance from body shape and target expressed in cartesian coordinates with specified los axis in satellite frame.

Method Summary

Modifier and Type	Method and Description
GeodeticPoint	getTargetGeo()
protected Vector3D	getTargetPoint(PVCoordinatesProvider pvProv, AbsoluteDate date, Frame frame) Compute the target point in specified frame.
String	toString()

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

getAttitude, getBodyFrame, getBodyShape, getLosInSatFrame, getLosNormalInSatFrame, getTargetPV

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

getSpinDerivativesComputation, setSpinDerivativesComputation

Methods inherited from class java.lang.Object

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

Methods inherited from interface fr.cnes.sirius.patrius.attitudes.AttitudeProvider

computeSpinByFD, computeSpinDerivativeByFD, getAttitude

Constructor Detail

TargetGroundPointing

public TargetGroundPointing(BodyShape shape,
                            Vector3D targetIn)
                     throws PatriusException

Creates a new instance from body shape and target expressed in cartesian coordinates.

Parameters:

shape - body shape.

targetIn - target position in body frame

Throws:

PatriusException - thrown if transformation failed

TargetGroundPointing

public TargetGroundPointing(BodyShape shape,
                            GeodeticPoint targetGeoIn)

Creates a new instance from body shape and target expressed in geodetic coordinates.

Parameters:

shape - body shape

targetGeoIn - target defined as a geodetic point in body shape frame

TargetGroundPointing

public TargetGroundPointing(BodyShape shape,
                            Vector3D targetIn,
                            Vector3D losInSatFrameVec,
                            Vector3D losNormalInSatFrameVec)
                     throws PatriusException

Creates a new instance from body shape and target expressed in cartesian coordinates with specified los axis in satellite frame.

Parameters:

shape - Body shape

targetIn - target position in body frame

losInSatFrameVec - LOS in satellite frame axis

losNormalInSatFrameVec - LOS normal axis in satellite frame

Throws:

PatriusException - thrown if transformation failed

TargetGroundPointing

public TargetGroundPointing(BodyShape shape,
                            Vector3D targetIn,
                            Vector3D losInSatFrameVec,
                            Vector3D losNormalInSatFrameVec,
                            double targetVelocityDeltaT)
                     throws PatriusException

Creates a new instance from body shape and target expressed in cartesian coordinates with specified los axis in satellite frame.

Parameters:

shape - Body shape

targetIn - target position in body frame

losInSatFrameVec - LOS in satellite frame axis

losNormalInSatFrameVec - LOS normal axis in satellite frame

targetVelocityDeltaT - the delta-T used to compute target velocity by finite differences

Throws:

PatriusException - thrown if transformation failed

TargetGroundPointing

public TargetGroundPointing(BodyShape shape,
                            GeodeticPoint targetGeoIn,
                            Vector3D losInSatFrameVec,
                            Vector3D losNormalInSatFrameVec)

Creates a new instance from body shape and target expressed in geodetic coordinates with specified los axis in satellite frame.

Parameters:

shape - Body shape

targetGeoIn - target defined as a geodetic point in body shape frame

losInSatFrameVec - LOS in satellite frame axis

losNormalInSatFrameVec - LOS normal axis in satellite frame

TargetGroundPointing

public TargetGroundPointing(BodyShape shape,
                            GeodeticPoint targetGeoIn,
                            Vector3D losInSatFrameVec,
                            Vector3D losNormalInSatFrameVec,
                            double targetVelocityDeltaT)

Creates a new instance from body shape and target expressed in geodetic coordinates with specified los axis in satellite frame.

Parameters:

shape - Body shape

targetGeoIn - target defined as a geodetic point in body shape frame

losInSatFrameVec - LOS in satellite frame axis

losNormalInSatFrameVec - LOS normal axis in satellite frame

targetVelocityDeltaT - the delta-T used to compute target velocity by finite differences

Method Detail

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

getTargetGeo

public GeodeticPoint getTargetGeo()

Returns:

the targetGeo

toString

public String toString()

Overrides:

toString in class Object