Metadata-Version: 1.1
Name: mapmatching
Version: 0.1.5
Summary: A map matching library
Home-page: https://github.com/categulairo/map_matching
Author: Abraham Toriz Cruz
Author-email: categulario@gmail.com
License: MIT
Description: Map-Matching Algorithm
        ######################
        
        .. image:: https://badges.gitter.im/Join%20Chat.svg
           :target: https://gitter.im/map_matching/Lobby?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge
           :alt: Gitter
        
        .. image:: https://img.shields.io/github/stars/categulario/map_matching.svg
           :target: https://github.com/categulario/map_matching
           :alt: GitHub stars
        
        .. image:: https://img.shields.io/github/contributors/categulario/map_matching.svg?color=red
           :target: https://github.com/categulario/map_matching/graphs/contributors
           :alt: GitHub contributors
        
        .. image:: https://img.shields.io/github/license/categulario/map_matching.svg?color=blue
           :target: https://github.com/categulario/map_matching/blob/master/LICENSE.txt
           :alt: GNU GPL v3
        
        .. image:: https://gitlab.com/categulario/map_matching/badges/master/pipeline.svg
           :target: https://gitlab.com/categulario/map_matching/pipelines
           :alt: Build Status
        
        
        My implementation of the map matching algorithm from `this article <https://www.researchgate.net/publication/308856380_Fast_Hidden_Markov_Model_Map-Matching_for_Sparse_and_Noisy_Trajectories>`_ (Althought with some modifications). The goal is to get the streets from a gps track.
        
        This is how it looks like:
        
        .. image:: https://categulario.tk/map_matching_result.png
           :target: https://categulario.tk/map_matching_result.png
           :alt: Output of the example run
        
        The gray line is the gps trace and the colored lines describe the map-matched most-likely route in the streets for the vehicle.
        
        For reference read `the resulting article <https://categulario.tk/mapmatching.pdf>`_.
        
        Setup
        -----
        
        You'll need python 3.5+ and a redis server running. The usage of a virtual environment is recommended.
        
        Install from pypi:
        
        .. code:: bash
        
           $ pip install mapmatching
        
        Or install from source:
        
        .. code:: bash
        
           $ cd mapmatching
           $ python setup.py install
        
        Usage
        -----
        
        Download data from OpenStreetMaps:
        
        .. code:: bash
        
           $ mapmatching download -h
           $ mapmatching download -96.99107360839844 19.441181182861328 -96.846435546875 19.59616470336914 -o streets.json
        
        And load it to redis, by default it loads it to database 1 instead of redis default of 0.
        
        .. code:: bash
        
           $ mapmatching load streets.json
        
        The two previous commands can be chained:
        
        .. code:: bash
        
           $ mapmatching download -96.99107360839844 19.441181182861328 -96.846435546875 19.59616470336914 | mapmatching load
        
        Then run the match task with a geojson file with a single gps track. A sample track that works with the sample bounding box is contained in the ``data/`` directory of the repository.
        
        .. code:: bash
        
           $ mapmatching match -h
           $ mapmatching match data/route.geojson -o output.json
        
        Optionally visualize it in the browser:
        
        .. code:: bash
        
           $ pip install geojsonio
           $ geojsonio output.json
        
Keywords: mapmatching algorithm gps
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Education
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Topic :: Scientific/Engineering :: GIS
Classifier: Topic :: Scientific/Engineering :: Mathematics
Classifier: Topic :: Software Development :: Libraries :: Python Modules
