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

# sea

Sea or ocean name at each point, from the IHO Sea Areas polygons.

```bash
geoenrich sea <INPUT> --data <IHO> [OPTIONS]
```

Appends one column, `sea_name` (rename with `--column`), holding the name of the
sea or ocean the point falls in.

## How it works

The IHO Sea Areas features (Marine Regions GeoJSON or shapefile) are cropped
whole to the region box plus a margin, and their bounding boxes are indexed in
an R-tree. Each point is resolved by an even-odd point-in-polygon test over the
candidate features, with a nearest-boundary fallback for points that fall just
inland (for example inside a fjord not covered by a sea polygon).

`--name-field` selects which feature property holds the name (default `NAME`);
the command errors clearly if that field is absent.

## Options

Beyond the [shared options](../reference/configuration.md) and the
[region options](../reference/regions.md):

| Option | Default | Meaning |
|--------|---------|---------|
| `--data <PATH>` | required | IHO Sea Areas polygons (GeoJSON or shapefile) |
| `--name-field <NAME>` | `NAME` | Property / attribute field holding the sea name |
| `--column <NAME>` | `sea_name` | Output column name |

## Example

```bash
geoenrich sea cores.parquet --region norway \
  --data ./data/iho/iho_sea_areas.geojson
```

See [Reference datasets](../data.md) for how to obtain the IHO Sea Areas.