cyang-kth / Fmm

Linux / macOS	Windows	Wiki	Docs

FMM is an open source map matching framework in C++ and Python. It solves the problem of matching noisy GPS data to a road network. The design considers maximizing performance, scalability and functionality.

Online demo

Check the online demo.

Features

• High performance: C++ implementation using Rtree, optimized routing, parallel computing (OpenMP).
• Python API: jupyter-notebook and web app
• Scalibility: millions of GPS points and millions of road edges.
• Multiple data format:
  • Road network in OpenStreetMap or ESRI shapefile.
  • GPS data in Point CSV, Trajectory CSV and Trajectory Shapefile (more details).
• Detailed matching information: traversed path, geometry, individual matched edges, GPS error, etc. More information at here.
• Multiple algorithms: FMM (for small and middle scale network) and STMatch (for large scale road network)
• Platform support: Unix (ubuntu) , Mac and Windows(cygwin environment).
• Hexagon match: 🎉 Match to the uber's h3 Hexagonal Hierarchical Geospatial Indexing System. Check the demo.

We encourage contribution with feature request, bug report or developping new map matching algorithms using the framework.

Screenshots of notebook

Map match to OSM road network by drawing

Explore the factor of candidate size k, search radius and GPS error

Explore detailed map matching information

Explore with dual map

Map match to hexagon by drawing

Explore the factor of hexagon level and interpolate

Source code of these screenshots are available at https://github.com/cyang-kth/fmm-examples.

Installation, example, tutorial and API.

• Check https://fmm-wiki.github.io/ for installation, documentation.
• Check example for simple examples of fmm.
• 🎉 Check https://github.com/cyang-kth/fmm-examples for interactive map matching in notebook.

Code docs for developer

Check https://cyang-kth.github.io/fmm/

Contact and citation

Can Yang, Ph.D. student at KTH, Royal Institute of Technology in Sweden

Email: cyang(at)kth.se

Homepage: https://people.kth.se/~cyang/

FMM originates from an implementation of this paper Fast map matching, an algorithm integrating hidden Markov model with precomputation. A post-print version of the paper can be downloaded at link. Substaintial new features have been added compared with the original paper.

Please cite fmm in your publications if it helps your research:

Can Yang & Gyozo Gidofalvi (2018) Fast map matching, an algorithm
integrating hidden Markov model with precomputation, International Journal of Geographical Information Science, 32:3, 547-570, DOI: 10.1080/13658816.2017.1400548

Bibtex file

@article{doi:10.1080/13658816.2017.1400548,
author = {Can Yang and Gyozo Gidofalvi},
title = {Fast map matching, an algorithm integrating hidden Markov model with precomputation},
journal = {International Journal of Geographical Information Science},
volume = {32},
number = {3},
pages = {547-570},
year  = {2018},
publisher = {Taylor & Francis},
doi = {10.1080/13658816.2017.1400548},
URL = {
        https://doi.org/10.1080/13658816.2017.1400548
},
eprint = {
        https://doi.org/10.1080/13658816.2017.1400548   
}
}