Skip to content
This repository has been archived by the owner on Feb 19, 2023. It is now read-only.
/ osmium-tool Public archive
forked from osmcode/osmium-tool

Command line tool for working with OpenStreetMap data based on the Osmium library.

License

GPL-3.0, Unknown licenses found

Licenses found

GPL-3.0
LICENSE.txt
Unknown
LICENSE-rapidjson.txt
Notifications You must be signed in to change notification settings

TheMarex/osmium-tool

 
 

Repository files navigation

Osmium Command Line Tool

Command line tool for working with OpenStreetMap data based on the Osmium library.

Build Status Build Status

Prerequisites

You need a C++11 compliant compiler. GCC 4.8 and later as well as clang 3.5 and later are known to work. You also need the following libraries:

Libosmium
    Need at least version 2.7.2
    http://osmcode.org/libosmium

Protozero
    This is included in the libosmium repository and might or might not
    have been installed with it. See the libosmium README.
    https://github.com/mapbox/protozero
    Debian/Ubuntu: protozero

Utfcpp
    This is included in the libosmium repository and might or might not
    have been installed with it. See the libosmium README.
    http://utfcpp.sourceforge.net/
    Debian/Ubuntu: libutfcpp-dev

boost-program-options (for parsing command line options)
    http://www.boost.org/doc/libs/1_54_0/doc/html/program_options.html
    Debian/Ubuntu: libboost-program-options-dev

boost-crc
    http://www.boost.org/doc/libs/1_57_0/libs/crc/
    Debian/Ubuntu: libboost-dev

zlib (for PBF support)
    http://www.zlib.net/
    Debian/Ubuntu: zlib1g-dev
    openSUSE: zlib-devel

Expat (for parsing XML files)
    http://expat.sourceforge.net/
    Debian/Ubuntu: libexpat1-dev
    openSUSE: libexpat-devel

cmake (for building)
    http://www.cmake.org/
    Debian/Ubuntu: cmake

Pandoc (optional, to build documentation)
    http://johnmacfarlane.net/pandoc/
    Debian/Ubuntu: pandoc

Building

Osmium uses CMake for its builds. For Unix/Linux systems a simple Makefile wrapper is provided to make the build even easier. Just type make to compile. Results will be in the build directory.

Or you can go the long route explicitly calling CMake as follows:

mkdir build
cd build
cmake ..
make

To set the build type call cmake with -DCMAKE_BUILD_TYPE=type. Possible values are empty, Debug, Release, RelWithDebInfo, MinSizeRel, and Dev. The defaults is RelWithDebInfo.

Documentation

See the manual.

There are man pages in the 'man' directory. To build them you need 'pandoc'. If the pandoc command was found during the CMake config step, the manpages will be built, if not they will not be built.

Tests

Call ctest in the build directory to run the tests after build.

More extensive tests of the libosmium I/O system can also be run. See test/io/Makefile.in for instructions.

License

Copyright (C) 2013-2016 Jochen Topf jochen@topf.org

This program is available under the GNU GENERAL PUBLIC LICENSE Version 3. See the file LICENSE.txt for the complete text of the license.

Authors

This program was written and is maintained by Jochen Topf jochen@topf.org.

About

Command line tool for working with OpenStreetMap data based on the Osmium library.

Resources

License

GPL-3.0, Unknown licenses found

Licenses found

GPL-3.0
LICENSE.txt
Unknown
LICENSE-rapidjson.txt

Stars

Watchers

Forks

Packages

No packages published

Languages

  • C++ 95.2%
  • C 2.2%
  • CMake 1.4%
  • Other 1.2%