TanGA
Geometric algebra library with a C++ core and a Python interface (pytanga).
→ Full documentation — C++ and Python API guides, architecture overview, notebooks, and developer workflows.
Key Features
-
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.
-
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. -
Interactive 3D visualization — Live WebSocket-driven Three.js visualizer in the browser. Export to standalone HTML, glTF/GLB, PNG, or MP4.
-
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/
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 0.5.2
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-0.5.2-py3-none-any.whl | Python 3 | none | any | Details |
| tanga_py-0.5.2-cp313-cp313-win_amd64.whl | CPython 3.13 | CPython 3.13 | Windows x86-64 | Details |
| tanga_py-0.5.2-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-0.5.2-cp312-cp312-win_amd64.whl | CPython 3.12 | CPython 3.12 | Windows x86-64 | Details |
| tanga_py-0.5.2-cp312-cp312-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl | CPython 3.12 | CPython 3.12 | Linux glibc 2.28+ x86-64, Linux glibc 2.27+ x86-64 | Details |
Total release size: 9.1 MB
Release files / tanga_py-0.5.2-py3-none-any.whl
| Download URL | tanga_py-0.5.2-py3-none-any.whl |
|---|---|
| Size | 689.0 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
2153270f323832f80e78db7f448c3fffd7fa0495eca154b69e7d3c99969f47c0
|
|
BLAKE2b-256 checksum How to use checksums |
48afaa27294ff75e93a31a7c0abbd5c7e421a2bfc07cebb4cb2f8cefe143d632
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.0.1 CPython/3.12.8
|
Release files / tanga_py-0.5.2-cp313-cp313-win_amd64.whl
| Download URL | tanga_py-0.5.2-cp313-cp313-win_amd64.whl |
|---|---|
| Size | 2.0 MB |
| Tags | CPython 3.13 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
54dcea7553ffe8e74e5451a2803d3cd33902e2d028571ccbe4673249ea18664e
|
|
BLAKE2b-256 checksum How to use checksums |
ee2683ab7c5370028dea72557b94461046af09f0a3ccc9880cf2ff689508bb69
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.0.1 CPython/3.12.8
|
Release files / tanga_py-0.5.2-cp313-cp313-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
| Download URL | tanga_py-0.5.2-cp313-cp313-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl |
|---|---|
| Size | 2.2 MB |
| Tags | CPython 3.13 Linux glibc 2.27+ x86-64 Linux glibc 2.28+ x86-64 |
|
SHA-256 checksum How to use checksums |
d8cc97330c7310c66a4e576597086fdec47077b07a9476beb543ac46f6a38dd0
|
|
BLAKE2b-256 checksum How to use checksums |
d6d3723f22822d7a540ac49828b3e9d5c5f8ae7f12b5ebc7354478458d8f99b4
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.0.1 CPython/3.12.8
|
Release files / tanga_py-0.5.2-cp312-cp312-win_amd64.whl
| Download URL | tanga_py-0.5.2-cp312-cp312-win_amd64.whl |
|---|---|
| Size | 2.0 MB |
| Tags | CPython 3.12 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
8fbe7c6225694de8726cd06cfc453e8956af399b4d2c5b99c9f7500f96d14c80
|
|
BLAKE2b-256 checksum How to use checksums |
2ae046f4f3309e2566b898fbe65f6633f7f8a78cd33051990f80587906c05b74
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.0.1 CPython/3.12.8
|
Release files / tanga_py-0.5.2-cp312-cp312-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
| Download URL | tanga_py-0.5.2-cp312-cp312-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl |
|---|---|
| Size | 2.2 MB |
| Tags | CPython 3.12 Linux glibc 2.27+ x86-64 Linux glibc 2.28+ x86-64 |
|
SHA-256 checksum How to use checksums |
c1c0341a469524e7350f152c7eb41fa01bdccfa3afc31ef0bab335b01968914b
|
|
BLAKE2b-256 checksum How to use checksums |
98de17eae8bc85a7f082812e32dcdfc020fcaef5e68d0f8546f3fe5007109ed3
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.0.1 CPython/3.12.8
|
