'\" -*- coding: us-ascii -*-
.if \n(.g .ds T< \\FC
.if \n(.g .ds T> \\F[\n[.fam]]
.de URL
\\$2 \(la\\$1\(ra\\$3
..
.if \n(.g .mso www.tmac
.TH planetsplitter-slim 1 "02 July 2017" "" ""
.SH NAME
planetsplitter-slim \- split OSM XML data into routino database
.SH SYNOPSIS
'nh
.fi
.ad l
\fBplanetsplitter-slim\fR \kx
.if (\nx>(\n(.l/2)) .nr x (\n(.l/5)
'in \n(.iu+\nxu
[\fB--help\fR] [\fB--dir=\fIdirname\fB\fR] [\fB--prefix=\fIname\fB\fR] [\fB--sort-ram-size=\fIsize\fB\fR] [\fB--sort-threads=\fInumber\fB\fR] [\fB--tmpdir=\fIdirname\fB\fR] [\fB--tagging=\fIfilename\fB\fR] [\fB--loggable\fR] [\fB--logtime\fR] [\fB--logmemory\fR] [\fB--errorlog[=\fIname\fB]\fR] [\fB--parse-only\fR | \fB--process-only\fR] [\fB--append\fR] [\fB--keep\fR] [\fB--changes\fR] [\fB--max-iterations=\fInumber\fB\fR] [\fB--prune-none\fR] [\fB--prune-isolated=\fIlen\fB\fR] [\fB--prune-short=\fIlen\fB\fR] [\fB--prune-straight=\fIlen\fB\fR] [\fIfilename.osm\fR ... | \fIfilename.osc\fR ... | \fIfilename.pbf\fR ... | \fIfilename.o5m\fR ... | \fIfilename.o5c\fR ... | \fIfilename.(o5m|osc|os5m|o5c).bz2\fR ... | \fIfilename.(o5m|osc|os5m|o5c).gz\fR ... | \fIfilename.(o5m|osc|os5m|o5c).xz\fR ...]
'in \n(.iu-\nxu
.ad b
'hy
.SH DESCRIPTION
\fBplanetsplitter-slim\fR reads in the OSM format XML file and
splits it up to create the \fBroutino\fR database that is
for routing.
.SH OPTIONS
.TP 
\*(T<\fB\-\-help\fR\*(T>
Prints usage information
.TP 
\*(T<\fB\-\-dir\fR\*(T>=\fIdirname\fR
Sets the directory name in which to save the results.
Defaults to the current directory.
.TP 
\*(T<\fB\-\-prefix\fR\*(T>=\fIname\fR
Sets the filename prefix for the files that are created.
Defaults to no prefix.
.TP 
\*(T<\fB\-\-sort\-ram\-size\fR\*(T>=\fIsize\fR
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.
.TP 
\*(T<\fB\-\-sort\-threads\fR\*(T>=\fInumber\fR
The number of threads to use for data sorting (the sorting memory
is shared between the threads \e- too many threads and not enough
memory will reduce the performance).
.TP 
\*(T<\fB\-\-tmpdir\fR\*(T>=\fIdirname\fR
Specifies the name of the directory to store the temporary disk
files.
If not specified then it defaults to either the value of the
\*(T<\fB\-\-dir\fR\*(T> option or the current directory.
.TP 
\*(T<\fB\-\-tagging\fR\*(T>=\fIfilename\fR
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
\fIdirname\fR,
\fIprefix\fR and "tagging.xml" will be
combined and used, if that doesn't exist then the file
\*(T<\fI/usr/share/routino/tagging.xml\fR\*(T>
will be used.
.TP 
\*(T<\fB\-\-loggable\fR\*(T>
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.
.TP 
\*(T<\fB\-\-logtime\fR\*(T>>
Print the elapsed time for each processing step
(minutes, seconds and milliseconds).
.TP 
\*(T<\fB\-\-logmemory\fR\*(T>
Print the maximum allocated and mapped memory for each processing
step (MBytes).
.TP 
\*(T<\fB\-\-errorlog[=\fR\*(T>\fIname\fR\*(T<\fB]\fR\*(T>
Log OSM parsing and processing errors to
\*(T<\fIerror.log\fR\*(T> or the specified file name
(the \*(T<\fB\-\-dir\fR\*(T> and \*(T<\fB\-\-prefix\fR\*(T> options
are applied).
If the \*(T<\fB\-\-append\fR\*(T> option is used then the existing
log file will be appended, otherwise a new one will be created.
If the \*(T<\fB\-\-keep\fR\*(T> option is also used a geographically
searchable database of error logs is created for use in the
visualiser.
.TP 
\*(T<\fB\-\-parse\-only\fR\*(T>
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 \*(T<\fB\-\-append\fR\*(T> option
for all except the first file.
.TP 
\*(T<\fB\-\-process\-only\fR\*(T>
Don't read in any files but process the existing intermediate files
created by using the \*(T<\fB\-\-parse\-only\fR\*(T> option.
.TP 
\*(T<\fB\-\-append\fR\*(T>
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.
.TP 
\*(T<\fB\-\-keep\fR\*(T>
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.
.TP 
\*(T<\fB\-\-changes\fR\*(T>
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 \*(T<\fB\-\-append\fR\*(T> when parsing data
files and \*(T<\fB\-\-keep\fR\*(T> when processing data.
.TP 
\*(T<\fB\-\-max\-iterations\fR\*(T>=\fInumber\fR
The maximum number of iterations to use when generating super-nodes
and super-segments.
Defaults to 5 which is normally enough.
.TP 
\*(T<\fB\-\-prune\-none\fR\*(T>
Disable the prune options below, they can be re-enabled by adding
them to the command line after this option.
.TP 
\*(T<\fB\-\-prune\-isolated\fR\*(T>=\fIlength\fR
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).
.TP 
\*(T<\fB\-\-prune\-short\fR\*(T>=\fIlength\fR
Remove short segments (defaults to removing segments up to a
maximum length of 5m).
.TP 
\*(T<\fB\-\-prune\-straight=\fR\*(T>=\fIlength\fR
Remove nodes in almost straight highways (defaults to removing
nodes up to 3m offset from a straight line).
.TP 
\*(T<\fIfilename.osm\fR\*(T>, \*(T<\fIfilename.osc\fR\*(T>, \*(T<\fIfilename.pbf\fR\*(T>, \*(T<\fIfilename.o5m\fR\*(T>, \*(T<\fIfilename.o5c\fR\*(T>
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.
.SH "SEE ALSO"
\fBplanetsplitter\fR(1)