.TH "OSMCOASTLINE_FILTER" "1" "2.1.4" "" ""
.SH NAME
.PP
osmcoastline_filter \- filter coastline data from OSM file
.SH SYNOPSIS
.PP
\f[B]osmcoastline_filter\f[] \-\-output=\f[I]OUTPUT_FILE\f[]
\f[I]INPUT\-FILE\f[]
.PP
\f[B]osmcoastline_filter\f[] \-\-help
.SH DESCRIPTION
.PP
\f[B]osmcoastline_filter\f[] is used to filter all nodes and ways needed
for building the coastlines from an OSM planet.
The data is written to the output file in PBF format.
.PP
This output file will be a lot smaller (less than 1%) than the original
planet file, but it contains everything needed to assemble the coastline
polygons.
.PP
If you are playing around or want to run \f[B]osmcoastline\f[] several
times with different parameters, run \f[B]osmcoastline_filter\f[] once
first and use its output as the input for \f[B]osmcoastline\f[].
.PP
\f[B]osmcoastline_filter\f[] can read PBF and XML files, but write only
PBF files.
PBF files are much smaller and faster to read and write than XML files.
The output file will first contain all ways tagged "natural=coastline",
then all nodes used for those ways (and all nodes tagged
"natural=coastline").
Having the ways first and the nodes later in the file is unusual for OSM
files, but the \f[B]osmcoastline\f[] and \f[B]osmcoastline_ways\f[]
programs work fine with it.
.SH OPTIONS
.TP
.B \-h, \-\-help
Display usage information
.RS
.RE
.TP
.B \-o, \-\-output=OSMFILE
Where to write output (default: none)
.RS
.RE
.TP
.B \-V, \-\-version
Display program version and license information.
.RS
.RE
.SH EXAMPLES
.PP
Run it as follows:
.IP
.nf
\f[C]
osmcoastline_filter\ \-o\ coastline\-data.osm.pbf\ planet.osm.pbf
\f[]
.fi
.SH SEE ALSO
.IP \[bu] 2
\f[B]osmcoastline\f[](1), \f[B]osmcoastline_ways\f[](1)
.IP \[bu] 2
OSMCoastline in OSM
wiki (http://wiki.openstreetmap.org/wiki/OSMCoastline)
.SH COPYRIGHT
.PP
Copyright (C) 2012\-2016 Jochen Topf <jochen@topf.org>.
License GPLv3+: GNU GPL version 3 or later
<http://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
http://osmcode.org/contact.html
.SH AUTHORS
Jochen Topf <jochen@topf.org>.