Documentation / @interstellar-tools/types / MeanElementsInterface
Interface: MeanElementsInterface
Defined in: tracking.ts:50
A satellite's mean elements, as published in a two-line element set (TLE) or an Orbit Mean-elements Message (OMM): the orbit SGP4 was fitted to at an epoch, with the drag terms it needs.
Returned by parseTle and parseOmm in @interstellar-tools/tracking.
INFO
- These aren't osculating elements. They're averaged the way SGP4 averages them, and only give correct positions through SGP4: Kepler's equations on them are off by kilometres.
- The angles are in radians and the mean motion in rad/s, like the rest of the library. TLEs and OMMs carry degrees and revolutions per day.
- TLEs and OMMs carry half the first derivative of the mean motion and a sixth of the second;
meanMotionDotandmeanMotionDdotare the derivatives themselves. SGP4 doesn't use them.
Example
// The ISS on 2026-11-04
const iss: MeanElementsInterface = {
name: 'ISS (ZARYA)',
objectId: '1998-067A',
catalogNumber: 25544,
classification: 'U',
epoch: new Date('2026-11-04T08:52:07.404Z'),
epochJulianDate: 2461348.86953014,
meanMotion: 0.0011266,
meanMotionDot: 8.8e-14,
meanMotionDdot: 0,
e: 0.0007186,
i: 0.9012 as Radians,
raan: 5.6967 as Radians,
argp: 6.0519 as Radians,
meanAnomaly: 0.2327 as Radians,
bstar: 0.00010236,
elementSetNumber: 999,
revolutionNumber: 59348
};Properties
argp
argp: Radians;Defined in: tracking.ts:76
Argument of perigee (ω) in radians, in [0, 2π].
bstar
bstar: number;Defined in: tracking.ts:80
SGP4's drag term
catalogNumber
catalogNumber: number;Defined in: tracking.ts:56
The NORAD catalogue number.
classification
classification: 'U' | 'C' | 'S';Defined in: tracking.ts:58
The security classification: U unclassified, C classified or S secret. Public element sets are U.
e
e: number;Defined in: tracking.ts:70
Eccentricity, in [0, 1).
elementSetNumber
elementSetNumber: number;Defined in: tracking.ts:82
The element set number, counted up by the publisher for each new set.
epoch
epoch: Date;Defined in: tracking.ts:60
The epoch the elements hold at, in UTC, to the millisecond.
epochJulianDate
epochJulianDate: number;Defined in: tracking.ts:62
The epoch as a Julian date in UTC (d), to about 40 µs: finer than epoch.
i
i: Radians;Defined in: tracking.ts:72
Inclination in radians, in [0, π].
meanAnomaly
meanAnomaly: Radians;Defined in: tracking.ts:78
Mean anomaly (M) in radians, in [0, 2π].
meanMotion
meanMotion: number;Defined in: tracking.ts:64
Mean motion
meanMotionDdot
meanMotionDdot: number;Defined in: tracking.ts:68
Second time derivative of the mean motion
meanMotionDot
meanMotionDot: number;Defined in: tracking.ts:66
First time derivative of the mean motion
name?
name?: string;Defined in: tracking.ts:52
The satellite's name, such as ISS (ZARYA). Omitted when not given.
objectId?
objectId?: string;Defined in: tracking.ts:54
The international designator (COSPAR ID), such as 1998-067A: launch year, launch number and piece. Omitted when blank.
raan
raan: Radians;Defined in: tracking.ts:74
Right ascension of the ascending node (Ω) in radians, in [0, 2π].
revolutionNumber
revolutionNumber: number;Defined in: tracking.ts:84
The number of revolutions at the epoch. TLEs only hold five digits: it wraps at 100 000.