程序包 org.hipparchus.ode.events

类 AbstractODEDetector<T extends AbstractODEDetector<T>>

java.lang.Object
org.hipparchus.ode.events.AbstractODEDetector<T>
类型参数:
T - 检测器的类型
所有已实现的接口:
ODEEventDetector
直接已知子类:
EventSlopeFilter, StepProblem
public abstract class AbstractODEDetector<T extends AbstractODEDetector<T>> extends Object implements ODEEventDetector
基类为#@link ODEEventDetector。
从以下版本开始:
3.0

  • 字段详细资料

    • DEFAULT_MAXCHECK

      public static final double DEFAULT_MAXCHECK
      默认最大检查间隔（秒）。
      另请参阅:

    • DEFAULT_THRESHOLD

      public static final double DEFAULT_THRESHOLD
      默认收敛阈值（秒）。
      另请参阅:

    • DEFAULT_MAX_ITER

      public static final int DEFAULT_MAX_ITER
      事件时间搜索中的默认最大迭代次数。
      另请参阅:

  • 构造器详细资料

    • AbstractODEDetector

      protected AbstractODEDetector(AdaptableInterval maxCheck, int maxIter, BracketedUnivariateSolver<UnivariateFunction> solver, ODEEventHandler handler)
      构建一个新实例。
      参数:
      maxCheck - 最大检查间隔，必须严格为正（秒）
      maxIter - 事件时间搜索中的最大迭代次数
      solver - 用于检测状态事件的根查找算法
      handler - 事件发生时调用的事件处理器

  • 方法详细资料

    • init

      public void init(ODEStateAndDerivative s0, double t)
      在ODE积分开始时初始化事件处理器。

      此方法在积分开始时调用一次。如果需要，事件处理器可以用于初始化一些内部数据。

      默认实现不执行任何操作

      此实现设置积分的方向并初始化事件处理器。如果子类覆盖此方法，则应调用 super.init(s0, t)。

      指定者:
      init 在接口中 ODEEventDetector
      参数:
      s0 - 初始时间、状态向量和导数
      t - 积分的目标时间

    • g

      public abstract double g(ODEStateAndDerivative s)
      计算切换函数的值。

      离散事件在此切换函数的符号变化时生成。积分器将确保以这种方式改变步长，使这些事件恰好发生在步长边界上。切换函数在其根邻域内必须连续（但不一定平滑），因为积分器需要找到其根以精确定位事件。

      还要注意，为了使积分器检测到事件，切换函数的符号在事件之前和之后必须相反。如果不保持这种一致性，则积分器可能不会检测到任何事件。

      这种一致性有时很难实现。一个典型的例子是使用事件来模拟球在地板上弹跳。表示这一点的第一个想法是g(state) = h(state)，其中h是时间state.getTime()时的地板上方的高度。当g(state)达到0时，球在地板上，因此应该弹起，通常的方法是反转其垂直速度。然而，这意味着在事件之前g(state)从正值减少到0，而在事件之后g(state)将从0增加到正值。这里破坏了一致性！解决方案是g(state) = sign * h(state)，其中sign是一个变量，初始值设置为+1。每次调用eventOccurred时，sign重置为-sign。这允许g(state)函数保持连续（甚至平滑），即使跨事件，尽管h(state)不是。基本上，事件用于在弹跳点处折叠h(state)，而sign用于展开它，因此求解器看到的是一个g(state)函数，即使跨事件也表现平滑。

      此方法是幂等的，即多次使用相同状态调用此方法将导致相同的值，但有两个例外。首先，当处理程序上的事件发生时，切换函数的定义可能会更改，就像上面的示例中那样。其次，当同一积分器中的任何其他事件处理程序的eventOccurred方法返回Action.RESET_EVENTS、Action.RESET_DERIVATIVES或Action.RESET_STATE时，切换函数的定义可能会更改。

      指定者:
      g 在接口中 ODEEventDetector
      参数:
      s - 独立时间变量的当前值、状态向量和导数
      返回:
      切换函数g的值
      另请参阅:

    • getMaxCheckInterval

      public AdaptableInterval getMaxCheckInterval()
      获取事件处理程序检查之间的最大时间间隔。
      指定者:
      getMaxCheckInterval 在接口中 ODEEventDetector
      返回:
      事件处理程序检查之间的最大时间间隔

    • getMaxIterationCount

      public int getMaxIterationCount()
      获取事件本地化的迭代计数的上限。
      指定者:
      getMaxIterationCount 在接口中 ODEEventDetector
      返回:
      事件本地化的迭代计数的上限

    • getSolver

      public BracketedUnivariateSolver<UnivariateFunction> getSolver()
      获取用于检测状态事件的根查找算法。
      指定者:
      getSolver 在接口中 ODEEventDetector
      返回:
      用于检测状态事件的根查找算法

    • withMaxCheck

      public T withMaxCheck(double newMaxCheck)
      设置最大检查间隔。

      如果之前已配置最大检查间隔，则将覆盖它。

      参数:
      newMaxCheck - 最大检查间隔
      返回:
      更新配置的新探测器（实例未更改）

    • withMaxCheck

      public T withMaxCheck(AdaptableInterval newMaxCheck)
      设置最大检查间隔。

      如果之前已配置最大检查间隔，则将覆盖它。

      参数:
      newMaxCheck - 最大检查间隔
      返回:
      更新配置的新探测器（实例未更改）
      从以下版本开始:
      3.0

    • withMaxIter

      public T withMaxIter(int newMaxIter)
      设置事件时间搜索中的最大迭代次数。

      如果之前已配置迭代次数，则将覆盖它。

      参数:
      newMaxIter - 事件时间搜索中的最大迭代次数
      返回:
      更新配置的新探测器（实例未更改）

    • withThreshold

      public T withThreshold(double newThreshold)
      设置收敛阈值。

      这相当于调用withSolver(new BracketingNthOrderBrentSolver(0, newThreshold, 0, 5))，因此如果之前已配置求解器，则将覆盖它。

      参数:
      newThreshold - 收敛阈值
      返回:
      更新配置的新探测器（实例未更改）
      另请参阅:

    • withSolver

      public T withSolver(BracketedUnivariateSolver<UnivariateFunction> newSolver)
      设置用于检测状态事件的根查找算法。

      如果之前已配置求解器，则将覆盖它。

      参数:
      newSolver - 用于检测状态事件的根查找算法
      返回:
      更新配置的新探测器（实例未更改）
      另请参阅:

    • withHandler

      public T withHandler(ODEEventHandler newHandler)
      设置事件发生时要调用的事件处理程序。

      如果之前已配置处理程序，则将覆盖它。

      参数:
      newHandler - 事件发生时要调用的事件处理程序
      返回:
      更新配置的新探测器（实例未更改）

    • getHandler

      public ODEEventHandler getHandler()
      获取基础事件处理程序。
      指定者:
      getHandler 在接口中 ODEEventDetector
      返回:
      基础事件处理程序

    • create

      protected abstract T create(AdaptableInterval newMaxCheck, int newmaxIter, BracketedUnivariateSolver<UnivariateFunction> newSolver, ODEEventHandler newHandler)
      构建一个新实例。
      参数:
      newMaxCheck - 最大检查间隔
      newmaxIter - 事件时间搜索中的最大迭代次数
      newSolver - 用于检测状态事件的根查找算法
      newHandler - 事件发生时要调用的事件处理程序
      返回:
      适当子类型的新实例

    • isForward

      public boolean isForward()
      检查当前传播是向前还是向后。
      返回:
      如果当前传播是向前，则为true