pytrack

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

Science Score: 67.0%

This score indicates how likely this project is to be science-related based on various indicators:

✓
CITATION.cff file
Found CITATION.cff file
✓
codemeta.json file
Found codemeta.json file
✓
.zenodo.json file
Found .zenodo.json file
✓
DOI references
Found 2 DOI reference(s) in README
✓
Academic publication links
Links to: ieee.org
○
Committers with academic emails
○
Institutional organization owner
○
JOSS paper metadata
○
Scientific vocabulary similarity
Low similarity (16.5%) to scientific vocabulary

Keywords

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: 4 months ago · JSON representation ·

Repository

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

Basic Info

Host: GitHub
Owner: cosbidev
License: bsd-3-clause-clear
Language: Python
Default Branch: main
Homepage: https://pytrack-lib.readthedocs.io/en/latest/#
Size: 92.3 MB

Statistics

Stars: 73
Watchers: 3
Forks: 13
Open Issues: 5
Releases: 11

Topics

Created over 3 years ago · Last pushed 11 months ago

Metadata Files

Readme License Citation

README.md

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

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," 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. 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.

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 - feel free to contact me!

License

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

Owner

Name: CoSBi.dev
Login: cosbidev
Kind: organization
Location: Università Campus Bio-Medico di Roma

Website: https://www.unicampus.it/ricerca/unita-di-ricerca/sistemi-di-elaborazione-e-bioinformatica
Repositories: 3
Profile: https://github.com/cosbidev

Citation (CITATION.cff)

cff-version: 1.2.0
message: "If you use PyTrack in your work, please cite the journal article."
preferred-citation:
  type: article
  authors:
  - family-names: "Tortora"
    given-names: "Matteo"
    orcid: "https://orcid.org/0000-0002-3932-7380"
  - family-names: "Cordelli"
    given-names: "Ermanno"
  - family-names: "Soda"
    given-names: "Paolo"
  journal: "IEEE Access"
  title: "PyTrack: a Map-Matching-based Python Toolbox for Vehicle Trajectory Reconstruction"
  year: 2022
  volume: 10
  start: 112713 # First page number
  end: 112720 # Last page number
  doi: "10.1109/ACCESS.2022.3216565"

GitHub Events

Total

Watch event: 11
Push event: 22
Fork event: 3

Last Year

Watch event: 11
Push event: 22
Fork event: 3

Committers

Last synced: 7 months ago

All Time

Total Commits: 326
Total Committers: 1
Avg Commits per committer: 326.0
Development Distribution Score (DDS): 0.0

Past Year

Commits: 23
Committers: 1
Avg Commits per committer: 23.0
Development Distribution Score (DDS): 0.0

Top Committers

Name	Email	Commits
Matteo Tortora	m**a@g**m	326

Issues and Pull Requests

Last synced: 5 months ago

All Time

Total issues: 8
Total pull requests: 9
Average time to close issues: 19 days
Average time to close pull requests: 1 minute
Total issue authors: 7
Total pull request authors: 3
Average comments per issue: 2.63
Average comments per pull request: 0.0
Merged pull requests: 7
Bot issues: 0
Bot pull requests: 0

Past Year

Issues: 0
Pull requests: 1
Average time to close issues: N/A
Average time to close pull requests: N/A
Issue authors: 0
Pull request authors: 1
Average comments per issue: 0
Average comments per pull request: 0.0
Merged pull requests: 0
Bot issues: 0
Bot pull requests: 0

View more stats

Top Authors

Issue Authors

RaniRaven (2)
pabst2009 (1)
raul-parada (1)
xuzhi0413 (1)
bernardotepedino (1)

Pull Request Authors

mtortora-ai (7)
gockar (1)
alexC-nonsense4k (1)

Top Labels

Issue Labels

bug (4)

Pull Request Labels

Packages

Total packages: 2
Total downloads:
- pypi 89 last-month

Total dependent packages: 0
(may contain duplicates)
Total dependent repositories: 1
(may contain duplicates)
Total versions: 19
Total maintainers: 1

pypi.org: pytrack-lib

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

Homepage: https://github.com/cosbidev/PyTrack
Documentation: https://pytrack-lib.readthedocs.io/
License: BSD-3-Clause-Clear
Latest release: 2.0.8
published over 2 years ago

Versions: 13
Dependent Packages: 0
Dependent Repositories: 1
Downloads: 89 Last month

Rankings

Stargazers count: 9.5%

Dependent packages count: 10.1%

Forks count: 14.2%

Average: 14.8%

Downloads: 18.6%

Dependent repos count: 21.6%

Maintainers (1)

mtortora

Last synced: 5 months ago

conda-forge.org: pytrack

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 develop virtual simulation environments for the first training phase in self-driving vehicle applications, 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.

Homepage: https://github.com/cosbidev/PyTrack
License: BSD-3-Clause
Latest release: 2.0.6
published about 3 years ago

Versions: 6
Dependent Packages: 0
Dependent Repositories: 0

Rankings

Dependent repos count: 34.0%

Average: 48.0%

Stargazers count: 49.6%

Dependent packages count: 51.2%

Forks count: 57.4%

Last synced: 4 months ago

Dependencies

docs/requirements.txt pypi

docutils ==0.16
ipython ==8.4.0
nbsphinx ==0.8.9
pygments-style-monokailight ==0.4
sphinx ==5.0.1
sphinx-rtd-theme ==1.0.0
sphinx_autodoc_typehints ==1.18.3

.github/workflows/python-publish-pypi.yml actions

actions/checkout v3 composite
actions/setup-python v3 composite
pypa/gh-action-pypi-publish master composite