Orbit Plotter

Generates polar az/el pass plots and ground-track maps directly via Skyfield/Matplotlib, entirely locally — no HTTP API server or external agent framework required. Use this for quick, local plot generation from any agent working in this repo.

--station resolves against the shared ground station catalogue by invoking ops-ground-stations-catalogue's script as a subprocess. Use that skill to list what's available, look up a station's coordinates, or add a new one — anything added there is immediately usable here by name, no restart needed.

--spacecraft resolves and fetches a TLE by invoking ops-tle-fetcher's script as a subprocess — this script has no space-track.org credentials or network logic of its own; that surface lives entirely in ops-tle-fetcher.

Generated PNGs are written to OUTPUT_DIR (default output/ at the repo root, configurable via .env). The script prints the saved file path(s) to stdout.

Usage

Run from the repo root:

uv run skills/ops-orbit-plotter/scripts/plot_orbits.py \
  --station Madrid --duration-hours 48 --plot-type both \
  --tle-line1 "<TLE line 1>" --tle-line2 "<TLE line 2>" --spacecraft-name ISS