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.13.1)
http://osmcode.org/libosmium
Debian/Ubuntu: libosmium2-dev
Protozero (>= 1.5.1)
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 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
default is RelWithDebInfo.
See the Osmium Tool website and Osmium Tool 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 automatically.
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.
Copyright (C) 2013-2017 Jochen Topf ([email protected])
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 protected]).