{"id":24678144,"url":"https://github.com/cosbidev/pytrack","last_synced_at":"2025-10-13T01:44:17.317Z","repository":{"id":38450043,"uuid":"497712838","full_name":"cosbidev/PyTrack","owner":"cosbidev","description":"a Map-Matching-based Python Toolbox for Vehicle Trajectory Reconstruction","archived":false,"fork":false,"pushed_at":"2025-01-16T23:28:09.000Z","size":96743,"stargazers_count":67,"open_issues_count":4,"forks_count":11,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-04-05T21:08:18.306Z","etag":null,"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"],"latest_commit_sha":null,"homepage":"https://pytrack-lib.readthedocs.io/en/latest/#","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause-clear","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/cosbidev.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":"CITATION.cff","codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2022-05-29T21:23:54.000Z","updated_at":"2025-01-20T11:47:22.000Z","dependencies_parsed_at":"2023-01-22T02:45:13.433Z","dependency_job_id":"bfbbf2f1-0708-4565-ad71-db7e8f7f3083","html_url":"https://github.com/cosbidev/PyTrack","commit_stats":{"total_commits":301,"total_committers":1,"mean_commits":301.0,"dds":0.0,"last_synced_commit":"33355dce4cdd0e9374bbcc3518633da5ec8d2332"},"previous_names":[],"tags_count":11,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cosbidev%2FPyTrack","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cosbidev%2FPyTrack/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cosbidev%2FPyTrack/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cosbidev%2FPyTrack/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cosbidev","download_url":"https://codeload.github.com/cosbidev/PyTrack/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247399877,"owners_count":20932876,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"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"],"created_at":"2025-01-26T13:14:57.241Z","updated_at":"2025-10-13T01:44:12.284Z","avatar_url":"https://github.com/cosbidev.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003ch1 align=\"center\"\u003e\n\u003cimg src=\"https://raw.githubusercontent.com/cosbidev/PyTrack/main/logo/pytracklogo.svg\" width=\"300\"\u003e\n\u003c/h1\u003e\u003cbr\u003e\n\n-----------------\n\n# PyTrack: a Map-Matching-based Python Toolbox for Vehicle Trajectory Reconstruction\n[![All platforms](https://dev.azure.com/conda-forge/feedstock-builds/_apis/build/status/pytrack-feedstock?branchName=main)](https://dev.azure.com/conda-forge/feedstock-builds/_build/latest?definitionId=16366\u0026branchName=main)\n[![PyPI Latest Release](https://img.shields.io/pypi/v/PyTrack-lib)](https://pypi.org/project/PyTrack-lib/)\n[![Conda Version](https://img.shields.io/conda/vn/conda-forge/pytrack.svg)](https://anaconda.org/conda-forge/pytrack)\n[![License](https://img.shields.io/pypi/l/pandas.svg)](LICENSE)\n[![docs](https://img.shields.io/readthedocs/pytrack-lib)](https://pytrack-lib.readthedocs.io/en/latest)\n[![PyPI downloads](https://img.shields.io/pypi/dm/pytrack-lib?label=PyPI%20downloads)](https://pypi.org/project/PyTrack-lib/)\n[![Anaconda downloads](https://img.shields.io/conda/dn/conda-forge/pytrack?label=conda%20downloads)](https://anaconda.org/conda-forge/pytrack)\n\n## What is it?\n**PyTrack** is a Python package that integrates the recorded GPS coordinates with data provided by the open-source OpenStreetMap (OSM). \nPyTrack 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.\n\nIf you use PyTrack in your work, please cite the journal article.\n\n**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.\n\n```latex\n@ARTICLE{mtpytrack,  \n      author={Tortora, Matteo and Cordelli, Ermanno and Soda, Paolo},\n      journal={IEEE Access}, \n      title={PyTrack: A Map-Matching-Based Python Toolbox for Vehicle Trajectory Reconstruction}, \n      year={2022},\n      volume={10},\n      number={},\n      pages={112713-112720},\n      doi={10.1109/ACCESS.2022.3216565}}\n```\n\n## Main Features\nThe following are the main features that PyTrack includes:\n- Generation of the street network graph using geospatial data from OpenStreetMap\n- Map-matching\n- Data cleaning\n- Video reconstruction of the GPS route\n- Visualisation and analysis capabilities\n\n## Getting Started\n### Installation\nThe source code is currently hosted on GitHub at:\nhttps://github.com/cosbidev/PyTrack.\nPyTrack can be installed using*:\n```sh\n# conda\nconda install pytrack \n```\n\n```sh\n# or PyPI\npip install PyTrack-lib\n```\n**for Mac m1 users, it is recommended to use conda in order to be able to install all dependencies.*\n## Documentation\nCheckout the official [documentation](https://pytrack-lib.readthedocs.io/en/latest).\nBesides, [here](https://github.com/cosbidev/PyTrack/tree/main/examples) you can see some examples of the application of the library.\n\n## Examples\n### Map-Matching\nTo 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).\n\n\u003cp align=\"center\"\u003e\n    \u003ca href=\"https://pytrack-lib.readthedocs.io/en/latest/notebooks/create_video_path.html\"\u003e \u003cimg width=\"1000\" src=\"https://raw.githubusercontent.com/cosbidev/PyTrack/main/logo/example.png\" alt=\"map-matching\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n### Video reconstruction of the itinerary\n\u003cp align=\"center\"\u003e\n    \u003ca href=\"https://pytrack-lib.readthedocs.io/en/latest/notebooks/create_video_path.html\"\u003e \u003cimg width=\"400\" src=\"https://raw.githubusercontent.com/cosbidev/PyTrack/main/logo/video.gif\" alt=\"video_track\"\u003e\u003c/a\u003e\n    \u003ca href=\"https://pytrack-lib.readthedocs.io/en/latest/notebooks/segmentation_video_path.html\"\u003e \u003cimg width=\"400\" src=\"https://raw.githubusercontent.com/cosbidev/PyTrack/main/logo/video_seg.gif\" alt=\"video_seg_track\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n\n\n## Contributing to PyTrack\nAll contributions, bug reports, bug fixes, documentation improvements, enhancements, and ideas are welcome.\n\n## Author\nCreated by [Matteo Tortora](https://matteotortora.github.io) - feel free to contact me!\n\n\u003c!---\n## Citation\n\nIf you use PyTrack in your work, please cite the [journal paper]().\n```bibtex\n\n```\n--\u003e\n\n## License\nPyTrack is distributed under a [BSD-3-Clause-Clear Licence](https://github.com/cosbidev/PyTrack/blob/main/LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcosbidev%2Fpytrack","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcosbidev%2Fpytrack","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcosbidev%2Fpytrack/lists"}