Skip to main content

geozl

Python bindings to libgeozl, the geospatial codec extensions for OpenZL.

import numpy as np
import geozl

tile = np.fromfile("b04.raw", dtype=np.uint16).reshape(1024, 1024)

g = geozl.graph(tile, "planar>zigzag>transpose>entropy")
frame = geozl.compress(tile, graph=g)
back = geozl.decompress(frame).view(np.uint16).reshape(1024, 1024)

Pass a positive number as error for a fixed absolute bound, or a percentage string for a relative bound. None and zero are lossless. Full LINEAR, LOG and SQRT recipes are also accepted.

absolute = geozl.graph(tile, "planar>zigzag>entropy", error=2)
relative = geozl.graph(tile, "planar>zigzag>entropy", error="1%")

profile returns a list-like result. Print it to see the input geometry, benchmark settings and ranked graphs together.

rows = geozl.profile(tile, prior=None)
print(rows)
best = rows[0]["graph"]

The documented codecs, lossless and lossy, are reachable two ways. geozl.graph takes a recipe string and builds the graph for you, and geozl.compress runs one tile through it. geozl.lossless and geozl.lossy hand you the individual nodes, apart from lanes and planar_zigzag_lanes, to place in an OpenZL graph yourself, and geozl.register_decoders teaches a DCtx to read what they wrote.

Prebuilt wheels are published for Linux x86-64 with CUDA support and macOS arm64 with Metal support. Device decode needs a compatible GPU. A source install on another platform has to build the native library first; see the build instructions in the repository.

The full documentation, the codec catalogue and the wire format live in the repository.

Metadata

Release files for geozl 0.33.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 geozl 0.33.0
File Interpreter ABI Platform Actions
geozl-0.33.0-py3-none-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl Python 3 none Linux glibc 2.27+ x86-64, Linux glibc 2.28+ x86-64 Details for geozl-0.33.0-py3-none-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
geozl-0.33.0-py3-none-macosx_11_0_arm64.whl Python 3 none macOS 11.0+ ARM64 Details for geozl-0.33.0-py3-none-macosx_11_0_arm64.whl

Total release size: 11.0 MB

Release files / geozl-0.33.0-py3-none-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl

Download URL geozl-0.33.0-py3-none-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
Size 9.5 MB
Tags Linux glibc 2.27+ x86-64 Linux glibc 2.28+ x86-64 Python 3
SHA-256 checksum
How to use checksums
7a5127fe80da9f8260ee52c4edaaf4ef7b1aabd301b20445fef57276cd2ce5a9
BLAKE2b-256 checksum
How to use checksums
3194017e128004d312eab24272607967f23b8491085b5c7e6974a6dcb036eccc
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 16, 2026.

Transparency log

Release files / geozl-0.33.0-py3-none-macosx_11_0_arm64.whl

Download URL geozl-0.33.0-py3-none-macosx_11_0_arm64.whl
Size 1.5 MB
Tags Python 3 macOS 11.0+ ARM64
SHA-256 checksum
How to use checksums
6e1a88c9c299e5751ade14f75ed937d2d3b9cd43e6249d6d24f74856e6581e19
BLAKE2b-256 checksum
How to use checksums
732be1dbf175aa1dfd24f8c69f4c51839708d14e733be2543cb5838e66a2501c
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 16, 2026.

Transparency log

Security for geozl 0.33.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

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for geozl-0.33.0-py3-none-manylinux_2_27_x86_64.manylinux_2_28_x86_64.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 16, 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.

Release history Release notifications | RSS feed

This release

0.33.0 This release

2 release files Full provenance

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