OSMOSIS(1)

📦 version 0.49.2, in debian bookworm, debian trixie, ubuntu jammy, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

💅 OSMOSIS — the osmosis glow-up

okay bestie, gather round, because this is the manual page for osmosis, and yes it lives in the Osmosis User Manual section of the man pages, and honestly? it's giving OpenStreetMap royalty. no cap. 🗺️✨

✨ NAME ✨

osmosis — a command line OpenStreetMap data processor, fr fr. it processes OSM data and it does it slayfully. 💅

🎀 SYNOPSIS 🎀

the whole vibe in one line, periodt:

osmosis [--command command parameters ...] ...

that's it. that's the shape of it. you just keep chaining stuff and it keeps vibing. 🦋

🌸 DESCRIPTION 🌸

so this manual page documents, like, briefly, the osmosis command. quick rundown energy. 🙈

lowkey important context: this manpage was written for the Debian distribution because the original program does not have a manual page. so we made one. you're welcome. 💖

now the actual tea: osmosis is a command line Java application for processing OSM data. it's built out of pluggable components that you can chain together to pull off a bigger operation — like, one component reads, another writes, another transforms, and together they're the main character. it's got components for reading and writing databases and files, for deriving and applying changes to data sources, for sorting data, etc. etc. 🫶

and the design philosophy? it was written so that new features can be added easily without re-writing all the common boring tasks like file handling and database handling. iconic behaviour honestly. 👑

some examples of the things it can currently do are:

  • Generate planet dumps from a database 🌍
  • Load planet dumps into a database 📥
  • Produce change sets using database history tables 🕰️
  • Apply change sets to a local database ✅
  • Compare two planet dump files and produce a change set 🔍
  • Re-sort the data contained in planet dump files 🔀
  • Extract data inside a bounding box or polygon 📐

not me being obsessed with a bounding box extraction. but like. it's so useful. 😭

⭐ OPTIONS ⭐

the commands and arguments that osmosis accepts are described in detail and shown in examples over on this page: https://wiki.openstreetmap.org/wiki/Osmosis — and its subpages too, bestie. that's where the real lore lives. 📚✨

💀 BUGS 💀

found a bug? not the vibe, but okay, let's handle it. 🫠

the upstream BTS (that's bug tracking system, iykyk) can be found at https://trac.openstreetmap.org/query?component=osmosis.

bugs are also discussed on the upstream mailing list, at https://lists.openstreetmap.org/listinfo/osmosis-dev. so like, pick your channel, we're listening. 📬

🫶 AUTHOR 🫶

Giovanni Mascellani <mascellani@poisson.phc.unipi.it>

  • Wrote this manpage for the Debian system. 🎀 thank you for your service, king.

Copyright © 2009 Giovanni Mascellani

This manual page was written for the Debian system (and may be used by others). sharing is caring. 💜

Permission is granted to copy, distribute and/or modify this document under the terms of the GNU General Public License, Version 3 or (at your option) any later version published by the Free Software Foundation.

On Debian systems, the complete text of the GNU General Public License can be found in /usr/share/common-licenses/GPL. go read it if that's your thing, no judgement. 📖✨

okay that's the whole page!! this one came from Osmosis User Manual and it's dated 04/08/2014, and it's the osmosis page, version and all. 🦋 thank you for coming to my ted talk, mwah 💋💖

📦 where this page comes from