Skip to content

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

GoDSAT Factorial

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.

Start here

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.

Quick setup

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 doctor

Tests 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.

Repository map

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.

Attribution

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.

Experiment Studio

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.

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages