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, 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)

Table of built distributions (wheels) for zxtalori 0.3.0
File Actions
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 log

Release 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 log

Release 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 log

Release 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 log

Release 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 log

Release 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 log

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

Select from 6 files

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