fr.cnes.sirius.patrius.attitudes.directions

Class GroundVelocityDirection

java.lang.Object

fr.cnes.sirius.patrius.attitudes.directions.GroundVelocityDirection

All Implemented Interfaces:

IDirection, Serializable

public class GroundVelocityDirection
extends Object
implements IDirection

Ground velocity direction. This direction depends on the location of the target point on the ground surface and therefore it depends on the pointing direction and the body shape. The intersection between the pointing direction and the body shape defines the target point.

Since:

1.2

Version:

$Id: GroundVelocityDirection.java 17582 2017-05-10 12:58:16Z bignon $

Author:

Julie Anton

See Also:

Serialized Form

Concurrency :

conditionally thread-safe

Concurrency comment :

The use of a celestial body linked to the tree of frames makes this class thread-safe only if the underlying CelestialBody is too.

Constructor Summary

Constructors

Constructor and Description
GroundVelocityDirection(BodyShape bodyShape, IDirection trackingDirection) Constructor

Method Summary

Modifier and Type	Method and Description
Line	getLine(PVCoordinatesProvider pvCoord, AbsoluteDate date, Frame frame) Provides the line containing the origin (given PV coordinates) and directed by the direction vector.
Vector3D	getVector(PVCoordinatesProvider pvCoord, AbsoluteDate date, Frame frame) Provides the direction vector at a given date in a given frame.

Methods inherited from class java.lang.Object

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

Constructor Detail

GroundVelocityDirection

public GroundVelocityDirection(BodyShape bodyShape,
                               IDirection trackingDirection)

Constructor

Parameters:

bodyShape - : shape of the body for which one we want to compute the ground velocity direction of a satellite.

trackingDirection - : line of sight of the satellite (pointing direction)

Method Detail

getVector

public Vector3D getVector(PVCoordinatesProvider pvCoord,
                          AbsoluteDate date,
                          Frame frame)
                   throws PatriusException

Provides the direction vector at a given date in a given frame.

Specified by:

getVector in interface IDirection

Parameters:

pvCoord - the current coordinates of the origin point of the direction (may be null, in that specific case, the origin of the direction is the frame origin).

date - the date

frame - the frame to project the vector's coordinates

Returns:

the direction vector (from origin to target) at the given date in the given frame

Throws:

PatriusException - if some frame specific errors occur

getLine

public Line getLine(PVCoordinatesProvider pvCoord,
                    AbsoluteDate date,
                    Frame frame)
             throws PatriusException

Provides the line containing the origin (given PV coordinates) and directed by the direction vector.

Specified by:

getLine in interface IDirection

Parameters:

pvCoord - the origin of the direction

date - the current date

frame - the expression frame of the line

Returns:

the half Line of space from the origin position at given date and containing the direction vector

Throws:

PatriusException - if some frame specific errors occur