Orbit age

For the complete documentation index, see llms.txt.

Orbit age is how long it has been since a spacecraft’s orbit was last updated. VALAR governs it with one workspace-wide policy that has two graded levels: the degraded level, where a spacecraft falls back to a lower-accuracy public-catalog orbit and the platform signals it, and the stale level, where the orbit is too old to trust and VALAR blocks the products that depend on it. Both levels are measured from the same point — each spacecraft’s latest state vector — and you set them together in one place. Both levels surface in one signal: the orbit-data-age footer that sits at the bottom of every page, tagging each affected spacecraft as Degraded or Blocked. Route: Settings → Orbits → Orbit age (the orbit-data-age footer appears across every page of the operations workspace).

​

Orbit age

A spacecraft’s orbit age is the time elapsed since its latest state vector — the position and velocity at an epoch you provide through orbit determination, an OPM import, or manual entry. It is now minus that latest state-vector epoch, expressed in whole days (all times UTC). Orbit age is a single, workspace-wide measure: the same definition applies to every spacecraft in the operations workspace, so an “old” orbit means one consistent thing across your fleet. As a spacecraft’s orbit ages, it crosses two thresholds in turn — first the degraded level, then the stale level — and each one changes how VALAR treats that spacecraft: The two levels are ordered: the degraded level must be at or below the stale level, so a spacecraft falls back to a public orbit before it is ever blocked. You configure both — together with the block switch — in the Orbit age settings below.

​

Degraded level

The degraded level is the orbit age at which a spacecraft stops using its own now-old precise orbit and falls back to a public TLE — a Two-Line Element set the platform fetches itself from the public catalog, located by the spacecraft’s NORAD catalog ID. The spacecraft keeps planning and plotting, but on a lower-accuracy orbit, and the orbit-data-age footer names it with a Degraded tag, alongside any spacecraft blocked at the stale level. You never upload or paste a TLE; the platform retrieves it for you. The degraded level is off by default — until you enable it, a spacecraft that loses a fresh precise orbit is governed only by the stale level. While it is on, a spacecraft enters the degraded level automatically when either condition applies: This is the lower-impact of the two levels: it keeps a product working, with a clear signal, rather than blocking it. What falls back to the public TLE — and which spacecraft the fallback cannot rescue — is detailed under How each product behaves.

​

What “Lower Accuracy” Means

A public TLE is a general-catalog orbit located by NORAD catalog ID, and it is less precise than an operator-provided state vector — so every result a spacecraft produces while it is at the degraded level is an approximation rather than a precise prediction. The platform never hides this: the orbit-data-age footer names every spacecraft currently running on a public TLE with a Degraded tag, and both the footer and the settings page describe that orbit as lower accuracy. Treat results for a degraded spacecraft as indicative, and restore a precise state vector when you need full accuracy.

​

Stale level

The stale level is the orbit age at which VALAR considers a spacecraft’s orbit too old to trust and blocks the products that depend on it. The block is judged per spacecraft: a stale spacecraft is blocked while every fresher spacecraft in the same view still computes normally. The stale level has a default of 14 days. Blocking is controlled by the Block orbit-dependent products on stale orbits switch in the Orbit age settings, on by default. When it is on, a spacecraft whose orbit age is past the stale level is blocked from each orbit-dependent product; turning it off lets every product compute from an old orbit again — the stale level still defines “stale”, it is just no longer enforced.

​

The Block Message

When a product is blocked, the spacecraft’s result is replaced — in place of the chart, timeline, or events — by a panel that explains why: Both N values are whole days — the spacecraft’s actual orbit age and your configured stale level. The remedy names the two ways to clear the block: provide fresher tracking data (a new state vector) for the spacecraft, or raise the stale level in Settings. When the old orbit came from the public-TLE fallback rather than your own tracking data, the panel adds the line the public-TLE fallback is also stale, so you know that refreshing your own data is what clears it.

​

The Orbit-Data-Age Footer

Both levels of the orbit-age policy — the degraded level and the stale level — surface in one signal: the orbit-data-age footer. Whenever any spacecraft in the workspace is affected at either level, a persistent footer sits at the bottom of every page of the operations workspace, spanning the full width beneath the sidebar and content. When no spacecraft is affected, no footer is shown.

​

The Collapsed Strip

By default the footer is a single collapsed strip reading Orbit data age — N spacecraft affected, where N is the count of affected spacecraft. For a single spacecraft it reads 1 spacecraft affected. The strip carries a blocked-severity cue: when one or more affected spacecraft are at the Blocked (stale) level, the strip switches to a higher-severity amber palette and shows an N blocked count, so “some are blocked” reads at a visibly higher severity than “all merely degraded”. When every affected spacecraft is only Degraded, the strip uses the softer degraded-yellow palette and shows no blocked count.

​

The Drawer

Select View affected spacecraft to open the Orbit age warnings drawer, described as Spacecraft affected by orbit data age — degraded or blocked — a grid showing one card per affected spacecraft. Each card carries: A spacecraft that qualifies at both levels appears once, at its most severe level — Blocked; blocked spacecraft are ordered ahead of degraded ones, so a single spacecraft never reads as both “degraded” and “blocked”. When an age is unavailable, the card shows — in place of the number, with a tooltip explaining why: This footer is the per-spacecraft orbit-data-age indicator — there is no separate badge on the spacecraft page or in the spacecraft selector.

​

How each product behaves

Orbit age governs every orbit-dependent product together. At the degraded level, the products that support the public-TLE fallback keep working on the fetched orbit; at the stale level, the orbit-dependent products are blocked and show the block panel above. Either way the spacecraft is named in the one orbit-data-age footer — tagged Degraded at the degraded level, Blocked at the stale level — so a single signal covers both. The block panel replaces the result of a blocked product; the footer is the workspace-wide signal that lists every affected spacecraft. Ground-station pass prediction (/passes/timeline) has no settings of its own — it follows this one workspace orbit-age policy, at both levels. Maneuver optimization’s stale-level block is documented in full on the Planner page. The subsections below detail how each product behaves on the degraded-level public-TLE fallback.

​

Ground-Station Passes on the Fallback

Ground-station pass prediction is the first planning function that runs on the fallback. While a spacecraft is at the degraded level, the Passes timeline computes its visibility windows from the public TLE the platform fetched for it, instead of skipping the spacecraft as it would without a fresh precise orbit. The fallback passes render exactly like passes computed from a precise state vector — the same timeline bars, and the same hover details (spacecraft, ground station, AOS, LOS, and duration). No individual pass is marked as degraded. Pass prediction follows the workspace degraded level in both directions: a spacecraft whose orbit age is past the degraded level computes its passes on the public TLE, while a spacecraft within the degraded level computes on its precise state vector and is not sent to the fallback. Passes computed from the fallback book exactly like precise-orbit passes — a booked fallback pass appears in your booked-passes list and its details panel, indistinguishable from any other pass. With degraded mode enabled, the skipped-spacecraft notice lists only the spacecraft the fallback could not rescue: Degraded operation on the timeline is signalled solely by the unified orbit-data-age footer above, which tags the spacecraft Degraded; an individual fallback pass carries no separate marker. While degraded mode is off, nothing falls back to a public TLE: a spacecraft with no state vector is skipped with the usual “no state vector available” reason, and one whose orbit age is past the stale level is blocked in place of its passes — and the footer tags that spacecraft Blocked.

​

AOI Overflight on the Fallback

Area-of-interest overflight planning also runs on the fallback. While a spacecraft is at the degraded level, VALAR computes its overflight events from the public TLE the platform fetched for it, instead of skipping the spacecraft as it would without a fresh precise orbit. A spacecraft located by a NORAD catalog ID alone — with no operator state vector — becomes overflight-plannable for its configured payloads. Fallback-computed overflight events render exactly like events computed from a precise state vector — the same per-payload rows, the same entry, exit, and peak times, and the same off-boresight and blinding detail — with no per-event marker that the orbit was a public TLE. An overflight recompute follows the workspace degraded level in both directions: a spacecraft whose orbit age is past the degraded level computes its overflights on the public TLE, while a spacecraft within the degraded level computes on its precise state vector and is not sent to the fallback. The fallback can’t rescue a degraded spacecraft in two cases — when no public TLE can be retrieved for it, or when it has neither a state vector nor a NORAD ID. In either case the spacecraft contributes no overflight events; unlike the Passes timeline, AOI overflight shows no per-spacecraft notice on the page. The reasons are the same two above for ground-station passes: Degraded operation for AOI overflight is signalled solely by the unified orbit-data-age footer, which tags the spacecraft Degraded; no individual overflight event carries a separate marker. While degraded mode is off, nothing falls back to a public TLE: a spacecraft with no state vector contributes no events, and one whose orbit age is past the stale level is blocked from the forecast — and the footer tags that spacecraft Blocked.

​

Orbit Plots & Ground Track on the Fallback

Orbit plotting is the everyday visualization that runs on the fallback. While a spacecraft is at the degraded level, both orbit-plot surfaces propagate it from the public TLE the platform fetched and plot the result, instead of skipping it as they would without a fresh precise orbit. The Ground Track page computes its ground track, 2D/3D globe position, and latitude/longitude plots from that public TLE; the Keplerian Elements page computes its six orbital-element time-series from the same fallback. A spacecraft located by a NORAD catalog ID alone — with no operator state vector — becomes plottable on both surfaces, and the fallback-propagated results render exactly like results computed from a precise state vector, with no per-result marker that the orbit was a public TLE. Both plot surfaces follow the workspace degraded level in both directions: a spacecraft whose orbit age is past the degraded level plots on the public TLE, while a spacecraft within the degraded level plots on its precise state vector and is not sent to the fallback. No per-track, per-position, or per-series source marker distinguishes a fallback plot from a precise one. Degraded operation on both surfaces is conveyed solely by the unified orbit-data-age footer, which tags the spacecraft Degraded (or Blocked once past the stale level); an individual plot carries no separate indicator, deliberately. With degraded mode enabled, the skipped-spacecraft warning lists only the spacecraft the fallback could not rescue. The reasons are the same two above for ground-station passes: While degraded mode is off, nothing falls back to a public TLE: a spacecraft with no state vector cannot plot, and a spacecraft whose orbit age is past the stale level is blocked in place of its plots.

​

Orbital Events on the Fallback

Orbital-event computation also runs on the fallback. While a spacecraft is at the degraded level, the Burn Plan timeline computes its eclipse, apsis, node, and South Atlantic Anomaly (SAA) crossings from the public TLE the platform fetched for it, instead of skipping the spacecraft as it would without a fresh precise orbit. The fallback events render exactly like events computed from a precise state vector — the same eclipse and SAA bands, the same apsis and node markers, and the same per-event-type toggles in the Display popover — with no per-event marker that the orbit was a public TLE. Because a public TLE is lower accuracy, treat the exact entry and exit timing of a degraded spacecraft’s events as indicative. Orbital-event computation follows the workspace degraded level in both directions: a spacecraft whose orbit age is past the degraded level computes its orbital events on the public TLE, while a spacecraft within the degraded level computes on its precise state vector and is not sent to the fallback. A degraded spacecraft’s fallback events flow into the exported schedule alongside precise-orbit events. When the events came from a public TLE, the exported .ssf file carries an in-file COMMENT line — Orbital events derived from public TLE - indicative timing — so a downstream reader of the file is not misled about their precision. See the Schedule Export Dialog for the export controls. The fallback can’t rescue a degraded spacecraft in two cases — when no public TLE can be retrieved for it, or when it has neither a state vector nor a NORAD ID. In either case the spacecraft contributes no orbital events, and the skipped-spacecraft notice names the reason. The reasons are the same two above for ground-station passes: Degraded operation for orbital events is signalled solely by the unified orbit-data-age footer, which tags the spacecraft Degraded (or Blocked once past the stale level); no individual event carries a separate marker. While degraded mode is off, orbital-event computation is unchanged — a spacecraft with no fresh precise orbit is skipped exactly as it is today, and nothing falls back to a public TLE.

​

Attitude Profiles & Export on the Fallback

Attitude profiles also run on the fallback. While a spacecraft is at the degraded level, the attitude pages — the pointing-mode configuration and the quaternion-profile charts — compute its orientation over time from the public TLE the platform fetched for it, instead of showing the No state vector available block that asks you to define a precise orbit first. The pointing profile and the quaternion-component charts render exactly as they do for a spacecraft with a precise state vector, with no per-result marker that the orbit was a public TLE. Every pointing mode runs on the public TLE; none is excluded. How much the lower-accuracy orbit matters depends on the mode family: The orbit-relative modes are the only ones a public TLE perturbs, and only slightly — treat their pointing as indicative rather than precise, exactly as for any other degraded result. See What “Lower Accuracy” Means for the general caveat; there is no separate per-mode accuracy read-out on the page. The Export action is enabled for a degraded spacecraft — it is no longer disabled with a No state vector available reason — so you can still hand off an attitude product for a spacecraft running on the public TLE. The exported AEM file is generated from the fallback orbit, with the same window, step size, representation, reference-frame, and Euler-sequence options as a precise-orbit export. When the attitude was computed from a public TLE, the downloaded AEM file carries an in-file COMMENT line — Attitude derived from public TLE - lower accuracy — so a downstream reader of the file is not misled about its precision once it leaves the platform. For a spacecraft with a fresh precise orbit the exported file is unchanged and carries no such comment line. Because the attitude pages compute for the single spacecraft you are viewing, a spacecraft the fallback can’t rescue is not dropped from a list — instead the page reports the reason inline, on both the profile and the export: Degraded operation for attitude is signalled solely by the unified orbit-data-age footer, which lists every affected spacecraft — tagging each Degraded or Blocked — so degraded attitude is never silent; no individual profile or chart carries a separate marker. While degraded mode is off, the attitude pages are unchanged — a spacecraft with no fresh precise orbit shows the No state vector available block, and nothing falls back to a public TLE.

​

Configuring orbit age

Open Settings → Orbits → Orbit age. One section sets both levels together, along with the block switch; the policy applies to every spacecraft in the operations workspace. To change the levels, click the edit (pencil) control, enter the day counts, and click Save. A confirmation reads Orbit-age policy saved. Because the degraded level must sit at or below the stale level, saving a degraded level above the stale level is rejected inline with Degraded level must be at or below the stale level.

​

Validation Messages

When you save, each level checks your entry and shows one of these messages inline if it cannot be accepted:

​

Turning degraded mode off

If you turn Enable degraded mode off while spacecraft are currently degraded, VALAR asks you to confirm before the change takes effect. The confirmation is titled Turn off degraded mode? with the body:

N spacecraft will return to requiring a precise orbit and their planning functions will be blocked until a fresh state vector is provided. Continue?

Click Continue to disable degraded mode, or Cancel to keep it on. When no spacecraft are currently degraded, the switch turns off without a confirmation.

​

Related Pages

• State Vectors: Provide and manage the precise orbital data whose epoch orbit age is measured against, and which the public-TLE fallback stands in for.
• Spacecraft Management: Set a spacecraft’s NORAD catalog ID so it can use the public-TLE fallback at the degraded level.
• Ground Track: The ground-track map that runs on the fallback at the degraded level and blocks a spacecraft past the stale level.
• Keplerian Elements: The orbital-element time-series that run on the fallback at the degraded level and block a spacecraft past the stale level.
• Overflight Events: AOI overflight runs on the fallback at the degraded level and blocks a spacecraft past the stale level.
• Burn Plan Timeline: Review and export the orbital events that run on the fallback at the degraded level.
• Attitude Profiles: Configure pointing modes and export the AEM attitude file that runs on the fallback at the degraded level.
• Planner: Maneuver optimization is blocked when the selected spacecraft’s orbit is past the stale level.