Skip to main content

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: the MTEX equispaced product grids for C2–C6 and D2–D6 (with a dihedral polar-parity repair and orbit-aware seam deduplication), 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", h=6) as sample:          # 1,043 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.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.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Built distributions (wheels)

Table of built distributions (wheels) for zxtalori 0.1.0
File Actions
zxtalori-0.1.0-py3-none-win_arm64.whl Python 3 none Windows ARM64 Details for zxtalori-0.1.0-py3-none-win_arm64.whl
zxtalori-0.1.0-py3-none-win_amd64.whl Python 3 none Windows x86-64 Details for zxtalori-0.1.0-py3-none-win_amd64.whl
zxtalori-0.1.0-py3-none-manylinux_2_28_x86_64.whl Python 3 none Linux glibc 2.28+ x86-64 Details for zxtalori-0.1.0-py3-none-manylinux_2_28_x86_64.whl
zxtalori-0.1.0-py3-none-manylinux_2_28_aarch64.whl Python 3 none Linux glibc 2.28+ ARM64 Details for zxtalori-0.1.0-py3-none-manylinux_2_28_aarch64.whl
zxtalori-0.1.0-py3-none-macosx_11_0_x86_64.whl Python 3 none macOS 11.0+ x86-64 Details for zxtalori-0.1.0-py3-none-macosx_11_0_x86_64.whl
zxtalori-0.1.0-py3-none-macosx_11_0_arm64.whl Python 3 none macOS 11.0+ ARM64 Details for zxtalori-0.1.0-py3-none-macosx_11_0_arm64.whl

Total release size: 26.8 MB

Release files / zxtalori-0.1.0-py3-none-win_arm64.whl

Download URL zxtalori-0.1.0-py3-none-win_arm64.whl
Size 4.1 MB
Tags Python 3 Windows ARM64
SHA-256 checksum
How to use checksums
48eccb1a5943bd745aa9ecafff0b2eaa008ac49807af63afb392741a6300583d
BLAKE2b-256 checksum
How to use checksums
d71273e39f85b3e9bfb6174fa6c7fc1f98e57b7c15b8da78198b0328fdbc0f0a
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 Oct 27, 2026.

Transparency log

Release files / zxtalori-0.1.0-py3-none-win_amd64.whl

Download URL zxtalori-0.1.0-py3-none-win_amd64.whl
Size 4.3 MB
Tags Python 3 Windows x86-64
SHA-256 checksum
How to use checksums
f8b0a90c8d91d665ebd2d33612ab27f7c76b39742b3d1184882c9aaba2a07e62
BLAKE2b-256 checksum
How to use checksums
a5a1fd619cc179b97e5c2a0ce2a356f14408e8d812369b94e0577c7b6a18a394
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 Oct 27, 2026.

Transparency log

Release files / zxtalori-0.1.0-py3-none-manylinux_2_28_x86_64.whl

Download URL zxtalori-0.1.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
a60860e18e4494b1474fe516cf62d6cf2250edd275c07ec73e5070c3aaa26a24
BLAKE2b-256 checksum
How to use checksums
cd779ba5f8425cb186abddfb2275dcf9006041050600adf52168f8477c6fc2b8
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 Oct 27, 2026.

Transparency log

Release files / zxtalori-0.1.0-py3-none-manylinux_2_28_aarch64.whl

Download URL zxtalori-0.1.0-py3-none-manylinux_2_28_aarch64.whl
Size 5.4 MB
Tags Linux glibc 2.28+ ARM64 Python 3
SHA-256 checksum
How to use checksums
2baf42bb3a95d927d4669169e5b4f7cf659d23a7262210f0670b7fb31c7025aa
BLAKE2b-256 checksum
How to use checksums
8ff1d744456c54bbb5f09a4b9c8277789c834b4de1a09185b11e97b012c78695
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 Oct 27, 2026.

Transparency log

Release files / zxtalori-0.1.0-py3-none-macosx_11_0_x86_64.whl

Download URL zxtalori-0.1.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
c5e634217aab7615dd3ddab14b5972de2015af56d18e904e08dd8da00eae495d
BLAKE2b-256 checksum
How to use checksums
52e9fbd70935c50f502c9677486f75498b45eb73a03bc6ff58fbf06ff3f591b8
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 Oct 27, 2026.

Transparency log

Release files / zxtalori-0.1.0-py3-none-macosx_11_0_arm64.whl

Download URL zxtalori-0.1.0-py3-none-macosx_11_0_arm64.whl
Size 3.6 MB
Tags Python 3 macOS 11.0+ ARM64
SHA-256 checksum
How to use checksums
0431c4afa8a65bc7757e34c63e20696c894c0537a9f0bcf1a5f62e072d75faf6
BLAKE2b-256 checksum
How to use checksums
ed31745e59a36c1e509b3e6a1ec28980207b15a4dc42e5d95bc5b1f48ccd4c6c
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 Oct 27, 2026.

Transparency log

Security for zxtalori 0.1.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.

Select from 6 files

Attestation for zxtalori-0.1.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 Oct 27, 2026.

Transparency log

A 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.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page