Interface EventState

All Known Implementing Classes:
DetectorBasedEventState, StepEndEventState

public interface EventState
This interface handles the state for either one event handler or one step end handler during integration steps.
Since:
3.0
  • Method Details

    • init

      void init(ODEStateAndDerivative s0, double t)
      Initialize handler at the start of an integration.

      This method is called once at the start of the integration. It may be used by the handler to initialize some internal data if needed.

      Parameters:
      s0 - initial state
      t - target time for the integration
    • getEventTime

      double getEventTime()
      Get the occurrence time of the event triggered in the current step.
      Returns:
      occurrence time of the event triggered in the current step or infinity if no events are triggered
    • evaluateStep

      Evaluate the impact of the proposed step on the handler.
      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 exceeded
      MathIllegalArgumentException - if the event cannot be bracketed
    • doEvent

      Notify the user's listener of the event. The event occurs wholly within this method call including a call to ODEEventHandler.resetState(ODEEventDetector, ODEStateAndDerivative) if necessary.
      Parameters:
      state - the state at the time of the event. This must be at the same time as the current value of getEventTime().
      Returns:
      the user's requested action and the new state if the action is Action.RESET_STATE. Otherwise the new state is state. The stop time indicates what time propagation should stop if the action is Action.STOP. This guarantees the integration will stop on or after the root, so that integration may be restarted safely.