|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
public interface StepInterpolator
This interface represents an interpolator over the last step during an ODE integration.
The various ODE integrators provide objects implementing this interface to the step handlers. These objects are often custom objects tightly bound to the integrator internal algorithms. The handlers can use these objects to retrieve the state vector at intermediate times between the previous and the current grid points (this feature is often called dense output).
FirstOrderIntegrator
,
SecondOrderIntegrator
,
StepHandler
Method Summary | |
---|---|
StepInterpolator |
copy()
Copy the instance. |
double |
getCurrentTime()
Get the current grid point time. |
double[] |
getInterpolatedState()
Get the state vector of the interpolated point. |
double |
getInterpolatedTime()
Get the time of the interpolated point. |
double |
getPreviousTime()
Get the previous grid point time. |
boolean |
isForward()
Check if the natural integration direction is forward. |
void |
setInterpolatedTime(double time)
Set the time of the interpolated point. |
Methods inherited from interface java.io.Externalizable |
---|
readExternal, writeExternal |
Method Detail |
---|
double getPreviousTime()
double getCurrentTime()
double getInterpolatedTime()
setInterpolatedTime(double)
has not been called, it returns
the current grid point time.
void setInterpolatedTime(double time) throws DerivativeException
Setting the time outside of the current step is now allowed, but should be used with care since the accuracy of the interpolator will probably be very poor far from this step. This allowance has been added to simplify implementation of search algorithms near the step endpoints.
Setting the time changes the instance internal state. If a
specific state must be preserved, a copy of the instance must be
created using copy()
.
time
- time of the interpolated point
DerivativeException
- if this call induces an automatic
step finalization that throws onedouble[] getInterpolatedState()
getInterpolatedTime()
boolean isForward()
This method provides the integration direction as specified by the integrator itself, it avoid some nasty problems in degenerated cases like null steps due to cancellation at step initialization, step control or switching function triggering.
StepInterpolator copy() throws DerivativeException
The copied instance is guaranteed to be independent from the original one. Both can be used with different settings for interpolated time without any side effect.
DerivativeException
- if this call induces an automatic
step finalization that throws onesetInterpolatedTime(double)
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |