1OSMIUM-CAT(1)                                                    OSMIUM-CAT(1)
2
3
4

NAME

6       osmium-cat - concatenate OSM files and convert to different formats
7

SYNOPSIS

9       osmium cat [OPTIONS] OSM-FILE...
10

DESCRIPTION

12       Concatenates  all input files and writes the result to the output file.
13       The data is not sorted in any way but strictly  copied  from  input  to
14       output.
15
16       Because  this  program supports several different input and output for‐
17       mats, it can be used to convert OSM files from one format into another.
18
19       This commands reads its input file(s) only once and writes  its  output
20       file  in  one go so it can be streamed, ie.  it can read from STDIN and
21       write to STDOUT.
22

OPTIONS

24       -t, –object-type=TYPE
25              Read only objects of given type (node,  way,  relation,  change‐
26              set).   By default all types are read.  This option can be given
27              multiple times.
28

COMMON OPTIONS

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

INPUT OPTIONS

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

OUTPUT OPTIONS

58       -f, –output-format=FORMAT
59              The  format  of  the output file.  Can be used to set the output
60              file format if it can't be autodetected  from  the  output  file
61              name.   See  osmium-file-formats(5)  or the libosmium manual for
62              details.
63
64       –fsync 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
70osmium/” 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.
83

DIAGNOSTICS

85       osmium cat exits with exit code
86
87       0      if everything went alright,
88
89       1      if there was an error processing the data, or
90
91       2      if there was a problem with the command line arguments.
92

MEMORY USAGE

94       osmium cat does all its work on the fly and doesn't keep much  data  in
95       main memory.
96

EXAMPLES

98       Convert a PBF file to a compressed XML file:
99
100              osmium cat -o out.osm.bz2 in.osm.pbf
101
102       Concatenate all change files in the `changes' directory into one:
103
104              osmium cat -o all-changes.osc.gz changes/*.osc.gz
105
106       Copy nodes and ways from source to destination file:
107
108              osmium cat -o dest.osm.pbf source.osm.pbf -t node -t way
109

SEE ALSO

111       · osmium(1), osmium-file-formats(5)
112
113       · Osmium website (https://osmcode.org/osmium-tool/)
114
116       Copyright (C) 2013-2018 Jochen Topf <jochen@topf.org>.
117
118       License      GPLv3+:     GNU     GPL     version     3     or     later
119       <https://gnu.org/licenses/gpl.html>.  This is free  software:  you  are
120       free  to  change  and  redistribute  it.   There is NO WARRANTY, to the
121       extent permitted by law.
122

CONTACT

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

AUTHORS

128       Jochen Topf <jochen@topf.org>.
129
130
131
132                                    1.10.0                       OSMIUM-CAT(1)
Impressum