fr.cnes.sirius.patrius.attitudes.directions

Class GlintApproximatePointingDirection

java.lang.Object

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

All Implemented Interfaces:

IDirection

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.

Since:

3.1

Version:

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

Author:

rodriguest

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(EllipsoidBodyShape shape, PVCoordinatesProvider sunPV) Constructor with default solver ( BisectionSolver.BisectionSolver(double, double)).
GlintApproximatePointingDirection(EllipsoidBodyShape shape, PVCoordinatesProvider sunPV, UnivariateSolver univariateSolver) Constructor.

Method Summary

Modifier and Type	Method and Description
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(EllipsoidBodyShape 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(EllipsoidBodyShape shape,
                                         PVCoordinatesProvider sunPV)

Constructor with default solver ( BisectionSolver.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 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 Line of space containing the origin and direction vector

Throws:

PatriusException - if some frame specific errors occur

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