Skip to main content

Common questions

Each answer starts with the short version. Follow the link when you need the detail.

The network config and forecasts at a time you name work on every plan. Questions marked Operator and above are about calibration, which Operator adds. Questions marked Enterprise are about dedicated enterprise deployments.

Setting up your network​

How do I add my ground stations and satellites?​

Upload them once in a network config with PUT /topology/config, then add or change entries with PATCH /topology/config. One document holds up to 1,000 ground stations, 100 antennas per station, and 5,000 satellites. See Limits.

Can I add many stations quickly, one after another?​

Yes. There is no waiting period between writes. To add several at once, put them all in one PATCH. Writes count toward the normal rate limits.

A new antenna starts from its link budget and improves as it calibrates. See How long until SNR forecasts are accurate?

Which orbit propagator do you use?​

Standard SGP4, from the satellite's current element set in our orbit catalog, or from the TLE you gave it. Propagate the same element set with SGP4 and your pass times should line up with ours.

My satellite is not in the public catalog. Can I give you its orbit?​

Yes. Give the satellite a tle (its two lines) in place of norad_id in your network config. Forecasts then propagate from your TLE, however old it is, so send a newer one with PATCH whenever you have it. See Satellite.

What elevation cutoff do you use?​

Whatever you set per antenna in min_elevation_deg. Without it, 0° is used, so set it to your antenna's real mask. See Antenna.

Getting forecasts​

How far ahead can I forecast?​

Any future time. Two things limit how good the answer is:

  • Orbit. A satellite from our orbit catalog needs an element set within 6 days of the time you ask for, or the forecast is declined with orbit_propagation_failed. A satellite with your own TLE has no limit, but its error grows the further you ask from the TLE's epoch.
  • Weather. Where radar covers the station, the next few minutes use the latest radar scan, then a rain nowcast that loses skill as it reaches further ahead. Past the nowcast, or outside radar coverage, the rain comes from weather-model forecasts, to 72 hours; past those, from long-term statistics for the location. Nearer forecasts are sharper.

How do I check the health of a whole pass?​

Ask for several times across the pass, one request per time. Three points cover most passes:

PointTime to ask for
StartJust after the satellite rises above the antenna's min_elevation_deg
MiddleMaximum elevation
EndJust before it sets below the mask

Add more points for finer planning, such as choosing a modulation for each part of the pass. The decision about what is healthy stays on your side. See Request forecasts.

Should I use SNR or weather attenuation?​

They answer different questions:

ModelAnswersNeeds telemetry
Link SNRWhat SNR will this antenna see, in dB, including the expected weather loss?Yes, to calibrate
Weather attenuationHow much will the atmosphere weaken the signal, and is it rain, gas, cloud or scintillation?No

Is a forecast per station or per antenna?​

Per link: one ground antenna and one satellite. Name a station and you get one forecast per antenna. SNR calibration is per antenna and band, shared across the satellites that antenna tracks.

Calibration​

How long until SNR forecasts are accurate?​

Operator and above. It depends on your data, but on the data we have evaluated so far:

Passes per antennaWhat to expect
0Link budget alone, only as accurate as the RF values in your network config.
10 to 30The quick adjustments have settled.
A few hundredCalibration has converged.

Accurate RF values in the network config and steady telemetry during every pass shorten the warm-up. See Telemetry.

What does the 10 minute window mean?​

Operator and above. It is when calibration starts, not how long it takes. A link starts calibrating with the first forecast request that finds one of its telemetry records from the last 10 minutes. From then on it also learns from the history you sent earlier.

How do I know if a forecast is calibrated yet?​

Operator and above. A forecast that is the link budget alone carries status: "uncertain" and reason: "link_budget_only"; a calibrated one has both null. To judge how far calibration has come, count the passes you have sent telemetry for on each antenna, and compare with How long until SNR forecasts are accurate?

Does weather attenuation learn from my data?​

No. It reads only your network config and weather data, so it is as good on the first request as on the hundredth.

Is my data used for anyone else?​

Enterprise. No. Your telemetry, forecasts and API keys stay in your own deployment. See Tenant isolation.

When something looks wrong​

Usually its newest sample is older than the freshness window, or its records were rejected for naming an ID that is not in your network config. See Telemetry does not appear.

Why are predictions empty?​

A 200 can still name your link in entity_errors with a code that says why. See Predictions are empty or fail.

Why is my saved work missing on another device?​

Saved work belongs to a workspace, and unsaved drafts stay in the browser where you edited them. See Saved work is missing.

Which plan includes tenant isolation?​

Enterprise. See Tenant isolation.