taginfo / taginfo-tools

C++ tools used in taginfo processing

Taginfo Tools

These are some tools needed for creating statistics from a planet or other OSM file. These are used as part of taginfo.

They used to "live" in the main taginfo repository.

There is no versioning of these tools. The official site always runs the version tagged osmorg-taginfo-live. If you are using the tools, we encourage you to stay up-to-date with that version also. But monitor your setup closely when you switch to a new version, sometimes things can break.

Make sure you keep both the main taginfo repository and this one up to date.

Prerequisites

You need a C++14-compatible compiler, make and CMake.

• libgd
• libicu
• libosmium (>= 2.14.2)
• libsqlite3
• protozero
• bz2lib
• zlib
• Expat

Ob Debian/Ubuntu install these like this:

apt install \
    cmake \
    libbz2-dev \
    libexpat1-dev \
    libgd-dev \
    libicu-dev \
    libosmium2-dev \
    libprotozero-dev \
    libsqlite3-dev \
    make \
    zlib1g-dev

Use Debian Backports or install libosmium and protozero manually if their versions are too old in your distribution.

Building

Update abseil submodule with:

git submodule update --init

Build as usual with CMake. For instance like this:

mkdir build && cd build
cmake ..
make

To run the tests, call ctest.

Programs

• osmstats - Create statistics from a planet or other OSM file (not used in taginfo)
• taginfo-chronology - Create statistics from a history planet
• taginfo-similarity - Find similarities between OSM tags
• taginfo-sizes - Debugging tool to print out sizes of important structs from taginfo-stats
• taginfo-stats - Create statistics from a planet or other OSM file
• taginfo-unicode - Categorizes OSM tags based on unicode character types

Contact

There is a mailing list for developers and people running their own instances of taginfo: taginfo-dev

Author

Jochen Topf ([email protected]) - https://jochentopf.com/

taginfo-tools's Issues

Build fails on macOS

...
error: no template named 'DenseMmapArray' in namespace 'osmium::index::map'
...
error: no template named 'SparseMmapArray' in namespace 'osmium::index::map'

taginfo-tools/src/tagstats-handler.hpp

Lines 64 to 72 in 6d26519

	template <typename T>
	static std::unique_ptr<map_type<T>> create_map(const std::string& location_index_type) {
	osmium::index::register_map<osmium::unsigned_object_id_type, T, osmium::index::map::DenseMemArray>("DenseMemArray");
	osmium::index::register_map<osmium::unsigned_object_id_type, T, osmium::index::map::DenseMmapArray>("DenseMmapArray");
	osmium::index::register_map<osmium::unsigned_object_id_type, T, osmium::index::map::SparseMemArray>("SparseMemArray");
	osmium::index::register_map<osmium::unsigned_object_id_type, T, osmium::index::map::SparseMmapArray>("SparseMmapArray");
	const auto& map_factory = osmium::index::MapFactory<osmium::unsigned_object_id_type, T>::instance();
	return map_factory.create_map(location_index_type);
	}

DenseMmapArray and SparseMmapArray are available only on linux:

• https://github.com/osmcode/libosmium/blob/3f64f01892eff951ec849c67e59a85ea5f117f40/include/osmium/index/map/dense_mmap_array.hpp#L36
• https://github.com/osmcode/libosmium/blob/3f64f01892eff951ec849c67e59a85ea5f117f40/include/osmium/index/map/sparse_mmap_array.hpp#L36