OSMCOASTLINE_FILTER(1)

📦
version 2.5.0 · 5 versions
, in ubuntu stonking

💖 osmcoastline_filter — the manual page, but make it cute 💖

okay bestie, gather round, because this is osmcoastline_filter(1) and she is lowkey a superstar. ✨

🌊 NAME 🌊

osmcoastline_filter — filter coastline data from OpenStreetMap file

🐚 SYNOPSIS 🐚

osmcoastline_filter --output=OUTPUT_FILE INPUT-FILE

osmcoastline_filter --help

💅 DESCRIPTION 💅

so like, osmcoastline_filter is the girl whose whole job is filtering all nodes and ways needed for building the coastlines out of an OSM planet. she takes that giant planet file, does her little sieve moment, and writes the good stuff out to the output file in PBF format. 🌸

and the glow-up?? the output file is gonna be a lot smaller — less than 1% of the original planet file. not me gasping. 😭 but fr fr, even though she's tiny she contains everything needed to assemble the coastline and the land or water polygons. small but mighty, main character energy, periodt. 👑

if you're just playing around, or you wanna run osmcoastline several times with different parameters, the move is: run osmcoastline_filter once first, then use its output as the input for osmcoastline. saves you so much time bestie, iykyk.

now, reading — she can read any file format supported by libosmium (in particular this is PBF, XML, and OPL files). but writing? only PBF files. that's the rule. and honestly it's a good rule because PBF files are much smaller and faster to read and write than XML files. slay. 🔥

and here's the quirky bit that makes her unique 💫 the output file will first contain all ways tagged natural=coastline, and then all nodes used for those ways (plus all nodes tagged natural=coastline too). so ways first, nodes later. that's unusual for OSM files, ngl, it's giving chaotic — but osmcoastline and osmcoastline_ways work fine with it. no cap. 🫶

✨ OPTIONS ✨

  • -f, --format — set output format options (default: pbf).
  • -h, --help — display usage information and exit. your classic "help meeee" button 🎀
  • -o, --output=OSMFILE — where to write output (default: none). yes bestie, you gotta tell her where to put it.
  • -v, --verbose — enable verbose output. she'll tell you what she's doing, and honestly? love that for her. 🦋
  • -V, --version — display program version and license information.

🌈 EXAMPLES 🌈

run it like this, okay:

osmcoastline_filter -o coastline-data.osm.pbf planet.osm.pbf

that's it. that's the whole vibe. iconic. ⭐

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

⚠️ yes bestie, NO WARRANTY — all caps, they mean it, don't come for her if something breaks. 🙈

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

okay that's the whole page!! 🥳 this was version 2.5.0 of OSMCOASTLINE_FILTER(1), and that's a wrap, bestie — go filter some coastlines, you're gonna eat. 💖✨🌊

📦 where this page comes from