NAME¶
osmium-time-filter - filter OSM data by time from a history file
SYNOPSIS¶
osmium time-filter [
OPTIONS]
OSM-HISTORY-FILE [
TIME]
osmium time-filter [
OPTIONS]
OSM-HISTORY-FILE
FROM-TIME TO-TIME
DESCRIPTION¶
Copy all objects that were valid at the given
TIME or in the time period
between
FROM-TIME (inclusive) and
TO-TIME (not inclusive) from
the input file into the output file. If no time is given, the current time is
used.
Usually the
INPUT-FILE will be an OSM data file with history. If both
FROM-TIME and
TO-TIME are given, the result will also have
history data, it will also include deleted versions of objects.
If only a single point in time was given, the result will be a normal OSM file
without history containing no deleted objects.
The format for the timestamps is "yyyy-mm-ddThh:mm::ssZ".
COMMON OPTIONS¶
- -h, --help
- Show usage help.
- -v, --verbose
- Set verbose mode. The program will output information about what it is
doing to stderr.
- -F, --input-format=FORMAT
- The format of the input file(s). Can be used to set the input format if it
can't be autodetected from the file name(s). This will set the format for
all input files, there is no way to set the format for some input files
only. See osmium-file-formats(5) or the libosmium manual for
details.
OUTPUT OPTIONS¶
- -f, --output-format=FORMAT
- The format of the output file. Can be used to set the output file format
if it can't be autodetected from the output file name. See
osmium-file-formats(5) or the libosmium manual for details.
- --fsync
- Call fsync after writing the output file to force flushing buffers to
disk.
- --generator=NAME
- The name and version of the program generating the output file. It will be
added to the header of the output file. Default is "
osmium/" and the version of osmium.
- -o, --output=FILE
- Name of the output file. Default is '-' (STDOUT).
- -O, --overwrite
- Allow an existing output file to be overwritten. Normally osmium
will refuse to write over an existing file.
- --output-header=OPTION
- Add output header option. This option can be given several times. See the
libosmium manual for a list of allowed header options.
DIAGNOSTICS¶
osmium time-filter exits with exit code
- 0
- if everything went alright,
- 1
- if there was an error processing the data, or
- 2
- if there was a problem with the command line arguments.
MEMORY USAGE¶
osmium time-filter does all its work on the fly and doesn't keep much
data in main memory.
EXAMPLES¶
Extract current planet file from history planet:
-
osmium time-filter -o planet.osm.pbf history-planet.osh.pbf
Extract planet data how it appeared on January 1 2008 from history planet:
-
osmium time-filter -o planet-20080101.osm.pbf history-planet.osh.pbf 2008-01-01T00:00:00Z
SEE ALSO¶
- •
- osmium(1), osmium-file-formats(5)
- •
- Osmium website (http://osmcode.org/osmium-tool/)
COPYRIGHT¶
Copyright (C) 2013-2017 Jochen Topf <jochen@topf.org>.
License GPLv3+: GNU GPL version 3 or later
<
https://gnu.org/licenses/gpl.html>. This is free software: you are free
to change and redistribute it. There is NO WARRANTY, to the extent permitted
by law.
If you have any questions or want to report a bug, please go to
http://osmcode.org/contact.html
AUTHORS¶
Jochen Topf <jochen@topf.org>.