Class StepNormalizer

    • Field Detail

      • h

        private double h
        Fixed time step.
      • firstTime

        private double firstTime
        First step time.
      • lastTime

        private double lastTime
        Last step time.
      • lastState

        private double[] lastState
        Last state vector.
      • lastDerivatives

        private double[] lastDerivatives
        Last derivatives vector.
      • forward

        private boolean forward
        Integration direction indicator.
    • Constructor Detail

      • StepNormalizer

        public StepNormalizer​(double h,
                              FixedStepHandler handler)
        Simple constructor. Uses INCREMENT mode, and FIRST bounds setting, for backwards compatibility.
        Parameters:
        h - fixed time step (sign is not used)
        handler - fixed time step handler to wrap
      • StepNormalizer

        public StepNormalizer​(double h,
                              FixedStepHandler handler,
                              StepNormalizerMode mode)
        Simple constructor. Uses FIRST bounds setting.
        Parameters:
        h - fixed time step (sign is not used)
        handler - fixed time step handler to wrap
        mode - step normalizer mode to use
        Since:
        3.0
      • StepNormalizer

        public StepNormalizer​(double h,
                              FixedStepHandler handler,
                              StepNormalizerBounds bounds)
        Simple constructor. Uses INCREMENT mode.
        Parameters:
        h - fixed time step (sign is not used)
        handler - fixed time step handler to wrap
        bounds - step normalizer bounds setting to use
        Since:
        3.0
      • StepNormalizer

        public StepNormalizer​(double h,
                              FixedStepHandler handler,
                              StepNormalizerMode mode,
                              StepNormalizerBounds bounds)
        Simple constructor.
        Parameters:
        h - fixed time step (sign is not used)
        handler - fixed time step handler to wrap
        mode - step normalizer mode to use
        bounds - step normalizer bounds setting to use
        Since:
        3.0
    • Method Detail

      • init

        public void init​(double t0,
                         double[] y0,
                         double t)
        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.

        Specified by:
        init in interface StepHandler
        Parameters:
        t0 - start value of the independent time variable
        y0 - array containing the start value of the state vector
        t - target time for the integration
      • handleStep

        public void handleStep​(StepInterpolator interpolator,
                               boolean isLast)
                        throws MaxCountExceededException
        Handle the last accepted step
        Specified by:
        handleStep in interface StepHandler
        Parameters:
        interpolator - interpolator for the last accepted step. For efficiency purposes, the various integrators reuse the same object on each call, so if the instance wants to keep it across all calls (for example to provide at the end of the integration a continuous model valid throughout the integration range), it should build a local copy using the clone method and store this copy.
        isLast - true if the step is the last one
        Throws:
        MaxCountExceededException - if the interpolator throws one because the number of functions evaluations is exceeded
      • isNextInStep

        private boolean isNextInStep​(double nextTime,
                                     StepInterpolator interpolator)
        Returns a value indicating whether the next normalized time is in the current step.
        Parameters:
        nextTime - the next normalized time
        interpolator - interpolator for the last accepted step, to use to get the end time of the current step
        Returns:
        value indicating whether the next normalized time is in the current step
      • doNormalizedStep

        private void doNormalizedStep​(boolean isLast)
        Invokes the underlying step handler for the current normalized step.
        Parameters:
        isLast - true if the step is the last one
      • storeStep

        private void storeStep​(StepInterpolator interpolator,
                               double t)
                        throws MaxCountExceededException
        Stores the interpolated information for the given time in the current state.
        Parameters:
        interpolator - interpolator for the last accepted step, to use to get the interpolated information
        t - the time for which to store the interpolated information
        Throws:
        MaxCountExceededException - if the interpolator throws one because the number of functions evaluations is exceeded