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, up to 10,000,000 orientations: product grids on the inverse Hopf fibration (the default for every group, never cut at the zone boundary; about a second for 10 million), 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): small samples drawn on the CPU, large ones as GPU discs, and very large ones (or their SO(3) images, hundreds of millions) as a per-pixel density, chosen automatically. Points are colored by symmetry zone, nearest-neighbour distance, largest adjacent cap or Voronoi face count, on a scale relative to the median that shows where a sample is denser or sparser than the rest, with the values' distribution and spread in the legend. Nearest neighbours come from a pass linear in the count, so every size can be colored by them. 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("I", count=10_000_000) as sample: # f=228: 9,876,998 orientations, about a second
sample.spacing() # each one's nearest neighbour, linear in the count
gaps = sample.point_values("separation") # per point (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 frequency (or, with kind="transport", the T/O/I lattice semi-edge) and count the
approximate size, up to 10,000,000; exact=True reaches count exactly, up to 1,000,000. 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.
Generation, spacing and drawing are tested to 10 million orientations and covering checks to about a million, natively and in the browser; CI runs the test suite on Apple M1 (Metal).
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.3.0
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.3.0-py3-none-win_arm64.whl | Python 3 | none | Windows ARM64 | Details for zxtalori-0.3.0-py3-none-win_arm64.whl |
| zxtalori-0.3.0-py3-none-win_amd64.whl | Python 3 | none | Windows x86-64 | Details for zxtalori-0.3.0-py3-none-win_amd64.whl |
| zxtalori-0.3.0-py3-none-manylinux_2_28_x86_64.whl | Python 3 | none | Linux glibc 2.28+ x86-64 | Details for zxtalori-0.3.0-py3-none-manylinux_2_28_x86_64.whl |
| zxtalori-0.3.0-py3-none-manylinux_2_28_aarch64.whl | Python 3 | none | Linux glibc 2.28+ ARM64 | Details for zxtalori-0.3.0-py3-none-manylinux_2_28_aarch64.whl |
| zxtalori-0.3.0-py3-none-macosx_11_0_x86_64.whl | Python 3 | none | macOS 11.0+ x86-64 | Details for zxtalori-0.3.0-py3-none-macosx_11_0_x86_64.whl |
| zxtalori-0.3.0-py3-none-macosx_11_0_arm64.whl | Python 3 | none | macOS 11.0+ ARM64 | Details for zxtalori-0.3.0-py3-none-macosx_11_0_arm64.whl |
Total release size: 27.0 MB
Release files / zxtalori-0.3.0-py3-none-win_arm64.whl
| Download URL | zxtalori-0.3.0-py3-none-win_arm64.whl |
|---|---|
| Size | 4.2 MB |
| Tags | Python 3 Windows ARM64 |
|
SHA-256 checksum How to use checksums |
fa2cbfeceb9806067cbcdcb80b57a316ae1e231c356a236b4ab4a67a4663bd1e
|
|
BLAKE2b-256 checksum How to use checksums |
6a08148cc63d3fe044c3c552422e423b2459bbd9cd851b7627391a8c074c686e
|
| 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 13, 2026.
Transparency logRelease files / zxtalori-0.3.0-py3-none-win_amd64.whl
| Download URL | zxtalori-0.3.0-py3-none-win_amd64.whl |
|---|---|
| Size | 4.4 MB |
| Tags | Python 3 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
0e4fcb4cd3a5056ceea3e8f12869b884efd165e4d47a1a8138e6b3bcf75b3903
|
|
BLAKE2b-256 checksum How to use checksums |
7520f15ae7212da0a7852df640757d51e055ed58a8e5edebd8feda5995e8e14a
|
| 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 13, 2026.
Transparency logRelease files / zxtalori-0.3.0-py3-none-manylinux_2_28_x86_64.whl
| Download URL | zxtalori-0.3.0-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 |
be816f5d3c7060883076967631a800ccc364a087c3b57d3a7ce0061f710b3dab
|
|
BLAKE2b-256 checksum How to use checksums |
7b152ffb6802a110a74b824b026e21d1b7796eb51fb9ae7b32eb513054b783c4
|
| 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 13, 2026.
Transparency logRelease files / zxtalori-0.3.0-py3-none-manylinux_2_28_aarch64.whl
| Download URL | zxtalori-0.3.0-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 |
72e21668d89703a50d9c24cd5d9312264289b15877d1a1d6a222da0a88858b65
|
|
BLAKE2b-256 checksum How to use checksums |
c5f7fbbda7631fac0cb7b78a89e95946d87cc46bdaffcbe4e413d2ce53ac6b1c
|
| 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 13, 2026.
Transparency logRelease files / zxtalori-0.3.0-py3-none-macosx_11_0_x86_64.whl
| Download URL | zxtalori-0.3.0-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 |
9f0f70f1978d2e601cbfff276cfa9b3ad62719312540fadfde2621a154f54c46
|
|
BLAKE2b-256 checksum How to use checksums |
d0423b1ce203959883c916aadef91b5cfe1ed3ba1fb2a244c4bdb2049f5d1eb7
|
| 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 13, 2026.
Transparency logRelease files / zxtalori-0.3.0-py3-none-macosx_11_0_arm64.whl
| Download URL | zxtalori-0.3.0-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 |
506f25df056e95c44302a016374eb85e3936272826c5d4d050b603144abfcb88
|
|
BLAKE2b-256 checksum How to use checksums |
837f5055775215475b9ad040a3a768242a1efb5ff02a262a7750729154062700
|
| 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 13, 2026.
Transparency logSecurity for zxtalori 0.3.0
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.3.0-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 13, 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.