1OSMIUM-MERGE-CHANGES(1) OSMIUM-MERGE-CHANGES(1)
2
6 osmium-merge-changes - merge several OSM change files into one
7
9 osmium merge-changes [OPTIONS] OSM-CHANGE-FILE...
10
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 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
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
29 -h, –help
30 Show usage help.
31 -v, –verbose
33 Set verbose mode. The program will output information about
34 what it is doing to STDERR.
35 –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 –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
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
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 –fsync Call fsync after writing the output file to force flushing buf‐
64 fers to disk.
65 –generator=NAME
67 The name and version of the program generating the output file.
68 It will be added to the header of the output file. Default is
69 “osmium/” and the version of osmium.
70 -o, –output=FILE
72 Name of the output file. Default is `-' (STDOUT).
73 -O, –overwrite
75 Allow an existing output file to be overwritten. Normally
76 osmium will refuse to write over an existing file.
77 –output-header=OPTION=VALUE
79 Add output header option. This command line option can be used
80 multiple times for different OPTIONs. See the libosmium manual
81 for a list of available header options.
82
84 osmium merge-changes exits with exit code
85 0 if everything went alright,
87 1 if there was an error processing the data, or
89 2 if there was a problem with the command line arguments.
91
93 osmium merge-changes keeps the contents of all the change files in main
94 memory. This will take roughly 10 times as much memory as the files
95 take on disk in .osm.bz2 format.
96
98 Merge all changes in changes directory into all.osc.gz:
99 osmium merge-changes -o all.osc.gz changes/*.gz
101 Because osmium merge-changes sorts its input, you can also use it to
103 sort just a single change file:
104 osmium merge-changes unsorted.osc.gz -o sorted.osc.gz
106
108 · osmium(1), osmium-file-formats(5), osmium-merge(1)
109 · Osmium website (https://osmcode.org/osmium-tool/)
111
113 Copyright (C) 2013-2018 Jochen Topf <jochen@topf.org>.
114 License GPLv3+: GNU GPL version 3 or later
116 <https://gnu.org/licenses/gpl.html>. This is free software: you are
117 free to change and redistribute it. There is NO WARRANTY, to the
118 extent permitted by law.
119
121 If you have any questions or want to report a bug, please go to
122 https://osmcode.org/contact.html
123
125 Jochen Topf <jochen@topf.org>.
126 1.10.0 OSMIUM-MERGE-CHANGES(1)