Frames (OREKIT 12.0.1 API)

All Known Implementing Classes:

AbstractFrames, LazyLoadedFrames
```
public interface Frames
```
一组常用的Frame的集合。该接口定义了获取许多常用参考坐标系实例的方法。

Since:

10.0

Author:

Guylaine Prat, Luc Maisonobe, Pascal Parraud, Evan Ward

See Also:

FramesFactory

Method Summary

All Methods Static Methods Instance Methods Abstract Methods Default Methods
Modifier and Type	Method and Description
`Frame`	`buildUncachedITRF(UT1Scale ut1)` 使用特定的`EOP历史`构建一个未缓存的国际地球参考系。
`FactoryManagedFrame`	`getCIRF(IERSConventions conventions, boolean simpleEOP)` 获取CIRF2000参考系。
`Frame`	`getEcliptic(IERSConventions conventions)` 获取黄道坐标系。
`FactoryManagedFrame`	`getEME2000()` 获取唯一的EME2000参考系。
`EOPHistory`	`getEOPHistory(IERSConventions conventions, boolean simpleEOP)` 获取地球定向参数历史。
`Frame`	`getFrame(Predefined factoryKey)` 获取预定义的参考坐标系之一。
`Frame`	`getGCRF()` 获取唯一的GCRF参考系。
`FactoryManagedFrame`	`getGTOD(boolean applyEOPCorr)` 获取GTOD参考系。
`FactoryManagedFrame`	`getGTOD(IERSConventions conventions, boolean simpleEOP)` 获取GTOD参考系。
`Frame`	`getICRF()` 获取唯一的ICRF参考系。
`FactoryManagedFrame`	`getITRF(IERSConventions conventions, boolean simpleEOP)` 获取未指定的国际地球参考系。
`VersionedITRF`	`getITRF(ITRFVersion version, IERSConventions conventions, boolean simpleEOP)` 获取特定的国际地球参考系。
`FactoryManagedFrame`	`getITRFEquinox(IERSConventions conventions, boolean simpleEOP)` 获取基于黄道的ITRF参考系。
`FactoryManagedFrame`	`getMOD(boolean applyEOPCorr)` 获取MOD参考系。
`FactoryManagedFrame`	`getMOD(IERSConventions conventions)` 获取MOD参考系。
`FactoryManagedFrame`	`getPZ9011(IERSConventions convention, boolean simpleEOP)` 获取PZ-90.11（Parametry Zemly – 1990.11）参考系。
`FactoryManagedFrame`	`getTEME()` 获取TEME参考系。
`FactoryManagedFrame`	`getTIRF(IERSConventions conventions)` 获取TIRF参考系，忽略潮汐效应。
`FactoryManagedFrame`	`getTIRF(IERSConventions conventions, boolean simpleEOP)` 获取TIRF参考系。
`FactoryManagedFrame`	`getTOD(boolean applyEOPCorr)` 获取TOD参考系。
`FactoryManagedFrame`	`getTOD(IERSConventions conventions, boolean simpleEOP)` 获取TOD参考系。
`FactoryManagedFrame`	`getVeis1950()` 获取VEIS 1950参考系。
`static Frames`	`of(TimeScales timeScales, CelestialBodies celestialBodies)` 从给定数据创建一组参考坐标系。
`static Frames`	`of(TimeScales timeScales, Supplier<Frame> icrfSupplier)` 从给定数据创建一组参考坐标系。

- Method Detail
  - getEOPHistory
```
EOPHistory getEOPHistory(IERSConventions conventions,
                         boolean simpleEOP)
```
    获取地球定向参数历史。
    
    参数：
    
    conventions - 请求EOP历史的约定
    
    simpleEOP - 如果为true，则在插值EOP时忽略潮汐效应
    
    返回：
    
    地球定向参数历史
  - getFrame
```
Frame getFrame(Predefined factoryKey)
```
    获取预定义的参考坐标系之一。
    
    参数：
    
    factoryKey - 工厂内的坐标系键
    
    返回：
    
    预定义的参考坐标系
  - getGCRF
```
Frame getGCRF()
```
    获取唯一的GCRF参考系。
    GCRF参考系是坐标系树中的根坐标系。
    
    返回：
    
    GCRF参考系的唯一实例
  - getICRF
```
Frame getICRF()
```
    获取唯一的ICRF参考系。
    ICRF参考系以太阳系质心为中心，并与GCRF对齐。
    
    返回：
    
    ICRF参考系的唯一实例
  - getEcliptic
```
Frame getEcliptic(IERSConventions conventions)
```
    获取黄道坐标系。IAU将黄道定义为“垂直于BCRS中地月质心的平均日心轨道角动量矢量的平面（IAU 2006决议B1）”。+z轴与角动量矢量对齐，+x轴与MOD的+x轴对齐。
    此实现与JPL 406天文历表一致，误差不超过0.5角秒。
    
    参数：
    
    conventions - 应用的IERS约定
    
    返回：
    
    选定的参考坐标系单例。
  - getEME2000
```
FactoryManagedFrame getEME2000()
```
    获取唯一的EME2000参考系。
    EME2000参考系也称为J2000参考系。Orekit更倾向于前者的命名。
    
    返回：
    
    EME2000参考系的唯一实例
  - getITRF
```
FactoryManagedFrame getITRF(IERSConventions conventions,
                            boolean simpleEOP)
```
    获取未指定的国际地球参考系。
    返回的坐标系盲目使用地球定向参数。因此，例如，如果仅加载EOP 14 C04文件以检索参数，则该坐标系将是ITRFVersion.ITRF_2014。但是，如果从不同文件类型加载参数，甚至对于更改其参考的文件类型（例如，从2008年切换到2014年的公告A，从2018-03-29发布的第31卷第013号开始），则此方法返回的ITRF将从一个版本跳转到另一个版本。
    
    如果需要特定版本的ITRF，则应改用getITRF(ITRFVersion, IERSConventions, boolean)。
    
    参数：
    
    conventions - 应用的IERS约定
    
    simpleEOP - 如果为true，则在插值EOP时忽略潮汐效应
    
    返回：
    
    选定的参考坐标系单例。
    
    自从：
    
    6.1
    
    另请参阅：
    
    getITRF(ITRFVersion, IERSConventions, boolean)
  - getTIRF
```
FactoryManagedFrame getTIRF(IERSConventions conventions)
```
    获取TIRF参考系，忽略潮汐效应。
    
    参数：
    
    conventions - 应用的IERS约定
    
    返回：
    
    选定的参考坐标系单例。库无法读取。
  - getITRF
```
VersionedITRF getITRF(ITRFVersion version,
                      IERSConventions conventions,
                      boolean simpleEOP)
```
    获取特定的国际地球参考系。
    请注意，如果需要特定版本的ITRF，则应将simpleEOP设置为false，因为忽略潮汐效应与各种ITRF版本之间的差异具有相同数量级的影响。
    
    参数：
    
    version - ITRF版本
    
    conventions - 应用的IERS约定
    
    simpleEOP - 如果为true，则在插值EOP时忽略潮汐效应
    
    返回：
    
    选定的参考坐标系单例。
    
    自从：
    
    9.2
  - buildUncachedITRF
```
Frame buildUncachedITRF(UT1Scale ut1)
```
    使用特定的EOP历史构建一个未缓存的国际地球参考系。
    此参考系及其父参考系（TIRF和CIRF）将不会被缓存，它们每次调用此方法时都会从头开始重建。此工厂方法旨在在运行时更改EOP历史时使用。对于常规ITRF使用，更适合使用getITRF(IERSConventions, boolean)和getITRF(ITRFVersion, IERSConventions, boolean)。
    
    参数：
    
    ut1 - UT1时间标度（包含EOP历史）
    
    返回：
    
    具有指定时间标度和嵌入式EOP历史的ITRF参考系
    
    自从：
    
    12.0
  - getTIRF
```
FactoryManagedFrame getTIRF(IERSConventions conventions,
                            boolean simpleEOP)
```
    获取TIRF参考系。
    
    参数：
    
    conventions - 应用的IERS约定
    
    simpleEOP - 如果为true，则在插值EOP时忽略潮汐效应
    
    返回：
    
    选定的参考坐标系单例。
    
    自从：
    
    6.1
  - getCIRF
```
FactoryManagedFrame getCIRF(IERSConventions conventions,
                            boolean simpleEOP)
```
    获取CIRF2000参考系。
    
    参数：
    
    conventions - 应用的IERS约定
    
    simpleEOP - 如果为true，则在插值EOP时忽略潮汐效应
    
    返回：
    
    选定的参考坐标系单例。
  - getVeis1950
```
FactoryManagedFrame getVeis1950()
```
    获取VEIS 1950参考系。
    其父坐标系是具有IERS 1996约定且没有EOP校正的GTOD坐标系。
    
    返回：
    
    选定的参考坐标系单例。
  - getITRFEquinox
```
FactoryManagedFrame getITRFEquinox(IERSConventions conventions,
                                   boolean simpleEOP)
```
    获取基于黄道的ITRF参考系。
    
    参数：
    
    conventions - 应用的IERS约定
    
    simpleEOP - 如果为true，则在插值EOP时忽略潮汐效应
    
    返回：
    
    选定的参考坐标系单例。
    
    自从：
    
    6.1
  - getGTOD
```
FactoryManagedFrame getGTOD(boolean applyEOPCorr)
```
    获取GTOD参考系。
    applyEOPCorr参数主要用于测试目的或与不处理EOP校正参数的传统软件保持一致。请注意，将此参数设置为false会导致粗略的精度（误差数量级可能超过LEO中的250m和GEO中的1400m）。因此，将此参数设置为false仅限于IERS 1996约定，因此在这里不能自由选择IERS约定。
    
    参数：
    
    applyEOPCorr - 如果为true，则应用EOP校正（这里是dut1和lod）
    
    返回：
    
    选定的参考坐标系单例。
  - getGTOD
```
FactoryManagedFrame getGTOD(IERSConventions conventions,
                            boolean simpleEOP)
```
    获取GTOD参考系。
    
    参数:
    
    conventions - 要应用的IERS约定
    
    simpleEOP - 如果为true，则在插值EOP时忽略潮汐效应
    
    返回:
    
    选定的参考系单例。
  - getTOD
```
FactoryManagedFrame getTOD(boolean applyEOPCorr)
```
    获取TOD参考系。
    applyEOPCorr参数主要用于测试目的或与不处理EOP校正参数的传统软件保持一致。请注意，将此参数设置为false会导致粗略的精度（误差数量级可能在LEO中超过1m，在GEO中超过10m）。因此，将此参数设置为false仅限于IERS 1996约定，因此在此处不能自由选择IERS约定。
    
    参数:
    
    applyEOPCorr - 如果为true，则应用EOP校正（这里是章动）
    
    返回:
    
    选定的参考系单例。
  - getTOD
```
FactoryManagedFrame getTOD(IERSConventions conventions,
                           boolean simpleEOP)
```
    获取TOD参考系。
    
    参数:
    
    conventions - 要应用的IERS约定
    
    simpleEOP - 如果为true，则在插值EOP时忽略潮汐效应
    
    返回:
    
    选定的参考系单例。
  - getMOD
```
FactoryManagedFrame getMOD(boolean applyEOPCorr)
```
    获取MOD参考系。
    applyEOPCorr参数主要用于测试目的或与不处理EOP校正参数的传统软件保持一致。请注意，将此参数设置为false会导致粗略的精度（误差数量级可能在LEO中超过1m，在GEO中超过10m）。因此，将此参数设置为false仅限于IERS 1996约定，因此在此处不能自由选择IERS约定。
    
    参数:
    
    applyEOPCorr - 如果为true，则应用EOP校正（EME2000/GCRF偏差补偿）
    
    返回:
    
    选定的参考系单例。
  - getMOD
```
FactoryManagedFrame getMOD(IERSConventions conventions)
```
    获取MOD参考系。
    
    参数:
    
    conventions - 要应用的IERS约定
    
    返回:
    
    选定的参考系单例。
  - getTEME
```
FactoryManagedFrame getTEME()
```
    获取TEME参考系。
    TEME参考系用于TLE传播中的SGP4模型。该参考系没有官方定义，关于它是应该作为“日期”还是“时代”的一些模糊性。因此，建议仅将此参考系用于TLE传播，而不用于其他任何目的，如CCSDS轨道数据消息蓝皮书所建议的。
    
    返回:
    
    选定的参考系单例。
  - getPZ9011
```
FactoryManagedFrame getPZ9011(IERSConventions convention,
                              boolean simpleEOP)
```
    获取PZ-90.11（Parametry Zemly – 1990.11）参考系。
    从2013年12月31日下午3:00开始，所有运行中的GLONASS卫星上都更新了PZ-90.11参考系统。
    
    父参考系（ITRF-2008）与PZ-90.11参考系之间的过渡使用七参数Helmert变换进行。
```
    从       到      ΔX(m)   ΔY(m)   ΔZ(m)   RX(mas)   RY(mas)  RZ(mas)   时代
 ITRF-2008  PZ-90.11  +0.003  +0.001  -0.000   +0.019    -0.042   +0.002     2010
 
```
    参数:
    
    convention - 要应用的IERS约定
    
    simpleEOP - 如果为true，则在插值EOP时忽略潮汐效应
    
    返回:
    
    选定的参考系单例。
    
    另请参阅:
    
    "Springer全球导航卫星系统手册，Peter Teunissen & Oliver Montenbruck"
  - of
```
static Frames of(TimeScales timeScales,
                 CelestialBodies celestialBodies)
```
    从给定数据创建一组参考系。
    
    参数:
    
    timeScales - 用于构建参考系以及EOP数据集。
    
    celestialBodies - 用于获取getICRF()，即太阳系质心的惯性参考系。
    
    返回:
    
    从给定数据构建的一组参考系。
    
    另请参阅:
    
    of(TimeScales, Supplier)
  - of
```
static Frames of(TimeScales timeScales,
                 Supplier<Frame> icrfSupplier)
```
    从给定数据创建一组参考系。
    
    参数:
    
    timeScales - 用于构建参考系以及EOP数据集。
    
    icrfSupplier - 用于获取getICRF()。例如，celestialBodies.getSolarSystemBarycenter().getInertiallyOrientedFrame()
    
    返回:
    
    从给定数据构建的一组参考系。
    
    另请参阅:
    
    CelestialBodies, TimeScales.of(Collection, BiFunction)

Interface Frames

Method Summary

Method Detail

getEOPHistory

getFrame

getGCRF

getICRF

getEcliptic

getEME2000

getITRF

getTIRF

getITRF

buildUncachedITRF

getTIRF

getCIRF

getVeis1950

getITRFEquinox

getGTOD

getGTOD

getTOD

getTOD

getMOD

getMOD

getTEME

getPZ9011

of

of