TerraFlow¶
Reproducible geospatial tool for agricultural suitability modeling. Give it a land-cover map, climate data, and a config file — it hands you a scored, location-stamped results table.
Choose your path¶
-
TerraFlow in 10 Minutes
New to TerraFlow? Start here — no coding required. Covers what it does, the problem it solves, how the pipeline works, and what the output means.
-
Field Guide
You receive results but don't run TerraFlow yourself. Plain-English guide to scores, labels, opening results in Excel or QGIS, and sharing with others.
-
Technical Reference
You install, configure, or contribute to TerraFlow. CLI, YAML schema, architecture docs, ADRs, and API reference.
v0.2.0 highlights¶
- Per-cell climate values
- Spatial interpolation via
scipy.griddata— not a single global mean. - CRS-aware ROI clipping
- Supply your bounding box in WGS 84 degrees regardless of the raster's native projection.
- Guaranteed WGS 84 output
lat/loncolumns always contain geographic degrees, safe for any mapping tool.- Reproducible sampling
- Cell selection is seeded from the run fingerprint — same config always yields the same rows.
- Portable configs
- Relative paths resolve against the config file's location, not the caller's working directory.
Technical documentation¶
Start running:
- CLI Usage — how to call
terraflowfrom the command line - Configuration Schema — every YAML field documented, including
roi_crs - Configuration Examples — ready-to-use config templates
Understand the system:
- Architecture Overview — module boundaries and data flow
- Run Identity & Fingerprinting — how reproducibility is guaranteed
- Output Artifact Contract — what files are written and their schemas
- Architecture Decisions (ADRs) — why key design choices were made
Contribute:
- Development Guide — environment setup, testing, coverage
- Contributing Guidelines — PR process, code standards
- Roadmap — what's planned next
API reference: