Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

sea

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

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 and the region options:

OptionDefaultMeaning
--data <PATH>requiredIHO Sea Areas polygons (GeoJSON or shapefile)
--name-field <NAME>NAMEProperty / attribute field holding the sea name
--column <NAME>sea_nameOutput column name

Example

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

See Reference datasets for how to obtain the IHO Sea Areas.