Class ContinuousOutputModel
- java.lang.Object
-
- org.hipparchus.ode.DenseOutputModel
-
- org.hipparchus.migration.ode.ContinuousOutputModel
-
- All Implemented Interfaces:
Serializable
,ODEStepHandler
@Deprecated public class ContinuousOutputModel extends DenseOutputModel
Deprecated.as of 1.0, replaced withDenseOutputModel
This class stores all information provided by an ODE integrator during the integration process and build a continuous model of the solution from this.This class act as a step handler from the integrator point of view. It is called iteratively during the integration process and stores a copy of all steps information in a sorted collection for later use. Once the integration process is over, the user can use the
setInterpolatedTime
andgetInterpolatedState
to retrieve this information at any time. It is important to wait for the integration to be over before attempting to callsetInterpolatedTime
because some internal variables are set only once the last step has been handled.This is useful for example if the main loop of the user application should remain independent from the integration process or if one needs to mimic the behaviour of an analytical model despite a numerical model is used (i.e. one needs the ability to get the model value at any time or to navigate through the data).
If problem modeling is done with several separate integration phases for contiguous intervals, the same ContinuousOutputModel can be used as step handler for all integration phases as long as they are performed in order and in the same direction. As an example, one can extrapolate the trajectory of a satellite with one model (i.e. one set of differential equations) up to the beginning of a maneuver, use another more complex model including thrusters modeling and accurate attitude control during the maneuver, and revert to the first model after the end of the maneuver. If the same continuous output model handles the steps of all integration phases, the user do not need to bother when the maneuver begins or ends, he has all the data available in a transparent manner.
An important feature of this class is that it implements the
Serializable
interface. This means that the result of an integration can be serialized and reused later (if stored into a persistent medium like a filesystem or a database) or elsewhere (if sent to another application). Only the result of the integration is stored, there is no reference to the integrated problem by itself.One should be aware that the amount of data stored in a ContinuousOutputModel instance can be important if the state vector is large, if the integration interval is long or if the steps are small (which can result from small tolerance settings in
adaptive step size integrators
).- See Also:
StepHandler
,ODEStateInterpolator
, Serialized Form
-
-
Constructor Summary
Constructors Constructor Description ContinuousOutputModel()
Deprecated.Empty constructor.
-
Method Summary
All Methods Instance Methods Concrete Methods Deprecated Methods Modifier and Type Method Description double[]
getInterpolatedDerivatives()
Deprecated.Get the derivatives of the state vector of the interpolated point.double[]
getInterpolatedSecondaryDerivatives(int secondaryStateIndex)
Deprecated.Get the interpolated secondary derivatives corresponding to the secondary equations.double[]
getInterpolatedSecondaryState(int secondaryStateIndex)
Deprecated.Get the interpolated secondary state corresponding to the secondary equations.double[]
getInterpolatedState()
Deprecated.Get the state vector of the interpolated point.double
getInterpolatedTime()
Deprecated.Get the time of the interpolated point.void
setInterpolatedTime(double time)
Deprecated.Set the time of the interpolated point.-
Methods inherited from class org.hipparchus.ode.DenseOutputModel
append, finish, getFinalTime, getInitialTime, getInterpolatedState, handleStep, init
-
-
-
-
Method Detail
-
setInterpolatedTime
public void setInterpolatedTime(double time)
Deprecated.Set the time of the interpolated point.This method should not be called before the integration is over because some internal variables are set only once the last step has been handled.
Setting the time outside of the integration interval is now allowed, but should be used with care since the accuracy of the interpolator will probably be very poor far from this interval. This allowance has been added to simplify implementation of search algorithms near the interval endpoints.
Note that each time this method is called, the internal arrays returned in
getInterpolatedState()
,getInterpolatedDerivatives()
andgetInterpolatedSecondaryState(int)
will be overwritten. So if their content must be preserved across several calls, user must copy them.- Parameters:
time
- time of the interpolated point- See Also:
getInterpolatedState()
,getInterpolatedDerivatives()
,getInterpolatedSecondaryState(int)
-
getInterpolatedTime
public double getInterpolatedTime()
Deprecated.Get the time of the interpolated point. IfsetInterpolatedTime(double)
has not been called, it returns the final integration time.- Returns:
- interpolation point time
-
getInterpolatedState
public double[] getInterpolatedState() throws MathIllegalStateException
Deprecated.Get the state vector of the interpolated point.The returned vector is a reference to a reused array, so it should not be modified and it should be copied if it needs to be preserved across several calls to the associated
setInterpolatedTime(double)
method.- Returns:
- state vector at time
getInterpolatedTime()
- Throws:
MathIllegalStateException
- if the number of functions evaluations is exceeded- See Also:
setInterpolatedTime(double)
,getInterpolatedDerivatives()
,getInterpolatedSecondaryState(int)
,getInterpolatedSecondaryDerivatives(int)
-
getInterpolatedDerivatives
public double[] getInterpolatedDerivatives() throws MathIllegalStateException
Deprecated.Get the derivatives of the state vector of the interpolated point.The returned vector is a reference to a reused array, so it should not be modified and it should be copied if it needs to be preserved across several calls to the associated
setInterpolatedTime(double)
method.- Returns:
- derivatives of the state vector at time
getInterpolatedTime()
- Throws:
MathIllegalStateException
- if the number of functions evaluations is exceeded- See Also:
setInterpolatedTime(double)
,getInterpolatedState()
,getInterpolatedSecondaryState(int)
,getInterpolatedSecondaryDerivatives(int)
-
getInterpolatedSecondaryState
public double[] getInterpolatedSecondaryState(int secondaryStateIndex) throws MathIllegalStateException
Deprecated.Get the interpolated secondary state corresponding to the secondary equations.The returned vector is a reference to a reused array, so it should not be modified and it should be copied if it needs to be preserved across several calls to the associated
setInterpolatedTime(double)
method.- Parameters:
secondaryStateIndex
- index of the secondary set, as returned byExpandableODE.addSecondaryEquations(secondary)
- Returns:
- interpolated secondary state at the current interpolation date
- Throws:
MathIllegalStateException
- if the number of functions evaluations is exceeded- See Also:
setInterpolatedTime(double)
,getInterpolatedState()
,getInterpolatedDerivatives()
,getInterpolatedSecondaryDerivatives(int)
-
getInterpolatedSecondaryDerivatives
public double[] getInterpolatedSecondaryDerivatives(int secondaryStateIndex) throws MathIllegalStateException
Deprecated.Get the interpolated secondary derivatives corresponding to the secondary equations.The returned vector is a reference to a reused array, so it should not be modified and it should be copied if it needs to be preserved across several calls to the associated
setInterpolatedTime(double)
method.- Parameters:
secondaryStateIndex
- index of the secondary set, as returned byExpandableODE.addSecondaryEquations(secondary)
- Returns:
- interpolated secondary derivatives at the current interpolation date
- Throws:
MathIllegalStateException
- if the number of functions evaluations is exceeded- See Also:
setInterpolatedTime(double)
,getInterpolatedState()
,getInterpolatedDerivatives()
,getInterpolatedSecondaryState(int)
-
-