OSMCOASTLINE_SEGMENTS(1)

📦
version 2.5.0 · 5 versions
, in ubuntu stonking

💖 OSMCOASTLINE_SEGMENTS 💖

okay bestie, sit down, we're doing osmcoastline_segments(1) today and honestly? it's giving detective energy. she analyzes OpenStreetMap coastline changes from segment files. slay.

✨ NAME ✨

osmcoastline_segments — analyze OpenStreetMap coastline changes from segment files 🦋

🌸 SYNOPSIS 🌸

osmcoastline_segments [OPTIONS] SEGMENT-FILE1 SEGMENT-FILE2

💅 DESCRIPTION 💅

so here's the lore: the osmcoastline program can write out all the segments of the coastline into a file (specifically when you start it with the -S, --write-segments=FILE option, iykyk).

this program right here is the girl who takes two of those segment files and compares them in various ways, so you can detect coastline changes between different runs of the osmcoastline program. that's it. that's the whole vibe check. 💀✨

🎀 OPTIONS 🎀

  • -h, --help — display usage information. the "help me bestie" button 🫶
  • -d, --dump — dump segment list to stdout in plain text format. just. spill it. all of it. 🍓
  • -g, --geom=FILENAME — write segments to a geometry file or a database using OGR.
  • -f, --format=FORMAT — the OGR format for writing out geometries.
  • -V, --version — display program version and license information. the "who even am I" option 💅

🚨 DIAGNOSTICS 🚨

osmcoastline_segments exits with exit code:

  • 0 — if the segment files are the same 👑
  • 1 — if the segment files are different 😭
  • 3 — if there was a fatal error when running the program 💀
  • 4 — if there was a problem with the command line arguments. (the audacity.) 🙈

🌈 EXAMPLES 🌈

just return 0 or 1 depending on whether the segments are the same in both files:

osmcoastline_segments old.segments new.segments

dump the list of removed and added segments to stdout:

osmcoastline_segments --dump old.segments new.segments

create a shapefile with the differences:

osmcoastline_segments --geom=diff.shp old.segments new.segments

👀 SEE ALSO 👀

Copyright (C) 2012-2026 Jochen Topf <jochen@topf.org>. License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. This is free software: you are free to change and redistribute it. There is NO WARRANTY, to the extent permitted by law. (no cap, no warranty, periodt.)

💌 CONTACT 💌

if you have any questions or want to report a bug, please go to <https://osmcode.org/contact.html>

🌟 AUTHORS 🌟

Jochen Topf <jochen@topf.org>.

literally that's the whole page bestie, go compare some coastlines 🦋

mwah 💖 version 2.5.0, OSMCOASTLINE_SEGMENTS(1), stay iconic ✨

📦 where this page comes from