org.orekit.propagation.numerical

Interface TimeDerivativesEquations

public interface TimeDerivativesEquations

Interface summing up the contribution of several forces into orbit and mass derivatives.

The aim of this interface is to gather the contributions of various perturbing forces expressed as accelerations into one set of time-derivatives of Orbit plus one mass derivatives. It implements Gauss equations for different kind of parameters.

An implementation of this interface is automatically provided by integration-based propagators, which are either semi-analytical or numerical propagators.

Author:

Luc Maisonobe, Fabien Maussion, Véronique Pommier-Maurussane

See Also:

ForceModel, NumericalPropagator

Method Summary

Methods

Modifier and Type	Method and Description
void	addAcceleration(Vector3D gamma, Frame frame) Add the contribution of an acceleration expressed in some inertial frame.
void	addKeplerContribution(double mu) Add the contribution of the Kepler evolution.
void	addMassDerivative(double q) Add the contribution of the flow rate (dm/dt).
void	addXYZAcceleration(double x, double y, double z) Add the contribution of an acceleration expressed in the inertial frame (it is important to make sure this acceleration is defined in the same frame as the orbit) .

Method Detail

addKeplerContribution

void addKeplerContribution(double mu)

Add the contribution of the Kepler evolution.

Since the Kepler evolution is the most important, it should be added after all the other ones, in order to improve numerical accuracy.

Parameters:

mu - central body gravitational constant

addXYZAcceleration

void addXYZAcceleration(double x,
                      double y,
                      double z)

Add the contribution of an acceleration expressed in the inertial frame (it is important to make sure this acceleration is defined in the same frame as the orbit) .

Parameters:

x - acceleration along the X axis (m/s²)

y - acceleration along the Y axis (m/s²)

z - acceleration along the Z axis (m/s²)

addAcceleration

void addAcceleration(Vector3D gamma,
                   Frame frame)
                     throws OrekitException

Add the contribution of an acceleration expressed in some inertial frame.

Parameters:

gamma - acceleration vector (m/s²)

frame - frame in which acceleration is defined (must be an inertial frame)

Throws:

OrekitException - if frame transforms cannot be computed

addMassDerivative

void addMassDerivative(double q)

Add the contribution of the flow rate (dm/dt).

Parameters:

q - the flow rate, must be negative (dm/dt)

Throws:

IllegalArgumentException - if flow-rate is positive