Package org.orekit.frames.encounter

Class ValsecchiEncounterFrame

java.lang.Object

org.orekit.frames.encounter.AbstractEncounterLOF

org.orekit.frames.encounter.ValsecchiEncounterFrame

All Implemented Interfaces:

EncounterLOF, LOF

public class ValsecchiEncounterFrame
extends AbstractEncounterLOF

Valsecchi encounter local orbital frame based on Valsecchi formulation from : "Valsecchi, G. B., Milani, A., Gronchi, G. F. & Ches- ley, S. R. Resonant returns to close approaches: Analytical theory. Astronomy & Astrophysics 408, 1179–1196 (2003).".

Note that it is up to the user to choose which object should be at the origin.

Since:

12.0

Author:

Vincent Cucchietti, Quentin Parpaite

Constructor Summary

Constructors

Constructor	Description
ValsecchiEncounterFrame(FieldPVCoordinates<T> other)	Constructor.
ValsecchiEncounterFrame(PVCoordinates other)	Constructor.

Method Summary

Modifier and Type	Method	Description
Vector3D	getAxisNormalToCollisionPlane()	Get the axis normal to the collision plane (i, j or k) in this encounter local orbital frame.
<T extends CalculusFieldElement<T>> FieldVector3D<T>	getAxisNormalToCollisionPlane(Field<T> field)	Get the axis normal to the collision plane (i, j or k) in this encounter local orbital frame.
String	getName()	Get name of the local orbital frame.
<T extends CalculusFieldElement<T>> FieldRotation<T>	rotationFromInertial(Field<T> field, FieldPVCoordinates<T> origin, FieldPVCoordinates<T> other)	Get the rotation from inertial to this encounter local orbital frame.
Rotation	rotationFromInertial(PVCoordinates origin, PVCoordinates other)	Get the rotation from inertial to this encounter local orbital frame.

Methods inherited from class org.orekit.frames.encounter.AbstractEncounterLOF

getFieldOther, getOther, rotationFromInertial, rotationFromInertial

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.orekit.frames.encounter.EncounterLOF

computeProjectionMatrix, computeProjectionMatrix, isQuasiInertial, projectOntoCollisionPlane, projectOntoCollisionPlane, projectOntoCollisionPlane, projectOntoCollisionPlane, rotationFromInertial, rotationFromInertial

Methods inherited from interface org.orekit.frames.LOF

rotationFromLOF, rotationFromLOF, transformFromInertial, transformFromInertial, transformFromLOF, transformFromLOF

Constructor Detail

ValsecchiEncounterFrame

public ValsecchiEncounterFrame(PVCoordinates other)

Constructor.

Parameters:

other - other object to create the encounter frame with (not the origin of the frame !)

ValsecchiEncounterFrame

public ValsecchiEncounterFrame(FieldPVCoordinates<T> other)

Constructor.

Type Parameters:

T - type of the field elements

Parameters:

other - other object to create the encounter frame with (not the origin of the frame !)

Method Detail

rotationFromInertial

public <T extends CalculusFieldElement<T>> FieldRotation<T> rotationFromInertial(Field<T> field,
                                                                                 FieldPVCoordinates<T> origin,
                                                                                 FieldPVCoordinates<T> other)

Get the rotation from inertial to this encounter local orbital frame.

BEWARE: The given origin's position and velocity coordinates must be given in the frame in which this instance has been expressed in.

Type Parameters:

T - type of the field elements

Parameters:

field - field to which the elements belong

origin - position-velocity of the origin in the same inertial frame as other

other - position-velocity of the other in the same inertial frame as origin

Returns:

rotation from inertial to this encounter local orbital frame

rotationFromInertial

public Rotation rotationFromInertial(PVCoordinates origin,
                                     PVCoordinates other)

Get the rotation from inertial to this encounter local orbital frame.

BEWARE: The given origin's position and velocity coordinates must be given in the frame in which this instance has been expressed in.

Parameters:

origin - position-velocity of the origin in the same inertial frame as other

other - position-velocity of the other instance in the same inertial frame as origin

Returns:

rotation from inertial to this encounter local orbital frame

getAxisNormalToCollisionPlane

public <T extends CalculusFieldElement<T>> FieldVector3D<T> getAxisNormalToCollisionPlane(Field<T> field)

Get the axis normal to the collision plane (i, j or k) in this encounter local orbital frame.

In this case, return (0,1,0);

Type Parameters:

T - type of the field elements

Parameters:

field - field of the elements

Returns:

axis normal to the collision plane (i, j or k) in this encounter local orbital frame

getAxisNormalToCollisionPlane

public Vector3D getAxisNormalToCollisionPlane()

Get the axis normal to the collision plane (i, j or k) in this encounter local orbital frame.

In this case, return (0,1,0);

Returns:

axis normal to the collision plane (i, j or k) in this encounter local orbital frame

getName

public String getName()

Get name of the local orbital frame.

Returns:

name of the local orbital frame