Helper scripts

The scripts/ directory holds two bash helpers that sit alongside the CLI: one to fetch the reference datasets, one to run several modules over an input in a single pass. Neither is required to use geoenrich, but together they cover the “get the data, then enrich” workflow end to end.

Both follow the same conventions:

• The header comment doubles as --help, so scripts/<name> --help prints the full interface.
• Steps are traced to stderr as they run (a timestamped RUN: line per command), so a long run shows what it is doing.
• They run under set -euo pipefail and stop at the first error.

download_data.sh

Downloads and unpacks the reference datasets into a local data/ tree, one sub-directory per source, matching the paths the command pages use. Selected datasets download in parallel, existing archives are kept unless --force is given, and the multi-GB GEBCO grid resumes an interrupted download.

scripts/download_data.sh download gshhg gebco countries lau

See Reference datasets for the full list of sources, the Marine Regions (IHO) form details, and the caveats.

enrich.sh

Runs several modules over one input in sequence and writes a single output file carrying every selected module’s new columns. A module runs when you give its data source, each step chains onto the previous one’s output, and the intermediate files are removed when the script ends.

scripts/enrich.sh cores.parquet cores.enriched.parquet \
  --coast ./data/gshhg/gshhg-shp-2.3.7/GSHHS_shp/f \
  --depth ./data/gebco/GEBCO_2024_sub_ice.nc \
  --nearest farms.parquet --nearest-name-field farm_name

See Enrich with several modules for the module flags, the per-module and common options, and how the intermediate files are handled.

Requirements

download_data.sh needs curl and unzip on PATH. enrich.sh needs a built geoenrich binary: it uses $GEOENRICH_BIN if set, else the one on PATH, else a ./target/release or ./target/debug build in the repository (pass --bin to point elsewhere).