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 getInterpolatedState
method to retrieve this information at any time. It is important to wait
for the integration to be over before attempting to call getInterpolatedState(RealFieldElement) 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.
One should be aware that the amount of data stored in a
ContinuousOutputFieldModel 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).
FieldStepHandler, FieldStepInterpolator
| Modifier and Type | Field and Description |
|---|---|
| private T | finalTime
Final integration time. |
| private boolean | forward
Integration direction indicator. |
| private int | index
Current interpolator index. |
| private T | initialTime
Initial integration time. |
| private List | steps
Steps table. |
| Access | Constructor and Description |
|---|---|
| public |
| Modifier and Type | Method and Description |
|---|---|
| public void | append(final ContinuousOutputFieldModel<T>
model to add at the end of the instance model)Append another model at the end of the instance. |
| private void | checkDimensionsEquality(final int
first dimension d1, final int second dimansion d2)Check dimensions equality. |
| public T | |
| public T | |
| public FieldODEStateAndDerivative | Returns: state at interpolated timetime of the interpolated point time)Get the state at interpolated time. |
| public void | handleStep(final FieldStepInterpolator<T>
interpolator for the last accepted step. interpolator, final boolean true if the step is the last one isLast)Implements org. Handle the last accepted step. |
| public void | init(final FieldODEStateAndDerivative<T>
initial time, state vector and derivative initialState, final T target time for the integration t)Implements org. Initialize step handler at the start of an ODE integration. |
| private int | Returns: -1 if the double is before the interval, 0 if it is in the interval, and +1 if it is after the interval, according to the interval directionpoint to locate time, final FieldStepInterpolator<T> step interval interval)Compare a step interval and a double. |
| finalTime | back to summary |
|---|---|
| private T finalTime Final integration time. | |
| forward | back to summary |
|---|---|
| private boolean forward Integration direction indicator. | |
| index | back to summary |
|---|---|
| private int index Current interpolator index. | |
| initialTime | back to summary |
|---|---|
| private T initialTime Initial integration time. | |
| steps | back to summary |
|---|---|
| private List<FieldStepInterpolator<T>> steps Steps table. | |
| ContinuousOutputFieldModel | back to summary |
|---|---|
| public ContinuousOutputFieldModel() Simple constructor. Build an empty continuous output model. | |
| append | back to summary |
|---|---|
| public void append(final ContinuousOutputFieldModel<T> model) throws MathIllegalArgumentException, MaxCountExceededException Append another model at the end of the instance.
| |
| checkDimensionsEquality | back to summary |
|---|---|
| private void checkDimensionsEquality(final int d1, final int d2) throws DimensionMismatchException Check dimensions equality.
| |
| getFinalTime | back to summary |
|---|---|
| public T getFinalTime() Get the final integration time.
| |
| getInitialTime | back to summary |
|---|---|
| public T getInitialTime() Get the initial integration time.
| |
| getInterpolatedState | back to summary |
|---|---|
| public FieldODEStateAndDerivative Get the state at interpolated time.
| |
| handleStep | back to summary |
|---|---|
| public void handleStep(final FieldStepInterpolator<T> interpolator, final boolean isLast) throws MaxCountExceededException Implements org. Handle the last accepted step. A copy of the information provided by the last step is stored in the instance for later use.
| |
| init | back to summary |
|---|---|
| public void init(final FieldODEStateAndDerivative<T> initialState, final T t) Implements org. Doc from org. Initialize step handler at the start of an ODE integration. This method is called once at the start of the integration. It may be used by the step handler to initialize some internal data if needed.
| |
| locatePoint | back to summary |
|---|---|
| private int locatePoint(final T time, final FieldStepInterpolator<T> interval) Compare a step interval and a double.
| |