Interface StepInterpolatorWithJacobians

  • All Superinterfaces:
    java.io.Externalizable, java.io.Serializable

    @Deprecated
    public interface StepInterpolatorWithJacobians
    extends java.io.Externalizable
    Deprecated.
    as of 2.2 the complete package is deprecated, it will be replaced in 3.0 by a completely rewritten implementation
    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).

    One important thing to note is that the step handlers may be so tightly bound to the integrators that they often share some internal state arrays. This imply that one should never use a direct reference to a step interpolator outside of the step handler, either for future use or for use in another thread. If such a need arise, the step interpolator must be copied using the dedicated copy() method.

    Since:
    2.1
    See Also:
    FirstOrderIntegratorWithJacobians, StepHandlerWithJacobians
    • Method Summary

      All Methods Instance Methods Abstract Methods Deprecated Methods 
      Modifier and Type Method Description
      StepInterpolatorWithJacobians copy()
      Deprecated.
      Copy the instance.
      double getCurrentTime()
      Deprecated.
      Get the current grid point time.
      double[][] getInterpolatedDyDp()
      Deprecated.
      Get the partial derivatives of the state vector with respect to the ODE parameters of the interpolated point.
      double[][] getInterpolatedDyDpDot()
      Deprecated.
      Get the time derivatives of the jacobian of the state vector with respect to the ODE parameters of the interpolated point.
      double[][] getInterpolatedDyDy0()
      Deprecated.
      Get the partial derivatives of the state vector with respect to the initial state of the interpolated point.
      double[][] getInterpolatedDyDy0Dot()
      Deprecated.
      Get the time derivatives of the jacobian of the state vector with respect to the initial state of the interpolated point.
      double getInterpolatedTime()
      Deprecated.
      Get the time of the interpolated point.
      double[] getInterpolatedY()
      Deprecated.
      Get the state vector of the interpolated point.
      double[] getInterpolatedYDot()
      Deprecated.
      Get the time derivatives of the state vector of the interpolated point.
      double getPreviousTime()
      Deprecated.
      Get the previous grid point time.
      boolean isForward()
      Deprecated.
      Check if the natural integration direction is forward.
      void setInterpolatedTime​(double time)
      Deprecated.
      Set the time of the interpolated point.
      • Methods inherited from interface java.io.Externalizable

        readExternal, writeExternal
    • Method Detail

      • getPreviousTime

        double getPreviousTime()
        Deprecated.
        Get the previous grid point time.
        Returns:
        previous grid point time
      • getCurrentTime

        double getCurrentTime()
        Deprecated.
        Get the current grid point time.
        Returns:
        current grid point time
      • getInterpolatedTime

        double getInterpolatedTime()
        Deprecated.
        Get the time of the interpolated point. If setInterpolatedTime(double) has not been called, it returns the current grid point time.
        Returns:
        interpolation point time
      • setInterpolatedTime

        void setInterpolatedTime​(double time)
        Deprecated.
        Set the time of the interpolated point.

        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().

        Parameters:
        time - time of the interpolated point
      • getInterpolatedY

        double[] getInterpolatedY()
                           throws DerivativeException
        Deprecated.
        Get the state vector of the interpolated point.

        The returned vector is a reference to a reused array, so it should not be modified and it should be copied if it needs to be preserved across several calls.

        Returns:
        state vector at time getInterpolatedTime()
        Throws:
        DerivativeException - if this call induces an automatic step finalization that throws one
        See Also:
        getInterpolatedYDot()
      • getInterpolatedDyDy0

        double[][] getInterpolatedDyDy0()
                                 throws DerivativeException
        Deprecated.
        Get the partial derivatives of the state vector with respect to the initial state of the interpolated point.

        The returned vector is a reference to a reused array, so it should not be modified and it should be copied if it needs to be preserved across several calls.

        Returns:
        partial derivatives of the state vector with respect to the initial state at time getInterpolatedTime()
        Throws:
        DerivativeException - if this call induces an automatic step finalization that throws one
        See Also:
        getInterpolatedY()
      • getInterpolatedDyDp

        double[][] getInterpolatedDyDp()
                                throws DerivativeException
        Deprecated.
        Get the partial derivatives of the state vector with respect to the ODE parameters of the interpolated point.

        The returned vector is a reference to a reused array, so it should not be modified and it should be copied if it needs to be preserved across several calls.

        Returns:
        partial derivatives of the state vector with respect to the ODE parameters at time getInterpolatedTime()
        Throws:
        DerivativeException - if this call induces an automatic step finalization that throws one
        See Also:
        getInterpolatedY()
      • getInterpolatedYDot

        double[] getInterpolatedYDot()
                              throws DerivativeException
        Deprecated.
        Get the time derivatives of the state vector of the interpolated point.

        The returned vector is a reference to a reused array, so it should not be modified and it should be copied if it needs to be preserved across several calls.

        Returns:
        derivatives of the state vector at time getInterpolatedTime()
        Throws:
        DerivativeException - if this call induces an automatic step finalization that throws one
        See Also:
        getInterpolatedY()
      • getInterpolatedDyDy0Dot

        double[][] getInterpolatedDyDy0Dot()
                                    throws DerivativeException
        Deprecated.
        Get the time derivatives of the jacobian of the state vector with respect to the initial state of the interpolated point.

        The returned vector is a reference to a reused array, so it should not be modified and it should be copied if it needs to be preserved across several calls.

        Returns:
        time derivatives of the jacobian of the state vector with respect to the initial state at time getInterpolatedTime()
        Throws:
        DerivativeException - if this call induces an automatic step finalization that throws one
        See Also:
        getInterpolatedY()
      • getInterpolatedDyDpDot

        double[][] getInterpolatedDyDpDot()
                                   throws DerivativeException
        Deprecated.
        Get the time derivatives of the jacobian of the state vector with respect to the ODE parameters of the interpolated point.

        The returned vector is a reference to a reused array, so it should not be modified and it should be copied if it needs to be preserved across several calls.

        Returns:
        time derivatives of the jacobian of the state vector with respect to the ODE parameters at time getInterpolatedTime()
        Throws:
        DerivativeException - if this call induces an automatic step finalization that throws one
        See Also:
        getInterpolatedY()
      • isForward

        boolean isForward()
        Deprecated.
        Check if the natural integration direction is forward.

        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 discrete events triggering.

        Returns:
        true if the integration variable (time) increases during integration
      • copy

        StepInterpolatorWithJacobians copy()
                                    throws DerivativeException
        Deprecated.
        Copy the instance.

        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.

        Returns:
        a deep copy of the instance, which can be used independently.
        Throws:
        DerivativeException - if this call induces an automatic step finalization that throws one
        See Also:
        setInterpolatedTime(double)