planetsplitter-slim(1)

📦
version 3.4.3 · 5 versions
, in ubuntu resolute, ubuntu stonking

💫 planetsplitter-slim — the manual page, but make it cute 💫

okay bestie, welcome to planetsplitter-slim(1) — yes that's the manual section, and yes it's in section 1, we're being official today. this is the slim version of the planetsplitter tool and she is lowkey the whole personality of the routino set. let's get into it 🫶

✨ NAME ✨

planetsplitter-slim — split OSM XML data into routino database 🌍➡️🗄️

like. she takes your big ol' pile of map data and turns it into a routino database, which is what routing actually runs on. it's giving "glow-up but for map files" 💅

🦋 SYNOPSIS 🦋

planetsplitter-slim [--help] [--dir=dirname] [--prefix=name]
                    [--sort-ram-size=size] [--sort-threads=number]
                    [--tmpdir=dirname] [--tagging=filename] [--loggable]
                    [--logtime] [--logmemory] [--errorlog=name]
                    [--parse-only | --process-only] [--append] [--keep]
                    [--changes] [--max-iterations=number] [--prune-none]
                    [--prune-isolated=len] [--prune-short=len]
                    [--prune-straight=len] [filename.osm ... |
                    filename.osc ... | filename.pbf ... | filename.o5m
                    ... | filename.o5c ... |
                    filename.(o5m|osc|os5m|o5c).bz2 ... |
                    filename.(o5m|osc|os5m|o5c).gz ... |
                    filename.(o5m|osc|os5m|o5c).xz ...]

💖 DESCRIPTION 💖

so the vibe is: planetsplitter-slim reads in the OSM format XML file and splits it up to create the routino database that is for routing. 🗺️✨

that's it. that's the whole job. she reads, she splits, she delivers a database that knows how to route. main character energy fr fr 👑

🌸 OPTIONS 🌸

the way that every single one of these matters — no skips, we're doing all of them 🎀

  • --help — Prints usage information. (the classic. the "bestie what do I even type" button 💀)
  • --dir=dirname — Sets the directory name in which to save the results. Defaults to the current directory. 📁
  • --prefix=name — Sets the filename prefix for the files that are created. Defaults to no prefix. 🏷️
  • --sort-ram-size=size — Specifies the amount of RAM (in MB) to use for sorting the data. If not specified then 64 MB will be used in slim mode or 256 MB otherwise. 🧠
  • --sort-threads=number — The number of threads to use for data sorting (the sorting memory is shared between the threads - too many threads and not enough memory will reduce the performance). bestie pls don't just crank this to 64 and wonder why it's slow 😭
  • --tmpdir=dirname — Specifies the name of the directory to store the temporary disk files. If not specified then it defaults to either the value of the --dir option or the current directory. 🗂️
  • --tagging=filename — Sets the filename containing the list of tagging rules in XML format for the parsing the input files. If the file doesn't exist then dirname, prefix and "tagging.xml" will be combined and used, if that doesn't exist then the file /usr/share/routino/tagging.xml will be used. 🏷️✨
  • --loggable — Print progress messages that are suitable for logging to a file; normally an incrementing counter is printed which is more suitable for real-time display than logging. 📝
  • --logtime> — Print the elapsed time for each processing step (minutes, seconds and milliseconds). ⏱️ (spelled exactly like that on the page, bestie — not a typo I introduced, I'm just the messenger 🫶)
  • --logmemory — Print the maximum allocated and mapped memory for each processing step (MBytes). 🧮
  • --errorlog[=name] — Log OSM parsing and processing errors to error.log or the specified file name (the --dir and --prefix options are applied). If the --append option is used then the existing log file will be appended, otherwise a new one will be created. If the --keep option is also used a geographically searchable database of error logs is created for use in the visualiser. 🚨📍
  • --parse-only — Parse the input files and store the data in intermediate files but don't process the data into a routing database. This option must be used with the --append option for all except the first file. 🔎
  • --process-only — Don't read in any files but process the existing intermediate files created by using the --parse-only option. ⚙️
  • --append — Parse the input file and append the result to the existing intermediate files; the appended file can be either an OSM file or an OSC change file. ➕
  • --keep — Store a set of intermediate files after parsing the OSM files, sorting and removing duplicates; this allows appending an OSC file and re-processing later. 📦
  • --changes — This option indicates that the data being processed contains one or more OSC (OSM changes) files, they must be applied in time sequence if more than one is used. This option implies --append when parsing data files and --keep when processing data. 🕰️ (order matters, no cap)
  • --max-iterations=number — The maximum number of iterations to use when generating super-nodes and super-segments. Defaults to 5 which is normally enough. 🔁
  • --prune-none — Disable the prune options below, they can be re-enabled by adding them to the command line after this option. ✂️🚫
  • --prune-isolated=length — Remove the access permissions for a transport type from small disconnected groups of segments and remove the segments if they end up with no access permission (defaults to removing groups under 500m). 🏝️
  • --prune-short=length — Remove short segments (defaults to removing segments up to a maximum length of 5m). 🩳
  • --prune-straight==length — Remove nodes in almost straight highways (defaults to removing nodes up to 3m offset from a straight line). 📏 (again — two equals signs, straight from the source, I would never 💅)
  • filename.osm, filename.osc, filename.pbf, filename.o5m, filename.o5c — Specifies the filename(s) to read data from. Filenames ending .pbf will be read as PBF, filenames ending in .o5m or .o5c will be read as O5M/O5C, otherwise as XML. Filenames ending .bz2 will be bzip2 uncompressed (if bzip2 support compiled in). Filenames ending .gz will be gzip uncompressed (if gzip support compiled in). Filenames ending .xz will be xz uncompressed (if xz support compiled in). 🗜️
Note: In version 2.5 of Routino the ability to read data from the standard input has been removed. This is because there is now the ability to read compressed files (bzip2, gzip, xz) and PBF files directly. Also using standard input the file type cannot be auto-detected from the filename. 😭 rip stdin, you served us well (until 2.5)

🌈 SEE ALSO 🌈

and that's the whole page bestie, you ate that 🍓

planetsplitter-slim(1) — dated 03 December 2025 💜 that's the manual page name and the manual page name again, plus the date, all cute and accounted for. mwah. now go split some planets 🪐✨

📦 where this page comes from