org.hipparchus.migration.ode

Class JacobianMatrices

java.lang.Object

org.hipparchus.migration.ode.JacobianMatrices

Deprecated.

as of 1.0, replaced with VariationalEquation

@Deprecated
public class JacobianMatrices
extends Object

This class defines a set of secondary equations to compute the Jacobian matrices with respect to the initial state vector and, if any, to some parameters of the primary ODE set.

It is intended to be packed into an ExpandableODE in conjunction with a primary set of ODE, which may be:

• a FirstOrderDifferentialEquations
• a MainStateJacobianProvider

In order to compute Jacobian matrices with respect to some parameters of the primary ODE set, the following parameter Jacobian providers may be set:

• a ParametersController

See Also:

ExpandableODE, FirstOrderDifferentialEquations, MainStateJacobianProvider, NamedParameterJacobianProvider, ParametersController

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	JacobianMatrices.MismatchedEquations Deprecated. Special exception for equations mismatch.

Constructor Summary

Constructors

Constructor and Description
JacobianMatrices(MainStateJacobianProvider jode, String... parameters) Deprecated. Simple constructor for a secondary equations set computing Jacobian matrices.
JacobianMatrices(OrdinaryDifferentialEquation fode, double[] hY, String... parameters) Deprecated. Simple constructor for a secondary equations set computing Jacobian matrices.

Method Summary

Modifier and Type	Method and Description
void	addParameterJacobianProvider(NamedParameterJacobianProvider provider) Deprecated. Add a parameter Jacobian provider.
double[][]	extractMainSetJacobian(ODEState state) Deprecated. Extract the Jacobian matrix with respect to state.
double[]	extractParameterJacobian(ODEState state, String pName) Deprecated. Extract the Jacobian matrix with respect to one parameter.
void	registerVariationalEquations(ExpandableODE expandable) Deprecated. Register the variational equations for the Jacobians matrices to the expandable set.
void	setInitialMainStateJacobian(double[][] dYdY0) Deprecated. Set the initial value of the Jacobian matrix with respect to state.
void	setInitialParameterJacobian(String pName, double[] dYdP) Deprecated. Set the initial value of a column of the Jacobian matrix with respect to one parameter.
void	setParameterizedODE(ParametersController pc) Deprecated. as of 1.0, replaced with setParametersController(ParametersController)
void	setParametersController(ParametersController parametersController) Deprecated. Set a parameter Jacobian provider.
void	setParameterStep(String parameter, double hP) Deprecated. Set the step associated to a parameter in order to compute by finite difference the Jacobian matrix.
ODEState	setUpInitialState(ODEState initialState) Deprecated. Set up initial state.

Methods inherited from class java.lang.Object

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

Constructor Detail

JacobianMatrices

public JacobianMatrices(OrdinaryDifferentialEquation fode,
                        double[] hY,
                        String... parameters)
                 throws MathIllegalArgumentException

Deprecated.

Simple constructor for a secondary equations set computing Jacobian matrices.

Parameters must belong to the supported ones given by Parameterizable.getParametersNames(), so the primary set of differential equations must be Parameterizable.

Note that each selection clears the previous selected parameters.

Parameters:

fode - the primary first order differential equations set to extend

hY - step used for finite difference computation with respect to state vector

parameters - parameters to consider for Jacobian matrices processing (may be null if parameters Jacobians is not desired)

Throws:

MathIllegalArgumentException - if there is a dimension mismatch between the steps array hY and the equation dimension

JacobianMatrices

public JacobianMatrices(MainStateJacobianProvider jode,
                        String... parameters)

Deprecated.

Simple constructor for a secondary equations set computing Jacobian matrices.

Parameters must belong to the supported ones given by Parameterizable.getParametersNames(), so the primary set of differential equations must be Parameterizable.

Note that each selection clears the previous selected parameters.

Parameters:

jode - the primary first order differential equations set to extend

parameters - parameters to consider for Jacobian matrices processing (may be null if parameters Jacobians is not desired)

Method Detail

registerVariationalEquations

public void registerVariationalEquations(ExpandableODE expandable)
                                  throws MathIllegalArgumentException,
                                         JacobianMatrices.MismatchedEquations

Deprecated.

Register the variational equations for the Jacobians matrices to the expandable set.

This method must be called before setUpInitialState(ODEState)

Parameters:

expandable - expandable set into which variational equations should be registered

Throws:

MathIllegalArgumentException - if the dimension of the partial state does not match the selected equations set dimension

JacobianMatrices.MismatchedEquations - if the primary set of the expandable set does not match the one used to build the instance

See Also:

ExpandableODE.addSecondaryEquations(SecondaryODE), setUpInitialState(ODEState)

setUpInitialState

public ODEState setUpInitialState(ODEState initialState)

Deprecated.

Set up initial state.

This method inserts the initial Jacobian matrices data into an ODE state by overriding the additional state components corresponding to the instance. It must be called prior to integrate the equations.

This method must be called after registerVariationalEquations(ExpandableODE), setInitialMainStateJacobian(double[][]) and setInitialParameterJacobian(String, double[]).

Parameters:

initialState - initial state, without the initial Jacobians matrices

Returns:

a new instance of initial state, with the initial Jacobians matrices properly initialized

addParameterJacobianProvider

public void addParameterJacobianProvider(NamedParameterJacobianProvider provider)

Deprecated.

Add a parameter Jacobian provider.

Parameters:

provider - the parameter Jacobian provider to compute exactly the parameter Jacobian matrix

setParameterizedODE

@Deprecated
public void setParameterizedODE(ParametersController pc)

Deprecated. as of 1.0, replaced with setParametersController(ParametersController)

Set a parameter Jacobian provider.

Parameters:

pc - the controller to compute the parameter Jacobian matrix using finite differences

setParametersController

public void setParametersController(ParametersController parametersController)

Deprecated.

Set a parameter Jacobian provider.

Parameters:

parametersController - the controller to compute the parameter Jacobian matrix using finite differences

setParameterStep

public void setParameterStep(String parameter,
                             double hP)
                      throws MathIllegalArgumentException

Deprecated.

Set the step associated to a parameter in order to compute by finite difference the Jacobian matrix.

Needed if and only if the primary ODE set is a ParametersController.

Given a non zero parameter value pval for the parameter, a reasonable value for such a step is pval * FastMath.sqrt(Precision.EPSILON).

A zero value for such a step doesn't enable to compute the parameter Jacobian matrix.

Parameters:

parameter - parameter to consider for Jacobian processing

hP - step for Jacobian finite difference computation w.r.t. the specified parameter

Throws:

MathIllegalArgumentException - if the parameter is not supported

See Also:

ParametersController

setInitialMainStateJacobian

public void setInitialMainStateJacobian(double[][] dYdY0)
                                 throws MathIllegalArgumentException

Deprecated.

Set the initial value of the Jacobian matrix with respect to state.

If this method is not called, the initial value of the Jacobian matrix with respect to state is set to identity.

This method must be called before setUpInitialState(ODEState)

Parameters:

dYdY0 - initial Jacobian matrix w.r.t. state

Throws:

MathIllegalArgumentException - if matrix dimensions are incorrect

setInitialParameterJacobian

public void setInitialParameterJacobian(String pName,
                                        double[] dYdP)
                                 throws MathIllegalArgumentException

Deprecated.

Set the initial value of a column of the Jacobian matrix with respect to one parameter.

If this method is not called for some parameter, the initial value of the column of the Jacobian matrix with respect to this parameter is set to zero.

This method must be called before setUpInitialState(ODEState)

Parameters:

pName - parameter name

dYdP - initial Jacobian column vector with respect to the parameter

Throws:

MathIllegalArgumentException - if a parameter is not supported

MathIllegalArgumentException - if the column vector does not match state dimension

extractMainSetJacobian

public double[][] extractMainSetJacobian(ODEState state)

Deprecated.

Extract the Jacobian matrix with respect to state.

Parameters:

state - state from which to extract Jacobian matrix

Returns:

Jacobian matrix dY/dY0 with respect to state.

extractParameterJacobian

public double[] extractParameterJacobian(ODEState state,
                                         String pName)

Deprecated.

Extract the Jacobian matrix with respect to one parameter.

Parameters:

state - state from which to extract Jacobian matrix

pName - name of the parameter for the computed Jacobian matrix

Returns:

Jacobian matrix dY/dP with respect to the named parameter