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: 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.1

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.2.1
File Actions
zxtalori-0.2.1-py3-none-win_arm64.whl Python 3 none Windows ARM64 Details for zxtalori-0.2.1-py3-none-win_arm64.whl
zxtalori-0.2.1-py3-none-win_amd64.whl Python 3 none Windows x86-64 Details for zxtalori-0.2.1-py3-none-win_amd64.whl
zxtalori-0.2.1-py3-none-manylinux_2_28_x86_64.whl Python 3 none Linux glibc 2.28+ x86-64 Details for zxtalori-0.2.1-py3-none-manylinux_2_28_x86_64.whl
zxtalori-0.2.1-py3-none-manylinux_2_28_aarch64.whl Python 3 none Linux glibc 2.28+ ARM64 Details for zxtalori-0.2.1-py3-none-manylinux_2_28_aarch64.whl
zxtalori-0.2.1-py3-none-macosx_11_0_x86_64.whl Python 3 none macOS 11.0+ x86-64 Details for zxtalori-0.2.1-py3-none-macosx_11_0_x86_64.whl
zxtalori-0.2.1-py3-none-macosx_11_0_arm64.whl Python 3 none macOS 11.0+ ARM64 Details for zxtalori-0.2.1-py3-none-macosx_11_0_arm64.whl

Total release size: 26.9 MB

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

Download URL zxtalori-0.2.1-py3-none-win_arm64.whl
Size 4.1 MB
Tags Python 3 Windows ARM64
SHA-256 checksum
How to use checksums
657705c7153651a1d6bd15e0f5fa47c2169258776d66e98c0ec74d67b90f095e
BLAKE2b-256 checksum
How to use checksums
5708830b8bc1e698fa663b3f696c6199c576069fb84d0e1c30907816cd7f1cd4
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 31, 2026.

Transparency log

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

Download URL zxtalori-0.2.1-py3-none-win_amd64.whl
Size 4.4 MB
Tags Python 3 Windows x86-64
SHA-256 checksum
How to use checksums
b3dba91496763611eb75f3ee17d388a05bdfd5d6d0f7b34735b92ae2549de680
BLAKE2b-256 checksum
How to use checksums
f0bf112e1c2ad259952b354ca8821401971b93df49a6953ad06fa2bfefb9a3ac
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 31, 2026.

Transparency log

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

Download URL zxtalori-0.2.1-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
6bcc35050c7a953a75d34d4b5fe47ed51195eedc6b2665274d8fbf9f77f6bdec
BLAKE2b-256 checksum
How to use checksums
7c5ee92a52c267e061a241ffdac9e1da43369a762c6da6a840a059f7cb2c34ce
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 31, 2026.

Transparency log

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

Download URL zxtalori-0.2.1-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
86a6e4e3dc7895f15743ba35492e5e6469012e9b9ac1382263338a6ba3b65b53
BLAKE2b-256 checksum
How to use checksums
388610cbcd9ce60a071402ba6b8d19f7a2a92ff8d5ec9907370831a43593662a
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 31, 2026.

Transparency log

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

Download URL zxtalori-0.2.1-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
d42184f361a6d1539d130d23e928ca200725aa3e0999cb9fa7dc78d5a904c25c
BLAKE2b-256 checksum
How to use checksums
5020251c6b0d150cd703df54286fd9d29258d0bd32036c32d324a7698477d454
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 31, 2026.

Transparency log

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

Download URL zxtalori-0.2.1-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
e6d8834c590a88117c1761ff48ac46e2ad60abb3804580df7017f5aef292d13d
BLAKE2b-256 checksum
How to use checksums
75028293df0d4936e6de34d771beeb28ca1432891fdd85dd8c53d5ed56110995
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 31, 2026.

Transparency log

Security for zxtalori 0.2.1

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.2.1-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 31, 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