pygeomatch

Python library for matching geospatial vector datasets. For now, we only have surface matching algorithms but others will come soon.

installation

from source

git clone git@github.com:umrlastig/pygeomatch.git
cd pygeomatch

Install uv

Install dependencies:

uv sync

source .venv/bin/activate

with pip

pip install pygeomatch

usage

You can now use the pygeomatch script to match your data. You can see the different parameters with:

pygeomatch --help

For instance, with the test data in directory data using the MCA algorithm and saving the results in test.gpkg, you can use the following:

pygeomatch data/popRef.shp data/popComp.shp test.gpkg MCA

Run tests

pytest -v --cov  --cov-report term-missing

References

Included matching algorithms

Ali, A. B. H. (2001). Qualité géométrique des entités géographiques surfaciques. Application à l'appariement et définition d'une typologie des écarts geométriques (Doctoral dissertation, université Gustave Eiffel).

Olteanu-Raimond, A. M., Mustiere, S., & Ruas, A. (2015). Knowledge formalization for vector data matching using belief theory. Journal of Spatial Information Science, (10), 21-46.

More to be included

Du, H. (2015). Matching disparate geospatial datasets and validating matches using spatial logic (Doctoral dissertation, University of Nottingham).

Yan, Y., Sun, Y., Wang, S., Lu, Y., Hu, Y., & Lu, M. (2025). Research on Multi-Scale Vector Road-Matching Model Based on ISOD Descriptor. ISPRS International Journal of Geo-Information, 14(7), 280.

Data

Ground-truth OSM/BDTopo centre Strasbourg (stage) [-> link BiblioDocs]