module

Kozai::Bundled

A handful of element sets compiled into the binary.

These exist for one situation: a station starting for the first time with no network and nothing cached. Without them the interface comes up empty — no satellites, dashes in every field — which reads as a broken program rather than as a station that has not been given any elements yet.

They are a last resort, not a source. Catalog reaches for them only when every configured file and URL has produced nothing and nothing is already in memory, and it says so in the log when it does. Their age is reported through the same field as any other element set, so a prediction made from them is labelled exactly as honestly as one made from a fresh download; by the time a release is a few weeks old the interface will be showing a stale warning over them, which is correct and is the point.

Nine satellites, chosen to make the first screen recognisable rather than to be a useful catalogue: the ISS, the oldest working amateur satellite and two popular FM birds, a geostationary one so the map shows a stationary footprint, and three weather satellites.

Constants

RETRIEVED_ON = "2026-08-05"

Retrieved from CelesTrak on 2026-08-05, groups amateur, weather and stations. Orbital element sets are US government data and carry no licence; CelesTrak asks only that clients cache rather than poll, which compiling them in rather satisfies.

TEXT = {{ read_file("/tmp/tmp.lHiJjp/src/src/elements/bundled.tle") }}

The raw file, as downloaded. Kept as text rather than as parsed structures so that it is diffable and so that regenerating it is a copy, not a code change.

Class methods

age

How old the compiled-in elements are now. Used to decide whether they are worth offering at all.

Source
elements

Parses the compiled-in text. Cheap enough to do on demand: nine satellites.

Source