WaypointPVBuilder (OREKIT 12.0.1 API)

java.lang.Object
- org.orekit.utils.WaypointPVBuilder

```
public class WaypointPVBuilder
extends Object
```
构建器类，使用在椭球上定义的航点逐步构建一个 PVCoordinatesProvider 实例。给定一系列航点（(日期，点) 元组），构建代表路径的 PVCoordinatesProvider。静态方法提供了最常见路径定义的实现（笛卡尔、大圆、loxodrome）。如果这些方法不够用，公共构造函数提供了自定义路径定义的方法。该类使用 AggregatedPVCoordinatesProvider 连接路径段。因此，在路径段之间不会努力平滑速度。虽然位置不受影响，但速度可能在相邻时间点之间不连续。因此，在建模具有突然方向变化的路径时（例如快速移动的飞行器），应谨慎考虑如何在特定应用中使用 PVCoordinatesProvider。

Since:

11.3

Author:

Joe Reed

Nested Class Summary

Nested Classes
Modifier and Type	Class and Description
`static interface`	`WaypointPVBuilder.InterpolationFactory` 工厂接口，创建提供的航点之间的 `PVCoordinatesProvider` 实例。

Constructor Summary

Constructors
Constructor and Description
`WaypointPVBuilder(WaypointPVBuilder.InterpolationFactory factory, OneAxisEllipsoid body)` 创建一个新实例。

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`WaypointPVBuilder`	`addWaypoint(GeodeticPoint point, AbsoluteDate date)` 添加一个航点。
`PVCoordinatesProvider`	`build()` 从添加到此构建器的航点构建一个 `PVCoordinatesProvider`。
`static WaypointPVBuilder`	`cartesianBuilder(OneAxisEllipsoid body)` 构建一个航点构建器，使用线性笛卡尔插值插值点。
`WaypointPVBuilder`	`constantAfter()` 指示生成的 `PVCoordinatesProvider` 在最后一个时间点之后提供最后一个航点的恒定位置。
`WaypointPVBuilder`	`constantBefore()` 指示生成的 `PVCoordinatesProvider` 在第一个时间点之前提供第一个航点的恒定位置。
`protected PVCoordinatesProvider`	`createFinal(AbsoluteDate lastDate, GeodeticPoint lastPoint)` 创建最终提供者。
`protected PVCoordinatesProvider`	`createInitial(AbsoluteDate firstDate, GeodeticPoint firstPoint)` 创建初始提供者。
`static WaypointPVBuilder`	`greatCircleBuilder(OneAxisEllipsoid body)` 构建一个航点构建器，使用大圆插值点。
`WaypointPVBuilder`	`invalidAfter()` 指示生成的 `PVCoordinatesProvider` 在最后一个航点之后应该无效。
`WaypointPVBuilder`	`invalidBefore()` 指示生成的 `PVCoordinatesProvider` 在第一个航点之前应该无效。
`static WaypointPVBuilder`	`loxodromeBuilder(OneAxisEllipsoid body)` 构建一个航点构建器，使用loxodrome（或Rhumbline）插值点。

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

- Constructor Detail
  - WaypointPVBuilder
```
public WaypointPVBuilder(WaypointPVBuilder.InterpolationFactory factory,
                         OneAxisEllipsoid body)
```
    创建一个新实例。
    
    参数：
    
    factory - 用于在航点之间创建中间坐标提供者的工厂。
    
    body - 航点所定义的中心天体。
- Method Detail
  - cartesianBuilder
```
public static WaypointPVBuilder cartesianBuilder(OneAxisEllipsoid body)
```
    构建一个航点构建器，使用线性笛卡尔插值插值点。
    
    参数：
    
    body - 航点所定义的参考椭球体。
    
    返回：
    
    航点构建器
  - loxodromeBuilder
```
public static WaypointPVBuilder loxodromeBuilder(OneAxisEllipsoid body)
```
    构建一个航点构建器，使用loxodrome（或Rhumbline）插值点。
    
    参数：
    
    body - 航点所定义的参考椭球体。
    
    返回：
    
    航点构建器
  - greatCircleBuilder
```
public static WaypointPVBuilder greatCircleBuilder(OneAxisEllipsoid body)
```
    构建一个航点构建器，使用大圆插值点。中间点的高度从边界航点线性插值。在第一个航点之前或最后一个航点之后进行外推可能导致高度未定义。
    
    参数：
    
    body - 航点所定义的参考椭球体。
    
    返回：
    
    航点构建器
  - addWaypoint
```
public WaypointPVBuilder addWaypoint(GeodeticPoint point,
                                     AbsoluteDate date)
```
    添加一个航点。
    
    参数：
    
    point - 航点位置
    
    date - 航点时间
    
    返回：
    
    此实例
  - invalidBefore
```
public WaypointPVBuilder invalidBefore()
```
    指示生成的 PVCoordinatesProvider 在第一个航点之前应该无效。
    
    返回：
    
    此实例
  - constantBefore
```
public WaypointPVBuilder constantBefore()
```
    指示生成的 PVCoordinatesProvider 在第一个时间点之前提供第一个航点的恒定位置。
    
    返回：
    
    此实例
  - invalidAfter
```
public WaypointPVBuilder invalidAfter()
```
    指示生成的 PVCoordinatesProvider 在最后一个航点之后应该无效。
    
    返回：
    
    此实例
  - constantAfter
```
public WaypointPVBuilder constantAfter()
```
    指示生成的 PVCoordinatesProvider 在最后一个时间点之后提供最后一个航点的恒定位置。
    
    返回：
    
    此实例
  - build
```
public PVCoordinatesProvider build()
```
    从添加到此构建器的航点构建一个 PVCoordinatesProvider。
    
    返回：
    
    坐标提供者实例。
  - createInitial
```
protected PVCoordinatesProvider createInitial(AbsoluteDate firstDate,
                                              GeodeticPoint firstPoint)
```
    创建初始提供者。此方法使用内部的 validBefore 标志来返回无效的 PVCoordinatesProvider 或恒定的一个。
    
    参数：
    
    firstDate - 达到第一个航点的日期，此提供者将不再被调用
    
    firstPoint - 第一个航点
    
    返回：
    
    坐标提供者
  - createFinal
```
protected PVCoordinatesProvider createFinal(AbsoluteDate lastDate,
                                            GeodeticPoint lastPoint)
```
    创建最终提供者。此方法使用内部的 validAfter 标志来返回无效的 PVCoordinatesProvider 或恒定的一个。
    
    参数：
    
    lastDate - 达到最后一个航点的日期，此提供者将被调用
    
    lastPoint - 最后一个航点
    
    返回：
    
    坐标提供者

Class WaypointPVBuilder

Nested Class Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

WaypointPVBuilder

Method Detail

cartesianBuilder

loxodromeBuilder

greatCircleBuilder

addWaypoint

invalidBefore

constantBefore

invalidAfter

constantAfter

build

createInitial

createFinal