org.orekit.propagation.analytical.tle

Class TLEJacobiansMapper

java.lang.Object

org.orekit.propagation.integration.AbstractJacobiansMapper

org.orekit.propagation.analytical.tle.TLEJacobiansMapper

public class TLEJacobiansMapper
extends AbstractJacobiansMapper

Mapper between two-dimensional Jacobian matrices and one-dimensional additional state arrays.

This class does not hold the states by itself. Instances of this class are guaranteed to be immutable.

Since:

11.0

Author:

Luc Maisonobe, Bryan Cazabonne, Thomas Paulet

See Also:

TLEPartialDerivativesEquations, TLEPropagator, SpacecraftState.getAdditionalState(String), AbstractPropagator

Field Summary

Fields

Modifier and Type	Field and Description
static int	STATE_DIMENSION State dimension, fixed to 6.

Constructor Summary

Constructors

Constructor and Description
TLEJacobiansMapper(String name, ParameterDriversList parameters, TLEPropagator propagator) Simple constructor.

Method Summary

Modifier and Type	Method and Description
void	analyticalDerivatives(SpacecraftState s) Compute the derivatives needed by analytical orbit determination methods.
void	getParametersJacobian(SpacecraftState state, double[][] dYdP) Get the Jacobian with respect to parameters from a one-dimensional additional state array.
void	getStateJacobian(SpacecraftState state, double[][] dYdY0) Get the Jacobian with respect to state from a one-dimensional additional state array.
void	setInitialJacobians(SpacecraftState state, double[][] dY1dY0, double[][] dY1dP, double[] p) Set the Jacobian with respect to state into a one-dimensional additional state array.

Methods inherited from class org.orekit.propagation.integration.AbstractJacobiansMapper

getAdditionalStateDimension, getName, getParameters

Methods inherited from class java.lang.Object

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

Field Detail

STATE_DIMENSION

public static final int STATE_DIMENSION

State dimension, fixed to 6.

See Also:

Constant Field Values

Constructor Detail

TLEJacobiansMapper

public TLEJacobiansMapper(String name,
                          ParameterDriversList parameters,
                          TLEPropagator propagator)

Simple constructor.

Parameters:

name - name of the Jacobians

parameters - selected parameters for Jacobian computation

propagator - the propagator that will handle the orbit propagation

Method Detail

setInitialJacobians

public void setInitialJacobians(SpacecraftState state,
                                double[][] dY1dY0,
                                double[][] dY1dP,
                                double[] p)

Set the Jacobian with respect to state into a one-dimensional additional state array.

Specified by:

setInitialJacobians in class AbstractJacobiansMapper

Parameters:

state - spacecraft state

dY1dY0 - Jacobian of current state at time t₁ with respect to state at some previous time t₀

dY1dP - Jacobian of current state at time t₁ with respect to parameters (may be null if there are no parameters)

p - placeholder where to put the one-dimensional additional state

See Also:

AbstractJacobiansMapper.getStateJacobian(SpacecraftState, double[][])

getStateJacobian

public void getStateJacobian(SpacecraftState state,
                             double[][] dYdY0)

Get the Jacobian with respect to state from a one-dimensional additional state array.

This method extract the data from the state and put it in the dYdY0 array.

For JacobiansMapper and TLEJacobiansMapper, the method provides the Jacobian with respect to Cartesian elements. For DSSTJacobiansMapper the method provides the Jacobian with respect to Equinoctial elements.

Specified by:

getStateJacobian in class AbstractJacobiansMapper

Parameters:

state - spacecraft state

dYdY0 - placeholder where to put the Jacobian with respect to state

See Also:

AbstractJacobiansMapper.getParametersJacobian(SpacecraftState, double[][])

getParametersJacobian

public void getParametersJacobian(SpacecraftState state,
                                  double[][] dYdP)

Get the Jacobian with respect to parameters from a one-dimensional additional state array.

This method extract the data from the state and put it in the dYdP array.

If no parameters have been set in the constructor, the method returns immediately and does not reference dYdP which can safely be null in this case.

Specified by:

getParametersJacobian in class AbstractJacobiansMapper

Parameters:

state - spacecraft state

dYdP - placeholder where to put the Jacobian with respect to parameters

See Also:

AbstractJacobiansMapper.getStateJacobian(SpacecraftState, double[][])

analyticalDerivatives

public void analyticalDerivatives(SpacecraftState s)

Compute the derivatives needed by analytical orbit determination methods.

Analytical derivatives are used to calculate state transition matrix of analytical orbit propagators and short period derivatives of DSST orbit propagator. In other word, this method does nothing for the numerical propagator.

Overrides:

analyticalDerivatives in class AbstractJacobiansMapper

Parameters:

s - spacecraft state with respect to which calculate derivatives