org.orekit.propagation.semianalytical.dsst

Class DSSTPartialDerivativesEquations

java.lang.Object

org.orekit.propagation.semianalytical.dsst.DSSTPartialDerivativesEquations

All Implemented Interfaces:

AdditionalDerivativesProvider, AdditionalEquations

Deprecated.

as of 11.1, replaced by Propagator.setupMatricesComputation(String, org.hipparchus.linear.RealMatrix, org.orekit.utils.DoubleArrayDictionary)

@Deprecated
public class DSSTPartialDerivativesEquations
extends Object
implements AdditionalDerivativesProvider, AdditionalEquations

derivatives provider computing the partial derivatives of the state (orbit) with respect to initial state and force models parameters.

This set of equations are automatically added to a DSST propagator in order to compute partial derivatives of the orbit along with the orbit itself. This is useful for example in orbit determination applications.

The partial derivatives with respect to initial state are dimension 6 (orbit only).

The partial derivatives with respect to force models parameters has a dimension equal to the number of selected parameters. Parameters selection is implemented at DSST force models level. Users must retrieve a parameter driver by looping on all drivers using DSSTForceModel.getParametersDrivers() and then select it by calling setSelected(true).

Since:

10.0

Author:

Bryan Cazabonne

Constructor Summary

Constructors

Constructor and Description
DSSTPartialDerivativesEquations(String name, DSSTPropagator propagator, PropagationType propagationType) Deprecated. Simple constructor.

Method Summary

Modifier and Type	Method and Description
double[]	computeDerivatives(SpacecraftState s, double[] pDot) Deprecated. Compute the derivatives related to the additional state parameters.
double[]	derivatives(SpacecraftState s) Deprecated. Compute the derivatives related to the additional state parameters.
int	getDimension() Deprecated. Get the dimension of the generated derivative.
DSSTJacobiansMapper	getMapper() Deprecated. Get a mapper between two-dimensional Jacobians and one-dimensional additional state.
String	getName() Deprecated. Get the name of the additional derivatives (which will become state once integrated).
void	init(SpacecraftState initialState, AbsoluteDate target) Deprecated. Initialize the generator at the start of propagation.
SpacecraftState	setInitialJacobians(SpacecraftState s0) Deprecated. Set the initial value of the Jacobian with respect to state and parameter.
SpacecraftState	setInitialJacobians(SpacecraftState s1, double[][] dY1dY0, double[][] dY1dP) Deprecated. Set the initial value of the Jacobian with respect to state and parameter.

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.orekit.propagation.integration.AdditionalDerivativesProvider

yield

Constructor Detail

DSSTPartialDerivativesEquations

public DSSTPartialDerivativesEquations(String name,
                                       DSSTPropagator propagator,
                                       PropagationType propagationType)

Deprecated.

Simple constructor.

Upon construction, this set of equations is automatically added to the propagator by calling its AbstractIntegratedPropagator.addAdditionalDerivativesProvider(AdditionalDerivativesProvider) method. So there is no need to call this method explicitly for these equations.

Parameters:

name - name of the partial derivatives equations

propagator - the propagator that will handle the orbit propagation

propagationType - type of the orbit used for the propagation (mean or osculating)

Method Detail

getName

public String getName()

Deprecated.

Get the name of the additional derivatives (which will become state once integrated).

Specified by:

getName in interface AdditionalDerivativesProvider

Specified by:

getName in interface AdditionalEquations

Returns:

name of the additional state (names containing "orekit" with any case are reserved for the library internal use)

getDimension

public int getDimension()

Deprecated.

Get the dimension of the generated derivative.

Specified by:

getDimension in interface AdditionalDerivativesProvider

Returns:

dimension of the generated

setInitialJacobians

public SpacecraftState setInitialJacobians(SpacecraftState s0)

Deprecated.

Set the initial value of the Jacobian with respect to state and parameter.

This method is equivalent to call setInitialJacobians(SpacecraftState, double[][], double[][]) with dYdY0 set to the identity matrix and dYdP set to a zero matrix.

The force models parameters for which partial derivatives are desired, must have been selected before this method is called, so proper matrices dimensions are used.

Parameters:

s0 - initial state

Returns:

state with initial Jacobians added

setInitialJacobians

public SpacecraftState setInitialJacobians(SpacecraftState s1,
                                           double[][] dY1dY0,
                                           double[][] dY1dP)

Deprecated.

Set the initial value of the Jacobian with respect to state and parameter.

The returned state must be added to the propagator (it is not done automatically, as the user may need to add more states to it).

The force models parameters for which partial derivatives are desired, must have been selected before this method is called, and the dY1dP matrix dimension must be consistent with the selection.

Parameters:

s1 - current state

dY1dY0 - Jacobian of current state at time t₁ with respect to state at some previous time t₀ (must be 6x6)

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

Returns:

state with initial Jacobians added

getMapper

public DSSTJacobiansMapper getMapper()

Deprecated.

Get a mapper between two-dimensional Jacobians and one-dimensional additional state.

Returns:

a mapper between two-dimensional Jacobians and one-dimensional additional state, with the same name as the instance

See Also:

setInitialJacobians(SpacecraftState), setInitialJacobians(SpacecraftState, double[][], double[][])

init

public void init(SpacecraftState initialState,
                 AbsoluteDate target)

Deprecated.

Initialize the generator at the start of propagation.

Specified by:

init in interface AdditionalDerivativesProvider

Specified by:

init in interface AdditionalEquations

Parameters:

initialState - initial state information at the start of propagation

target - date of propagation

computeDerivatives

public double[] computeDerivatives(SpacecraftState s,
                                   double[] pDot)

Deprecated.

Compute the derivatives related to the additional state parameters.

When this method is called, the spacecraft state contains the main state (orbit, attitude and mass), all the states provided through the additional state providers registered to the propagator, and the additional state integrated using this equation. It does not contains any other states to be integrated alongside during the same propagation.

Specified by:

computeDerivatives in interface AdditionalEquations

Parameters:

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

pDot - placeholder where the derivatives of the additional parameters should be put

Returns:

cumulative effect of the equations on the main state (may be null if equations do not change main state at all)

derivatives

public double[] derivatives(SpacecraftState s)

Deprecated.

Compute the derivatives related to the additional state parameters.

Specified by:

derivatives in interface AdditionalDerivativesProvider

Parameters:

s - current state information: date, kinematics, attitude, and additional states this equations depend on (according to the yield method)

Returns:

computed derivatives