Satellite-tasking experiments, sensor-dropout analysis, and Lean verification for the supplied methodology paper.
Current scope: Iridium NEXT and ground systems. The rerun uses a documented model in which six hypothetical ground tracking sensors observe all 80 pinned NEXT spacecraft, including listed spares. Published station coordinates determine geometry; detection and energy remain simulation assumptions. MEO is disabled. Earlier mixed-catalogue results remain separate.
- Project status and results: what ran, what was found, and what remains incomplete.
- Setup and commands: install, prepare data, and check the runtime.
- Current system scope: membership, exclusions, and ground-system requirements.
- Documentation index: methodology, assumptions, and reproduction limits.
- Lean verification: checked mathematics and proof boundaries.
The implemented actor–critic study has not established the draft's claimed custody or energy improvements. It is a documented simulation adaptation; published-baseline reproduction and whole-controller equivalence remain unverified.
Use Python 3.11 or newer. From the repository root:
python -m venv .venv
# macOS/Linux: source .venv/bin/activate
# Windows PowerShell: .venv\Scripts\Activate.ps1
python -m pip install -e ".[test,ground]"
python -m pytest -q
python -m godsat doctorTests do not require the large datasets. doctor reports missing local data; it does not download it or validate sensor assumptions. See setup for data preparation and optional dependencies.
| Directory | Contents |
|---|---|
godsat/ |
Simulation, actor–critic training, experimental design, scope checks, CLI |
configs/ |
Active scope, pinned Iridium NEXT membership, current config |
configs/archive/ |
Historical mixed-catalogue experiment configurations |
scripts/ |
Tools grouped into data, experiments, analysis, validation, figures, and formal checks |
tests/unit/ |
Portable automated tests; the default CI suite |
tests/research/ |
Supplementary tests requiring optional dependencies or local evidence |
docs/ |
Setup, methodology, assumptions, and the supplied paper |
reports/ |
Result summaries, compact evidence, and historical report snapshots |
formal/ |
Lean source, pinned dependencies, and proof documentation |
data/, outputs/ |
Local datasets and generated results; excluded from Git |
vendor/AWP/ |
Optional upstream propagation submodule |
Use python -m scripts.<group>.<tool> for research tools. The tool index lists common commands. The migration map locates files moved from the earlier flat layout. Historical numerical evidence and provenance receipts are preserved; archived reports may retain their original paths.
Original repository code is MIT licensed. Orbital source data, the original GoDSAT framework, and optional AWP code have separate terms. See data sources, upstream GoDSAT attribution, and AWP notes.
Run python -m godsat.studio --output outputs/iridium-next-ground and open http://127.0.0.1:8765 for the 3D experiment frontend (CesiumJS globe, Rust/WebAssembly frame evaluation, one canonical visualization). Explore a single target or a full saved scene, inspect results and evidence, and replay observation loss. See the studio guide for data adapters, display assumptions and additional artifact roots. Both server commands open the same Studio. Older dashboard links redirect to it.