org.orekit.files.ccsds.definitions

Class FrameFacade

java.lang.Object

org.orekit.files.ccsds.definitions.FrameFacade

public class FrameFacade
extends Object

在CCSDS消息中，Facade在几种帧类型的前面。

Since:

11.0

Author:

Luc Maisonobe, Vincent Cucchietti

Constructor Summary

Constructors

Constructor and Description
FrameFacade(Frame frame, CelestialBodyFrame celestialBodyFrame, OrbitRelativeFrame orbitRelativeFrame, SpacecraftBodyFrame spacecraftBodyFrame, String name) 简单构造函数。

Method Summary

Modifier and Type	Method and Description
CelestialBodyFrame	asCelestialBodyFrame() 获取关联的天体参考系。
Frame	asFrame() 获取关联的帧树节点。
OrbitRelativeFrame	asOrbitRelativeFrame() 获取关联的轨道相关参考系。
SpacecraftBodyFrame	asSpacecraftBodyFrame() 获取关联的航天器体参考系。
String	getName() 获取帧的CCSDS名称。
static Transform	getTransform(FrameFacade frameIn, FrameFacade frameOut, Frame inertialPivotFrame, AbsoluteDate date, PVCoordinatesProvider pv) 获取在CCSDS帧之间的变换。
static FrameFacade	map(Frame frame) 将Orekit帧映射到CCSDS帧Facade。
static FrameFacade	parse(String name, IERSConventions conventions, boolean simpleEOP, DataContext dataContext, boolean allowCelestial, boolean allowOrbit, boolean allowSpacecraft) 简单构造函数。

Methods inherited from class java.lang.Object

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

Constructor Detail

FrameFacade

public FrameFacade(Frame frame,
                   CelestialBodyFrame celestialBodyFrame,
                   OrbitRelativeFrame orbitRelativeFrame,
                   SpacecraftBodyFrame spacecraftBodyFrame,
                   String name)

简单构造函数。

最多只能有一个celestialBodyFrame、orbitRelativeFrame或spacecraftBodyFrame可以为非空。如果帧未知，则它们都可以为空，在这种情况下只有名称可用。

参数：

frame - Orekit帧树中节点的引用（可以为null）

celestialBodyFrame - 天体中心的参考系的引用（可以为null）

orbitRelativeFrame - 轨道相关参考系的引用（可以为null）

spacecraftBodyFrame - 航天器体参考系的引用（可以为null）

name - 帧的名称

Method Detail

asFrame

public Frame asFrame()

获取关联的帧树节点。

返回：

关联的帧树节点，如果不存在则返回null

asCelestialBodyFrame

public CelestialBodyFrame asCelestialBodyFrame()

获取关联的天体参考系。

返回：

关联的天体参考系，如果帧关联到一个轨道、一个航天器或不受支持，则返回null

asOrbitRelativeFrame

public OrbitRelativeFrame asOrbitRelativeFrame()

获取关联的轨道相关参考系。

返回：

关联的轨道相关参考系，如果帧关联到一个天体、一个航天器或不受支持，则返回null

asSpacecraftBodyFrame

public SpacecraftBodyFrame asSpacecraftBodyFrame()

获取关联的航天器体参考系。

返回：

关联的航天器体参考系，如果帧关联到一个天体、一个轨道或不受支持，则返回null

getName

public String getName()

获取帧的CCSDS名称。

返回：

CCSDS名称

map

public static FrameFacade map(Frame frame)

将Orekit帧映射到CCSDS帧Facade。

参数：

frame - 参考帧。

返回：

对应于Orekit帧的CCSDS帧

parse

public static FrameFacade parse(String name,
                                IERSConventions conventions,
                                boolean simpleEOP,
                                DataContext dataContext,
                                boolean allowCelestial,
                                boolean allowOrbit,
                                boolean allowSpacecraft)

简单构造函数。

参数：

name - 帧的名称

conventions - 要使用的IERS约定

simpleEOP - 如果为true，则在插值EOP时忽略潮汐效应

dataContext - 创建帧时要使用的数据上下文

allowCelestial - 如果为true，则允许天体参考系

allowOrbit - 如果为true，则允许轨道相关参考系

allowSpacecraft - 如果为true，则允许航天器体参考系

返回：

对应于CCSDS名称的帧Facade

getTransform

public static Transform getTransform(FrameFacade frameIn,
                                     FrameFacade frameOut,
                                     Frame inertialPivotFrame,
                                     AbsoluteDate date,
                                     PVCoordinatesProvider pv)

获取在CCSDS帧之间的变换。

如果输入和输出帧都是轨道相关参考系，则返回的变换将仅由一个旋转组成。只有常用的轨道相关参考系将被识别。

请注意，如果输入/输出的CCSDS帧是使用冒号定义的：

• 天体参考系
• 航天器体参考系

那么将会抛出异常（目前不支持）。

请注意，提供的枢轴帧必须是惯性的，并且与您正在处理的内容一致（例如，如果围绕地球，则为GCRF）。

参数：

frameIn - 要转换的输入CCSDS帧

frameOut - 要转换为的输出CCSDS帧

inertialPivotFrame - 用作创建变换的惯性帧

date - 变换的日期

pv - 位置和速度坐标提供者（如果其中一个帧是轨道相关参考系，则需要）

返回：

CCSDS帧之间的变换。