Osmium Command Line Tool
A multipurpose command line tool for working with OpenStreetMap data based on the Osmium library.
Official web site: http://osmcode.org/osmium-tool/
You need a C++11 compliant compiler. GCC 4.8 and later as well as clang 3.6 and later are known to work. It also works on modern Visual Studio C++ compilers.
You also need the following libraries:
Libosmium (>= 2.11.0) http://osmcode.org/libosmium Debian/Ubuntu: libosmium2-dev Protozero (>= 1.4.5) 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 Fedora: protozero-devel 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 openSUSE: utfcpp Fedora: utf8cpp-devel RapidJSON (>= 1.1) This is included in the osmium-tool repository, so you usually do not need to install this. http://rapidjson.org/ Debian/Ubuntu: rapidjson-dev boost-program-options (>= 1.55) http://www.boost.org/doc/libs/1_55_0/doc/html/program_options.html Debian/Ubuntu: libboost-program-options-dev boost-crc http://www.boost.org/doc/libs/1_55_0/libs/crc/ Debian/Ubuntu: libboost-dev bz2lib http://www.bzip.org/ Debian/Ubuntu: libbz2-dev Fedora: bzip2-devel CentOS: bzip2-devel zlib http://www.zlib.net/ Debian/Ubuntu: zlib1g-dev openSUSE: zlib-devel Fedora: zlib-devel CentOS: zlib-devel Expat http://expat.sourceforge.net/ Debian/Ubuntu: libexpat1-dev openSUSE: libexpat-devel Fedora: expat-devel CentOS: expat-devel cmake http://www.cmake.org/ Debian/Ubuntu: cmake openSUSE: cmake Fedora: cmake Pandoc (Needed to build documentation, optional) http://johnmacfarlane.net/pandoc/ Debian/Ubuntu: pandoc openSUSE: pandoc Fedora: pandoc
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
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
values are empty, Debug, Release, RelWithDebInfo, MinSizeRel, and Dev. The
default is RelWithDebInfo.
There are man pages in the 'man' directory. To build them you need 'pandoc'.
pandoc command was found during the CMake config step, the manpages
will be built automatically.
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.
Copyright (C) 2013-2017 Jochen Topf (firstname.lastname@example.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.
This program was written and is maintained by Jochen Topf (email@example.com).