zxtalori
Orientation grids on SO(3)/K: generate, measure, relax and lower the covering radius on the GPU, in the browser or from Python.
Open the web app: it runs on your GPU inside the page (Chrome or Edge 137+, which have WebGPU and WebAssembly promise integration). It opens on an octahedral grid; pick a group and a count, then relax or optimize the covering.
What it does
- Generates samples for all eleven proper point groups: product grids on the inverse Hopf fibration (the default for every group, never cut at the zone boundary), FCC lattice transports for T, O and I, seeded Haar-random samples, and exact counts from 32 to 1,000,000 (a smaller grid filled at its largest empty Delaunay circumcentres).
- Measures minimum separation, mean geodesic repulsion energy, Riesz s = 1, 2, 3, Green and logarithmic energy ratios, and the covering radius: the largest empty cap, from a GPU Delaunay triangulation of the fundamental zone and a symmetry shell (a port of Gao and Chen's parallel 3D Delaunay method) with exact predicates and a shell-completeness certificate.
- Relaxes by Quey–Villani–Maurice geodesic repulsion with Barzilai–Borwein steps. Forces sum over all pairs, or over each point's near field (about 7,500 neighbours within 20 mean orientation radii, faded smoothly), which costs time linear in the count.
- Lowers the covering radius by disjoint local moves around the largest empty caps, judged against an exact triangulation that is updated in place as points move. An optional separation floor keeps every pair apart, and the best sample is kept.
- Shows the sample in homochoric, Rodrigues or axis–angle space, in the fundamental zone or all of SO(3), with points colored by symmetry zone, nearest-neighbour distance, largest adjacent cap or Voronoi face count, and the Delaunay edges on request. Every measure has a history plot.
- Reads and writes JSON and CSV quaternions (scalar first, right action
q*g).
One engine (Zig and WGSL) runs natively through wgpu-native and as WebAssembly on WebGPU, so the app and the Python package do the same thing. Symmetry images are evaluated implicitly; the expanded orbit is never stored.
Python
pip install zxtalori
python -m zxtalori # the same app, served locally
import zxtalori as zo
with zo.generate("O", count=1000) as sample: # inverse Hopf grid nearest 1,000: 1,048 orientations
sample.relax(30)
print(sample.measure()["separation_deg"], sample.covering()["covering_radius_deg"])
sample.optimize_covering(2000) # lowers it; the best sample is kept
q = sample.quaternions # NumPy (N, 4), scalar first
sample.save("octahedral.json") # opens in the web app
with zo.generate("D6", h=12) as sample: # frequency f=12: 2,936 orientations
print(sample.covering()["covering_excess"])
with zo.generate("O", h=6, kind="transport") as sample: # FCC transport, semi-edge 6: 1,043
sample.relax(30)
with zo.haar("O", count=100_000, seed=193) as sample:
sample.relax(100, neighbourhood=20) # near-field forces; 0 for all pairs
sample.covering()
sizes = sample.point_values("covering") # per point: largest adjacent cap (degrees)
with zo.generate("D2", count=1000, exact=True, fixed_identity=True) as sample:
sample.relax(30) # identity included and held fixed
h sets the T/O/I lattice resolution and count the approximate C/D budget; exact=True
reaches count exactly for any group. Separation and covering radius are SO(3) rotation angles
in degrees; the repulsion objective uses S³ geodesic distances in radians. Lower repulsion energy
does not by itself certify a lower covering radius.
More
- Methods: generation, measures, relaxation and covering optimization, with conventions and numerical limits; workbench methods for zone membership and exact counts.
- GPU Delaunay triangulation: the parallel construction after Gao and Chen, exact predicates and the covering certificate.
- CONTRIBUTING.md: building, testing, conventions.
Validated natively and in the browser through about 100,000 orientations; CI runs the test suite on Apple M1 (Metal). One million orientations remains a design goal.
MIT (LICENSE). Third-party components keep their notices (THIRD_PARTY_NOTICES.md). The wheels bundle wgpu-native (MIT / Apache-2.0).
Metadata
Release files for zxtalori 0.2.2
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Built distributions (wheels)
| File | Actions Reset | |||
|---|---|---|---|---|
| zxtalori-0.2.2-py3-none-win_arm64.whl | Python 3 | none | Windows ARM64 | Details for zxtalori-0.2.2-py3-none-win_arm64.whl |
| zxtalori-0.2.2-py3-none-win_amd64.whl | Python 3 | none | Windows x86-64 | Details for zxtalori-0.2.2-py3-none-win_amd64.whl |
| zxtalori-0.2.2-py3-none-manylinux_2_28_x86_64.whl | Python 3 | none | Linux glibc 2.28+ x86-64 | Details for zxtalori-0.2.2-py3-none-manylinux_2_28_x86_64.whl |
| zxtalori-0.2.2-py3-none-manylinux_2_28_aarch64.whl | Python 3 | none | Linux glibc 2.28+ ARM64 | Details for zxtalori-0.2.2-py3-none-manylinux_2_28_aarch64.whl |
| zxtalori-0.2.2-py3-none-macosx_11_0_x86_64.whl | Python 3 | none | macOS 11.0+ x86-64 | Details for zxtalori-0.2.2-py3-none-macosx_11_0_x86_64.whl |
| zxtalori-0.2.2-py3-none-macosx_11_0_arm64.whl | Python 3 | none | macOS 11.0+ ARM64 | Details for zxtalori-0.2.2-py3-none-macosx_11_0_arm64.whl |
Total release size: 27.0 MB
Release files / zxtalori-0.2.2-py3-none-win_arm64.whl
| Download URL | zxtalori-0.2.2-py3-none-win_arm64.whl |
|---|---|
| Size | 4.1 MB |
| Tags | Python 3 Windows ARM64 |
|
SHA-256 checksum How to use checksums |
0c340d9e19c4b274a7d88e7c87d2fe0a09d4f19487c45b4f5d16643a15f72894
|
|
BLAKE2b-256 checksum How to use checksums |
d72dfd560c29ead842b7183a50ee09775892949e1fdd7a0f3e53d13290bac30c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 3, 2026.
Transparency logRelease files / zxtalori-0.2.2-py3-none-win_amd64.whl
| Download URL | zxtalori-0.2.2-py3-none-win_amd64.whl |
|---|---|
| Size | 4.4 MB |
| Tags | Python 3 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
7fd938f60f13044f62829f1a71cd472112171a8bea674949bbd0f05ee3282778
|
|
BLAKE2b-256 checksum How to use checksums |
808d287c93f23431d7ee61d0bacf004cb5e40641901025d4505214cb2759dfc5
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 3, 2026.
Transparency logRelease files / zxtalori-0.2.2-py3-none-manylinux_2_28_x86_64.whl
| Download URL | zxtalori-0.2.2-py3-none-manylinux_2_28_x86_64.whl |
|---|---|
| Size | 5.5 MB |
| Tags | Linux glibc 2.28+ x86-64 Python 3 |
|
SHA-256 checksum How to use checksums |
00755876fae5ded50237197787966c4c929f59906e54231d3f33bd5e03b4acfd
|
|
BLAKE2b-256 checksum How to use checksums |
cc60289b65a55ec30f1e4fda1b0c4bddc9fc21d6b048706c2908950b108340ad
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 3, 2026.
Transparency logRelease files / zxtalori-0.2.2-py3-none-manylinux_2_28_aarch64.whl
| Download URL | zxtalori-0.2.2-py3-none-manylinux_2_28_aarch64.whl |
|---|---|
| Size | 5.5 MB |
| Tags | Linux glibc 2.28+ ARM64 Python 3 |
|
SHA-256 checksum How to use checksums |
5298468ed7e10912b119c1dd2c584aaafd9007efe59387e99b70bd1a50ac6b7d
|
|
BLAKE2b-256 checksum How to use checksums |
d9da19bbef32fd2b132689571e69aedaf87fe7b1d72c15f906abb412f7aebedb
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 3, 2026.
Transparency logRelease files / zxtalori-0.2.2-py3-none-macosx_11_0_x86_64.whl
| Download URL | zxtalori-0.2.2-py3-none-macosx_11_0_x86_64.whl |
|---|---|
| Size | 3.8 MB |
| Tags | Python 3 macOS 11.0+ x86-64 |
|
SHA-256 checksum How to use checksums |
2dd746d1634fb8f454aae61ae6896deeb554a3d8f97f5c795d4feb606de15ea5
|
|
BLAKE2b-256 checksum How to use checksums |
91f55b5aae6bab500e0866c17aaad56f39f59fb59113fe6a3fa3ed4bf2cb1e54
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 3, 2026.
Transparency logRelease files / zxtalori-0.2.2-py3-none-macosx_11_0_arm64.whl
| Download URL | zxtalori-0.2.2-py3-none-macosx_11_0_arm64.whl |
|---|---|
| Size | 3.7 MB |
| Tags | Python 3 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
f20c5ae91e4e6ec0d7f8da1d3c3e98da1e72c62381f5a0e67df2ed024785c33d
|
|
BLAKE2b-256 checksum How to use checksums |
b71bfbf021b850197fb3b430d6accd1bd83f084572393f4ba025a37ef7b12426
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 3, 2026.
Transparency logSecurity for zxtalori 0.2.2
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
Full provenance
All 6 files in this release have been uploaded with provenance metadata.
Attestation for zxtalori-0.2.2-py3-none-win_arm64.whl
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 3, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.