.TH "OSMCOASTLINE_SEGMENTS" "1" "2.4.0" "" ""
.SH NAME
.PP
osmcoastline_segments - analyze OpenStreetMap coastline changes from
segment files
.SH SYNOPSIS
.PP
\f[B]osmcoastline_segments\f[R] [\f[I]OPTIONS\f[R]]
\f[I]SEGMENT-FILE1\f[R] \f[I]SEGMENT-FILE2\f[R]
.SH DESCRIPTION
.PP
The \f[B]osmcoastline\f[R] program can write out all segments of the
coastline into a file (when started with the \f[B]-S,
--write-segments=FILE\f[R] 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
\f[B]osmcoastline\f[R] program.
.SH OPTIONS
.TP
-h, --help
Display usage information.
.TP
-d, --dump
Dump segment list to stdout in plain text format.
.TP
-g, --geom=FILENAME
Write segments to geometry file or database using OGR.
.TP
-f, --format=FORMAT
OGR format for writing out geometries.
.TP
-V, --version
Display program version and license information.
.SH DIAGNOSTICS
.PP
\f[B]osmcoastline_segments\f[R] exits with exit code
.TP
0
if the segment files are the same
.TP
1
if the segment files are different
.TP
3
if there was a fatal error when running the program
.TP
4
if there was a problem with the command line arguments.
.SH EXAMPLES
.PP
Just return 0 or 1 depending on whether the segments are the same in
both files:
.IP
.nf
\f[C]
osmcoastline_segments old.segments new.segments
\f[R]
.fi
.PP
Dump the list of removed and added segments to stdout:
.IP
.nf
\f[C]
osmcoastline_segments --dump old.segments new.segments
\f[R]
.fi
.PP
Create a shapefile with the differences:
.IP
.nf
\f[C]
osmcoastline_segments --geom=diff.shp old.segments new.segments
\f[R]
.fi
.SH SEE ALSO
.IP \[bu] 2
\f[C]README.md\f[R]
.IP \[bu] 2
\f[B]osmcoastline\f[R](1)
.IP \[bu] 2
Project page (https://osmcode.org/osmcoastline/)
.IP \[bu] 2
OSMCoastline in OSM
wiki (https://wiki.openstreetmap.org/wiki/OSMCoastline)
.SH COPYRIGHT
.PP
Copyright (C) 2012\-2021 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.
.SH CONTACT
.PP
If you have any questions or want to report a bug, please go to
https://osmcode.org/contact.html
.SH AUTHORS
Jochen Topf <jochen@topf.org>.