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

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

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

       --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,  file‐
              names  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.

SEE ALSO

       planetsplitter(1)

                                                  22 April 2024                           planetsplitter-slim(1)