fr.cnes.sirius.patrius.propagation.analytical

Class J2SecularPropagator

java.lang.Object

fr.cnes.sirius.patrius.propagation.AbstractPropagator

fr.cnes.sirius.patrius.propagation.analytical.J2SecularPropagator

All Implemented Interfaces:

PVCoordinatesProvider, Propagator, SpacecraftStateProvider, Serializable

public class J2SecularPropagator
extends AbstractPropagator

J2 secular propagator.

This propagator is an analytical propagator taking into account only mean secular effects of J2 zonal harmonic.

Since:

3.2

Version:

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

Author:

Emmanuel Bignon

See Also:

Serialized Form

Field Summary

Fields inherited from class fr.cnes.sirius.patrius.propagation.AbstractPropagator

MASS

Fields inherited from interface fr.cnes.sirius.patrius.propagation.Propagator

EPHEMERIS_GENERATION_MODE, MASTER_MODE, SLAVE_MODE

Constructor Summary

Constructors

Constructor and Description
J2SecularPropagator(Orbit initialOrbit, double referenceRadiusIn, double muIn, double c20In, Frame frameIn) Constructor without attitude provider and mass provider.
J2SecularPropagator(Orbit initialOrbit, double referenceRadiusIn, double muIn, double c20In, Frame frameIn, AttitudeProvider attitudeProvider) Constructor without mass provider.
J2SecularPropagator(Orbit initialOrbit, double referenceRadiusIn, double muIn, double c20In, Frame frameIn, AttitudeProvider attitudeProvForces, AttitudeProvider attitudeProvEvents) Constructor without mass provider.
J2SecularPropagator(Orbit initialOrbit, double referenceRadiusIn, double muIn, double c20In, Frame frameIn, AttitudeProvider attitudeProvForces, AttitudeProvider attitudeProvEvents, MassProvider massProvider) Generic constructor.
J2SecularPropagator(Orbit initialOrbit, double referenceRadiusIn, double muIn, double c20In, Frame frameIn, AttitudeProvider attitudeProvider, MassProvider massProvider) Generic constructor.
J2SecularPropagator(Orbit initialOrbit, double referenceRadiusIn, double muIn, double c20In, Frame frameIn, MassProvider massProvider) Constructor without attitude provider.

Method Summary

Modifier and Type	Method and Description
RealMatrix	getTransitionMatrix(AbsoluteDate date) Compute transition matrix for given date.
Orbit	propagateOrbit(AbsoluteDate date) Extrapolate an orbit up to a specific target date.
void	resetInitialState(SpacecraftState state) Reset the propagator initial state.

Methods inherited from class fr.cnes.sirius.patrius.propagation.AbstractPropagator

acceptStep, addAdditionalStateProvider, addAdditionalStateProvider, addEventDetector, basicPropagate, clearEventsDetectors, getAttitudeProvider, getAttitudeProviderEvents, getAttitudeProviderForces, getEventsDetectors, getFrame, getGeneratedEphemeris, getInitialState, getMode, getPVCoordinates, getPvProvider, getSpacecraftState, manageStateFrame, propagate, propagate, setAttitudeProvider, setAttitudeProviderEvents, setAttitudeProviderForces, setEphemerisMode, setMasterMode, setMasterMode, setOrbitFrame, setSlaveMode, setStartDate

Methods inherited from class java.lang.Object

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

Methods inherited from interface fr.cnes.sirius.patrius.propagation.Propagator

getNativeFrame

Constructor Detail

J2SecularPropagator

public J2SecularPropagator(Orbit initialOrbit,
                           double referenceRadiusIn,
                           double muIn,
                           double c20In,
                           Frame frameIn)
                    throws PatriusException

Constructor without attitude provider and mass provider.

Parameters:

initialOrbit - initial orbit

referenceRadiusIn - reference radius of the central body attraction model (m)

muIn - central attraction coefficient (m³/s²)

c20In - un-normalized 2nd zonal coefficient (about -1.08e-3 for Earth)

frameIn - Inertial or quasi-inertial frame in which the model is supposed valid, the Z axis of the frame being the polar axis of the body

Throws:

PatriusException - thrown if failed to build initial state or coefficients frame is not inertial

J2SecularPropagator

public J2SecularPropagator(Orbit initialOrbit,
                           double referenceRadiusIn,
                           double muIn,
                           double c20In,
                           Frame frameIn,
                           MassProvider massProvider)
                    throws PatriusException

Constructor without attitude provider.

Parameters:

initialOrbit - initial orbit

referenceRadiusIn - reference radius of the central body attraction model (m)

muIn - central attraction coefficient (m³/s²)

c20In - un-normalized 2nd zonal coefficient (about -1.08e-3 for Earth)

frameIn - Inertial or quasi-inertial frame in which the model is supposed valid, the Z axis of the frame being the polar axis of the body

massProvider - mass provider

Throws:

PatriusException - thrown if failed to build initial state or coefficients frame is not inertial

J2SecularPropagator

public J2SecularPropagator(Orbit initialOrbit,
                           double referenceRadiusIn,
                           double muIn,
                           double c20In,
                           Frame frameIn,
                           AttitudeProvider attitudeProvider)
                    throws PatriusException

Constructor without mass provider.

Parameters:

initialOrbit - initial orbit

referenceRadiusIn - reference radius of the central body attraction model (m)

muIn - central attraction coefficient (m³/s²)

c20In - un-normalized 2nd zonal coefficient (about -1.08e-3 for Earth)

frameIn - Inertial or quasi-inertial frame in which the model is supposed valid, the Z axis of the frame being the polar axis of the body

attitudeProvider - attitude provider

Throws:

PatriusException - thrown if failed to build initial state or coefficients frame is not inertial

J2SecularPropagator

public J2SecularPropagator(Orbit initialOrbit,
                           double referenceRadiusIn,
                           double muIn,
                           double c20In,
                           Frame frameIn,
                           AttitudeProvider attitudeProvForces,
                           AttitudeProvider attitudeProvEvents)
                    throws PatriusException

Constructor without mass provider.

Parameters:

initialOrbit - initial orbit

referenceRadiusIn - reference radius of the central body attraction model (m)

muIn - central attraction coefficient (m³/s²)

c20In - un-normalized 2nd zonal coefficient (about -1.08e-3 for Earth)

frameIn - Inertial or quasi-inertial frame in which the model is supposed valid, the Z axis of the frame being the polar axis of the body

attitudeProvForces - attitude provider for force computation

attitudeProvEvents - attitude provider for events computation

Throws:

PatriusException - thrown if failed to build initial state or coefficients frame is not inertial

J2SecularPropagator

public J2SecularPropagator(Orbit initialOrbit,
                           double referenceRadiusIn,
                           double muIn,
                           double c20In,
                           Frame frameIn,
                           AttitudeProvider attitudeProvider,
                           MassProvider massProvider)
                    throws PatriusException

Generic constructor.

Parameters:

initialOrbit - initial orbit

referenceRadiusIn - reference radius of the central body attraction model (m)

muIn - central attraction coefficient (m³/s²)

c20In - un-normalized 2nd zonal coefficient (about -1.08e-3 for Earth)

frameIn - Inertial or quasi-inertial frame in which the model is supposed valid, the Z axis of the frame being the polar axis of the body

attitudeProvider - attitude provider

massProvider - mass provider

Throws:

PatriusException - thrown if failed to build initial state or coefficients frame is not inertial

J2SecularPropagator

public J2SecularPropagator(Orbit initialOrbit,
                           double referenceRadiusIn,
                           double muIn,
                           double c20In,
                           Frame frameIn,
                           AttitudeProvider attitudeProvForces,
                           AttitudeProvider attitudeProvEvents,
                           MassProvider massProvider)
                    throws PatriusException

Generic constructor.

Parameters:

initialOrbit - initial orbit

referenceRadiusIn - reference radius of the central body attraction model (m)

muIn - central attraction coefficient (m³/s²)

c20In - un-normalized 2nd zonal coefficient (about -1.08e-3 for Earth)

frameIn - Inertial or quasi-inertial frame in which the model is supposed valid, the Z axis of the frame being the polar axis of the body

attitudeProvForces - attitude provider for force computation

attitudeProvEvents - attitude provider for events computation

massProvider - mass provider

Throws:

PatriusException - thrown if failed to build initial state or coefficients frame is not inertial

Method Detail

propagateOrbit

public Orbit propagateOrbit(AbsoluteDate date)
                     throws PropagationException

Extrapolate an orbit up to a specific target date.

Specified by:

propagateOrbit in class AbstractPropagator

Parameters:

date - target date for the orbit

Returns:

extrapolated parameters

Throws:

PropagationException - if some parameters are out of bounds

getTransitionMatrix

public RealMatrix getTransitionMatrix(AbsoluteDate date)
                               throws PropagationException

Compute transition matrix for given date.

Parameters:

date - a date

Returns:

transition matrix for given date

Throws:

PropagationException - thrown if frame conversion failed or initial state could not be retrieved

resetInitialState

public void resetInitialState(SpacecraftState state)
                       throws PropagationException

Reset the propagator initial state.

Specified by:

resetInitialState in interface Propagator

Overrides:

resetInitialState in class AbstractPropagator

Parameters:

state - new initial state to consider

Throws:

PropagationException - if initial state cannot be reset