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 al‐
22              ways 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
93              Call  fsync after writing the output file to force flushing buf‐
94              fers to disk.
95
96       --generator=NAME
97              The name and version of the program generating the output  file.
98              It  will  be added to the header of the output file.  Default is
99osmium/” and the version of osmium.
100
101       -o, --output=FILE
102              Name of the output file.  Default is `-' (STDOUT).
103
104       -O, --overwrite
105              Allow an existing output file to be overwritten.   Normally  os‐
106              mium will refuse to write over an existing file.
107
108       --output-header=OPTION=VALUE
109              Add  output header option.  This command line option can be used
110              multiple times for different OPTIONs.   See  the  osmium-output-
111              headers(5) man page for a list of available header options.  For
112              some commands you can use the special format “OPTION!” (ie.   an
113              exclamation  mark  after the OPTION and no value set) to set the
114              value to the same as in the input file.
115

DIAGNOSTICS

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

MEMORY USAGE

126       osmium changeset-filter does all its work on the fly and  doesn’t  keep
127       much data in main memory.
128

EXAMPLES

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

SEE ALSO

139osmium(1), osmium-file-formats(5), osmium-output-headers(5)
140
141       • Osmium website (https://osmcode.org/osmium-tool/)
142
144       Copyright (C) 2013-2023 Jochen Topf <jochen@topf.org>.
145
146       License  GPLv3+:  GNU  GPL  version  3  or  later  <https://gnu.org/li
147       censes/gpl.html>.  This is free software: you are free  to  change  and
148       redistribute it.  There is NO WARRANTY, to the extent permitted by law.
149

CONTACT

151       If  you  have  any  questions  or  want  to  report a bug, please go to
152       https://osmcode.org/contact.html
153

AUTHORS

155       Jochen Topf <jochen@topf.org>.
156
157
158
159                                    1.16.0          OSMIUM-CHANGESET-FILTER(1)
Impressum