Output columns
Each command appends its columns to a copy of the input and writes the result; the input columns are preserved and their order is kept.
| Command | Appended columns | Type |
|---|---|---|
coast | dist_to_coast | float (km or m) |
depth | bathymetry | float (m) |
sea | sea_name | text |
place | country, country_code, municipality | text |
nearest | nearest_name, nearest_dist | text, float (km or m) |
The single-column commands rename their output with --column; nearest
renames with --name-column / --dist-column.
Null values
A row gets null (or NaN for float columns) output when:
- its
longitudeorlatitudeis null or NaN, or - the lookup finds nothing (for example a
depthpoint off the GEBCO grid, or anearestrun against an empty reference set).
Clashing columns
If an output column name already exists in the input, the run fails before any
enrichment, naming the clashing column(s). Pass --overwrite to replace such a
column in place instead: it keeps its position but takes the output value and
dtype.
Output format
By default the output file is written beside the input as
<stem>.<command>.<input format>, so the output format follows the input’s
(a points.csv.gz input enriches to points.coast.csv.gz). Override the path
with --output or the format with --out-format. An input with an unrecognized
extension defaults to Parquet.