osmium-merge-changes(1)

1OSMIUM-MERGE-CHANGES(1)                                OSMIUM-MERGE-CHANGES(1)
2
3
4

NAME

6       osmium-merge-changes - merge several OSM change files into one
7

SYNOPSIS

9       osmium merge-changes [OPTIONS] OSM-CHANGE-FILE...
10

DESCRIPTION

12       Merges  the  content of all change files given on the command line into
13       one large change file.  Objects are sorted by type,  ID,  version,  and
14       timestamp so it doesn’t matter in what order the change files are given
15       or in what order they contain the data.
16
17       This commands reads its input file(s) only once and writes  its  output
18       file  in  one go so it can be streamed, ie.  it can read from STDIN and
19       write to STDOUT.
20

OPTIONS

22       -s, --simplify
23              Only write the last version of any object to the output.  For an
24              object created in one of the change files and removed in a later
25              one, the deleted version of the object will still appear because
26              it is the latest version.
27

COMMON OPTIONS

29       -h, --help
30              Show usage help.
31
32       -v, --verbose
33              Set  verbose  mode.   The  program will output information about
34              what it is doing to STDERR.
35
36       --progress
37              Show progress bar.  Usually a progress bar is only displayed  if
38              STDOUT  and  STDERR  are detected to be TTY.  With this option a
39              progress bar is always shown.  Note that  a  progress  bar  will
40              never be shown when reading from STDIN or a pipe.
41
42       --no-progress
43              Do  not  show progress bar.  Usually a progress bar is displayed
44              if STDOUT and STDERR are detected to be a TTY.  With this option
45              the  progress  bar is suppressed.  Note that a progress bar will
46              never be shown when reading from STDIN or a pipe.
47

INPUT OPTIONS

49       -F, --input-format=FORMAT
50              The format of the input file(s).  Can be used to set  the  input
51              format  if it can’t be autodetected from the file name(s).  This
52              will set the format for all input files, there is no way to  set
53              the  format  for  some  input  files only.  See osmium-file-for‐
54              mats(5) or the libosmium manual for details.
55

OUTPUT OPTIONS

57       -f, --output-format=FORMAT
58              The format of the output file.  Can be used to  set  the  output
59              file  format  if  it  can’t be autodetected from the output file
60              name.  See osmium-file-formats(5) or the  libosmium  manual  for
61              details.
62
63       --fsync
64              Call  fsync after writing the output file to force flushing buf‐
65              fers to disk.
66
67       --generator=NAME
68              The name and version of the program generating the output  file.
69              It  will  be added to the header of the output file.  Default is
70              “osmium/” and the version of osmium.
71
72       -o, --output=FILE
73              Name of the output file.  Default is `-' (STDOUT).
74
75       -O, --overwrite
76              Allow an existing  output  file  to  be  overwritten.   Normally
77              osmium will refuse to write over an existing file.
78
79       --output-header=OPTION=VALUE
80              Add  output header option.  This command line option can be used
81              multiple times for different OPTIONs.  See the libosmium  manual
82              for  a  list of available header options.  For some commands you
83              can use the special format “OPTION!” (ie.  an  exclamation  mark
84              after  the OPTION and no value set) to set the value to the same
85              as in the input file.
86

DIAGNOSTICS

88       osmium merge-changes exits with exit code
89
90       0      if everything went alright,
91
92       1      if there was an error processing the data, or
93
94       2      if there was a problem with the command line arguments.
95

MEMORY USAGE

97       osmium merge-changes keeps the contents of all the change files in main
98       memory.   This  will  take roughly 10 times as much memory as the files
99       take on disk in .osm.bz2 format.
100

EXAMPLES

102       Merge all changes in changes directory into all.osc.gz:
103
104              osmium merge-changes -o all.osc.gz changes/*.gz
105
106       Because osmium merge-changes sorts its input, you can also  use  it  to
107       sort just a single change file:
108
109              osmium merge-changes unsorted.osc.gz -o sorted.osc.gz
110

COPYRIGHT

117       Copyright (C) 2013-2020 Jochen Topf <jochen@topf.org>.
118
119       License      GPLv3+:     GNU     GPL     version     3     or     later
120       <https://gnu.org/licenses/gpl.html>.  This is free  software:  you  are
121       free  to  change  and  redistribute  it.   There is NO WARRANTY, to the
122       extent permitted by law.
123

CONTACT

125       If you have any questions or  want  to  report  a  bug,  please  go  to
126       https://osmcode.org/contact.html
127

AUTHORS

129       Jochen Topf <jochen@topf.org>.
130
131
132
133                                    1.12.1             OSMIUM-MERGE-CHANGES(1)