Ubuntu Manpage: osmcoastline - extract coastline from OpenStreetMap data

Provided by: osmcoastline_2.3.1-1build3_amd64

NAME

       osmcoastline - extract coastline from OpenStreetMap data

SYNOPSIS

       osmcoastline [OPTIONS] –output-database=OUTPUT-DB INPUT-FILE

DESCRIPTION

       osmcoastline  extracts  the  coastline data from the INPUT-FILE, usually a planet file (or
       the output of the osmcoastline_filter program, see below) and  assembles  all  the  pieces
       into polygons for use in map renderers etc.

       The  output  is written to the Spatialite database OUTPUT-DB.  Depending on the options it
       will contain the coastlines in different formats.  See  the  description  of  the  options
       below and the README.md for details.

OPTIONS

-h, –help
Display usage information.

-b, –bbox-overlap=OVERLAP
Polygons that are too large are split into two halves (recursively if need be).
Where the polygons touch the OVERLAP is added, because two polygons just touching
often lead to rendering problems. The value is given in the units used for the
projection (for WGS84 (EPSG: 4326) this is in degrees, for Mercator (EPSG: 3857)
this is in meters). If this is set too small you might get rendering artefacts
where polygons touch. The larger you set this the larger the output polygons will
be. The best values depend on the map scale or zoom level you are preparing the
data for. Disable the overlap by setting it to 0. Default is 0.0001 for WGS84 and
10 for Mercator.

-c, –close-distance=DISTANCE
osmcoastline assembles ways tagged natural=coastline into rings. Sometimes there
is a gap in the coastline in the OSM data. osmcoastline will close this gap if it
is smaller than DISTANCE. Use 0 to disable this feature.

-d, –debug
Enable debugging output.

-f, –overwrite
Overwrite output file if it already exists.

-g, –gdal-driver=DRIVER
Allows user to select any GDAL driver. Only “SQLite”, “GPKG” and “ESRI Shapefile”
GDAL drivers have been tested. The default is “SQLite”.

-i, –no-index
Do not create spatial indexes in output db. The default is to create those
indexes. This makes the database larger, but data access is faster.

-l, –output-lines
Output coastlines as lines to database file.

-m, –max-points=NUM
Set this to 0 to prevent splitting of large polygons and linestrings. If set to
any other positive integer osmcoastline will try to split polygons/linestrings to
not have more than this many points. Depending on the overlap defined with -b and
the shape of the polygons it is sometimes not possible to get the polygons small
enough. osmcoastline will warn you on STDERR if this is the case. Default is
1000.

-o, –output-database=FILE
Spatialite database file for output. This option must be set.

-p, –output-polygons=land|water|both|none
Which polygons to write out (default: land).

-r, –output-rings
Output rings to database file. This is used for debugging.

-s, –srs=EPSGCODE
Set spatial reference system/projection. Use 4326 for WGS84 or 3857 for “Web
Mercator”. If you want to use the data for the usual tiled web maps, 3857 is
probably right. For other uses, especially if you want to re-project to some other
projection, 4326 is probably right. Other projections are currently not supported.
Default is 4326.

-S, –write-segments=FILENAME
Write out all coastline segments to the specified file. Segments are connections
between two points. The segments are written in an internal format intended for
use with the osmcoastline_segments program only. The file includes all segments
actually in the OSM data and only those. Gaps are (possibly) closed in a later
stage of running osmcoastline, but those closing segments will not be included.

-v, –verbose
Gives you detailed information on what osmcoastline is doing, including timing.

-V, –version
Display program version and license information.

NOTES

       To speed up processing you might want to run the osmcoastline_filter program  first.   See
       its man page for details.

DIAGNOSTICS

       osmcoastline exits with exit code

       0      if everything was okay

       1      if there were warnings while processing the coastline

       2      if there were errors while processing the coastline

       3      if there was a fatal error when running the program

       4      if there was a problem with the command line arguments.

EXAMPLES

       Run osmcoastline on a planet file using default options:

              osmcoastline -o coastline.db planet.osm.pbf

       Running osmcoastline_filter first:

              osmcoastline_filter -o coastline.osm.pbf planet.osm.pbf
              osmcoastline -o coastline.db coastline.osm.pbf

COPYRIGHT

       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.

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>.

                                              2.3.1                               OSMCOASTLINE(1)