planetsplitter-slim Man page

planetsplitter-slim planetsplitter-slim

NAME

planetsplitter-slim – split OSM XML data into routino database

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

planetsplitter-slim reads in the OSM format XML file and splits it up
to create the routino database that is for routing.

OPTIONS

–help Prints usage information

–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. De‐
faults 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 memo‐
ry is shared between the threads \- too many threads and not
enough memory will reduce the performance).

–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 ex‐
ist then dirname, prefix and “profiles.xml” will be combined and
used, if that doesn’t exist then the file /usr/share/routi‐
no/profiles.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 suit‐
able for real-time display than logging.

–logtime>
Print the elapsed time for each processing step (minutes, sec‐
onds and milliseconds).

–logmemory
Print the maximum allocated and mapped memory for each process‐
ing step (MBytes).

–errorlog[=name] Log OSM parsing and processing errors to error.log or the speci‐
fied 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 er‐
ror 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 in‐
termediate 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.

–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).

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 uncom‐
pressed (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.

SEE ALSO

planetsplitter

20 September 2015 planetsplitter-slim