org.orekit.propagation.semianalytical.dsst

Class DSSTJacobiansMapper

java.lang.Object

org.orekit.propagation.integration.AbstractJacobiansMapper

org.orekit.propagation.semianalytical.dsst.DSSTJacobiansMapper

All Implemented Interfaces:

MatricesHarvester

public class DSSTJacobiansMapper
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.

Author:

Luc Maisonobe, Bryan Cazabonne

See Also:

DSSTPartialDerivativesEquations, DSSTPropagator, SpacecraftState.getAdditionalState(String), AbstractPropagator

Field Summary

Fields

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

Method Summary

Modifier and Type	Method and Description
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.
void	setReferenceState(SpacecraftState reference) Set up reference state.
void	setShortPeriodJacobians(SpacecraftState s) Deprecated. as of 11.1, replaced by setReferenceState(SpacecraftState)

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

analyticalDerivatives, getAdditionalStateDimension, getJacobiansColumnsNames, getName, getParameters, getParametersJacobian, getStateTransitionMatrix

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.

Since:

9.0

See Also:

Constant Field Values

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.

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[][])

setShortPeriodJacobians

@Deprecated
public void setShortPeriodJacobians(SpacecraftState s)

Deprecated. as of 11.1, replaced by setReferenceState(SpacecraftState)

Compute the derivatives of the short period terms related to the additional state parameters.

Parameters:

s - Current state information: date, kinematics, attitude, and additional state

setReferenceState

public void setReferenceState(SpacecraftState reference)

Set up reference state.

This method is called whenever the global propagation reference state changes. This corresponds to the start of propagation in batch least squares orbit determination or at prediction step for each measurement in Kalman filtering. Its goal is to allow the harvester to compute some internal data. Analytical models like TLE use it to compute analytical derivatives, semi-analytical models like DSST use it to compute short periodic terms, numerical models do not use it at all.

Specified by:

setReferenceState in interface MatricesHarvester

Overrides:

setReferenceState in class AbstractJacobiansMapper

Parameters:

reference - reference state to set