1OSMIUM-CHANGESET-FILTER(1)                          OSMIUM-CHANGESET-FILTER(1)
2
3
4

NAME

6       osmium-changeset-filter - filter changesets from OSM changeset file
7

SYNOPSIS

9       osmium changeset-filter [OPTIONS] OSM-CHANGESET-FILE
10

DESCRIPTION

12       Copy  the  changesets  matching  all  the given criteria to the output.
13       Matching criteria are given through command line options.
14
15       This commands reads its input file only once and writes its output file
16       in  one go so it can be streamed, ie.  it can read from STDIN and write
17       to STDOUT.
18

FILTER OPTIONS

20       -a, –after=TIMESTAMP
21              Only copy changesets closed after the  given  time.   This  will
22              always include all open changesets.
23
24       -b, –before=TIMESTAMP
25              Only copy changesets created before the given time.
26
27       -B, –bbox=LONG1,LAT1,LONG2,LAT2
28              Only  copy changesets with a bounding box overlapping the speci‐
29              fied box.  The coordinates LONG1,LAT1  are  from  one  arbitrary
30              corner, the coordinates LONG2,LAT2 are from the opposite corner.
31
32       -c, –with-changes
33              Only copy changesets with changes.
34
35       -C, –without-changes
36              Only copy changesets without changes.
37
38       -d, –with-discussion
39              Only  copy  changesets  with  discussions, ie changesets with at
40              least one comment.
41
42       -D, –without-discussion
43              Only copy changesets without discussions, ie changesets  without
44              any comments.
45
46       –open  Only copy open changesets.
47
48       –closed
49              Only copy closed changesets.
50
51       -u, –user=USER
52              Only copy changesets by the given user name.
53
54       -U, –uid=UID
55              Only copy changesets by the given user ID.
56

COMMON OPTIONS

58       -h, –help
59              Show usage help.
60
61       -v, –verbose
62              Set  verbose  mode.   The  program will output information about
63              what it is doing to STDERR.
64
65       –progress
66              Show progress bar.  Usually a progress bar is only displayed  if
67              STDOUT  and  STDERR  are detected to be TTY.  With this option a
68              progress bar is always shown.  Note that  a  progress  bar  will
69              never be shown when reading from STDIN or a pipe.
70
71       –no-progress
72              Do  not  show progress bar.  Usually a progress bar is displayed
73              if STDOUT and STDERR are detected to be a TTY.  With this option
74              the  progress  bar is suppressed.  Note that a progress bar will
75              never be shown when reading from STDIN or a pipe.
76

INPUT OPTIONS

78       -F, –input-format=FORMAT
79              The format of the input file(s).  Can be used to set  the  input
80              format  if it can't be autodetected from the file name(s).  This
81              will set the format for all input files, there is no way to  set
82              the  format  for  some  input  files only.  See osmium-file-for‐
83              mats(5) or the libosmium manual for details.
84

OUTPUT OPTIONS

86       -f, –output-format=FORMAT
87              The format of the output file.  Can be used to  set  the  output
88              file  format  if  it  can't be autodetected from the output file
89              name.  See osmium-file-formats(5) or the  libosmium  manual  for
90              details.
91
92       –fsync Call  fsync after writing the output file to force flushing buf‐
93              fers to disk.
94
95       –generator=NAME
96              The name and version of the program generating the output  file.
97              It  will  be added to the header of the output file.  Default is
98osmium/” and the version of osmium.
99
100       -o, –output=FILE
101              Name of the output file.  Default is `-' (STDOUT).
102
103       -O, –overwrite
104              Allow an existing  output  file  to  be  overwritten.   Normally
105              osmium will refuse to write over an existing file.
106
107       –output-header=OPTION=VALUE
108              Add  output header option.  This command line option can be used
109              multiple times for different OPTIONs.  See the libosmium  manual
110              for a list of available header options.
111

DIAGNOSTICS

113       osmium changeset-filter exits with exit code
114
115       0      if everything went alright,
116
117       1      if there was an error processing the data, or
118
119       2      if there was a problem with the command line arguments.
120

MEMORY USAGE

122       osmium  changeset-filter  does all its work on the fly and doesn't keep
123       much data in main memory.
124

EXAMPLES

126       To see all changesets by user “foo”:
127
128              osmium changeset-filter -u foo -f debug changesets.osm.bz2
129
130       To create an OPL file containing only open changesets:
131
132              osmium changeset-filter --open -o open-changesets.opl.bz2 changesets.osm.bz2
133

SEE ALSO

135       · osmium(1), osmium-file-formats(5)
136
137       · Osmium website (https://osmcode.org/osmium-tool/)
138
140       Copyright (C) 2013-2018 Jochen Topf <jochen@topf.org>.
141
142       License     GPLv3+:     GNU     GPL     version     3     or      later
143       <https://gnu.org/licenses/gpl.html>.   This  is  free software: you are
144       free to change and redistribute it.   There  is  NO  WARRANTY,  to  the
145       extent permitted by law.
146

CONTACT

148       If  you  have  any  questions  or  want  to  report a bug, please go to
149       https://osmcode.org/contact.html
150

AUTHORS

152       Jochen Topf <jochen@topf.org>.
153
154
155
156                                    1.10.0          OSMIUM-CHANGESET-FILTER(1)
Impressum