# Tle
查阅Cesium API

#### new mars3d.Tle(tle1, tle2, name)
plugins/mars3d-space/core/Tle.js 8

卫星TLE和SGP4相关算法类

参数名称 | 类型 | 描述信息
--- | --- | ---
`tle1` | string | 卫星两行轨道数（TLE） 的tle1，每行69个字符, 示例：'1 39150U 13018A 18309.20646405 .00000034 00000-0 12253-4 0 9993'
`tle2` | string | 卫星两行轨道数（TLE） 的tle2，每行69个字符, 示例：'2 39150 97.9189 29.2064 0018076 220.9170 139.0692 14.76532215297913'
`name` | string | 可选 卫星名称

##### 参考:

- TLE解释

### 属性值

#### 只读 bstarDrag : number
plugins/mars3d-space/core/Tle.js 137

BSTAR阻力系数，用于大气阻力对卫星运动的影响。 tle1的第45–52列

#### 只读 checksum1 : number
plugins/mars3d-space/core/Tle.js 167

校验和，指这一行的所有非数字字符，按照“字母、空格、句点、正号= 0；负号=1”的规则换算成0和1后，将这一行中原来的全部数字加起来，以10为模计算后所得的和。校验和可以检查出90%的数据存储或传送错误。按十进制加起来的个位数字的校验和，用于精确纠正误差。 tle1的第69列

#### 只读 checksum2 : number
plugins/mars3d-space/core/Tle.js 258

校验和， tle2的第69列

#### 只读 classification : string
plugins/mars3d-space/core/Tle.js 57

卫星类别（U表示不保密，可供公众使用的；C 表示保密，仅限NORAD使用；S表示保密的，仅限NORAD使用）, tle1的第8列

#### 只读 cospar : string
plugins/mars3d-space/core/Tle.js 36

COSPAR国际代号,国际空间研究委员会制定.

#### 只读 eccentricity : number
plugins/mars3d-space/core/Tle.js 199

轨道偏心率，轨道离心率是指卫星椭圆轨道的中心点到地球的球心点的距离（c）除以卫星轨道半长轴(a)得到的一个0（圆型）到1（抛物线）之间的小数值。 tle2的第27–33列

#### 只读 epochDay : number
plugins/mars3d-space/core/Tle.js 107

TLE历时 (用十进制小数表示一年中的第几日和日中的小数部分)， tle1的第21–32列

#### 只读 epochYear : number
plugins/mars3d-space/core/Tle.js 97

TLE历时（年份后两位）， tle1的第19–20列

#### 只读 firstTimeDerivative : number
plugins/mars3d-space/core/Tle.js 117

平均运动的一阶时间导数，用来计算每一天平均运动的变化带来的轨道漂移，提供给轨道计算软件预测卫星的位置。两行式轨道数据使用这个数据校准卫星的位置。 tle1的第34–43列

#### 只读 inclination : number
plugins/mars3d-space/core/Tle.js 179

轨道的交角是指天体的轨道面和地球赤道面之间的夹度，用0～90°来表示顺行轨道（从地球北极上空看是逆时针运行）；用90～180°表示逆行轨道（从地球北极上空看是顺时针运行）。 tle2的第09–16列

#### 只读 intDesignatorLaunchNumber : number
plugins/mars3d-space/core/Tle.js 77

返回当年的发射顺序编号，这是COSPAR id的一部分(国际指示器)， tle1的第12–14列

#### 只读 intDesignatorPieceOfLaunch : string
plugins/mars3d-space/core/Tle.js 87

发射卫星个数（A表示是第一个，如果一次发射多颗卫星，使用26个英文字母排序；如果超过了26个编号，则使用两位字母，如AA、AB、AC编号），这是COSPAR id的一部分(国际指示器)， tle1的第15–17列

#### 只读 intDesignatorYear : number
plugins/mars3d-space/core/Tle.js 67

返回发射年份(最后两位数字)，这是COSPAR id的一部分(国际指示器)， tle1的第10–11列

#### 只读 meanAnomaly : number
plugins/mars3d-space/core/Tle.js 219

平近点角， tle2的第44–51列

#### 只读 meanMotion : number
plugins/mars3d-space/core/Tle.js 229

每天绕地球公转圈数(平均运动)， tle2的第53–63列

#### 只读 norad : number
plugins/mars3d-space/core/Tle.js 47

NORAD 空间目录号,北美空防司令部制定。 tle1的第3-7列

#### 只读 orbitModel : number
plugins/mars3d-space/core/Tle.js 147

美国空军空间指挥中心内部使用的为1；美国空军空间指挥中心以外公开使用标识为0。 tle1的第63列

#### 只读 perigee : number
plugins/mars3d-space/core/Tle.js 209

近地点角矩(deg) tle2的第35–42列

#### 只读 period : number
plugins/mars3d-space/core/Tle.js 238

卫星的运行周期（单位：分钟）

#### 只读 revNumberAtEpoch : number
plugins/mars3d-space/core/Tle.js 248

发射以来飞行的圈数， tle2的第64–68列

#### 只读 rightAscension : number
plugins/mars3d-space/core/Tle.js 189

升交点赤经，升交点赤经是指卫星由南到北穿过地球赤道平面时，与地球赤道平面的交点。 tle2的第18–25列

#### 只读 secondTimeDerivative : number
plugins/mars3d-space/core/Tle.js 127

平均运动的二阶时间导数，用来计算每一天平均运动的变化带来的轨道漂移，提供给轨道计算软件预测卫星的位置。 tle1的第45–52列

#### 只读 tleSetNumber : number
plugins/mars3d-space/core/Tle.js 157

星历编号，TLE数据按新发现卫星的先后顺序的编号， tle1的第65–68列

### 方法

#### static mars3d.Tle.ecfToEci(positionEcf, datetime) → Cesium.Cartesian3
plugins/mars3d-space/core/Tle.js 559

ECEF地心地固坐标系 转换为 ECI惯性系坐标

参数名称 | 类型 | 描述信息
--- | --- | ---
`positionEcf` | Cesium.Cartesian3 | ECEF(地心地固坐标系) 坐标
`datetime` | Date | Cesium.JulianDate | number | 指定时间, Number时请传入格林尼治恒星时(GMST)时间

##### 返回值:

ECI(地心惯性坐标系)坐标

#### static mars3d.Tle.eciToEcf(positionEci, datetime, positionEcf) → Cesium.Cartesian3
plugins/mars3d-space/core/Tle.js 535

ECI惯性系坐标 转换为 ECEF地心地固坐标系

参数名称 | 类型 | 描述信息
--- | --- | ---
`positionEci` | Cesium.Cartesian3 | ECI(地心惯性坐标系)坐标
`datetime` | Date | Cesium.JulianDate | number | 指定时间, Number时请传入格林尼治恒星时(GMST)时间
`positionEcf` | Cesium.Cartesian3 | 可选 ECI(地心惯性坐标系)坐标

##### 返回值:

ECEF(地心地固坐标系) 坐标

#### static mars3d.Tle.eciToGeodetic(positionEci, datetime) → LngLatPoint
plugins/mars3d-space/core/Tle.js 511

ECI惯性系坐标 转换为 经纬度坐标

参数名称 | 类型 | 描述信息
--- | --- | ---
`positionEci` | Cesium.Cartesian3 | ECI(地心惯性坐标系) 坐标
`datetime` | Date | Cesium.JulianDate | number | 指定时间, Number时请传入格林尼治恒星时(GMST)时间

##### 返回值:

经纬度坐标

##### 参考:

- Cesium.ReferenceFrame.INERTIAL

#### static mars3d.Tle.getEcfPosition(tle1, tle2, datetime) → Cesium.Cartesian3|undefined
plugins/mars3d-space/core/Tle.js 473

获取卫星指定时间所在的 ECEF地心地固坐标系

参数名称 | 类型 | 描述信息
--- | --- | ---
`tle1` | string | 卫星TLE的第一行
`tle2` | string | 卫星TLE的第二行
`datetime` | Date | Cesium.JulianDate | number | 指定的时间

##### 返回值:

ECEF(地心地固坐标系) 坐标

#### static mars3d.Tle.getEciPosition(tle1, tle2, datetime) → Cesium.Cartesian3|undefined
plugins/mars3d-space/core/Tle.js 485

获取卫星指定时间所在的 ECI惯性坐标

参数名称 | 类型 | 描述信息
--- | --- | ---
`tle1` | string | 卫星TLE的第一行
`tle2` | string | 卫星TLE的第二行
`datetime` | Date | Cesium.JulianDate | number | 指定的时间

##### 返回值:

ECI(地心惯性坐标系)坐标

#### static mars3d.Tle.getPoint(tle1, tle2, datetime, isFixed) → LngLatPoint|undefined
plugins/mars3d-space/core/Tle.js 461

计算卫星指定时间所在的 经纬度位置

参数名称 | 类型 | 描述信息
--- | --- | ---
`tle1` | string | 卫星TLE的第一行
`tle2` | string | 卫星TLE的第二行
`datetime` | Date | Cesium.JulianDate | number | 指定的时间
`isFixed` | boolean | 可选 是否返回Cesium.ReferenceFrame.FIXED地固系坐标

##### 返回值:

卫星当前经纬度位置

#### static mars3d.Tle.gstime(datetime) → number
plugins/mars3d-space/core/Tle.js 495

获取 格林尼治恒星时(GMST)时间

参数名称 | 类型 | 描述信息
--- | --- | ---
`datetime` | Date | Cesium.JulianDate | 时间对象

##### 返回值:

格林尼治恒星时(GMST)时间

#### static mars3d.Tle.tle2coe(tle1, tle2) → object
plugins/mars3d-space/core/Tle.js 614

两行轨道根数 转换到 开普勒六根数

参数名称 | 类型 | 描述信息
--- | --- | ---
`tle1` | string | 两行轨道根数1
`tle2` | string | 两行轨道根数2

##### 返回值:

卫星开普勒六根数对象

#### getEcfPosition(datetime) → Cesium.Cartesian3|undefined
plugins/mars3d-space/core/Tle.js 296

获取卫星指定时间所在的 ECEF地心地固坐标系

参数名称 | 类型 | 描述信息
--- | --- | ---
`datetime` | Date | Cesium.JulianDate | number | 指定的时间

##### 返回值:

ECEF(地心地固坐标系) 坐标

#### getEciPosition(datetime) → Cesium.Cartesian3|undefined
plugins/mars3d-space/core/Tle.js 315

获取卫星指定时间所在的 ECI惯性坐标

参数名称 | 类型 | 描述信息
--- | --- | ---
`datetime` | Date | Cesium.JulianDate | number | 指定的时间

##### 返回值:

ECI(地心惯性坐标系)坐标

#### getLookAngles(point, datetime) → Tle.LookAngles
plugins/mars3d-space/core/Tle.js 407

获取 地面地点 对卫星的 天文观测值

参数名称 | 类型 | 描述信息
--- | --- | ---
`point` | LngLatPoint | 地面地点经纬度坐标
`datetime` | Date | Cesium.JulianDate | number | 指定的时间

##### 返回值:

观测值

#### getPoint(time, isFixed) → LngLatPoint|undefined
plugins/mars3d-space/core/Tle.js 351

获取卫星指定时间 所在的位置坐标(经纬度)

参数名称 | 类型 | 描述信息
--- | --- | ---
`time` | Date | Cesium.JulianDate | number | 指定的时间
`isFixed` | boolean | 可选 是否返回Cesium.ReferenceFrame.FIXED地固系坐标

##### 返回值:

卫星当前经纬度位置

#### getPosition(time, isFixed) → Cesium.Cartesian3|undefined
plugins/mars3d-space/core/Tle.js 332

获取卫星指定时间所在的坐标(用于cesium内property坐标)

参数名称 | 类型 | 描述信息
--- | --- | ---
`time` | Date | Cesium.JulianDate | number | 指定的时间
`isFixed` | boolean | 可选 是否返回Cesium.ReferenceFrame.FIXED地固系坐标

##### 返回值:

坐标

### 定义的类型

#### mars3d.Tle.LookAngles
plugins/mars3d-space/core/Tle.js 389

从地面上某点的天文观测角度等值。

##### 属性:

属性名称 | 类型 | 描述信息
--- | --- | ---
`position` | Cesium.Cartesian3 | 卫星的当前位置
`range` | number | 与卫星的距离，单位：米
`azimuth` | number | 方位角，角度值
`elevation` | number | 仰角，角度值