A set of scoping reports for the GeoStack — a JAX-native research software stack for geophysical modeling, inference, and data assimilation. Each report is a deep dive on one piece of the stack; together they describe the full picture.
If you are new here, start with Report 0 — the synthesis document that weaves everything together. The companion vision document is The Idea (v3), and the operational discipline is described in Report 16 — modeling cycle.
Navigation by report number¶
| Report | File | Topic |
|---|---|---|
| Report 0 | toolz_0_overview.md | The GeoStack — an introduction (start here) |
| Report 1 | toolz_1_primer.md | Background: toolz lineage and typed entities |
| Report 2 | toolz_2_pipekit.md | What pipekit will ship |
| Report 3 | toolz_3_pipekit_array.md | Sister libraries on top of pipekit |
| Report 4 | (superseded — see Report 9) | Original use-case mapping |
| Report 5 | toolz_12_pipekit_jax.md | pipekit-jax — future-direction analysis |
| Report 6 | toolz_4_geocatalog.md | geocatalog — spatiotemporal index |
| Report 7 | toolz_5_geopatcher.md | geopatcher — four-axis patcher |
| Report 8 | (not yet written) | xr-toolz deep dive |
| Report 9 | toolz_6_usecases.md | Use-case revisit with full library structure |
| Report 10 | toolz_8_pipekit_cycle.md | pipekit-cycle — time-stepping, DA, observation operators |
| Report 11 | toolz_9_pipekit_train.md | pipekit-train — training pipelines |
| Report 12 | toolz_10_pipekit_experiment.md | pipekit-experiment — tracking and model registry |
| Report 13 | toolz_7_statecatalog.md | statecatalog — catalog for model states |
| Report 14 | toolz_11_pipekit_evaluate.md | pipekit-evaluate — multidimensional evaluation |
| Report 15 | supporting_info/benchmark.md | Benchmarking as first-class infrastructure |
| Report 16 | supporting_info/modeling_cycle.md | Data-driven modeling cycle, benchmark-gated L0–L4 |
Companion documents¶
The Idea (v3) — manifesto / vision document.
Data + ML lifecycle — three-layer model, two streams, depth axis, matchup.
Benchmarks gallery — worked benchmark designs across six domains.
Note. Filenames preserve historical ordering and don’t match report numbers one-to-one. Use this table to navigate by report number.