xenial (1) osmium-renumber.1.gz

Provided by: osmium-tool_1.3.0-1_amd64 bug

NAME
       osmium-renumber - renumber object IDs


SYNOPSIS
       osmium renumber [OPTIONS] INPUT-FILE


DESCRIPTION
       The  objects  (nodes,  ways, and relations) in an OSM file often have very large IDs.  This can make some
       kinds of postprocessing difficult.  This command will renumber all  objects  using  IDs  starting  at  1.
       Referential integrity will be kept.

       This command can only be run on OSM files sorted in the usual way (nodes first, then ways, then IDs).  It
       will read the input file twice, so it will not work with STDIN.

       This command needs quite a bit of main memory to keep the  mapping  between  old  and  new  IDs.   It  is
       intended for small extracts.  Don't try to run this on a full planet!

       You  must  never  upload  the  data  generated  by this command to OSM! This would really confuse the OSM
       database because it knows the objects under different IDs.


OPTIONS
       -f, --output-format=FORMAT
              The format of the output file.  Can be used  to  set  the  output  file  format  if  it  can't  be
              autodetected  from  the  output file name.  See osmium-file-formats(5) or the libosmium manual for
              details.

       -F, --input-format=FORMAT
              The format of the input file.  Can be used to set the input format if  it  can't  be  autodetected
              from the file name.  See osmium-file-formats(5) or the libosmium manual for details.

       --generator=NAME
              The name and version of the program generating the output file.  It will be added to the header of
              the output file.  Default is "osmium/" and the version of osmium.

       -i, --index-directory=DIR
              Directory where the index files for mapping between old and news IDs are read from and written to,
              respectively.   Use  this  if  you want to map IDs in several OSM files.  Without this option, the
              indexes are not read from or written to disk.  The directory must exist.  Use '.' for the  current
              directory.  The files written will be named nodes.idx, ways.idx, and relations.idx.

       -o, --output=FILE
              Name of the output file.  Default is '-' (stdout).

       --output-header=OPTION
              Add output header option.  This option can be given several times.  See the libosmium manual for a
              list of allowed header options.

       -O, --overwrite
              Allow an existing output file to be overwritten.  Normally osmium will refuse  to  write  over  an
              existing file.

       --fsync
              Call fsync after writing the output file to force the OS to flush buffers to disk.

       -v, --verbose
              Set verbose mode.  The program will output information about what it is doing to stderr.


DIAGNOSTICS
       osmium renumber exits with exit code

       0      if everything went alright,

       1      if there was an error processing the data, or

       2      if there was a problem with the command line arguments.


EXAMPLES
       Renumber a PBF file and output to a compressed XML file:

              osmium renumber -o ch.osm.bz2 switzerland.osm.pbf

       Renumbering  Switzerland currently (summer 2015) takes only about a minute and needs a bit more than 2 GB
       RAM.

       Renumber an OSM file storing the indexes on disk:

              osmium renumber -i. -o renumbered.osm data.osm

       then rewrite a change file, too:

              osmium renumber -i. -o renumbered.osc changes.osc


SEE ALSO
       • osmium(1), osmium-file-formats(5)

       • Osmium website (http://osmcode.org/osmium)


       Copyright (C) 2013-2015 Jochen Topf <jochen@topf.org>.

       License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>.  This  is  free  software:
       you are free to change and redistribute it.  There is NO WARRANTY, to the extent permitted by law.


CONTACT
       If you have any questions or want to report a bug, please go to http://osmcode.org/contact.html


AUTHORS
       Jochen Topf <jochen@topf.org>.

                                                      1.3.0                                   OSMIUM-RENUMBER(1)