Space situational awareness for operators
Space situational awareness (SSA) is knowing where objects in orbit are, where they will be, and how sure you are. For an operator it decides two practical things: whether an antenna points at the right patch of sky when a pass starts, and whether anything will come too close to your satellite.
Orbit data and its age
Most operators start from a two-line element set (TLE), propagated with SGP4. An element set is a fit to tracking data at one epoch; the further you propagate from that epoch, the larger the error, mostly along the track, so the satellite arrives early or late.
In Constellation, each satellite's orbit comes from the newest element set for its norad_id in the orbit catalog, or from the tle you give it, which is how a satellite not in the public catalog gets forecasts. See Satellite. A Link SNR forecast declines a catalog set more than 6 days from the requested time, rather than forecasting from a stale orbit.
Pass prediction with uncertainty
Pass geometry is available today: GET /topology/passes returns each pass's AOS, LOS and peak elevation from SGP4, and every forecast uses the same propagation.
The SSA pass forecast model adds the uncertainty: the pass's peak elevation and slant range, the along-track error of its element set in distance and time, and the chance the element set alone keeps the satellite inside the antenna's beam at the peak.
Conjunction screening
A conjunction is a close approach between two objects, screened by miss distance and its uncertainty. Conjunction screening is research at Constellation, not served: no model or API route returns it, so use your conjunction data provider for now. See Intelligence.
Common questions
Does Constellation offer a space situational awareness API?
Pass geometry from SGP4 is available today through the passes route and is used by every forecast. The SSA pass forecast model, which adds orbit uncertainty, is served to every self-serve account. Conjunction screening is research, not served.
What is a TLE?
A two-line element set: a compact, standard description of a satellite orbit at one epoch, meant to be propagated with the SGP4 model. Its accuracy falls the further you propagate from the epoch.
My satellite is not in the public catalog. Can I still get forecasts?
Yes. Give the satellite a tle in your network config in place of a norad_id. Forecasts then propagate from your TLE, so send a newer one whenever you have it.