Name | Date | Size | #Lines | LOC | ||
---|---|---|---|---|---|---|
.. | 03-May-2022 | - | ||||
.github/ | H | 16-Dec-2021 | - | 584 | 512 | |
benchmarks/ | H | 03-May-2022 | - | 682 | 420 | |
cmake/ | H | 16-Dec-2021 | - | 679 | 583 | |
doc/ | H | 03-May-2022 | - | 2,368 | 1,821 | |
examples/ | H | 03-May-2022 | - | 2,541 | 1,271 | |
include/ | H | 16-Dec-2021 | - | 44,774 | 24,669 | |
test/ | H | 03-May-2022 | - | 36,603 | 28,627 | |
.clang-tidy | H A D | 16-Dec-2021 | 6.1 KiB | 158 | 157 | |
.codecov.yml | H A D | 16-Dec-2021 | 116 | 8 | 5 | |
.gitignore | H A D | 16-Dec-2021 | 64 | 7 | 6 | |
.gitmodules | H A D | 16-Dec-2021 | 127 | 4 | 3 | |
.ycm_extra_conf.py | H A D | 16-Dec-2021 | 1.2 KiB | 54 | 25 | |
CHANGELOG.md | H A D | 16-Dec-2021 | 50.2 KiB | 1,254 | 961 | |
CONTRIBUTING.md | H A D | 16-Dec-2021 | 864 | 20 | 13 | |
LICENSE | H A D | 16-Dec-2021 | 1.3 KiB | 24 | 20 | |
NOTES_FOR_DEVELOPERS.md | H A D | 16-Dec-2021 | 6.5 KiB | 151 | 109 | |
README.md | H A D | 16-Dec-2021 | 3.1 KiB | 108 | 64 | |
appveyor.yml | H A D | 16-Dec-2021 | 2 KiB | 64 | 51 | |
build-appveyor.bat | H A D | 16-Dec-2021 | 2.3 KiB | 85 | 60 | |
build-local.bat | H A D | 16-Dec-2021 | 559 | 41 | 29 | |
build-msys2.bat | H A D | 16-Dec-2021 | 1.5 KiB | 47 | 34 | |
osmium.imp | H A D | 16-Dec-2021 | 770 | 17 | 16 |
README.md
1# Libosmium 2 3https://osmcode.org/libosmium 4 5A fast and flexible C++ library for working with OpenStreetMap data. 6 7Libosmium works on Linux, macOS and Windows. 8 9[![Github Build Status](https://github.com/osmcode/libosmium/workflows/CI/badge.svg?branch=master)](https://github.com/osmcode/libosmium/actions) 10[![Appveyor Build status](https://ci.appveyor.com/api/projects/status/yy099a4vxcb604rn/branch/master?svg=true)](https://ci.appveyor.com/project/lonvia/libosmium-eq41p/branch/master) 11[![Coverage Status](https://codecov.io/gh/osmcode/libosmium/branch/master/graph/badge.svg)](https://codecov.io/gh/osmcode/libosmium) 12[![Packaging status](https://repology.org/badge/tiny-repos/libosmium.svg)](https://repology.org/metapackage/libosmium) 13 14Please see the [Libosmium manual](https://osmcode.org/libosmium/manual.html) 15for more details than this README can provide. 16 17 18## Prerequisites 19 20Because Libosmium uses many C++11 features you need a modern compiler and 21standard C++ library. Osmium needs at least GCC 4.8 or clang (LLVM) 3.4. 22(Some parts may work with older versions.) 23 24Different parts of Libosmium (and the applications built on top of it) need 25different libraries. You DO NOT NEED to install all of them, just install those 26you need for your programs. 27 28For details see the [list of 29dependencies](https://osmcode.org/libosmium/manual.html#dependencies) in the 30manual. 31 32The following external (header-only) libraries are included in the libosmium 33repository: 34* [gdalcpp](https://github.com/joto/gdalcpp) 35 36Note that [protozero](https://github.com/mapbox/protozero) was included in 37earlier versions of libosmium, but isn't any more. 38 39 40## Directories 41 42* benchmarks: Some benchmarks checking different parts of Libosmium. 43 44* cmake: CMake configuration scripts. 45 46* doc: Config for API reference documentation. 47 48* examples: Osmium example applications. 49 50* include: C/C++ include files. All of Libosmium is in those header files 51 which are needed for building Osmium applications. 52 53* test: Tests (see below). 54 55 56## Building 57 58Osmium is a header-only library, so there is nothing to build for the 59library itself. 60 61But there are some tests and examples that can be build. Libosmium uses 62cmake: 63 64 mkdir build 65 cd build 66 cmake .. 67 make 68 69This will build the examples and tests. Call `ctest` to run the tests. 70 71For more details see the 72[Building Libosmium](https://osmcode.org/libosmium/manual.html#building-libosmium) 73chapter in the manual. 74 75 76## Testing 77 78To download the `osm-testdata` submodule call: 79 80``` 81git submodule update --init 82``` 83 84This will enable additional tests. 85 86See the 87[Libosmium Manual](https://osmcode.org/libosmium/manual.html#running-tests) 88for instructions. 89 90 91## Switching from the old Osmium 92 93If you have been using the old version of Osmium at 94https://github.com/joto/osmium you might want to read about the [changes 95needed](https://osmcode.org/libosmium/manual.html#changes-from-old-versions-of-osmium). 96 97 98## License 99 100Libosmium is available under the Boost Software License. See LICENSE.txt. 101 102 103## Authors 104 105Libosmium was mainly written and is maintained by Jochen Topf 106(jochen@topf.org). See the git commit log for other authors. 107 108