fr.cnes.sirius.patrius.attitudes.directions

Class GlintApproximatePointingDirection

java.lang.Object

fr.cnes.sirius.patrius.attitudes.directions.GlintApproximatePointingDirection

All Implemented Interfaces:

IDirection, Serializable

public final class GlintApproximatePointingDirection
extends Object
implements IDirection

"Glint" direction pointing. It provides methods to compute Glint point G coordinates and to create a vector/line between a point and G.

Glint point is the point of Sun reflexion on a body shape (the Earth for instance) as seen from a spacecraft.

Light speed is currently never taken into account.

Since:

3.1

Version:

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

Author:

rodriguest

See Also:

Serialized Form

Concurrency :

not thread-safe

Concurrency comment :

Not thread-safe by default. No use case for sharing an instance between threads found.

Constructor Summary

Constructors

Constructor and Description
GlintApproximatePointingDirection(OneAxisEllipsoid shape, PVCoordinatesProvider sunPV) Constructor with default solver ( BisectionSolver(double, double)).
GlintApproximatePointingDirection(OneAxisEllipsoid shape, PVCoordinatesProvider sunPV, UnivariateSolver univariateSolver) Constructor.

Method Summary

Modifier and Type	Method and Description
protected Vector3D	getGlintPosition(Vector3D satPos, Vector3D sunPos, AbsoluteDate date) Compute Glint position.
Vector3D	getGlintVectorPosition(PVCoordinatesProvider origin, AbsoluteDate date, Frame frame) Get the position vector of the glint point
Line	getLine(PVCoordinatesProvider origin, AbsoluteDate date, Frame frame) Provides the line containing the origin (given PV coordinates) and directed by the direction vector.
Vector3D	getVector(PVCoordinatesProvider origin, 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

GlintApproximatePointingDirection

public GlintApproximatePointingDirection(OneAxisEllipsoid shape,
                                         PVCoordinatesProvider sunPV,
                                         UnivariateSolver univariateSolver)

Constructor.

Parameters:

shape - the body shape

sunPV - the Sun PV coordinates

univariateSolver - the solver used to find Glint direction

GlintApproximatePointingDirection

public GlintApproximatePointingDirection(OneAxisEllipsoid shape,
                                         PVCoordinatesProvider sunPV)

Constructor with default solver ( BisectionSolver(double, double)).

Parameters:

shape - the body shape

sunPV - the Sun PV coordinates

Method Detail

getVector

public Vector3D getVector(PVCoordinatesProvider origin,
                          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:

origin - 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 origin,
                    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:

origin - 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

getGlintPosition

protected Vector3D getGlintPosition(Vector3D satPos,
                                    Vector3D sunPos,
                                    AbsoluteDate date)
                             throws PatriusException

Compute Glint position.

Parameters:

satPos - spacecraft position in body frame

sunPos - Sun position in body frame

date - date

Returns:

Glint position in body frame

Throws:

PatriusException - thrown if computation failed

getGlintVectorPosition

public Vector3D getGlintVectorPosition(PVCoordinatesProvider origin,
                                       AbsoluteDate date,
                                       Frame frame)
                                throws PatriusException

Get the position vector of the glint point

Parameters:

origin - the origin of the direction

date - the current date

frame - the current frame

Returns:

position vector of the glint point

Throws:

PatriusException - thrown if computation failed