TanGA
TanGA is a Python and C++ library for interactive technical visualization and geometric algebra (Clifford algebra) — two independent toolkits under one roof.
- Visualization — build animated, interactive 3D and 2D technical scenes in the browser, and export them as standalone HTML (animations included), glTF/GLB, PNG, or MP4. No knowledge of geometric algebra required.
- Geometric algebra / Clifford algebra — sparse multivectors over vector spaces of up to 31 dimensions with arbitrary signature, with explicit support for Euclidean, projective, and conformal spaces (E2/E3, P2/P3, N2/N3, PGA2/PGA3). Backed by a C++ template core with a zero-setup Python interface (pytanga).
→ Full documentation — C++ and Python API guides, architecture overview, notebooks, and developer workflows.
Key Features
Visualization
-
Interactive 3D & 2D scenes — Live WebSocket-driven Three.js visualizer in the browser. Rotate, pan, and zoom; add entities, apply per-entity styles, and work in 3D or 2D (
space_dim=2). Usable without geometric algebra. -
Animations — Frame-by-frame streaming at ~60 FPS and keyframe tweening (
animate_to) with a scene-awareTimelinesequencer. -
Standalone HTML export — Export self-contained, shareable HTML that includes animations, plus embeddable HTML for iframes, glTF/GLB for other 3D tools, PNG screenshots, and MP4 video.
-
Interactivity — Interactive controls (sliders, dropdowns, buttons), pointer-based object interaction (click, drag, scroll), and a simplified
ActPointAPI. Jupyter notebook support with inline iframes.
Geometric Algebra / Clifford Algebra
-
High-dimensional algebras — Sparse blade encoding for vector spaces up to 31 dimensions with arbitrary signature. Storage proportional to non-zero coefficients, not the full $2^D$ blade space.
-
Built-in spaces — Explicit, ready-to-use algebras for Euclidean (E2/E3), projective (P2/P3), and conformal (N2/N3, PGA2/PGA3) spaces.
-
C++ template header library — 100 % C++17 headers with
constexpr-friendly templates. Compile-time dimension and signature let the compiler inline blade arithmetic down to machine instructions. -
On‑demand Python compilation — pytanga generates, compiles, and caches pybind11 bindings on first use. Pre‑compiled wheels for common configurations ship with the package — zero-setup
pip installfor most users. -
GA formula solving — Convert product equations into linear systems, solve with Gaussian elimination (floating-point or modular), and reconstruct the unknown multivector.
-
Matrix and tensor pipelines — Blade-mask-aware matrices and labeled tensors with Einsum-style contractions, broadcasts, and slicing on multivector data.
-
Geometry analysis and creation —
analyze()extracts geometric meaning from a multivector;create()builds one from primitives. Works across E3, P3, N3, and PGA3 algebras. -
galgebra interoperability — Bidirectional conversion between galgebra (sympy‑based) and tanga (numeric) multivectors via
GalgebraBridge. Symbolic derivation → numeric computation → visualization, with support for non‑orthogonal bases.
Installation
pip install tanga-py
No C++ compiler or build tools required. pytanga ships with precompiled bindings for the five most common algebra configurations on Linux (x86_64) and Windows (win_amd64).
If you need a custom algebra not covered by the precompiled set, add the
compile extra (pip install "tanga-py[compile]") — see the
installation guide
for per-platform compiler setup instructions.
AI Tool Documentation Access
When pytanga is installed, the markdown documentation and example scripts are packaged inside the wheel. AI coding tools can expose them by calling:
import pytanga
pytanga.install_docs() # copies docs to .dep-docs/pytanga/
pytanga.install_examples() # copies examples to .dep-examples/pytanga/
pytanga.install_info() # installs docs and examples in one call
License
TanGA is released under the Apache License 2.0.
Every source file carries an SPDX-License-Identifier: Apache-2.0 comment.
1 maintainer
Release files for tanga-py 2.8.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Built distributions (wheels)
| File | Reset | |||
|---|---|---|---|---|
| tanga_py-2.8.0-py3-none-any.whl | Python 3 | none | any | Details |
| tanga_py-2.8.0-cp313-cp313-win_amd64.whl | CPython 3.13 | CPython 3.13 | Windows x86-64 | Details |
| tanga_py-2.8.0-cp313-cp313-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl | CPython 3.13 | CPython 3.13 | Linux glibc 2.27+ x86-64, Linux glibc 2.28+ x86-64 | Details |
| tanga_py-2.8.0-cp313-cp313-macosx_14_0_arm64.whl | CPython 3.13 | CPython 3.13 | macOS 14.0+ ARM64 | Details |
| tanga_py-2.8.0-cp312-cp312-win_amd64.whl | CPython 3.12 | CPython 3.12 | Windows x86-64 | Details |
| tanga_py-2.8.0-cp312-cp312-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl | CPython 3.12 | CPython 3.12 | Linux glibc 2.27+ x86-64, Linux glibc 2.28+ x86-64 | Details |
| tanga_py-2.8.0-cp312-cp312-macosx_14_0_arm64.whl | CPython 3.12 | CPython 3.12 | macOS 14.0+ ARM64 | Details |
Total release size: 22.0 MB
Release files / tanga_py-2.8.0-py3-none-any.whl
| Download URL | tanga_py-2.8.0-py3-none-any.whl |
|---|---|
| Size | 1.9 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
3addbe31e7b568fa9325ee8b5bfb85540c3838a6cb55a6b5ef28a5d5c4c15ea5
|
|
BLAKE2b-256 checksum How to use checksums |
74f486b544b6cb13b681239dda48638bb6eb4f832cfe3c3cfe53d5a1b67eb646
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Release files / tanga_py-2.8.0-cp313-cp313-win_amd64.whl
| Download URL | tanga_py-2.8.0-cp313-cp313-win_amd64.whl |
|---|---|
| Size | 3.3 MB |
| Tags | CPython 3.13 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
cfb1bc2654960d282e20a66f1d44ff3652ffe50cf98d9b47e73640303dea0071
|
|
BLAKE2b-256 checksum How to use checksums |
6b6292ae7f23b80737930b941fd354383b372f60da6749bf91a501cf826e7403
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Release files / tanga_py-2.8.0-cp313-cp313-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
| Download URL | tanga_py-2.8.0-cp313-cp313-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl |
|---|---|
| Size | 3.6 MB |
| Tags | CPython 3.13 Linux glibc 2.27+ x86-64 Linux glibc 2.28+ x86-64 |
|
SHA-256 checksum How to use checksums |
cd0391579c6d7e38d0c17cee0866904fca71847c3da1dd094ce6991d6b1e0981
|
|
BLAKE2b-256 checksum How to use checksums |
b219265b790ea0a55138dab2ae0639523530d16c2f640c49ec6c6086fc39d906
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Release files / tanga_py-2.8.0-cp313-cp313-macosx_14_0_arm64.whl
| Download URL | tanga_py-2.8.0-cp313-cp313-macosx_14_0_arm64.whl |
|---|---|
| Size | 3.2 MB |
| Tags | CPython 3.13 macOS 14.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
2026e35b8d76f7fa7ea299c786b1251b72a03f099c0e3631f22d7a50791aab0d
|
|
BLAKE2b-256 checksum How to use checksums |
c864cb4047ef75ad6e6f2438ded2f0d0a943b499df1846f9f79c0f1b4454ed0a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Release files / tanga_py-2.8.0-cp312-cp312-win_amd64.whl
| Download URL | tanga_py-2.8.0-cp312-cp312-win_amd64.whl |
|---|---|
| Size | 3.3 MB |
| Tags | CPython 3.12 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
d09d23c7fd29e2a90fe30d444d2e1273697e4077f471fe3bb842b675d76fcf57
|
|
BLAKE2b-256 checksum How to use checksums |
f62e935613f41037a1ee4b193d717af12bf57fd14a0d43de60c3360a53379781
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Release files / tanga_py-2.8.0-cp312-cp312-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
| Download URL | tanga_py-2.8.0-cp312-cp312-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl |
|---|---|
| Size | 3.6 MB |
| Tags | CPython 3.12 Linux glibc 2.27+ x86-64 Linux glibc 2.28+ x86-64 |
|
SHA-256 checksum How to use checksums |
60c1802e44c9d1d23c9a7a96c193378ffec857e51b9256c46addbb35c33bce78
|
|
BLAKE2b-256 checksum How to use checksums |
c0b65593e7213783bb420026e4f579cd095e3d36f7df5b7f266a2a0480c4ef80
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Release files / tanga_py-2.8.0-cp312-cp312-macosx_14_0_arm64.whl
| Download URL | tanga_py-2.8.0-cp312-cp312-macosx_14_0_arm64.whl |
|---|---|
| Size | 3.2 MB |
| Tags | CPython 3.12 macOS 14.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
3cd7df1297c9598d0aa3b9676aa3b0d85cf09549c75ddf24c79e019a3cfdcc48
|
|
BLAKE2b-256 checksum How to use checksums |
6389dead27076f767eba2741e0f3209dfb0d3864ac9d8ef941ae180839619fa1
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
