osmcoastline_segments - analyze OpenStreetMap coastline changes from segment files
Contents
Contact
If you have any questions or want to report a bug, please go to https://osmcode.org/contact.html
Copyright
Copyright (C) 2012-2025 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.
Description
The osmcoastline program can write out all segments of the coastline into a file (when started with the
-S,--write-segments=FILE option). This program can be used to compare two of those segment files in
various ways to detect coastline changes between different runs of the osmcoastline program.
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.
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
Name
osmcoastline_segments - analyze OpenStreetMap coastline changes from segment files
Options
-h, --help
Display usage information.
-d, --dump
Dump segment list to stdout in plain text format.
-g, --geom=FILENAME
Write segments to geometry file or database using OGR.
-f, --format=FORMAT
OGR format for writing out geometries.
-V, --version
Display program version and license information.
See Also
• README.md
• osmcoastline(1)
• Project page
• OSMCoastline in OSM wiki
Synopsis
osmcoastline_segments [OPTIONS] SEGMENT-FILE1SEGMENT-FILE2
