OSMCOASTLINE_WAYS(1)

📦
version 2.5.0 · 5 versions
, in ubuntu stonking

💖 OSMCOASTLINE_WAYS 💖

okay bestie, welcome to osmcoastline_ways from the OSMCoastline fam (that's the <rainbow>OSMCOASTLINE_WAYS(1)</rainbow> manual, if you're keeping track) — she's a little niche, a little underrated, but she does exactly one thing and she does it cute ✨

🌊 NAME 🌊

osmcoastline_ways — extract coastline ways from OpenStreetMap data 🗺️💅

📜 SYNOPSIS 📜

osmcoastline_ways INPUT-FILE [OUTPUT-DB]

like. that's it. two args. we love an uncomplicated queen.

✨ OPTIONS ✨

  • -h, --help — shows you how to use her. the "hi what do u need" of flags 🫶
  • -V, --version — spills the program version and the license info. very transparent of her, honestly 👑

🌸 DESCRIPTION 🌸

okay so here's the tea ☕ osmcoastline_ways goes into your OSM data and extracts the coastline ways, then writes them into a Spatialite database. that's the whole job. she's not trying to be everything, she's trying to be this.

and ngl, the output is for debugging and statistics. that's it. that's the vibe. it is not the main-character coastline assembler — if you want coastlines for "real" use, that's the osmcoastline program's moment. she's the opening act, not the headliner 💖

⚠️ BIG ONE, DO NOT SKIP: you have to run osmcoastline_ways on the output of the osmcoastline_filter program. if you don't, it will not work correctly! like, at all. no cap. run the filter first, periodt 🚨

so where does the data go? into the Spatialite database OUTPUT-DB. if OUTPUT-DB isn't set, she falls back to the default <cyan>coastline-ways.db</cyan> — cute name, she picked it herself 🎀

and she writes exactly one single table called <cyan>ways</cyan>. what's in it? the IDs of all the ways, their geometries, and the contents of their name and source tags. that's the whole schema, bestie, no hidden columns, no surprises, icon behavior ✨

oh and also — osmcoastline_ways outputs the sum of all way lengths. math girlie behavior, we respect it 📏

👀 SEE ALSO 👀

(the whole friend group, go say hi 💖)

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.

(translation: free to use, free to remix, but she comes as-is, no promises 🫶)

💌 CONTACT 💌

got questions? found a bug? wanna just talk? go to https://osmcode.org/contact.html — they're nice, fr fr 🙈

👑 AUTHORS 👑

Jochen Topf <jochen@topf.org>.

and that's the whole page bestie!! this one's coming at you from version 2.5.0, and yeah the manual footer says OSMCOASTLINE_WAYS(1) but we already knew that 💅

go extract some coastline ways. slay. 🌊✨💖

📦 where this page comes from