CelestialBodyFactory (OREKIT 12.0.1 API)

java.lang.Object
- org.orekit.bodies.CelestialBodyFactory

```
public class CelestialBodyFactory
extends Object
```
太阳系天体的工厂类。
此工厂提供了太阳、月球和行星（包括冥王星矮行星）。此外，为方便起见，还提供了两个重要点：太阳系质心和地月质心。

这些基础以天体为中心的参考系要么是直接作为EME2000的子级（对于月球和地月质心），要么是其他以天体为中心的参考系的子级。例如，从EME2000到以木星为中心的参考系的路径是：EME2000，以地月质心为中心，以太阳系质心为中心，以木星为中心。这些参考系的定义变换是简单线性的平移/速度变换的组合，没有任何旋转。因此，参考系轴始终与EME2000参考系轴平行。

此类提供的天体位置是使用JPL DE 405/DE 406历书进行插值的。

Author:

Luc Maisonobe

Field Summary

Fields
Modifier and Type	Field and Description
`static String`	`EARTH` 地球的预定义名称。
`static String`	`EARTH_MOON` 地月质心的预定义名称。
`static String`	`JUPITER` 木星的预定义名称。
`static String`	`MARS` 火星的预定义名称。
`static String`	`MERCURY` 水星的预定义名称。
`static String`	`MOON` 月球的预定义名称。
`static String`	`NEPTUNE` 海王星的预定义名称。
`static String`	`PLUTO` 冥王星的预定义名称。
`static String`	`SATURN` 土星的预定义名称。
`static String`	`SOLAR_SYSTEM_BARYCENTER` 太阳系质心的预定义名称。
`static String`	`SUN` 太阳的预定义名称。
`static String`	`URANUS` 天王星的预定义名称。
`static String`	`VENUS` 金星的预定义名称。

Method Summary

All Methods Static Methods Concrete Methods
Modifier and Type	Method and Description
`static void`	`addCelestialBodyLoader(String name, CelestialBodyLoader loader)` 为天体添加加载器。
`static void`	`addDefaultCelestialBodyLoader(String supportedNames)` 为所有预定义天体添加默认加载器。
`static void`	`addDefaultCelestialBodyLoader(String name, String supportedNames)` 为天体添加默认加载器。
`static void`	`clearCelestialBodyCache()` 清除所有已加载的天体。
`static void`	`clearCelestialBodyCache(String name)` 从内部缓存中清除指定的天体。
`static void`	`clearCelestialBodyLoaders()` 清除所有天体的加载器。
`static void`	`clearCelestialBodyLoaders(String name)` 清除一个天体的加载器。
`static CelestialBody`	`getBody(String name)` 获取一个天体。
`static LazyLoadedCelestialBodies`	`getCelestialBodies()` 获取由此类中的静态方法调用的`CelestialBodies`的实例。
`static CelestialBody`	`getEarth()` 获取地球的单例天体。
`static CelestialBody`	`getEarthMoonBarycenter()` 获取地月质心的单例天体对。
`static CelestialBody`	`getJupiter()` 获取木星的单例天体。
`static CelestialBody`	`getMars()` 获取火星的单例天体。
`static CelestialBody`	`getMercury()` 获取水星的单例天体。
`static CelestialBody`	`getMoon()` 获取月球的单例天体。
`static CelestialBody`	`getNeptune()` 获取海王星的单例天体。
`static CelestialBody`	`getPluto()` 获取冥王星的单例天体。
`static CelestialBody`	`getSaturn()` 获取土星的单例天体。
`static CelestialBody`	`getSolarSystemBarycenter()` 获取太阳系质心的聚合天体。
`static CelestialBody`	`getSun()` 获取太阳的单例天体。
`static CelestialBody`	`getUranus()` 获取天王星的单例天体。
`static CelestialBody`	`getVenus()` 获取金星的单例天体。

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

- Field Detail
  - SOLAR_SYSTEM_BARYCENTER
```
public static final String SOLAR_SYSTEM_BARYCENTER
```
    太阳系质心的预定义名称。
    
    另请参阅:
    
    getBody(String), 常量字段值
  - SUN
```
public static final String SUN
```
    太阳的预定义名称。
    
    另请参阅:
    
    getBody(String), 常量字段值
  - MERCURY
```
public static final String MERCURY
```
    水星的预定义名称。
    
    另请参阅:
    
    getBody(String), 常量字段值
  - VENUS
```
public static final String VENUS
```
    金星的预定义名称。
    
    另请参阅:
    
    getBody(String), 常量字段值
  - EARTH_MOON
```
public static final String EARTH_MOON
```
    地月质心的预定义名称。
    
    另请参阅:
    
    getBody(String), 常量字段值
  - EARTH
```
public static final String EARTH
```
    地球的预定义名称。
    
    另请参阅:
    
    getBody(String), 常量字段值
  - MOON
```
public static final String MOON
```
    月球的预定义名称。
    
    另请参阅:
    
    getBody(String), 常量字段值
  - MARS
```
public static final String MARS
```
    火星的预定义名称。
    
    另请参阅:
    
    getBody(String), 常量字段值
  - JUPITER
```
public static final String JUPITER
```
    木星的预定义名称。
    
    另请参阅:
    
    getBody(String), 常量字段值
  - SATURN
```
public static final String SATURN
```
    土星的预定义名称。
    
    另请参阅:
    
    getBody(String), 常量字段值
  - URANUS
```
public static final String URANUS
```
    天王星的预定义名称。
    
    另请参阅:
    
    getBody(String), 常量字段值
  - NEPTUNE
```
public static final String NEPTUNE
```
    海王星的预定义名称。
    
    另请参阅:
    
    getBody(String), 常量字段值
  - PLUTO
```
public static final String PLUTO
```
    冥王星的预定义名称。
    
    另请参阅:
    
    getBody(String), 常量字段值
- Method Detail
  - getCelestialBodies
```
@DefaultDataContext
public static LazyLoadedCelestialBodies getCelestialBodies()
```
    获取由此类中的静态方法调用的CelestialBodies的实例。
    
    返回:
    
    此工厂使用的参考系。
  - addCelestialBodyLoader
```
@DefaultDataContext
public static void addCelestialBodyLoader(String name,
                                                              CelestialBodyLoader loader)
```
    为天体添加加载器。
    
    参数:
    
    name - 天体的名称（可以是预定义名称之一或用户定义的名称）
    
    loader - 要为该天体添加的自定义加载器
    
    另请参阅:
    
    addDefaultCelestialBodyLoader(String), clearCelestialBodyLoaders(String), clearCelestialBodyLoaders()
  - addDefaultCelestialBodyLoader
```
@DefaultDataContext
public static void addDefaultCelestialBodyLoader(String supportedNames)
```
    为所有预定义天体添加默认加载器。
    
    参数:
    
    supportedNames - 支持的文件名称的正则表达式（如果使用默认的JPL文件名称，则可以为null）
    默认加载器寻找DE405或DE406 JPL历书。
    
    另请参阅:
    
    DE405 JPL历书, DE406 JPL历书, addCelestialBodyLoader(String, CelestialBodyLoader), addDefaultCelestialBodyLoader(String), clearCelestialBodyLoaders(String), clearCelestialBodyLoaders()
  - addDefaultCelestialBodyLoader
```
@DefaultDataContext
public static void addDefaultCelestialBodyLoader(String name,
                                                                     String supportedNames)
```
    添加天体的默认加载器。
    
    参数：
    
    name - 天体的名称（如果不是预定义的名称之一，则该方法不执行任何操作）
    
    supportedNames - 支持的文件名称的正则表达式（如果使用默认的JPL文件名称，则可以为null）
    默认加载器查找DE405或DE406 JPL天文历。
    
    另请参阅：
    
    DE405 JPL天文历, DE406 JPL天文历, addCelestialBodyLoader(String, CelestialBodyLoader), addDefaultCelestialBodyLoader(String), clearCelestialBodyLoaders(String), clearCelestialBodyLoaders()
  - clearCelestialBodyLoaders
```
@DefaultDataContext
public static void clearCelestialBodyLoaders(String name)
```
    清除一个天体的加载器。
    调用此方法还会清除通过此CelestialBodyLoader加载的天体。
    
    参数：
    
    name - 天体的名称
    
    另请参阅：
    
    addCelestialBodyLoader(String, CelestialBodyLoader), clearCelestialBodyLoaders(), clearCelestialBodyCache(String)
  - clearCelestialBodyLoaders
```
@DefaultDataContext
public static void clearCelestialBodyLoaders()
```
    清除所有天体的加载器。
    调用此方法还会清除所有已加载的天体。
    
    另请参阅：
    
    addCelestialBodyLoader(String, CelestialBodyLoader), clearCelestialBodyLoaders(String), clearCelestialBodyCache()
  - clearCelestialBodyCache
```
@DefaultDataContext
public static void clearCelestialBodyCache(String name)
```
    从内部缓存中清除指定的天体。
    
    参数：
    
    name - 天体的名称
  - clearCelestialBodyCache
```
@DefaultDataContext
public static void clearCelestialBodyCache()
```
    清除所有已加载的天体。
    调用此方法将从内部缓存中删除所有已加载的天体。随后对getBody(String)或类似方法的后续调用将导致从配置的加载器重新加载请求的天体。
  - getSolarSystemBarycenter
```
@DefaultDataContext
public static CelestialBody getSolarSystemBarycenter()
```
    获取太阳系质心聚合体。
    此聚合体的惯性定向框架和体定向框架都与ICRF（因此也与GCRF）对齐
    
    返回：
    
    太阳系质心聚合体
  - getSun
```
@DefaultDataContext
public static CelestialBody getSun()
```
    获取太阳单体天体。
    
    返回：
    
    太阳天体
  - getMercury
```
@DefaultDataContext
public static CelestialBody getMercury()
```
    获取水星单体天体。
    
    返回：
    
    太阳天体
  - getVenus
```
@DefaultDataContext
public static CelestialBody getVenus()
```
    获取金星单体天体。
    
    返回：
    
    金星天体
  - getEarthMoonBarycenter
```
@DefaultDataContext
public static CelestialBody getEarthMoonBarycenter()
```
    获取地月质心单体天体对。
    此对天体的惯性定向框架和体定向框架都与ICRF（因此也与GCRF）对齐
    
    返回：
    
    地月质心天体对
  - getEarth
```
@DefaultDataContext
public static CelestialBody getEarth()
```
    获取地球单体天体。
    
    返回：
    
    地球天体
  - getMoon
```
@DefaultDataContext
public static CelestialBody getMoon()
```
    获取月球单体天体。
    
    返回：
    
    月球天体
  - getMars
```
@DefaultDataContext
public static CelestialBody getMars()
```
    获取火星单体天体。
    
    返回：
    
    火星天体
  - getJupiter
```
@DefaultDataContext
public static CelestialBody getJupiter()
```
    获取木星单体天体。
    
    返回：
    
    木星天体
  - getSaturn
```
@DefaultDataContext
public static CelestialBody getSaturn()
```
    获取土星单体天体。
    
    返回：
    
    土星天体
  - getUranus
```
@DefaultDataContext
public static CelestialBody getUranus()
```
    获取天王星单体天体。
    
    返回：
    
    天王星天体
  - getNeptune
```
@DefaultDataContext
public static CelestialBody getNeptune()
```
    获取海王星单体天体。
    
    返回：
    
    海王星天体
  - getPluto
```
@DefaultDataContext
public static CelestialBody getPluto()
```
    获取冥王星单体天体。
    
    返回：
    
    冥王星天体
  - getBody
```
@DefaultDataContext
public static CelestialBody getBody(String name)
```
    获取一个天体。
    如果没有通过调用addCelestialBodyLoader添加CelestialBodyLoader，或者之后调用了clearCelestialBodyLoaders，则将自动调用addDefaultCelestialBodyLoader方法，一次使用JPL DE天文历的默认名称，一次使用IMCCE INPOP文件的默认名称。
    
    参数：
    
    name - 天体的名称
    
    返回：
    
    天体

Class CelestialBodyFactory

Field Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

SOLAR_SYSTEM_BARYCENTER

SUN

MERCURY

VENUS

EARTH_MOON

EARTH

MOON

MARS

JUPITER

SATURN

URANUS

NEPTUNE

PLUTO

Method Detail

getCelestialBodies

addCelestialBodyLoader

addDefaultCelestialBodyLoader

addDefaultCelestialBodyLoader

clearCelestialBodyLoaders

clearCelestialBodyLoaders

clearCelestialBodyCache

clearCelestialBodyCache

getSolarSystemBarycenter

getSun

getMercury

getVenus

getEarthMoonBarycenter

getEarth

getMoon

getMars

getJupiter

getSaturn

getUranus

getNeptune

getPluto

getBody