Skip to main content

jp15

Python bindings for OpenJPH HTJ2K encode/decode, with an optional Zarr v3 codec.

Installation

pip install "jp15[zarr]"   # with Zarr codec support
pip install jp15           # encode/decode only

Basic usage

import jp15
import numpy as np

data = np.random.randint(0, 60000, (64, 128), dtype=np.uint16)

encoded = jp15.encode(
    data,
    irreversible=False,
    qstep=None,
    num_decompositions=5,
    block_size=(64, 64),
    progression_order="LRCP",
    color_transform=False,
    planar=True,
)
decoded = jp15.decode(encoded)

np.testing.assert_array_equal(decoded, data)

decode requires no dtype or shape hint from the caller. HTJ2K codestreams carry a SIZ (image size) marker in their header that records the image dimensions, number of components, bit depth, and signedness at encode time. decode reads this marker and uses it to allocate the output buffer and select the correct element type, so the reconstructed array always matches the original without any extra bookkeeping on the caller's side.

Zarr v3 codec

OpenJPHCodec is a Zarr v3 array-to-bytes codec passed in the array's codecs pipeline.

from jp15.codecs.zarr import OpenJPHCodec
import numpy as np
import zarr

data = np.arange(64 * 96, dtype=np.uint16).reshape(64, 96)

array = zarr.create(
    store="example.zarr",
    shape=data.shape,
    chunks=data.shape,
    dtype=data.dtype,
    codecs=[OpenJPHCodec(layout="yx")],
    zarr_format=3,
)

array[:] = data
np.testing.assert_array_equal(array[:], data)

Metadata

Release files for jp15 0.2.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for jp15 0.2.0
File Size Uploaded
jp15-0.2.0.tar.gz 18.1 kB Details

Built distributions (wheels)

Table of built distributions (wheels) for jp15 0.2.0
File
jp15-0.2.0-py3-none-win_arm64.whl Python 3 none Windows ARM64 Details
jp15-0.2.0-py3-none-win_amd64.whl Python 3 none Windows x86-64 Details
jp15-0.2.0-py3-none-manylinux_2_28_x86_64.whl Python 3 none Linux glibc 2.28+ x86-64 Details
jp15-0.2.0-py3-none-manylinux_2_28_aarch64.whl Python 3 none Linux glibc 2.28+ ARM64 Details
jp15-0.2.0-py3-none-macosx_11_0_arm64.whl Python 3 none macOS 11.0+ ARM64 Details
jp15-0.2.0-py3-none-macosx_10_15_x86_64.whl Python 3 none macOS 10.15+ x86-64 Details

Total release size: 1.1 MB

Release files / jp15-0.2.0.tar.gz

Download URL jp15-0.2.0.tar.gz
Size 18.1 kB
Tags Source
SHA-256 checksum
How to use checksums
2fcc2e1f11d2dae6ece55b7d9f0f97505652ce01a0116771616f4f4f50f072a6
BLAKE2b-256 checksum
How to use checksums
a2cb3e6916c1bfb18eae2e4445ca75a7d53b672d308104e8c94ba781ed54b8ee
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.14

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 Jul 28, 2026.

Transparency log

Release files / jp15-0.2.0-py3-none-win_arm64.whl

Download URL jp15-0.2.0-py3-none-win_arm64.whl
Size 108.6 kB
Tags Python 3 Windows ARM64
SHA-256 checksum
How to use checksums
4367e3654a1e445948456c99430ff03d94ec6d2da9c8f2ea209b45dad10a28d1
BLAKE2b-256 checksum
How to use checksums
958bbda48658ba332fa83fe21ac9b24808daa88bde3a09d6ba2315461295f582
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.14

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 Jul 28, 2026.

Transparency log

Release files / jp15-0.2.0-py3-none-win_amd64.whl

Download URL jp15-0.2.0-py3-none-win_amd64.whl
Size 164.4 kB
Tags Python 3 Windows x86-64
SHA-256 checksum
How to use checksums
c7fe54e07413f29697b836cdbca1f209dcb76838bc69f7e218a8ee199ef26cca
BLAKE2b-256 checksum
How to use checksums
d2c1b2c0bfce1e43679e279d53eb1a18e3489c9519a9459da243615c3c87740d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.14

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 Jul 28, 2026.

Transparency log

Release files / jp15-0.2.0-py3-none-manylinux_2_28_x86_64.whl

Download URL jp15-0.2.0-py3-none-manylinux_2_28_x86_64.whl
Size 256.9 kB
Tags Linux glibc 2.28+ x86-64 Python 3
SHA-256 checksum
How to use checksums
60b87592539bf58b493dda6980a4ea4fd4cc8c7a0176991330e2d970da061be6
BLAKE2b-256 checksum
How to use checksums
87244defa670cb59feb81e6480b13b600ecbb18090404e1c4eed5f7756fa670b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.14

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 Jul 28, 2026.

Transparency log

Release files / jp15-0.2.0-py3-none-manylinux_2_28_aarch64.whl

Download URL jp15-0.2.0-py3-none-manylinux_2_28_aarch64.whl
Size 179.9 kB
Tags Linux glibc 2.28+ ARM64 Python 3
SHA-256 checksum
How to use checksums
007c9452633f934c87cd7593115a544cbb1b6065bf4264c4b1aea1acac1c22f8
BLAKE2b-256 checksum
How to use checksums
eee59cdfe005bafeb18a1ec77e170b2342c1627f440f92607cfb9626a9916997
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.14

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 Jul 28, 2026.

Transparency log

Release files / jp15-0.2.0-py3-none-macosx_11_0_arm64.whl

Download URL jp15-0.2.0-py3-none-macosx_11_0_arm64.whl
Size 138.8 kB
Tags Python 3 macOS 11.0+ ARM64
SHA-256 checksum
How to use checksums
785423cc3ee771a4077151bae1bf0ec168d50b2bc9c183b72e67de155e0fffff
BLAKE2b-256 checksum
How to use checksums
524fde23f03ec8a5126f6e017e338464f3e1e873dd59f1c3408cfd2cab726a45
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.14

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 Jul 28, 2026.

Transparency log

Release files / jp15-0.2.0-py3-none-macosx_10_15_x86_64.whl

Download URL jp15-0.2.0-py3-none-macosx_10_15_x86_64.whl
Size 207.1 kB
Tags Python 3 macOS 10.15+ x86-64
SHA-256 checksum
How to use checksums
99006f751011af608431d75d6efe83f692b45e919db481ec30c2d0e9625c39a2
BLAKE2b-256 checksum
How to use checksums
8549791009063916f0931b91ec5eb32f44c1f23cbd5318901daefb175a412c74
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.14

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 Jul 28, 2026.

Transparency log

Release history Release notifications | RSS feed

This release

0.2.0 This release

7 release files

0.1.0

7 release files

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