struct

Kozai::TLE::Elements

Inherits Struct < Value < Object

A parsed two-line element set.

Angles are in degrees and mean motion in revolutions per day, exactly as they appear in the file. SGP4 converts to radians and radians per minute at initialisation; keeping the raw units here means a round trip through this struct changes nothing.

This is a struct: element sets are created once per satellite and copied freely into propagator state, and there is no reason to put them on the heap.

Constructors

new(catalog_number : Int32, classification : Char, international_designator : String | Nil, epoch_year : Int32, epoch_day : Float64, mean_motion_dot : Float64, mean_motion_ddot : Float64, bstar : Float64, ephemeris_type : Int32, element_set_number : Int32, inclination : Float64, right_ascension : Float64, eccentricity : Float64, argument_of_perigee : Float64, mean_anomaly : Float64, mean_motion : Float64, revolution_number : Int32, name : String | Nil = nil)
Source

Instance methods

age(at : Time = Time.utc) : Time::Span

How old these elements are at at.

Accuracy degrades as this grows; the API reports it on every response and the web interface warns on it, because a plausible-looking answer from a week-old element set is the most common way to be wrong here.

Source
argument_of_perigee

Argument of perigee in degrees.

Source
bstar

Drag term B*, in inverse Earth radii.

Source
catalog_number

Satellite catalog number, alpha-5 decoded where applicable.

Source
classification

Security classification, conventionally 'U' for unclassified.

Source
deep_space?

Whether the deep-space branch of the model applies.

NOTE: the model switches to SDP4 at a period of 225 minutes, per Spacetrack Report No. 3. Below roughly 6.4 revolutions per day the near-earth branch is not merely less accurate, it is wrong — lunar and solar perturbations and resonance effects are simply absent from it.

Source
eccentricity

Eccentricity, dimensionless.

Source
element_set_number

Element set number.

Source
ephemeris_type

Ephemeris type. Zero in all distributed data.

Source
epoch

Epoch as a UTC Time.

Precision is limited to nanoseconds by Time. For propagation use #epoch_year and #epoch_day directly, or Timescale.julian_date, which keep the full Float64 day fraction.

Source
epoch_day

Day of the epoch year including fraction, where 1.0 is January 1st at 00:00 UTC.

Source
epoch_year

Four-digit epoch year, already resolved from the two-digit field.

Source
inclination

Inclination in degrees.

Source
international_designator

International designator (launch year, launch number, piece), or nil when the field is blank — which happens in older and synthetic sets.

Source
mean_anomaly

Mean anomaly at epoch in degrees.

Source
mean_motion

Mean motion in revolutions per day.

This is the Kozai mean motion; SGP4 converts it to the Brouwer definition during initialisation.

Source
mean_motion_ddot

Second derivative of mean motion divided by six, in revolutions per day cubed, as stored in the file.

Source
mean_motion_dot

First derivative of mean motion divided by two, in revolutions per day squared, as stored in the file.

Unused by SGP4 itself, which derives drag from #bstar; retained because it is part of the element set and appears in the API.

Source
name

Common name, if the set came from a 3-line ("3LE") record.

Source
period_minutes

Orbital period in minutes, derived from mean motion.

Source
revolution_number

Revolution number at epoch.

Source
right_ascension

Right ascension of the ascending node in degrees.

Source