Metadata-Version: 2.4
Name: geozl
Version: 0.11.0
Summary: Geospatial codec extensions for OpenZL.
Project-URL: Homepage, https://github.com/asterisk-labs/geozl
Project-URL: Repository, https://github.com/asterisk-labs/geozl
Project-URL: Issues, https://github.com/asterisk-labs/geozl/issues
Author-email: Cesar Aybar <cesar@asterisk.coop>
License: BSD-3-Clause
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: BSD License
Classifier: Operating System :: MacOS
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: C
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Scientific/Engineering :: GIS
Classifier: Typing :: Typed
Requires-Python: >=3.11
Requires-Dist: cffi>=1.17
Requires-Dist: numpy>=1.24
Requires-Dist: openzl>=0.2
Provides-Extra: test
Requires-Dist: pytest>=7; extra == 'test'
Description-Content-Type: text/markdown

# geozl

Python bindings for [geozl](https://github.com/asterisk-labs/geozl), geospatial
codec extensions for [OpenZL](https://github.com/facebook/openzl).

```python
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)
```

Eleven codecs, lossless and lossy, 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 to
place in an OpenZL graph yourself, and `geozl.register_decoders` teaches a
`DCtx` to read what they wrote.

Wheels carry a prebuilt native library. A source install has to build it first,
see the build instructions in the repository.

The full documentation, the codec catalogue and the wire format live in the
[repository](https://github.com/asterisk-labs/geozl).
