Package org.hipparchus.ode.events
Class FieldDetectorBasedEventState<T extends CalculusFieldElement<T>>
java.lang.Object
org.hipparchus.ode.events.FieldDetectorBasedEventState<T>
- Type Parameters:
T
- the type of the field elements
- All Implemented Interfaces:
FieldEventState<T>
public class FieldDetectorBasedEventState<T extends CalculusFieldElement<T>>
extends Object
implements FieldEventState<T>
This class handles the state for one
event handler
during integration steps.
Each time the integrator proposes a step, the event handler switching function should be checked. This class handles the state of one handler during one integration step, with references to the state at the end of the preceding step. This information is used to decide if the handler should trigger an event or not during the proposed step.
-
Constructor Summary
ConstructorDescriptionFieldDetectorBasedEventState
(FieldODEEventDetector<T> detector) Simple constructor. -
Method Summary
Modifier and TypeMethodDescriptiondoEvent
(FieldODEStateAndDerivative<T> state) Notify the user's listener of the event.boolean
evaluateStep
(FieldODEStateInterpolator<T> interpolator) Evaluate the impact of the proposed step on the event handler.Get the underlying event detector.Get the occurrence time of the event triggered in the current step.void
init
(FieldODEStateAndDerivative<T> s0, T t) Initialize event handler at the start of an integration.void
reinitializeBegin
(FieldODEStateInterpolator<T> interpolator) Reinitialize the beginning of the step.boolean
tryAdvance
(FieldODEStateAndDerivative<T> state, FieldODEStateInterpolator<T> interpolator) Try to accept the current history up to the given time.
-
Constructor Details
-
FieldDetectorBasedEventState
Simple constructor.- Parameters:
detector
- event detector- Since:
- 3.0
-
-
Method Details
-
getEventDetector
Get the underlying event detector.- Returns:
- underlying event detector
- Since:
- 3.0
-
init
Initialize event handler at the start of an integration.This method is called once at the start of the integration. It may be used by the event handler to initialize some internal data if needed.
- Specified by:
init
in interfaceFieldEventState<T extends CalculusFieldElement<T>>
- Parameters:
s0
- initial statet
- target time for the integration
-
reinitializeBegin
public void reinitializeBegin(FieldODEStateInterpolator<T> interpolator) throws MathIllegalStateException Reinitialize the beginning of the step.- Parameters:
interpolator
- valid for the current step- Throws:
MathIllegalStateException
- if the interpolator throws one because the number of functions evaluations is exceeded
-
evaluateStep
public boolean evaluateStep(FieldODEStateInterpolator<T> interpolator) throws MathIllegalArgumentException, MathIllegalStateException Evaluate the impact of the proposed step on the event handler.- Specified by:
evaluateStep
in interfaceFieldEventState<T extends CalculusFieldElement<T>>
- Parameters:
interpolator
- step interpolator for the proposed step- Returns:
- true if the event handler triggers an event before the end of the proposed step
- Throws:
MathIllegalStateException
- if the interpolator throws one because the number of functions evaluations is exceededMathIllegalArgumentException
- if the event cannot be bracketed
-
tryAdvance
public boolean tryAdvance(FieldODEStateAndDerivative<T> state, FieldODEStateInterpolator<T> interpolator) Try to accept the current history up to the given time.It is not necessary to call this method before calling
doEvent(FieldODEStateAndDerivative)
with the same state. It is necessary to call this method before you calldoEvent(FieldODEStateAndDerivative)
on some other event detector.- Parameters:
state
- to try to accept.interpolator
- to use to find the new root, if any.- Returns:
- if the event detector has an event it has not detected before that is on or
before the same time as
state
. In other wordsfalse
means continue on whiletrue
means stop and handle my event first.
-
doEvent
Notify the user's listener of the event. The event occurs wholly within this method call including a call toFieldODEEventHandler.resetState(FieldODEEventDetector, FieldODEStateAndDerivative)
if necessary.- Specified by:
doEvent
in interfaceFieldEventState<T extends CalculusFieldElement<T>>
- Parameters:
state
- the state at the time of the event. This must be at the same time as the current value ofgetEventTime()
.- Returns:
- the user's requested action and the new state if the action is
Action.RESET_STATE
. Otherwise the new state isstate
. The stop time indicates what time propagation should stop if the action isAction.STOP
. This guarantees the integration will stop on or after the root, so that integration may be restarted safely.
-
getEventTime
Get the occurrence time of the event triggered in the current step.- Specified by:
getEventTime
in interfaceFieldEventState<T extends CalculusFieldElement<T>>
- Returns:
- occurrence time of the event triggered in the current step or infinity if no events are triggered
-