org.orekit.utils

Class TimeSpanMap<T>

java.lang.Object

org.orekit.utils.TimeSpanMap<T>

Type Parameters:

T - Type of the data.

public class TimeSpanMap<T>
extends Object

时间跨度映射的容器。

时间跨度映射可以被看作是一个有序的时间跨度集合，或者是一个有序的过渡集合。这两种视图是相互对偶的。一个时间跨度从一个过渡延伸到下一个过渡，而一个过渡将一个时间跨度与下一个时间跨度分开。每个时间跨度包含一个在该时间跨度内有效的条目；如果在该时间跨度内没有有效内容，则该条目可能为空。

TimeSpanMap的典型用途是保存分段数据，例如在升交点处变化的轨道计数（在这种情况下，条目将是一个Integer），或者在多个对象之间的可见性状态（在这种情况下，条目将是一个Boolean），或者每日或每三小时预计将被估计的阻力系数（这就是TimeSpanDragForce的实现方式）。

时间跨度映射是逐步构建的。首先，它们只包含一个从过去无限延伸到未来无限的时间跨度。然后逐个添加新条目，与过渡日期关联，以构建完整的映射。过渡日期可以是有效性的开始（调用addValidAfter(Object, AbsoluteDate, boolean)时），或者是有效性的结束（调用addValidBefore(Object, AbsoluteDate, boolean)时）。条目通常只在一端添加（主要按时间顺序），但这不是必需的。例如，可以首先设置一个覆盖较大范围（比如一天）的映射，然后使用传播和事件检测器插入中间日期，从而划分出一些部分。这类似于二叉空间分区树的工作方式。

自11.1版本起，此类是线程安全的。

Since:

7.1

Author:

Luc Maisonobe

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	TimeSpanMap.Span<S> 一个时间跨度的持有者。
static class	TimeSpanMap.Transition<S> 保存过渡时间的类。

Constructor Summary

Constructors

Constructor and Description
TimeSpanMap(T entry) 创建一个包含单个对象的映射，最初在整个时间线上有效。

Method Summary

Modifier and Type	Method and Description
TimeSpanMap.Span<T>	addValidAfter(T entry, AbsoluteDate earliestValidityDate, boolean erasesLater) 在限制日期之后添加一个有效条目。
TimeSpanMap.Span<T>	addValidBefore(T entry, AbsoluteDate latestValidityDate, boolean erasesEarlier) 在限制日期之前添加一个有效条目。
TimeSpanMap.Span<T>	addValidBetween(T entry, AbsoluteDate earliestValidityDate, AbsoluteDate latestValidityDate) 在两个限制日期之间添加一个有效条目。
TimeSpanMap<T>	extractRange(AbsoluteDate start, AbsoluteDate end) 提取映射的范围。
void	forEach(Consumer<T> action) 对映射的每个非空元素执行操作。
T	get(AbsoluteDate date) 获取指定日期有效的条目。
TimeSpanMap.Span<T>	getFirstSpan() 获取第一个（最早）时间跨度。
TimeSpanMap.Transition<T>	getFirstTransition() 获取第一个（最早）过渡。
TimeSpanMap.Span<T>	getLastSpan() 获取最后一个（最新）时间跨度。
TimeSpanMap.Transition<T>	getLastTransition() 获取最后一个（最新）过渡。
TimeSpanMap.Span<T>	getSpan(AbsoluteDate date) 获取包含指定日期的时间跨度。
int	getSpansNumber() 获取时间跨度的数量。

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

TimeSpanMap

public TimeSpanMap(T entry)

创建一个包含单个对象的映射，最初在整个时间线上有效。

随着其他条目被添加到映射中，这第一个条目的实际有效性将被截断，因为其他条目要么在其之前被添加，要么在其之后被添加。

参数：

entry - 条目（最初在整个时间线上有效）

Method Detail

getSpansNumber

public int getSpansNumber()

获取时间跨度的数量。

时间跨度的数量始终至少为1。过渡的数量始终比时间跨度的数量少1。

返回：

时间跨度的数量

自：

11.1

addValidBefore

public TimeSpanMap.Span<T> addValidBefore(T entry,
                                          AbsoluteDate latestValidityDate,
                                          boolean erasesEarlier)

在限制日期之前添加一个有效条目。

随着条目的有效性，它将截断或覆盖已经存在于映射中的相邻条目的有效性。

如果映射已经包含早于latestValidityDate的过渡，则erasesEarlier参数控制如何处理这些过渡。假设与条目eₖ关联的时间跨度[tₖ ; tₖ₊₁[将在调用该方法之前（即 tₖ < latestValidityDate < tₖ₊₁）在latestValidityDate时有效。

• 如果erasesEarlier为true，则所有早于tₖ的过渡都将被擦除，而entry将从过去无限到latestValidityDate有效
• 如果erasesEarlier为false，则所有早期过渡将被保留，而entry将从tₖ到latestValidityDate有效

在这两种情况下，现有条目eₖ的时间跨度将被截断，并且仅在latestValidityDate到tₖ₊₁之间有效。

参数：

entry - 要添加的条目

latestValidityDate - 条目有效之前的日期

erasesEarlier - 如果为true，则该条目擦除所有早于latestValidityDate的现有过渡

返回：

添加条目后的时间跨度

自：

11.1

addValidAfter

public TimeSpanMap.Span<T> addValidAfter(T entry,
                                         AbsoluteDate earliestValidityDate,
                                         boolean erasesLater)

在限制日期之后添加一个有效条目。

随着条目的有效性，它将截断或覆盖已经存在于映射中的相邻条目的有效性。

如果映射已经包含晚于earliestValidityDate的过渡，则erasesLater参数控制如何处理这些过渡。假设与条目eₖ关联的时间跨度[tₖ ; tₖ₊₁[将在调用该方法之前（即 tₖ < earliestValidityDate < tₖ₊₁）在earliestValidityDate时有效。

• 如果erasesLater为true，则从tₖ₊₁开始的所有后续过渡都将被擦除，而entry将从earliestValidityDate到未来无限有效
• 如果erasesLater为false，则所有后续过渡将被保留，而entry将从earliestValidityDate到tₖ₊₁有效

在这两种情况下，现有条目eₖ的时间跨度将被截断，并且仅在tₖ到earliestValidityDate之间有效。

参数：

entry - 要添加的条目

earliestValidityDate - 条目有效之后的日期

erasesLater - 如果为true，则该条目擦除所有晚于earliestValidityDate的现有过渡

返回：

添加条目后的时间跨度

自：

11.1

addValidBetween

public TimeSpanMap.Span<T> addValidBetween(T entry,
                                           AbsoluteDate earliestValidityDate,
                                           AbsoluteDate latestValidityDate)

在两个限制日期之间添加一个有效条目。

随着条目的有效性，它将截断或覆盖已经存在于映射中的相邻条目的有效性。

参数：

entry - 要添加的条目

earliestValidityDate - 条目有效之后的日期

latestValidityDate - 条目有效之前的日期

返回：

添加条目后的时间跨度

自：

11.1

get

public T get(AbsoluteDate date)

获取指定日期有效的条目。

预期的复杂度对于连续调用相邻日期为O(1)，这是在传播或轨道确定应用中更常见的用法，对于随机调用为O(n)。

参数：

date - 条目必须有效的日期

返回：

指定日期有效的条目

另请参阅：

getSpan(AbsoluteDate)

getSpan

public TimeSpanMap.Span<T> getSpan(AbsoluteDate date)

获取包含指定日期的时间跨度。

预期的复杂度对于连续调用相邻日期为O(1)，这是在传播或轨道确定应用中更常见的用法，对于随机调用为O(n)。

参数：

date - 属于所需时间跨度的日期

返回：

包含指定日期的时间跨度

自：

9.3

getFirstTransition

public TimeSpanMap.Transition<T> getFirstTransition()

获取第一个（最早）过渡。

返回：

第一个（最早）过渡，如果没有过渡则返回null

自：

11.1

getLastTransition

public TimeSpanMap.Transition<T> getLastTransition()

获取最后一个（最新）过渡。

返回：

最后一个（最新）过渡，如果没有过渡则返回null

自：

11.1

getFirstSpan

public TimeSpanMap.Span<T> getFirstSpan()

获取第一个（最早）时间跨度。

返回：

第一个（最早）时间跨度

自：

11.1

getLastSpan

public TimeSpanMap.Span<T> getLastSpan()

获取最后一个（最新）时间跨度。

返回：

最后一个（最新）时间跨度

自：

11.1

extractRange

public TimeSpanMap<T> extractRange(AbsoluteDate start,
                                   AbsoluteDate end)

提取地图的范围。

返回的对象将是一个新的独立实例，其中只包含位于指定范围内的过渡。

例如，考虑一个包含对象 O₀ 在 t₁ 之前有效，O₁ 在 t₁ 和 t₂ 之间有效，O₂ 在 t₂ 和 t₃ 之间有效，O₃ 在 t₃ 和 t₄ 之间有效，以及 O₄ 在 t₄ 之后有效的地图。然后，使用介于 t₁ 和 t₂ 之间的 start 日期和介于 t₃ 和 t₄ 之间的 end 日期调用此方法将导致一个新地图，其中包含在 t₂ 之前有效的对象 O₁，在 t₂ 和 t₃ 之间有效的对象 O₂，以及在 t₃ 之后有效的对象 O₃。因此，O₁ 的有效性在过去延长，O₃ 的有效性在未来延长。

参数：

start - 过渡包含在范围内的最早日期（可以设置为 AbsoluteDate.PAST_INFINITY 以保留所有早期过渡）

end - 过渡包含在范围内的最晚日期（可以设置为 AbsoluteDate.FUTURE_INFINITY 以保留所有晚期过渡）

返回：

包含所有过渡限制在指定范围内的新实例

自版本：

9.2

forEach

public void forEach(Consumer<T> action)

对地图的每个非空元素执行操作。

按时间顺序执行操作。

参数：

action - 在非空元素上执行的操作

自版本：

10.3