Skip to main content

a Map-Matching-based Python Toolbox for Vehicle Trajectory Reconstruction

Project description



PyTrack: a Map-Matching-based Python Toolbox for Vehicle Trajectory Reconstruction

All platforms PyPI Latest Release Conda Version License docs PyPI downloads Anaconda downloads

What is it?

PyTrack is a Python package that integrate the recorded GPS coordinates with data provided by the open-source OpenStreetMap (OSM). PyTrack can serve the intelligent transport research, e.g. to reconstruct the video of a vehicle’s route by exploiting available data and without equipping it with camera sensors, to update the urban road network, and so on.

If you use PyTrack in your work, please cite the journal article.

Citation info: M. Tortora, E. Cordelli and P. Soda, "PyTrack: a Map-Matching-based Python Toolbox for Vehicle Trajectory Reconstruction," in IEEE Access, vol. 10, pp. 112713-112720, 2022, doi: 10.1109/ACCESS.2022.3216565.

@ARTICLE{mtpytrack,  
      author={Tortora, Matteo and Cordelli, Ermanno and Soda, Paolo},
      journal={IEEE Access}, 
      title={PyTrack: A Map-Matching-Based Python Toolbox for Vehicle Trajectory Reconstruction}, 
      year={2022},
      volume={10},
      number={},
      pages={112713-112720},
      doi={10.1109/ACCESS.2022.3216565}}

Main Features

The following are the main features that PyTrack includes:

  • Generation of the street network graph using geospatial data from OpenStreetMap
  • Map-matching
  • Data cleaning
  • Video reconstruction of the GPS route
  • Visualisation and analysis capabilities

Getting Started

Installation

The source code is currently hosted on GitHub at: https://github.com/cosbidev/PyTrack. PyTrack can be installed using*:

# conda
conda install pytrack 
# or PyPI
pip install PyTrack-lib

*for Mac m1 users, it is recommended to use conda in order to be able to install all dependencies.

Documentation

Checkout the official documentation. Besides, here you can see some examples of the application of the library.

Examples

Map-Matching

To see the map-matching feature of PyTrack in action please go to map-matching documentation.

map-matching

Video reconstruction of the itinerary

video_track video_seg_track

Contributing to PyTrack

All contributions, bug reports, bug fixes, documentation improvements, enhancements, and ideas are welcome.

Author

Created by Matteo Tortora - feel free to contact me!

License

PyTrack is distributed under a BSD-3-Clause-Clear Licence.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

PyTrack-lib-2.0.7.tar.gz (23.8 kB view details)

Uploaded Source

Built Distribution

PyTrack_lib-2.0.7-py3-none-any.whl (28.9 kB view details)

Uploaded Python 3

File details

Details for the file PyTrack-lib-2.0.7.tar.gz.

File metadata

  • Download URL: PyTrack-lib-2.0.7.tar.gz
  • Upload date:
  • Size: 23.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.9.16

File hashes

Hashes for PyTrack-lib-2.0.7.tar.gz
Algorithm Hash digest
SHA256 fa4c720c6bbd9ac6582b7b178805840156b0669409cc3de90a8baae0f7346c00
MD5 32a8effa31ed61ba86a6bd3e7afd09a8
BLAKE2b-256 7adeba7257868f80ccc64aeddf7e853e017351c080f51d0a279ea865f5858529

See more details on using hashes here.

Provenance

File details

Details for the file PyTrack_lib-2.0.7-py3-none-any.whl.

File metadata

  • Download URL: PyTrack_lib-2.0.7-py3-none-any.whl
  • Upload date:
  • Size: 28.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.9.16

File hashes

Hashes for PyTrack_lib-2.0.7-py3-none-any.whl
Algorithm Hash digest
SHA256 965b4ce1bd0ae879121cb80a01d2395e6dd7fca0a4b87d5af0cfa9a3e69b3871
MD5 47dc24b3cf8e4c7427ce5e3f39169f6c
BLAKE2b-256 a75a0d2cd70e54a96efe289171557f66c24e4c5e6fcf9cc9e6b7c22df9a94422

See more details on using hashes here.

Provenance

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page