osmium-time-filter(1)

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

NAME

6       osmium-time-filter - filter OSM data by time from a history file
7

SYNOPSIS

9       osmium time-filter [OPTIONS] OSM-HISTORY-FILE [TIME]
10       osmium time-filter [OPTIONS] OSM-HISTORY-FILE FROM-TIME TO-TIME
11

DESCRIPTION

13       Copy  all  objects  that  were  valid  at the given TIME or in the time
14       period between FROM-TIME (inclusive) and TO-TIME (not  inclusive)  from
15       the  input file into the output file.  If no time is given, the current
16       time is used.
17
18       Usually the INPUT-FILE will be an OSM data file with history.  If  both
19       FROM-TIME  and  TO-TIME  are  given,  the result will also have history
20       data, it will also include deleted versions of objects.
21
22       If only a single point in time was given, the result will be  a  normal
23       OSM file without history containing no deleted objects.
24
25       The format for the timestamps is “yyyy-mm-ddThh:mm:ssZ”.
26
27       This commands reads its input file only once and writes its output file
28       in one go so it can be streamed, ie.  it can read from STDIN and  write
29       to STDOUT.
30

COMMON OPTIONS

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

INPUT OPTIONS

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

OUTPUT OPTIONS

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

DIAGNOSTICS

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

MEMORY USAGE

96       osmium  time-filter  does all its work on the fly and doesn't keep much
97       data in main memory.
98

EXAMPLES

100       Extract current planet file from history planet:
101
102              osmium time-filter -o planet.osm.pbf history-planet.osh.pbf
103
104       Extract planet data how it appeared on  January  1  2008  from  history
105       planet:
106
107              osmium time-filter -o planet-20080101.osm.pbf history-planet.osh.pbf 2008-01-01T00:00:00Z
108

COPYRIGHT

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

CONTACT

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

AUTHORS

127       Jochen Topf <jochen@topf.org>.
128
129
130
131                                    1.10.0               OSMIUM-TIME-FILTER(1)