https://github.com/cosbidev/pytrack
a Map-Matching-based Python Toolbox for Vehicle Trajectory Reconstruction
https://github.com/cosbidev/pytrack
computer-vision data-cleaning gps-tracker graph intelligent-transportation-systems map-match map-matching maps network-graph networkx openstreetmap python snapping street-view topology tracking trajectory-analysis visualization
Last synced: 23 days ago
JSON representation
a Map-Matching-based Python Toolbox for Vehicle Trajectory Reconstruction
- Host: GitHub
- URL: https://github.com/cosbidev/pytrack
- Owner: cosbidev
- License: bsd-3-clause-clear
- Created: 2022-05-29T21:23:54.000Z (almost 3 years ago)
- Default Branch: main
- Last Pushed: 2025-01-16T23:28:09.000Z (3 months ago)
- Last Synced: 2025-04-05T21:08:18.306Z (23 days ago)
- Topics: computer-vision, data-cleaning, gps-tracker, graph, intelligent-transportation-systems, map-match, map-matching, maps, network-graph, networkx, openstreetmap, python, snapping, street-view, topology, tracking, trajectory-analysis, visualization
- Language: Python
- Homepage: https://pytrack-lib.readthedocs.io/en/latest/#
- Size: 92.3 MB
- Stars: 67
- Watchers: 3
- Forks: 11
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Citation: CITATION.cff
Awesome Lists containing this project
README
-----------------
# PyTrack: a Map-Matching-based Python Toolbox for Vehicle Trajectory Reconstruction
[](https://dev.azure.com/conda-forge/feedstock-builds/_build/latest?definitionId=16366&branchName=main)
[](https://pypi.org/project/PyTrack-lib/)
[](https://anaconda.org/conda-forge/pytrack)
[](LICENSE)
[](https://pytrack-lib.readthedocs.io/en/latest)
[](https://pypi.org/project/PyTrack-lib/)
[](https://anaconda.org/conda-forge/pytrack)
## What is it?
**PyTrack** is a Python package that integrates 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](https://ieeexplore.ieee.org/document/9927417)," in IEEE Access, vol. 10, pp. 112713-112720, 2022, doi: 10.1109/ACCESS.2022.3216565.
```latex
@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*:
```sh
# conda
conda install pytrack
```
```sh
# 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](https://pytrack-lib.readthedocs.io/en/latest).
Besides, [here](https://github.com/cosbidev/PyTrack/tree/main/examples) 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](https://pytrack-lib.readthedocs.io/en/latest/notebooks/map-matching.html).
### Video reconstruction of the itinerary
## Contributing to PyTrack
All contributions, bug reports, bug fixes, documentation improvements, enhancements, and ideas are welcome.
## Author
Created by [Matteo Tortora](https://matteotortora.github.io) - feel free to contact me!
## License
PyTrack is distributed under a [BSD-3-Clause-Clear Licence](https://github.com/cosbidev/PyTrack/blob/main/LICENSE).