Class FieldStepNormalizer<T extends CalculusFieldElement<T>>
- Type Parameters:
T
- the type of the field elements
- All Implemented Interfaces:
FieldODEStepHandler<T>
FieldODEFixedStepHandler
into a FieldODEStepHandler
.
This wrapper allows to use fixed step handlers with general integrators which cannot guaranty their integration steps will remain constant and therefore only accept general step handlers.
The stepsize used is selected at construction time. The handleStep
method of the underlying
FieldODEFixedStepHandler
object is called at normalized times. The
normalized times can be influenced by the StepNormalizerMode
and
StepNormalizerBounds
.
There is no constraint on the integrator, it can use any time step it needs (time steps longer or shorter than the fixed time step and non-integer ratios are all allowed).
Start time | End time | Direction | Mode |
Bounds | Output |
0.3 | 3.1 | forward | INCREMENT | NEITHER | 0.8, 1.3, 1.8, 2.3, 2.8 |
0.3 | 3.1 | forward | INCREMENT | FIRST | 0.3, 0.8, 1.3, 1.8, 2.3, 2.8 |
0.3 | 3.1 | forward | INCREMENT | LAST | 0.8, 1.3, 1.8, 2.3, 2.8, 3.1 |
0.3 | 3.1 | forward | INCREMENT | BOTH | 0.3, 0.8, 1.3, 1.8, 2.3, 2.8, 3.1 |
0.3 | 3.1 | forward | MULTIPLES | NEITHER | 0.5, 1.0, 1.5, 2.0, 2.5, 3.0 |
0.3 | 3.1 | forward | MULTIPLES | FIRST | 0.3, 0.5, 1.0, 1.5, 2.0, 2.5, 3.0 |
0.3 | 3.1 | forward | MULTIPLES | LAST | 0.5, 1.0, 1.5, 2.0, 2.5, 3.0, 3.1 |
0.3 | 3.1 | forward | MULTIPLES | BOTH | 0.3, 0.5, 1.0, 1.5, 2.0, 2.5, 3.0, 3.1 |
0.0 | 3.0 | forward | INCREMENT | NEITHER | 0.5, 1.0, 1.5, 2.0, 2.5, 3.0 |
0.0 | 3.0 | forward | INCREMENT | FIRST | 0.0, 0.5, 1.0, 1.5, 2.0, 2.5, 3.0 |
0.0 | 3.0 | forward | INCREMENT | LAST | 0.5, 1.0, 1.5, 2.0, 2.5, 3.0 |
0.0 | 3.0 | forward | INCREMENT | BOTH | 0.0, 0.5, 1.0, 1.5, 2.0, 2.5, 3.0 |
0.0 | 3.0 | forward | MULTIPLES | NEITHER | 0.5, 1.0, 1.5, 2.0, 2.5, 3.0 |
0.0 | 3.0 | forward | MULTIPLES | FIRST | 0.0, 0.5, 1.0, 1.5, 2.0, 2.5, 3.0 |
0.0 | 3.0 | forward | MULTIPLES | LAST | 0.5, 1.0, 1.5, 2.0, 2.5, 3.0 |
0.0 | 3.0 | forward | MULTIPLES | BOTH | 0.0, 0.5, 1.0, 1.5, 2.0, 2.5, 3.0 |
3.1 | 0.3 | backward | INCREMENT | NEITHER | 2.6, 2.1, 1.6, 1.1, 0.6 |
3.1 | 0.3 | backward | INCREMENT | FIRST | 3.1, 2.6, 2.1, 1.6, 1.1, 0.6 |
3.1 | 0.3 | backward | INCREMENT | LAST | 2.6, 2.1, 1.6, 1.1, 0.6, 0.3 |
3.1 | 0.3 | backward | INCREMENT | BOTH | 3.1, 2.6, 2.1, 1.6, 1.1, 0.6, 0.3 |
3.1 | 0.3 | backward | MULTIPLES | NEITHER | 3.0, 2.5, 2.0, 1.5, 1.0, 0.5 |
3.1 | 0.3 | backward | MULTIPLES | FIRST | 3.1, 3.0, 2.5, 2.0, 1.5, 1.0, 0.5 |
3.1 | 0.3 | backward | MULTIPLES | LAST | 3.0, 2.5, 2.0, 1.5, 1.0, 0.5, 0.3 |
3.1 | 0.3 | backward | MULTIPLES | BOTH | 3.1, 3.0, 2.5, 2.0, 1.5, 1.0, 0.5, 0.3 |
3.0 | 0.0 | backward | INCREMENT | NEITHER | 2.5, 2.0, 1.5, 1.0, 0.5, 0.0 |
3.0 | 0.0 | backward | INCREMENT | FIRST | 3.0, 2.5, 2.0, 1.5, 1.0, 0.5, 0.0 |
3.0 | 0.0 | backward | INCREMENT | LAST | 2.5, 2.0, 1.5, 1.0, 0.5, 0.0 |
3.0 | 0.0 | backward | INCREMENT | BOTH | 3.0, 2.5, 2.0, 1.5, 1.0, 0.5, 0.0 |
3.0 | 0.0 | backward | MULTIPLES | NEITHER | 2.5, 2.0, 1.5, 1.0, 0.5, 0.0 |
3.0 | 0.0 | backward | MULTIPLES | FIRST | 3.0, 2.5, 2.0, 1.5, 1.0, 0.5, 0.0 |
3.0 | 0.0 | backward | MULTIPLES | LAST | 2.5, 2.0, 1.5, 1.0, 0.5, 0.0 |
3.0 | 0.0 | backward | MULTIPLES | BOTH | 3.0, 2.5, 2.0, 1.5, 1.0, 0.5, 0.0 |
-
Constructor Summary
ConstructorDescriptionFieldStepNormalizer
(double h, FieldODEFixedStepHandler<T> handler) Simple constructor.FieldStepNormalizer
(double h, FieldODEFixedStepHandler<T> handler, StepNormalizerBounds bounds) Simple constructor.FieldStepNormalizer
(double h, FieldODEFixedStepHandler<T> handler, StepNormalizerMode mode) Simple constructor.FieldStepNormalizer
(double h, FieldODEFixedStepHandler<T> handler, StepNormalizerMode mode, StepNormalizerBounds bounds) Simple constructor. -
Method Summary
Modifier and TypeMethodDescriptionvoid
finish
(FieldODEStateAndDerivative<T> finalState) Finalize integration.void
handleStep
(FieldODEStateInterpolator<T> interpolator) Handle the last accepted step.void
init
(FieldODEStateAndDerivative<T> initialState, T finalTime) Initialize step handler at the start of an ODE integration.
-
Constructor Details
-
FieldStepNormalizer
- Parameters:
h
- fixed time step (sign is not used)handler
- fixed time step handler to wrap
-
FieldStepNormalizer
Simple constructor. UsesFIRST
bounds setting.- Parameters:
h
- fixed time step (sign is not used)handler
- fixed time step handler to wrapmode
- step normalizer mode to use
-
FieldStepNormalizer
public FieldStepNormalizer(double h, FieldODEFixedStepHandler<T> handler, StepNormalizerBounds bounds) Simple constructor. UsesINCREMENT
mode.- Parameters:
h
- fixed time step (sign is not used)handler
- fixed time step handler to wrapbounds
- step normalizer bounds setting to use
-
FieldStepNormalizer
public FieldStepNormalizer(double h, FieldODEFixedStepHandler<T> handler, StepNormalizerMode mode, StepNormalizerBounds bounds) Simple constructor.- Parameters:
h
- fixed time step (sign is not used)handler
- fixed time step handler to wrapmode
- step normalizer mode to usebounds
- step normalizer bounds setting to use
-
-
Method Details
-
init
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.
The default implementation does nothing.
- Specified by:
init
in interfaceFieldODEStepHandler<T extends CalculusFieldElement<T>>
- Parameters:
initialState
- initial time, state vector and derivativefinalTime
- target time for the integration
-
handleStep
Handle the last accepted step.- Specified by:
handleStep
in interfaceFieldODEStepHandler<T extends CalculusFieldElement<T>>
- Parameters:
interpolator
- interpolator for the last accepted step
-
finish
Finalize integration.- Specified by:
finish
in interfaceFieldODEStepHandler<T extends CalculusFieldElement<T>>
- Parameters:
finalState
- state at integration end
-