Fleet: your satellites and ground stations
Fleet shows what your fleet is: the ground stations, antennas and satellites in your network config, and whether each works as declared. It is read from the latest network config, the newest telemetry (read again every minute while the page is open) and the newest run of the pass-yield workflow, so what it shows is what every workflow prices.
The page is three panes side by side: the list on the left, the map in the middle, and on the right the asset you chose or, with none chosen, the next passes.
The list
The switch at the top of the list chooses Ground stations or Satellites, each with its count. The pane's title row counts their state, such as "3 fine · 1 need a look". Past 12 rows a search box finds an asset by its name or id.
When the catalog has changed since you added assets, a notice at the top of the list offers a button such as Refresh 3 from catalog, with the number of assets you picked: it refills what the catalog gave them and keeps your own values.
Each row is one asset, by its name (the demo fleet's assets, which its config does not name, read as NOAA 20, Fairbanks and so on):
- A ground station: its state as a dot, its name, and at the right its passes in the next 24 hours. Under the name, its antennas and band, and its weather now where rain is falling.
- A satellite: its state as a dot, its name, and at the right what its next pass should deliver, in GB. Under the name, the ground station of that pass and how soon it starts, such as "Svalbard in 2 h".
The dot is green when the asset is reporting, amber when it needs a look (drift, rain heavy enough to fade its links, or a satellite whose lanes cannot all price its passes), and gray when it is quiet: no telemetry in the last five minutes.
A fleet of hundreds draws 100 rows at a time; Show 100 more of N draws the next. Add, at the foot of the list, adds assets from the catalog.
The map
Fleet draws each ground station at its declared position and each satellite whose config holds an element set (TLE) as a dot where it is now, moving every 5 seconds. Tracks are drawn one orbit ahead, the half orbit behind faded, each pass of the newest run thicker along it:
- At risk (the default) draws the track of the satellite you chose (in the accent color), the one under the pointer, and those whose next pass could fail (in amber), the soonest 8.
- All tracks draws every satellite's track in gray, with the chosen and at-risk ones in their colors. The address keeps the choice as
?tracks=all.
A satellite the config names only by NORAD id has its orbit worked out on the server, so the map draws it at its next pass instead, with that pass's track. A ground station shows its name when you point at it or choose it, so a fleet of hundreds reads as dots. A ground station where rain fades its links is drawn in the rain color. Choose a dot to open it. A ground station with no declared position is named under the map instead. The key under the map lists only what is drawn.
The title row counts the whole fleet's state, then the At risk and All tracks switch and Share, which copies a link to the view or the API call behind it. The version line sits at the foot of the pane.
One asset
Choose a row or a dot to open the asset (a link to #asset-<id>, such as a builder's Fix in Fleet, opens it too) in the right pane, linkable as ?scope=station:<id>, antenna:<id> or satellite:<id>. Escape or the close button goes back to the next passes.
- It opens with one sentence: a satellite's next pass and what it should deliver, or a ground station's passes in the next 24 hours.
- Declared and observed: what the config declares beside the newest value of each telemetry field from the last five minutes, and the checks where they measure the same thing. A ground station also shows its weather and each of its antennas.
- Passes in the next 48 hours: each pass's start, length, and the antenna or satellite on the other end, computed from TLE orbits and antenna masks. Open in Passes opens Passes scoped to it.
A link inside the pane to another asset opens that asset in the same pane. A link to an asset the config does not hold says Not in your network config.
Next passes
With nothing chosen, the right pane lists the next passes across the fleet, soonest first, up to 50: each with a dot for its risk (amber where it could fail, delivering nothing in its low case), the satellite and ground station, the GB it should deliver, and when it starts. The title row says how many there are and how far ahead the list goes. It reads the newest run again every minute.
Add and refresh
Add opens the public asset catalog. Search satellites by name, NORAD id or operator, or ground stations by id, owner or site, and tick what is yours (In fleet marks what you have). Add N to fleet goes on to the radio values the catalog cannot know: carrier, bandwidth and EIRP for a satellite; antenna id, receive range, G/T and dish for a station. Leave a field blank and the lanes that need it say so. Save to fleet saves a new network config version. See Planned fleet.
The refresh button at the top of the list sends every asset picked from the catalog again in one change.
On Explore, your network config holds up to 2 satellites of your own; adding a third is refused with 403 plan_required. The demo fleet does not count toward that limit.
No fleet yet
With no network config, Fleet says No fleet on this account yet and offers Load the demo fleet or Start from the catalog. See Demo fleet.
In the API
| On screen | Call |
|---|---|
| The fleet and its version | GET /topology/config |
| State, weather, Declared and observed | GET /topology?layers=weather |
| Next passes, a satellite's next pass, the passes on the map, what is at risk | The newest run of the pass-yield workflow |
| Each satellite's position and track | The tle the config holds for it, propagated in your browser |
| An asset's passes | GET /topology/passes |
| Add, Refresh | GET /assets/satellites, GET /assets/stations, then PATCH /topology/config |
| Lanes | Readiness on the config |
| Load the demo fleet | POST /topology/demo-fleet |