geoenrich 0.7.0

Enrich longitude/latitude points with coast distance, bathymetric depth, sea name, and nearest country/municipality
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52

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

```bash
scripts/download_data.sh download gshhg gebco countries lau
```

See [Reference datasets](./data.md) 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.

```bash
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](./scripts.md) 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).