SpacecraftStateInterpolator (OREKIT 12.0.1 API)

java.lang.Object
- org.orekit.time.AbstractTimeInterpolator<SpacecraftState>
- - org.orekit.propagation.SpacecraftStateInterpolator

All Implemented Interfaces:

TimeInterpolator<SpacecraftState>
```
public class SpacecraftStateInterpolator
extends AbstractTimeInterpolator<SpacecraftState>
```
太空船状态插值器的通用类。
用户可以指定每个太空船状态属性使用什么插值器。但是，至少需要一个轨道或绝对位置-速度-加速度的插值器。如果用户不想对这些值进行插值，所有其他插值器都可以保留为空。

Author:

Luc Maisonobe, Vincent Cucchietti

See Also:

SpacecraftState

Nested Class Summary
- Nested classes/interfaces inherited from class org.orekit.time.AbstractTimeInterpolator
  AbstractTimeInterpolator.InterpolationData

Field Summary
- Fields inherited from class org.orekit.time.AbstractTimeInterpolator
  DEFAULT_EXTRAPOLATION_THRESHOLD_SEC, DEFAULT_INTERPOLATION_POINTS

Constructor Summary

Constructors
Constructor and Description
`SpacecraftStateInterpolator(Frame outputFrame)` 创建默认Hermite插值器以创建每个太空船状态字段的最简单构造函数。
`SpacecraftStateInterpolator(Frame outputFrame, TimeInterpolator<Orbit> orbitInterpolator, TimeInterpolator<AbsolutePVCoordinates> absPVAInterpolator, TimeInterpolator<TimeStampedDouble> massInterpolator, TimeInterpolator<Attitude> attitudeInterpolator, TimeInterpolator<TimeStampedDouble> additionalStateInterpolator)` 构造函数：默认插值点数为`DEFAULT_INTERPOLATION_POINTS`，默认外推阈值为`DEFAULT_EXTRAPOLATION_THRESHOLD_SEC`秒
`SpacecraftStateInterpolator(int interpolationPoints, double extrapolationThreshold, Frame outputFrame, Frame attitudeReferenceFrame)` 创建可定制的Hermite插值器以创建每个太空船状态字段的构造函数。
`SpacecraftStateInterpolator(int interpolationPoints, double extrapolationThreshold, Frame outputFrame, Frame attitudeReferenceFrame, CartesianDerivativesFilter pvaFilter, AngularDerivativesFilter angularFilter)` 创建可定制的Hermite插值器以创建每个太空船状态字段的构造函数。
`SpacecraftStateInterpolator(int interpolationPoints, double extrapolationThreshold, Frame outputFrame, TimeInterpolator<Orbit> orbitInterpolator, TimeInterpolator<AbsolutePVCoordinates> absPVAInterpolator, TimeInterpolator<TimeStampedDouble> massInterpolator, TimeInterpolator<Attitude> attitudeInterpolator, TimeInterpolator<TimeStampedDouble> additionalStateInterpolator)` 构造函数。
`SpacecraftStateInterpolator(int interpolationPoints, Frame outputFrame)` 创建可定制的Hermite插值器以创建每个太空船状态字段的构造函数。
`SpacecraftStateInterpolator(int interpolationPoints, Frame outputFrame, Frame attitudeReferenceFrame)` 创建可定制的Hermite插值器以创建每个太空船状态字段的构造函数。

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`static void`	`checkSampleAndInterpolatorConsistency(List<SpacecraftState> sample, boolean orbitInterpolatorIsPresent, boolean absPVInterpolatorIsPresent)` 检查给定样本状态定义的插值器是否存在。
`static void`	`checkStatesDefinitionsConsistency(List<SpacecraftState> states)` 检查所有状态是轨道定义的还是基于绝对位置-速度-加速度的。
`Optional<TimeInterpolator<AbsolutePVCoordinates>>`	`getAbsPVAInterpolator()` 获取绝对位置-速度-加速度插值器。
`Optional<TimeInterpolator<TimeStampedDouble>>`	`getAdditionalStateInterpolator()` 获取附加状态插值器。
`Optional<TimeInterpolator<Attitude>>`	`getAttitudeInterpolator()` 获取姿态插值器。
`Optional<TimeInterpolator<TimeStampedDouble>>`	`getMassInterpolator()` 获取质量插值器。
`Optional<TimeInterpolator<Orbit>>`	`getOrbitInterpolator()` 获取轨道插值器。
`Frame`	`getOutputFrame()` 获取输出参考系。
`List<TimeInterpolator<? extends TimeStamped>>`	`getSubInterpolators()` 获取此实例实现的所有最低级插值器，否则仅返回包含此实例的列表。
`SpacecraftState`	`interpolate(AbsoluteDate interpolationDate, Collection<SpacecraftState> sample)` 获取插值实例。
`protected SpacecraftState`	`interpolate(AbstractTimeInterpolator.InterpolationData interpolationData)` 从给定的插值数据插值实例。

Methods inherited from class org.orekit.time.AbstractTimeInterpolator
addOptionalSubInterpolatorIfDefined, checkInterpolatorCompatibilityWithSampleSize, getCentralDate, getExtrapolationThreshold, getNbInterpolationPoints, getTimeParameter, interpolate

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - SpacecraftStateInterpolator
```
public SpacecraftStateInterpolator(Frame outputFrame)
```
    创建每个太空船状态字段的默认Hermite插值器的最简单构造函数。
    插值器将具有以下配置：
    - 坐标和姿态相同的参考系
    - 默认插值点数为DEFAULT_INTERPOLATION_POINTS
    - 默认外推阈值为DEFAULT_EXTRAPOLATION_THRESHOLD_SEC秒
    - 使用位置和两个时间导数进行绝对位置-速度-加速度坐标插值
    - 使用角度和第一个时间导数进行姿态插值
    由于此插值的实现是多项式的，应该仅在插值点数较小（约10-20点）时使用，以避免龙格现象和数值问题（包括NaN出现）。
    
    注意：如果此实例将在轨道定义的表格化太空船状态之间进行插值，则输出参考系必须是惯性的，否则将引发错误。
    参数：
    
    outputFrame - 输出参考系
    
    另请参阅：
    
    AbstractTimeInterpolator
  - SpacecraftStateInterpolator
```
public SpacecraftStateInterpolator(int interpolationPoints,
                                   Frame outputFrame)
```
    创建每个太空船状态字段的可定制Hermite插值器的构造函数。
    插值器将具有以下配置：
    - 坐标和姿态相同的参考系
    - 默认外推阈值为DEFAULT_EXTRAPOLATION_THRESHOLD_SEC秒
    - 使用位置和两个时间导数进行绝对位置-速度-加速度坐标插值
    - 使用角度和第一个时间导数进行姿态插值
    由于此插值的实现是多项式的，应该仅在插值点数较小（约10-20点）时使用，以避免龙格现象和数值问题（包括NaN出现）。
    
    注意：如果此实例将在轨道定义的表格化太空船状态之间进行插值，则输出参考系必须是惯性的，否则将引发错误。
    参数：
    
    interpolationPoints - 插值点数
    
    outputFrame - 输出参考系
    
    另请参阅：
    
    AbstractTimeInterpolator
  - SpacecraftStateInterpolator
```
public SpacecraftStateInterpolator(int interpolationPoints,
                                   Frame outputFrame,
                                   Frame attitudeReferenceFrame)
```
    创建每个太空船状态字段的可定制Hermite插值器的构造函数。
    插值器将具有以下配置：
    - 默认外推阈值为DEFAULT_EXTRAPOLATION_THRESHOLD_SEC秒
    - 使用位置和两个时间导数进行绝对位置-速度-加速度坐标插值
    - 使用角度和第一个时间导数进行姿态插值
    由于此插值的实现是多项式的，应该仅在插值点数较小（约10-20点）时使用，以避免龙格现象和数值问题（包括NaN出现）。
    
    注意：如果此实例将在轨道定义的表格化太空船状态之间进行插值，则输出参考系必须是惯性的，否则将引发错误。
    参数：
    
    interpolationPoints - 插值点数
    
    outputFrame - 输出参考系
    
    attitudeReferenceFrame - 定义姿态的参考系
    
    另请参阅：
    
    AbstractTimeInterpolator
  - SpacecraftStateInterpolator
```
public SpacecraftStateInterpolator(int interpolationPoints,
                                   double extrapolationThreshold,
                                   Frame outputFrame,
                                   Frame attitudeReferenceFrame)
```
    创建每个太空船状态字段的可定制Hermite插值器的构造函数。
    插值器将具有以下配置：
    - 使用位置和两个时间导数进行绝对位置-速度-加速度坐标插值
    - 使用角度和第一个时间导数进行姿态插值
    由于此插值的实现是多项式的，应该仅在插值点数较小（约10-20点）时使用，以避免龙格现象和数值问题（包括NaN出现）。
    
    注意：如果此实例将在轨道定义的表格化太空船状态之间进行插值，则输出参考系必须是惯性的，否则将引发错误。
    参数：
    
    interpolationPoints - 插值点数
    
    extrapolationThreshold - 超出此阈值将导致传播失败的外推阈值
    
    outputFrame - 输出参考系
    
    attitudeReferenceFrame - 定义姿态的参考系
  - SpacecraftStateInterpolator
```
public SpacecraftStateInterpolator(int interpolationPoints,
                                   double extrapolationThreshold,
                                   Frame outputFrame,
                                   Frame attitudeReferenceFrame,
                                   CartesianDerivativesFilter pvaFilter,
                                   AngularDerivativesFilter angularFilter)
```
    创建每个太空船状态字段的可定制Hermite插值器的构造函数。
    由于此插值的实现是多项式的，应该仅在插值点数较小（约10-20点）时使用，以避免龙格现象和数值问题（包括NaN出现）。
    
    注意：如果此实例将在轨道定义的表格化太空船状态之间进行插值，则输出参考系必须是惯性的，否则将引发错误。
    
    参数：
    
    interpolationPoints - 插值点数
    
    extrapolationThreshold - 超出此阈值将导致传播失败的外推阈值
    
    outputFrame - 输出参考系
    
    attitudeReferenceFrame - 定义姿态的参考系
    
    pvaFilter - 用于在绝对位置-速度-加速度插值中使用的样本导数的过滤器
    
    angularFilter - 用于在姿态插值中使用的样本导数的过滤器
  - SpacecraftStateInterpolator
```
public SpacecraftStateInterpolator(Frame outputFrame,
                                   TimeInterpolator<Orbit> orbitInterpolator,
                                   TimeInterpolator<AbsolutePVCoordinates> absPVAInterpolator,
                                   TimeInterpolator<TimeStampedDouble> massInterpolator,
                                   TimeInterpolator<Attitude> attitudeInterpolator,
                                   TimeInterpolator<TimeStampedDouble> additionalStateInterpolator)
```
    构造函数。
    至少需要一个轨道或绝对位置-速度-加速度的插值器。如果用户不想对这些值进行插值，所有其他插值器都可以保留为空。
    
    注意：如果插值的太空船状态由轨道定义，则输出参考系必须是惯性的。否则将引发错误。
    
    注意：用户需要检查输入插值器的一致性。
    
    参数：
    
    outputFrame - 输出参考系（如果用户计划使用轨道插值器，则为惯性）
    
    orbitInterpolator - 轨道插值器（如果定义了absPVAInterpolator，则可以为空）
    
    absPVAInterpolator - 绝对位置-速度-加速度插值器（如果定义了轨道插值器，则可以为空）
    
    massInterpolator - 质量插值器（可以为空）
    
    attitudeInterpolator - 姿态插值器（可以为空）
    
    additionalStateInterpolator - 附加状态插值器（可以为空）
    
    另请参阅：
    
    AbstractTimeInterpolator
  - SpacecraftStateInterpolator
```
public SpacecraftStateInterpolator(int interpolationPoints,
                                   double extrapolationThreshold,
                                   Frame outputFrame,
                                   TimeInterpolator<Orbit> orbitInterpolator,
                                   TimeInterpolator<AbsolutePVCoordinates> absPVAInterpolator,
                                   TimeInterpolator<TimeStampedDouble> massInterpolator,
                                   TimeInterpolator<Attitude> attitudeInterpolator,
                                   TimeInterpolator<TimeStampedDouble> additionalStateInterpolator)
```
    构造函数。
    至少需要一个轨道或绝对位置-速度-加速度的插值器。如果用户不想对这些值进行插值，所有其他插值器都可以保留为空。
    
    注意：如果插值的太空船状态由轨道定义，则输出参考系必须是惯性的。否则将引发错误。
    
    注意：用户需要检查输入插值器的一致性。
    
    参数:
    
    interpolationPoints - 插值点的数量
    
    extrapolationThreshold - 超出此阈值的外推将导致传播失败
    
    outputFrame - 输出参考系（如果用户计划使用轨道插值器，则为惯性参考系）
    
    orbitInterpolator - 轨道插值器（如果定义了absPVAInterpolator，则可以为null）
    
    absPVAInterpolator - 绝对位置-速度-加速度插值器（如果定义了轨道插值器，则可以为null）
    
    massInterpolator - 质量插值器（可以为null）
    
    attitudeInterpolator - 姿态插值器（可以为null）
    
    additionalStateInterpolator - 附加状态插值器（可以为null）
    
    自版本:
    
    12.0.1
- Method Detail
  - checkSampleAndInterpolatorConsistency
```
public static void checkSampleAndInterpolatorConsistency(List<SpacecraftState> sample,
                                                         boolean orbitInterpolatorIsPresent,
                                                         boolean absPVInterpolatorIsPresent)
```
    检查给定样本状态定义的插值器是否存在。
    
    参数:
    
    sample - 样本（非空）
    
    orbitInterpolatorIsPresent - 标志，定义是否为此实例定义了轨道插值器
    
    absPVInterpolatorIsPresent - 标志，定义是否为此实例定义了绝对位置-速度-加速度插值器
    
    抛出:
    
    OrekitIllegalArgumentException - 如果给定样本航天器状态定义类型没有定义插值器
  - checkStatesDefinitionsConsistency
```
public static void checkStatesDefinitionsConsistency(List<SpacecraftState> states)
```
    检查所有状态是轨道定义的还是基于绝对位置-速度-加速度的。
    
    参数:
    
    states - 航天器状态样本
  - interpolate
```
public SpacecraftState interpolate(AbsoluteDate interpolationDate,
                                   Collection<SpacecraftState> sample)
```
    获取一个插值实例。
    要插值的附加状态是已经存在于第一个邻居实例中的状态。因此，样本实例必须至少具有与此邻居实例相同的附加状态。它们可能具有更多的附加状态，但额外的状态将被忽略。
    
    所有样本实例必须基于类似的轨迹数据，即它们必须全部基于轨道或全部基于绝对位置-速度-加速度。任何不一致都将触发一个OrekitIllegalArgumentException。
    
    由以下指定:
    
    interpolate 在接口 TimeInterpolator<SpacecraftState>
    
    覆盖:
    
    interpolate 在类 AbstractTimeInterpolator<SpacecraftState>
    
    参数:
    
    interpolationDate - 插值日期
    
    sample - 时间戳样本
    
    返回:
    
    在指定日期插值的新实例
    
    抛出:
    
    OrekitIllegalArgumentException - 如果存在由轨道和绝对位置-速度-加速度坐标定义的状态
    
    OrekitIllegalArgumentException - 如果给定样本航天器状态定义类型没有定义插值器
  - getSubInterpolators
```
public List<TimeInterpolator<? extends TimeStamped>> getSubInterpolators()
```
    获取此实例实现的所有最低级插值器，否则返回仅包含此实例的列表。
    例如，航天器状态插值器可以为其每个属性（轨道、绝对位置-速度-加速度坐标、质量等）使用不同的插值器。在这种情况下，它将返回所有这些插值器的列表（或者如果它们要使用多个插值器本身，则可能返回所有这些插值器的子插值器）。
    
    由以下指定:
    
    getSubInterpolators 在接口 TimeInterpolator<SpacecraftState>
    
    覆盖:
    
    getSubInterpolators 在类 AbstractTimeInterpolator<SpacecraftState>
    
    返回:
    
    插值器列表
  - interpolate
```
protected SpacecraftState interpolate(AbstractTimeInterpolator.InterpolationData interpolationData)
```
    从给定的插值数据中插值实例。
    
    由以下指定:
    
    interpolate 在类 AbstractTimeInterpolator<SpacecraftState>
    
    参数:
    
    interpolationData - 插值数据
    
    返回:
    
    从给定的插值数据中插值的实例。
  - getOutputFrame
```
public Frame getOutputFrame()
```
    获取输出参考系。
    
    返回:
    
    输出参考系
  - getOrbitInterpolator
```
public Optional<TimeInterpolator<Orbit>> getOrbitInterpolator()
```
    获取轨道插值器。
    
    返回:
    
    可选的轨道插值器
    
    另请参阅:
    
    Optional
  - getAbsPVAInterpolator
```
public Optional<TimeInterpolator<AbsolutePVCoordinates>> getAbsPVAInterpolator()
```
    获取绝对位置-速度-加速度插值器。
    
    返回:
    
    可选的绝对位置-速度-加速度插值器
    
    另请参阅:
    
    Optional
  - getMassInterpolator
```
public Optional<TimeInterpolator<TimeStampedDouble>> getMassInterpolator()
```
    获取质量插值器。
    
    返回:
    
    可选的质量插值器
    
    另请参阅:
    
    Optional
  - getAttitudeInterpolator
```
public Optional<TimeInterpolator<Attitude>> getAttitudeInterpolator()
```
    获取姿态插值器。
    
    返回:
    
    可选的姿态插值器
    
    另请参阅:
    
    Optional
  - getAdditionalStateInterpolator
```
public Optional<TimeInterpolator<TimeStampedDouble>> getAdditionalStateInterpolator()
```
    获取附加状态插值器。
    
    返回:
    
    可选的附加状态插值器
    
    另请参阅:
    
    Optional

Class SpacecraftStateInterpolator

Nested Class Summary

Nested classes/interfaces inherited from class org.orekit.time.AbstractTimeInterpolator

Field Summary

Fields inherited from class org.orekit.time.AbstractTimeInterpolator

Constructor Summary

Method Summary

Methods inherited from class org.orekit.time.AbstractTimeInterpolator

Methods inherited from class java.lang.Object

Constructor Detail

SpacecraftStateInterpolator

SpacecraftStateInterpolator

SpacecraftStateInterpolator

SpacecraftStateInterpolator

SpacecraftStateInterpolator

SpacecraftStateInterpolator

SpacecraftStateInterpolator

Method Detail

checkSampleAndInterpolatorConsistency

checkStatesDefinitionsConsistency

interpolate

getSubInterpolators

interpolate

getOutputFrame

getOrbitInterpolator

getAbsPVAInterpolator

getMassInterpolator

getAttitudeInterpolator

getAdditionalStateInterpolator