<div align="center">
<h1>Trajectopy - Trajectory Evaluation in Python</h1>
<a href="https://github.com/gereon-t/trajectopy/releases"><img src="https://img.shields.io/github/v/release/gereon-t/trajectopy?label=version" /></a>
<a href="https://www.python.org/downloads/"><img src="https://img.shields.io/badge/python-3.9+-blue.svg" /></a>
<a href="https://github.com/gereon-t/trajectopy/blob/main/LICENSE"><img src="https://img.shields.io/github/license/gereon-t/trajectopy" /></a>
<a href="https://github.com/psf/black"><img alt="Code style: black" src="https://img.shields.io/badge/code%20style-black-000000.svg"></a>
<br />
<a href="https://github.com/gereon-t/trajectopy"><img src="https://img.shields.io/badge/Windows-0078D6?st&logo=windows&logoColor=white" /></a>
<a href="https://github.com/gereon-t/trajectopy"><img src="https://img.shields.io/badge/Linux-FCC624?logo=linux&logoColor=black" /></a>
<a href="https://github.com/gereon-t/trajectopy"><img src="https://img.shields.io/badge/mac%20os-000000?&logo=apple&logoColor=white" /></a>
<h4>Trajectopy is a Python package with an optional graphical user interface for empirical trajectory evaluation. </h4>
<p align="center">
<img style="border-radius: 10px;" src="https://raw.githubusercontent.com/gereon-t/trajectopy/main/.images/trajectopy_gif_low_quality.gif">
</p>
Using [Mapbox](https://www.mapbox.com/), you can visualize your trajectories on a map:
<p align="center">
<img style="border-radius: 10px;" src=".images/plot.png">
</p>
</div>
## Installation
Full version (with GUI):
```bash
pip install "trajectopy[gui]"
```
Python package only:
```bash
pip install trajectopy
```
## Documentation
<a href="https://gereon-t.github.io/trajectopy/" target="_blank">https://gereon-t.github.io/trajectopy/</a>
## Key Features
Trajectopy offers a range of features, including:
- __Interactive GUI__: A user-friendly interface that enables seamless interaction with your trajectory data, making it easy to visualize, align, and compare trajectories.
- __Alignment__: An advanced trajectory alignment algorithm that can be tailored to the specific application and supports a similarity transformation, a leverarm and a time shift estimation.
- __Comparison__: Absolute and relative trajectory comparison metrics (__ATE and RPE__) that can be computed using various pose-matching methods.
- __Data Import/Export__: Support for importing and exporting data, ensuring compatibility with your existing workflows.
- __Customizable Visualization__: Powered by [Plotly](https://plotly.com/) or [Matplotlib](https://matplotlib.org/), trajectopy offers a range of interactive plots that can be customized to your needs. ([Demo](https://htmlpreview.github.io/?https://github.com/gereon-t/trajectopy/blob/main/example_data/report.html))
## Web Application (Docker)
A simple web application is available at [gereon-t/trajectopy-web](https://github.com/gereon-t/trajectopy-web) that allows you to use the core functionality of Trajectopy using Docker.
## Citation
If you use this library for any academic work, please cite our original [paper](https://www.degruyter.com/document/doi/10.1515/jag-2024-0040/html).
```bibtex
@article{Tombrink2024,
url = {https://doi.org/10.1515/jag-2024-0040},
title = {Spatio-temporal trajectory alignment for trajectory evaluation},
author = {Gereon Tombrink and Ansgar Dreier and Lasse Klingbeil and Heiner Kuhlmann},
journal = {Journal of Applied Geodesy},
doi = {doi:10.1515/jag-2024-0040},
year = {2024},
codeurl = {https://github.com/gereon-t/trajectopy},
}
```
Raw data
{
"_id": null,
"home_page": null,
"name": "trajectopy",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": "Gereon Tombrink <tombrink@igg.uni-bonn.de>",
"keywords": "alignment, epsg, evaluation, leverarm, robotics, similarity, trajectory",
"author": null,
"author_email": "Gereon Tombrink <tombrink@igg.uni-bonn.de>",
"download_url": "https://files.pythonhosted.org/packages/23/3f/7dc82d79e1172e7e3e5da15b2b8da5c5bfe8e8b5fc1fa9710dd87e0c844e/trajectopy-3.1.5.tar.gz",
"platform": null,
"description": "<div align=\"center\">\n <h1>Trajectopy - Trajectory Evaluation in Python</h1>\n <a href=\"https://github.com/gereon-t/trajectopy/releases\"><img src=\"https://img.shields.io/github/v/release/gereon-t/trajectopy?label=version\" /></a>\n <a href=\"https://www.python.org/downloads/\"><img src=\"https://img.shields.io/badge/python-3.9+-blue.svg\" /></a>\n <a href=\"https://github.com/gereon-t/trajectopy/blob/main/LICENSE\"><img src=\"https://img.shields.io/github/license/gereon-t/trajectopy\" /></a>\n <a href=\"https://github.com/psf/black\"><img alt=\"Code style: black\" src=\"https://img.shields.io/badge/code%20style-black-000000.svg\"></a>\n <br />\n <a href=\"https://github.com/gereon-t/trajectopy\"><img src=\"https://img.shields.io/badge/Windows-0078D6?st&logo=windows&logoColor=white\" /></a>\n <a href=\"https://github.com/gereon-t/trajectopy\"><img src=\"https://img.shields.io/badge/Linux-FCC624?logo=linux&logoColor=black\" /></a>\n <a href=\"https://github.com/gereon-t/trajectopy\"><img src=\"https://img.shields.io/badge/mac%20os-000000?&logo=apple&logoColor=white\" /></a>\n\n<h4>Trajectopy is a Python package with an optional graphical user interface for empirical trajectory evaluation. </h4>\n\n<p align=\"center\">\n <img style=\"border-radius: 10px;\" src=\"https://raw.githubusercontent.com/gereon-t/trajectopy/main/.images/trajectopy_gif_low_quality.gif\">\n</p>\n\nUsing [Mapbox](https://www.mapbox.com/), you can visualize your trajectories on a map:\n\n<p align=\"center\">\n <img style=\"border-radius: 10px;\" src=\".images/plot.png\">\n</p>\n\n</div>\n\n## Installation\n\nFull version (with GUI):\n\n```bash\npip install \"trajectopy[gui]\"\n```\n\nPython package only:\n\n```bash\npip install trajectopy\n```\n\n## Documentation\n\n<a href=\"https://gereon-t.github.io/trajectopy/\" target=\"_blank\">https://gereon-t.github.io/trajectopy/</a>\n\n## Key Features\n\nTrajectopy offers a range of features, including:\n\n- __Interactive GUI__: A user-friendly interface that enables seamless interaction with your trajectory data, making it easy to visualize, align, and compare trajectories.\n- __Alignment__: An advanced trajectory alignment algorithm that can be tailored to the specific application and supports a similarity transformation, a leverarm and a time shift estimation.\n- __Comparison__: Absolute and relative trajectory comparison metrics (__ATE and RPE__) that can be computed using various pose-matching methods.\n- __Data Import/Export__: Support for importing and exporting data, ensuring compatibility with your existing workflows.\n- __Customizable Visualization__: Powered by [Plotly](https://plotly.com/) or [Matplotlib](https://matplotlib.org/), trajectopy offers a range of interactive plots that can be customized to your needs. ([Demo](https://htmlpreview.github.io/?https://github.com/gereon-t/trajectopy/blob/main/example_data/report.html))\n\n## Web Application (Docker)\n\nA simple web application is available at [gereon-t/trajectopy-web](https://github.com/gereon-t/trajectopy-web) that allows you to use the core functionality of Trajectopy using Docker.\n\n## Citation\n\nIf you use this library for any academic work, please cite our original [paper](https://www.degruyter.com/document/doi/10.1515/jag-2024-0040/html).\n\n```bibtex\n@article{Tombrink2024,\nurl = {https://doi.org/10.1515/jag-2024-0040},\ntitle = {Spatio-temporal trajectory alignment for trajectory evaluation},\nauthor = {Gereon Tombrink and Ansgar Dreier and Lasse Klingbeil and Heiner Kuhlmann},\njournal = {Journal of Applied Geodesy},\ndoi = {doi:10.1515/jag-2024-0040},\nyear = {2024},\ncodeurl = {https://github.com/gereon-t/trajectopy},\n}\n```",
"bugtrack_url": null,
"license": "GPLv3",
"summary": "Trajectory Evaluation in Python",
"version": "3.1.5",
"project_urls": {
"Bug Tracker": "https://github.com/gereon-t/trajectopy/issues",
"Documentation": "https://gereon-t.github.io/trajectopy/",
"Homepage": "https://gereon-t.github.io/trajectopy/",
"Repository": "https://github.com/gereon-t/trajectopy"
},
"split_keywords": [
"alignment",
" epsg",
" evaluation",
" leverarm",
" robotics",
" similarity",
" trajectory"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "54920ba71d5e27ea0598f5f51a4ee3e0d595c943644d0fef3dc0c31c02293796",
"md5": "1531356092a872c4826e3cd1ca0d3187",
"sha256": "633fa0a2fce22d2f8e9e16e81358f2f70dfa7a877c8e982669878fb30012eb11"
},
"downloads": -1,
"filename": "trajectopy-3.1.5-py3-none-any.whl",
"has_sig": false,
"md5_digest": "1531356092a872c4826e3cd1ca0d3187",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 415305,
"upload_time": "2025-08-07T14:50:13",
"upload_time_iso_8601": "2025-08-07T14:50:13.216336Z",
"url": "https://files.pythonhosted.org/packages/54/92/0ba71d5e27ea0598f5f51a4ee3e0d595c943644d0fef3dc0c31c02293796/trajectopy-3.1.5-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "233f7dc82d79e1172e7e3e5da15b2b8da5c5bfe8e8b5fc1fa9710dd87e0c844e",
"md5": "2dce959d3d312d1f7e9c75eda9376a0c",
"sha256": "a1e5b1542a6928229fc20ae7efd4e43374c9e4515708d171257643ad3b3bdc7c"
},
"downloads": -1,
"filename": "trajectopy-3.1.5.tar.gz",
"has_sig": false,
"md5_digest": "2dce959d3d312d1f7e9c75eda9376a0c",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 24603616,
"upload_time": "2025-08-07T14:50:19",
"upload_time_iso_8601": "2025-08-07T14:50:19.474749Z",
"url": "https://files.pythonhosted.org/packages/23/3f/7dc82d79e1172e7e3e5da15b2b8da5c5bfe8e8b5fc1fa9710dd87e0c844e/trajectopy-3.1.5.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-08-07 14:50:19",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "gereon-t",
"github_project": "trajectopy",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"requirements": [],
"lcname": "trajectopy"
}