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

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.2
File Actions
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 log

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

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

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

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

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

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

Select from 6 files

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