org.orekit.orbits

Class LibrationOrbit

java.lang.Object

org.orekit.orbits.LibrationOrbit

Direct Known Subclasses:

HaloOrbit, LyapunovOrbit

public abstract class LibrationOrbit
extends Object

Base class for libration orbits.

Since:

10.2

Author:

Vincent Mouraux, Bryan Cazabonne

See Also:

HaloOrbit, LyapunovOrbit

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	LibrationOrbit(CR3BPSystem system, PVCoordinates initialPV, double orbitalPeriod) Constructor.

Method Summary

Modifier and Type	Method and Description
protected abstract PVCoordinates	applyCorrectionOnPV(CR3BPDifferentialCorrection diff) Apply the differential correction to compute more accurate initial PV.
void	applyDifferentialCorrection() Apply differential correction.
void	applyDifferentialCorrection(AttitudeProvider attitudeProvider, TimeScale utc) Deprecated. as of 11.1, replaced by applyDifferentialCorrection()
PVCoordinates	getInitialPV() Return the initialPV on the libration orbit.
PVCoordinates	getManifolds(SpacecraftState s, boolean isStable) Return a manifold direction from one position on a libration Orbit.
double	getOrbitalPeriod() Return the orbital period of the libration orbit.

Methods inherited from class java.lang.Object

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

Constructor Detail

LibrationOrbit

protected LibrationOrbit(CR3BPSystem system,
                         PVCoordinates initialPV,
                         double orbitalPeriod)

Constructor.

Parameters:

system - CR3BP System considered

initialPV - initial position on a libration Orbit

orbitalPeriod - initial orbital period of the libration Orbit

Method Detail

getOrbitalPeriod

public double getOrbitalPeriod()

Return the orbital period of the libration orbit.

Returns:

orbitalPeriod orbital period of the libration orbit

getInitialPV

public PVCoordinates getInitialPV()

Return the initialPV on the libration orbit.

This will return the exact initialPV only if you applied a prior differential correction. If you did not, you can use the method applyCorrectionOnPV(CR3BPDifferentialCorrection)

Returns:

initialPV initialPV on the libration orbit

applyDifferentialCorrection

public void applyDifferentialCorrection()

Apply differential correction.

This will update initialPV and orbitalPeriod parameters.

applyDifferentialCorrection

@Deprecated
public void applyDifferentialCorrection(AttitudeProvider attitudeProvider,
                                                    TimeScale utc)

Deprecated. as of 11.1, replaced by applyDifferentialCorrection()

Apply differential correction.

This will update initialPV and orbitalPeriod parameters.

Parameters:

attitudeProvider - the attitude law for the numerocal propagator

utc - UTC time scale

getManifolds

public PVCoordinates getManifolds(SpacecraftState s,
                                  boolean isStable)

Return a manifold direction from one position on a libration Orbit.

Parameters:

s - SpacecraftState with additional equations

isStable - true if the manifold is stable

Returns:

manifold first guess Position-Velocity of a point on the libration Orbit

applyCorrectionOnPV

protected abstract PVCoordinates applyCorrectionOnPV(CR3BPDifferentialCorrection diff)

Apply the differential correction to compute more accurate initial PV.

Parameters:

diff - cr3bp differential correction

Returns:

corrected PV coordinates