{"id":32178274,"url":"https://github.com/dfki-ric/pytransform3d","last_synced_at":"2025-10-21T20:52:46.146Z","repository":{"id":37867161,"uuid":"91809394","full_name":"dfki-ric/pytransform3d","owner":"dfki-ric","description":"3D transformations for Python.","archived":false,"fork":false,"pushed_at":"2025-10-16T13:36:41.000Z","size":198019,"stargazers_count":688,"open_issues_count":5,"forks_count":72,"subscribers_count":9,"default_branch":"main","last_synced_at":"2025-10-19T20:53:21.294Z","etag":null,"topics":["mathematics","matplotlib","python","transformations","visualization"],"latest_commit_sha":null,"homepage":"https://dfki-ric.github.io/pytransform3d/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/dfki-ric.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":"CITATION.cff","codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2017-05-19T13:35:08.000Z","updated_at":"2025-10-16T03:56:16.000Z","dependencies_parsed_at":"2024-06-18T15:22:34.991Z","dependency_job_id":"6469e3ef-7621-468e-8277-7b1069756780","html_url":"https://github.com/dfki-ric/pytransform3d","commit_stats":{"total_commits":1534,"total_committers":18,"mean_commits":85.22222222222223,"dds":"0.40156453715775753","last_synced_commit":"f96bc42903a20e2ec0a1b430eb3d30b3e56dd0cc"},"previous_names":["rock-learning/pytransform3d"],"tags_count":46,"template":false,"template_full_name":null,"purl":"pkg:github/dfki-ric/pytransform3d","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dfki-ric%2Fpytransform3d","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dfki-ric%2Fpytransform3d/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dfki-ric%2Fpytransform3d/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dfki-ric%2Fpytransform3d/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dfki-ric","download_url":"https://codeload.github.com/dfki-ric/pytransform3d/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dfki-ric%2Fpytransform3d/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279932405,"owners_count":26246548,"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","status":"online","status_checked_at":"2025-10-19T02:00:07.647Z","response_time":64,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["mathematics","matplotlib","python","transformations","visualization"],"created_at":"2025-10-21T20:52:44.800Z","updated_at":"2025-10-21T20:52:46.138Z","avatar_url":"https://github.com/dfki-ric.png","language":"Python","readme":"\u003cimg src=\"https://raw.githubusercontent.com/dfki-ric/pytransform3d/main/doc/source/_static/logo.png\" /\u003e\n\n[![codecov](https://codecov.io/gh/dfki-ric/pytransform3d/branch/main/graph/badge.svg?token=jB10RM3Ujj)](https://codecov.io/gh/dfki-ric/pytransform3d)\n[![Paper DOI](http://joss.theoj.org/papers/10.21105/joss.01159/status.svg)](https://doi.org/10.21105/joss.01159)\n[![Release DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.2553450.svg)](https://doi.org/10.5281/zenodo.2553450)\n\n# pytransform3d\n\nA Python library for transformations in three dimensions.\n\npytransform3d offers...\n\n* operations like concatenation and inversion for most common representations\n  of rotation (orientation) and translation (position)\n* conversions between those representations\n* clear documentation of transformation conventions\n* tight coupling with matplotlib to quickly visualize (or animate)\n  transformations\n* the TransformManager which manages complex chains of transformations\n  (with export to graph visualization as PNG, additionally requires pydot)\n* the TransformEditor which allows to modify transformations graphically\n  (additionally requires PyQt4/5)\n* the UrdfTransformManager which is able to load transformations from\n  [URDF](https://wiki.ros.org/urdf) files (additionally requires lxml)\n* a matplotlib-like interface to Open3D's visualizer to display and animate\n  geometries and transformations (additionally requires Open3D)\n\npytransform3d is used in various domains, for example:\n\n* specifying motions of a robot\n* learning robot movements from human demonstration\n* sensor fusion for human pose estimation\n* collision detection for robots\n\nThe API documentation can be found\n[here](https://dfki-ric.github.io/pytransform3d/).\n\nI gave a talk at EuroSciPy 2023 about pytransform3d. Slides are available\n[here](https://github.com/AlexanderFabisch/pytransform3d_euroscipy2023/).\n\nIf you need similar features in JAX (on GPU, vectorized, differentiable),\nhave a look at the experimental library\n[jaxtransform3d](https://github.com/AlexanderFabisch/jaxtransform3d/).\n\n## Installation\n\nUse pip to install the package from PyPI:\n\n```bash\npip install 'pytransform3d[all]'\n```\n\nor conda:\n\n```bash\nconda install -c conda-forge pytransform3d\n```\n\nTake a look at the\n[installation instructions](https://dfki-ric.github.io/pytransform3d/install.html)\nin the documentation for more details.\n\n## Gallery\n\nThe following plots and visualizations have been generated with pytransform3d.\nThe code for most examples can be found in\n[the documentation](https://dfki-ric.github.io/pytransform3d/_auto_examples/index.html).\n\nLeft: [Nao robot](https://www.softbankrobotics.com/emea/en/nao) with URDF\nfrom [Bullet3](https://github.com/bulletphysics/bullet3).\nRight: [Kuka iiwa](https://www.kuka.com/en-de/products/robot-systems/industrial-robots/lbr-iiwa).\nThe animation is based on pytransform3d's visualization interface to\n[Open3D](http://www.open3d.org/).\n\n\u003cimg src=\"https://raw.githubusercontent.com/dfki-ric/pytransform3d/main/doc/source/_static/animation_nao.gif\" height=200px/\u003e\u003cimg src=\"https://raw.githubusercontent.com/dfki-ric/pytransform3d/main/doc/source/_static/animation_kuka.gif\" height=200px/\u003e\u003cimg src=\"https://raw.githubusercontent.com/dfki-ric/pytransform3d/main/doc/source/_static/animation_dynamics.gif\" height=200px/\u003e\n\nVisualizations based on [Open3D](http://www.open3d.org/).\n\n\u003cimg src=\"https://raw.githubusercontent.com/dfki-ric/pytransform3d/main/doc/source/_static/photogrammetry.png\" height=200px/\u003e\u003cimg src=\"https://raw.githubusercontent.com/dfki-ric/pytransform3d/main/doc/source/_static/kuka_trajectories.png\" height=200px/\u003e\n\nVarious plots based on Matplotlib.\n\n\u003cimg src=\"https://raw.githubusercontent.com/dfki-ric/pytransform3d/main/doc/source/_static/example_plot_box.png\" width=200px/\u003e\u003cimg src=\"https://raw.githubusercontent.com/dfki-ric/pytransform3d/main/doc/source/_static/cylinders.png\" width=200px/\u003e\u003cimg src=\"https://raw.githubusercontent.com/dfki-ric/pytransform3d/main/paper/plot_urdf.png\" width=200px/\u003e\u003cimg src=\"https://raw.githubusercontent.com/dfki-ric/pytransform3d/main/doc/source/_static/transform_manager_mesh.png\" width=200px/\u003e\u003cimg src=\"https://raw.githubusercontent.com/dfki-ric/pytransform3d/main/doc/source/_static/accelerate_cylinder.png\" width=200px/\u003e\u003cimg src=\"https://raw.githubusercontent.com/dfki-ric/pytransform3d/main/doc/source/_static/example_plot_screw.png\" width=200px/\u003e\u003cimg src=\"https://raw.githubusercontent.com/dfki-ric/pytransform3d/main/doc/source/_static/rotations_axis_angle.png\" width=200px/\u003e\u003cimg src=\"https://raw.githubusercontent.com/dfki-ric/pytransform3d/main/doc/source/_static/concatenate_uncertain_transforms.png\" width=200px/\u003e\n\nTransformation editor based on Qt.\n\n\u003cimg src=\"https://raw.githubusercontent.com/dfki-ric/pytransform3d/main/paper/app_transformation_editor.png\" height=300px/\u003e\n\n## Example\n\nThis is just one simple example. You can find more examples in the subfolder\n`examples/`.\n\n```python\nimport numpy as np\nimport matplotlib.pyplot as plt\nfrom pytransform3d import rotations as pr\nfrom pytransform3d import transformations as pt\nfrom pytransform3d.transform_manager import TransformManager\n\n\nrng = np.random.default_rng(0)\n\nee2robot = pt.transform_from_pq(\n    np.hstack((np.array([0.4, -0.3, 0.5]),\n               pr.random_quaternion(rng))))\ncam2robot = pt.transform_from_pq(\n    np.hstack((np.array([0.0, 0.0, 0.8]), pr.q_id)))\nobject2cam = pt.transform_from(\n    pr.active_matrix_from_intrinsic_euler_xyz(np.array([0.0, 0.0, -0.5])),\n    np.array([0.5, 0.1, 0.1]))\n\ntm = TransformManager()\ntm.add_transform(\"end-effector\", \"robot\", ee2robot)\ntm.add_transform(\"camera\", \"robot\", cam2robot)\ntm.add_transform(\"object\", \"camera\", object2cam)\n\nee2object = tm.get_transform(\"end-effector\", \"object\")\n\nax = tm.plot_frames_in(\"robot\", s=0.1)\nax.set_xlim((-0.25, 0.75))\nax.set_ylim((-0.5, 0.5))\nax.set_zlim((0.0, 1.0))\nplt.show()\n```\n\n![output](https://dfki-ric.github.io/pytransform3d/_images/sphx_glr_plot_transform_manager_001.png)\n\n## Documentation\n\nThe API documentation can be found\n[here](https://dfki-ric.github.io/pytransform3d/).\n\nThe documentation can be found in the directory `doc`.\nTo build the documentation, run e.g. (on linux):\n\n```bash\ncd doc\nmake html\n```\n\nThe HTML documentation is now located at `doc/build/html/index.html`.\nExecute the following command in the main folder of the repository\nto install the dependencies:\n\n```bash\npip install -e '.[doc]'\n```\n\n## Tests\n\nYou can use pytest to run the tests of this project in the root directory:\n\n```bash\npytest\n```\n\nA coverage report will be located at `htmlcov/index.html`.\nNote that you have to install `pytest` to run the tests and `pytest-cov` to\nobtain the code coverage report.\n\n## Contributing\n\nIf you wish to report bugs, please use the\n[issue tracker](https://github.com/dfki-ric/pytransform3d/issues) at\nGithub. If you would like to contribute to pytransform3d, just open an issue\nor a [pull request](https://github.com/dfki-ric/pytransform3d/pulls).\nThe target branch for pull requests is the develop branch.\nThe development branch will be merged to main for new releases.\nIf you have questions about the software, you should ask them in the\n[discussion section](https://github.com/dfki-ric/pytransform3d/discussions).\n\nThe recommended workflow to add a new feature, add documentation, or fix a bug\nis the following:\n\n* Push your changes to a branch (e.g. `feature/x`, `doc/y`, or `fix/z`) of your\n  fork of the pytransform3d repository.\n* Open a pull request to the latest development branch. There is usually an\n  open merge request from the latest development branch to the main branch.\n* When the latest development branch is merged to the main branch, a new\n  release will be made.\n\nNote that there is a\n[checklist](https://github.com/dfki-ric/pytransform3d/wiki#checklist-for-new-features)\nfor new features.\n\nIt is forbidden to directly push to the main branch. Each new version\nhas its own development branch from which a pull request will be opened to the\nmain branch. Only the maintainer of the software is allowed to merge a\ndevelopment branch to the main branch.\n\n## License\n\nThe library is distributed under the\n[3-Clause BSD license](https://github.com/dfki-ric/pytransform3d/blob/main/LICENSE).\n\n## Citation\n\nIf you use pytransform3d for a scientific publication, I would appreciate\ncitation of the following paper:\n\nFabisch, A. (2019). pytransform3d: 3D Transformations for Python.\nJournal of Open Source Software, 4(33), 1159,\n[![Paper DOI](http://joss.theoj.org/papers/10.21105/joss.01159/status.svg)](https://doi.org/10.21105/joss.01159)\n\nBibtex entry:\n\n```bibtex\n@article{Fabisch2019,\n  doi = {10.21105/joss.01159},\n  url = {https://doi.org/10.21105/joss.01159},\n  year = {2019},\n  publisher = {The Open Journal},\n  volume = {4},\n  number = {33},\n  pages = {1159},\n  author = {Alexander Fabisch},\n  title = {pytransform3d: 3D Transformations for Python},\n  journal = {Journal of Open Source Software}\n}\n```\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdfki-ric%2Fpytransform3d","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdfki-ric%2Fpytransform3d","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdfki-ric%2Fpytransform3d/lists"}