TLE (OREKIT 12.0.1 API)

java.lang.Object
- org.orekit.propagation.analytical.tle.TLE

All Implemented Interfaces:

Serializable, TimeStamped, ParameterDriversProvider
```
public class TLE
extends Object
implements TimeStamped, Serializable, ParameterDriversProvider
```
这个类是单个TLE数据集的容器。
TLE数据集可以通过直接提供两行数据来构建，此时将在内部执行解析，也可以通过提供已解析的元素来构建。

TLE不能直接转换为Orbit实例。它们只与专用的propagator相关联，后者还计算位置和速度坐标。任何直接使用轨道参数如eccentricity、inclination等而没有参考TLE propagator的尝试都容易出错。

有关TLE格式的更多信息可以在CelesTrak网站上找到。

Author:

Fabien Maussion, Luc Maisonobe

See Also:

Serialized Form

Field Summary

Fields
Modifier and Type	Field and Description
`static String`	`B_STAR` B*系数的参数名称。
`static int`	`DEFAULT` 默认星历类型（SGP4/SDP4）的标识符。
`static int`	`SDP4` SDP4星历类型的标识符。
`static int`	`SDP8` SDP8星历类型的标识符。
`static int`	`SGP` SGP星历类型的标识符。
`static int`	`SGP4` SGP4星历类型的标识符。
`static int`	`SGP8` SGP8星历类型的标识符。

Constructor Summary

Constructors
Constructor and Description
`TLE(int satelliteNumber, char classification, int launchYear, int launchNumber, String launchPiece, int ephemerisType, int elementNumber, AbsoluteDate epoch, double meanMotion, double meanMotionFirstDerivative, double meanMotionSecondDerivative, double e, double i, double pa, double raan, double meanAnomaly, int revolutionNumberAtEpoch, double bStar)` 使用已解析的元素的简单构造函数。
`TLE(int satelliteNumber, char classification, int launchYear, int launchNumber, String launchPiece, int ephemerisType, int elementNumber, AbsoluteDate epoch, double meanMotion, double meanMotionFirstDerivative, double meanMotionSecondDerivative, double e, double i, double pa, double raan, double meanAnomaly, int revolutionNumberAtEpoch, double bStar, TimeScale utc)` 使用已解析的元素和给定的UTC时间标度的简单构造函数。
`TLE(String line1, String line2)` 使用未解析的两行数据的简单构造函数。
`TLE(String line1, String line2, TimeScale utc)` 使用未解析的两行数据和给定的UTC时间标度的简单构造函数。

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`boolean`	`equals(Object o)` 检查此TLE是否等于提供的TLE。
`double`	`getBStar()` 获取TLE日期的弹道系数。
`double`	`getBStar(AbsoluteDate date)` 获取特定日期的弹道系数。
`char`	`getClassification()` 获取分类。
`AbsoluteDate`	`getDate()` 获取TLE当前日期。
`double`	`getE()` 获取偏心率。
`int`	`getElementNumber()` 获取元素编号。
`int`	`getEphemerisType()` 获取星历类型。
`double`	`getI()` 获取倾角。
`int`	`getLaunchNumber()` 获取发射编号。
`String`	`getLaunchPiece()` 获取发射部件。
`int`	`getLaunchYear()` 获取发射年份。
`String`	`getLine1()` 获取第一行。
`String`	`getLine2()` 获取第二行。
`double`	`getMeanAnomaly()` 获取平近点角。
`double`	`getMeanMotion()` 获取平均运动。
`double`	`getMeanMotionFirstDerivative()` 获取平均运动的第一导数。
`double`	`getMeanMotionSecondDerivative()` 获取平均运动的第二导数。
`List<ParameterDriver>`	`getParametersDrivers()` 获取TLE传播SGP4和SDP4的驱动程序。
`double`	`getPerigeeArgument()` 获取近地点幅角。
`double`	`getRaan()` 获取升交点赤经。
`int`	`getRevolutionNumberAtEpoch()` 获取革命数。
`int`	`getSatelliteNumber()` 获取卫星ID。
`TimeScale`	`getUtc()` 获取用于创建此TLE的UTC时间标度。
`int`	`hashCode()` 获取此TLE的哈希码。
`static boolean`	`isFormatOK(String line1, String line2)` 检查行格式的有效性。
`static TLE`	`stateToTLE(SpacecraftState state, TLE templateTLE, TleGenerationAlgorithm generationAlgorithm)` 将空间飞行器状态转换为TLE。
`String`	`toString()` 获取此TLE集的字符串表示。

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

Methods inherited from interface org.orekit.time.TimeStamped
durationFrom

Methods inherited from interface org.orekit.utils.ParameterDriversProvider
getNbParametersDriversValue, getParameterDriver, getParameters, getParameters, getParameters, getParameters, getParametersAllValues, getParametersAllValues, isSupported

- Field Detail
  - SGP
```
public static final int SGP
```
    SGP星历类型的标识符。
    
    另请参阅:
    
    常量字段值
  - SGP4
```
public static final int SGP4
```
    SGP4星历类型的标识符。
    
    另请参阅:
    
    常量字段值
  - SDP4
```
public static final int SDP4
```
    SDP4星历类型的标识符。
    
    另请参阅:
    
    常量字段值
  - SGP8
```
public static final int SGP8
```
    SGP8星历类型的标识符。
    
    另请参阅:
    
    常量字段值
  - SDP8
```
public static final int SDP8
```
    SDP8星历类型的标识符。
    
    另请参阅:
    
    常量字段值
  - DEFAULT
```
public static final int DEFAULT
```
    默认星历类型（SGP4/SDP4）的标识符。
    
    另请参阅:
    
    常量字段值
  - B_STAR
```
public static final String B_STAR
```
    B*系数的参数名称。
    
    另请参阅:
    
    常量字段值
- Constructor Detail
  - TLE
```
@DefaultDataContext
public TLE(String line1,
                               String line2)
```
    使用未解析的两行数据的简单构造函数。此构造函数使用默认数据上下文。
    在尝试构建此对象之前，应调用静态方法isFormatOK(String, String)。
    
    参数:
    
    line1 - 第一个元素（69个字符的字符串）
    
    line2 - 第二个元素（69个字符的字符串）
    
    另请参阅:
    
    TLE(String, String, TimeScale)
  - TLE
```
public TLE(String line1,
           String line2,
           TimeScale utc)
```
    使用未解析的两行数据和给定的UTC时间标度的简单构造函数。
    在尝试构建此对象之前，应调用静态方法isFormatOK(String, String)。
    
    参数:
    
    line1 - 第一个元素（69个字符的字符串）
    
    line2 - 第二个元素（69个字符的字符串）
    
    utc - UTC时间标度
    
    自从:
    
    10.1
  - TLE
```
@DefaultDataContext
public TLE(int satelliteNumber,
                               char classification,
                               int launchYear,
                               int launchNumber,
                               String launchPiece,
                               int ephemerisType,
                               int elementNumber,
                               AbsoluteDate epoch,
                               double meanMotion,
                               double meanMotionFirstDerivative,
                               double meanMotionSecondDerivative,
                               double e,
                               double i,
                               double pa,
                               double raan,
                               double meanAnomaly,
                               int revolutionNumberAtEpoch,
                               double bStar)
```
    使用已解析的元素的简单构造函数。此构造函数使用默认数据上下文。
    
    平近点角、升交点赤经Ω和近地点幅角ω被归一化到[0, 2π]区间，因为它们可能为负数。之后，对一些轨道元素进行范围检查：
```
     meanMotion >= 0
     0 <= i <= π
     0 <= Ω <= 2π
     0 <= e <= 1
     0 <= ω <= 2π
     0 <= meanAnomaly <= 2π
 
```
    参数:
    
    satelliteNumber - 卫星编号
    
    classification - 分类（未分类为U）
    
    launchYear - 发射年份（所有数字）
    
    launchNumber - 发射编号
    
    launchPiece - 发射部件（3个字符的字符串）
    
    ephemerisType - 星历类型
    
    elementNumber - 元素编号
    
    epoch - 元素时刻
    
    meanMotion - 平均运动（弧度/秒）
    
    meanMotionFirstDerivative - 平均运动第一导数（弧度/秒²）
    
    meanMotionSecondDerivative - 平均运动第二导数（弧度/秒³）
    
    e - 偏心率
    
    i - 倾角（弧度）
    
    pa - 近地点幅角（弧度）
    
    raan - 升交点赤经（弧度）
    
    meanAnomaly - 平近点角（弧度）
    
    revolutionNumberAtEpoch - 元素时刻的革命数
    
    bStar - 弹道系数
    
    另请参阅:
    
    TLE(int, char, int, int, String, int, int, AbsoluteDate, double, double, double, double, double, double, double, double, int, double, TimeScale)
  - TLE
```
public TLE(int satelliteNumber,
           char classification,
           int launchYear,
           int launchNumber,
           String launchPiece,
           int ephemerisType,
           int elementNumber,
           AbsoluteDate epoch,
           double meanMotion,
           double meanMotionFirstDerivative,
           double meanMotionSecondDerivative,
           double e,
           double i,
           double pa,
           double raan,
           double meanAnomaly,
           int revolutionNumberAtEpoch,
           double bStar,
           TimeScale utc)
```
    使用已解析的元素和给定的UTC时间标度的简单构造函数。
    
    平近点角、升交点赤经Ω和近地点幅角ω被归一化到[0, 2π]区间，因为它们可能为负数。之后，对一些轨道元素进行范围检查：
```
     meanMotion >= 0
     0 <= i <= π
     0 <= Ω <= 2π
     0 <= e <= 1
     0 <= ω <= 2π
     0 <= meanAnomaly <= 2π
 
```
    参数:
    
    satelliteNumber - 卫星编号
    
    classification - 分类（未分类为U）
    
    launchYear - 发射年份（所有数字）
    
    launchNumber - 发射编号
    
    launchPiece - 发射部件（3个字符的字符串）
    
    ephemerisType - 星历类型
    
    elementNumber - 元素编号
    
    epoch - 元素时刻
    
    meanMotion - 平均运动（弧度/秒）
    
    meanMotionFirstDerivative - 平均运动第一导数（弧度/秒²）
    
    meanMotionSecondDerivative - 平均运动第二导数（弧度/秒³）
    
    e - 偏心率
    
    i - 倾角（弧度）
    
    pa - 近地点幅角（弧度）
    
    raan - 升交点赤经（弧度）
    
    meanAnomaly - 平近点角（弧度）
    
    revolutionNumberAtEpoch - 元素时刻的革命数
    
    bStar - 弹道系数
    
    utc - UTC时间标度
    
    自从:
    
    10.1
- Method Detail
  - getUtc
```
public TimeScale getUtc()
```
    获取用于创建此TLE的UTC时间标度。
    
    返回：
    
    UTC时间标度。
  - getLine1
```
public String getLine1()
```
    获取第一行。
    
    返回：
    
    第一行
  - getLine2
```
public String getLine2()
```
    获取第二行。
    
    返回：
    
    第二行
  - getSatelliteNumber
```
public int getSatelliteNumber()
```
    获取卫星ID。
    
    返回：
    
    卫星编号
  - getClassification
```
public char getClassification()
```
    获取分类。
    
    返回：
    
    分类
  - getLaunchYear
```
public int getLaunchYear()
```
    获取发射年份。
    
    返回：
    
    发射年份
  - getLaunchNumber
```
public int getLaunchNumber()
```
    获取发射编号。
    
    返回：
    
    发射编号
  - getLaunchPiece
```
public String getLaunchPiece()
```
    获取发射部件。
    
    返回：
    
    发射部件
  - getEphemerisType
```
public int getEphemerisType()
```
    获取星历类型。
    
    返回：
    
    星历类型（其中之一为DEFAULT，SGP，SGP4，SGP8，SDP4，SDP8）
  - getElementNumber
```
public int getElementNumber()
```
    获取元素编号。
    
    返回：
    
    元素编号
  - getDate
```
public AbsoluteDate getDate()
```
    获取TLE当前日期。
    
    指定者：
    
    getDate 在接口 TimeStamped
    
    返回：
    
    纪元
  - getMeanMotion
```
public double getMeanMotion()
```
    获取平均运动。
    
    返回：
    
    平均运动（弧度/秒）
  - getMeanMotionFirstDerivative
```
public double getMeanMotionFirstDerivative()
```
    获取平均运动第一导数。
    
    返回：
    
    平均运动第一导数（弧度/秒²）
  - getMeanMotionSecondDerivative
```
public double getMeanMotionSecondDerivative()
```
    获取平均运动第二导数。
    
    返回：
    
    平均运动第二导数（弧度/秒³）
  - getE
```
public double getE()
```
    获取偏心率。
    
    返回：
    
    偏心率
  - getI
```
public double getI()
```
    获取倾角。
    
    返回：
    
    倾角（弧度）
  - getPerigeeArgument
```
public double getPerigeeArgument()
```
    获取近地点幅角。
    
    返回：
    
    近地点幅角（弧度）
  - getRaan
```
public double getRaan()
```
    获取升交点赤经。
    
    返回：
    
    升交点赤经（弧度）
  - getMeanAnomaly
```
public double getMeanAnomaly()
```
    获取平近点角。
    
    返回：
    
    平近点角（弧度）
  - getRevolutionNumberAtEpoch
```
public int getRevolutionNumberAtEpoch()
```
    获取革命数。
    
    返回：
    
    在纪元时的革命数
  - getBStar
```
public double getBStar()
```
    获取TLE日期的弹道系数。
    
    返回：
    
    bStar
  - getBStar
```
public double getBStar(AbsoluteDate date)
```
    获取特定日期的弹道系数。
    
    参数：
    
    date - 要获取弹道系数的日期
    
    返回：
    
    bStar
  - toString
```
public String toString()
```
    获取此TLE集的字符串表示形式。
    表示形式只是两行，由平台行分隔。
    
    覆盖：
    
    toString 在类 Object
    
    返回：
    
    此TLE集的字符串表示形式
  - stateToTLE
```
public static TLE stateToTLE(SpacecraftState state,
                             TLE templateTLE,
                             TleGenerationAlgorithm generationAlgorithm)
```
    将航天器状态转换为TLE。
    
    参数：
    
    state - 要转换为TLE的航天器状态
    
    templateTLE - 用于获取标识和估计新TLE的第一个猜测
    
    generationAlgorithm - TLE生成算法
    
    返回：
    
    生成的TLE
    
    自：
    
    12.0
  - isFormatOK
```
public static boolean isFormatOK(String line1,
                                 String line2)
```
    检查行格式的有效性。
    
    参数：
    
    line1 - 第一个元素
    
    line2 - 第二个元素
    
    返回：
    
    如果格式被识别（非空行，69个字符长度，行内容），则为true，否则为false
  - equals
```
public boolean equals(Object o)
```
    检查此TLE是否等于提供的TLE。
    由于TLE的对象和字符串表示之间精度的差异，即使由toString()返回的字符串表示相等，此方法可能返回false。
    
    覆盖：
    
    equals 在类 Object
    
    参数：
    
    o - 其他TLE
    
    返回：
    
    如果此TLE等于提供的TLE，则为true
  - hashCode
```
public int hashCode()
```
    获取此TLE的哈希码。
    
    覆盖：
    
    hashCode 在类 Object
    
    返回：
    
    哈希码
  - getParametersDrivers
```
public List<ParameterDriver> getParametersDrivers()
```
    获取TLE传播SGP4和SDP4的驱动程序。
    
    指定者：
    
    getParametersDrivers 在接口 ParameterDriversProvider
    
    返回：
    
    SGP4和SDP4模型参数的驱动程序

Class TLE

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Methods inherited from interface org.orekit.time.TimeStamped

Methods inherited from interface org.orekit.utils.ParameterDriversProvider

Field Detail

SGP

SGP4

SDP4

SGP8

SDP8

DEFAULT

B_STAR

Constructor Detail

TLE

TLE

TLE

TLE

Method Detail

getUtc

getLine1

getLine2

getSatelliteNumber

getClassification

getLaunchYear

getLaunchNumber

getLaunchPiece

getEphemerisType

getElementNumber

getDate

getMeanMotion

getMeanMotionFirstDerivative

getMeanMotionSecondDerivative

getE

getI

getPerigeeArgument

getRaan

getMeanAnomaly

getRevolutionNumberAtEpoch

getBStar

getBStar

toString

stateToTLE

isFormatOK

equals

hashCode

getParametersDrivers