xenial (1) osmium-time-filter.1.gz

Provided by: osmium-tool_1.3.0-1_amd64 bug

NAME
       osmium-time-filter - filter OSM data by time from a history file


SYNOPSIS
       osmium time-filter [OPTIONS] INPUT-FILE [TIME]
       osmium time-filter [OPTIONS] INPUT-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".


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.

       -F, --input-format=FORMAT
              The  format  of  the  input  file.   Can  be  used  to  set  the  input file format if it can't be
              autodetected from the file name.  See osmium-file-formats(5) or the libosmium manual for details.

       --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).

       --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.

       -O, --overwrite
              Allow an existing output file to be overwritten.  Normally osmium will refuse  to  write  over  an
              existing file.

       --fsync
              Call fsync after writing the output file to force the OS to flush buffers to disk.

       -v, --verbose
              Set verbose mode.  The program will output information about what it is doing to stderr.


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.


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)


       Copyright (C) 2013-2015 Jochen Topf <jochen@topf.org>.

       License  GPLv3+:  GNU  GPL version 3 or later <http://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.


CONTACT
       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>.

                                                      1.3.0                                OSMIUM-TIME-FILTER(1)