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.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.1.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.1.0
File Size Uploaded
jp15-0.1.0.tar.gz 16.3 kB Details

Built distributions (wheels)

Table of built distributions (wheels) for jp15 0.1.0
File
jp15-0.1.0-py3-none-win_arm64.whl Python 3 none Windows ARM64 Details
jp15-0.1.0-py3-none-win_amd64.whl Python 3 none Windows x86-64 Details
jp15-0.1.0-py3-none-manylinux_2_28_x86_64.whl Python 3 none Linux glibc 2.28+ x86-64 Details
jp15-0.1.0-py3-none-manylinux_2_28_aarch64.whl Python 3 none Linux glibc 2.28+ ARM64 Details
jp15-0.1.0-py3-none-macosx_11_0_arm64.whl Python 3 none macOS 11.0+ ARM64 Details
jp15-0.1.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.1.0.tar.gz

Download URL jp15-0.1.0.tar.gz
Size 16.3 kB
Tags Source
SHA-256 checksum
How to use checksums
423c4d624a12097de49ef14a631de418fcf1f1f0faafe5f6b30e4a87125a3825
BLAKE2b-256 checksum
How to use checksums
f16bbba4338e6587ce8c549f55d2ef287a2261c79acef8704e0c7e0ef9e608df
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 23, 2026.

Transparency log

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

Download URL jp15-0.1.0-py3-none-win_arm64.whl
Size 106.8 kB
Tags Python 3 Windows ARM64
SHA-256 checksum
How to use checksums
f278cb74de4f57e53db94edd0675530920cedf73fb79d6cc0f5fff437e2cc8fb
BLAKE2b-256 checksum
How to use checksums
b8112346ac1ada94e413164486fd9c74800ea67a86cb324038d62a77037d02d5
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 23, 2026.

Transparency log

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

Download URL jp15-0.1.0-py3-none-win_amd64.whl
Size 162.6 kB
Tags Python 3 Windows x86-64
SHA-256 checksum
How to use checksums
3870b72840249162c2ae6a13d1f39edcefff0a9fccb00f203b83bd2c4a341506
BLAKE2b-256 checksum
How to use checksums
2e1a01cfab96d70de83e5600c216d98cb90d497db2c89825dc9dc2ddfa16524b
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 23, 2026.

Transparency log

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

Download URL jp15-0.1.0-py3-none-manylinux_2_28_x86_64.whl
Size 255.0 kB
Tags Linux glibc 2.28+ x86-64 Python 3
SHA-256 checksum
How to use checksums
31b06abad0b57ba1c63d4c881549b9853c29012b94ae999d79b0d078e754a958
BLAKE2b-256 checksum
How to use checksums
4d4d0a389a1a4910b7df794ae3fb7814e94d7921cd7973b11dd4e8d62ff1c4f9
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 23, 2026.

Transparency log

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

Download URL jp15-0.1.0-py3-none-manylinux_2_28_aarch64.whl
Size 178.0 kB
Tags Linux glibc 2.28+ ARM64 Python 3
SHA-256 checksum
How to use checksums
0accaafb5cc2b72242699b6ef5e54d43bb648c09f9c2aa9bd656735e23f5d8c3
BLAKE2b-256 checksum
How to use checksums
a9d6ed2e353c1cae93f5865b99b5fa9d2e9b5670a242c72abdbece6f288da960
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 23, 2026.

Transparency log

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

Download URL jp15-0.1.0-py3-none-macosx_11_0_arm64.whl
Size 136.9 kB
Tags Python 3 macOS 11.0+ ARM64
SHA-256 checksum
How to use checksums
d6cea1b6326f1c574c48aaac5f1aedc68c8dcf52fa06f2339295e4f35d911202
BLAKE2b-256 checksum
How to use checksums
6126e13d67edce11a30f7c80fb418b418dd3dbe9f644c2d4b803baa4a93223d4
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 23, 2026.

Transparency log

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

Download URL jp15-0.1.0-py3-none-macosx_10_15_x86_64.whl
Size 205.2 kB
Tags Python 3 macOS 10.15+ x86-64
SHA-256 checksum
How to use checksums
f59e8bc13ce027e79d88ac25fa518869da53a3c797b9fc78ddc534237c672eab
BLAKE2b-256 checksum
How to use checksums
8ea4f359bfee3c9d3572b999ccba82c67689f10644303b6904757814f3129d79
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 23, 2026.

Transparency log

Release history Release notifications | RSS feed

0.2.0

7 release files

This release

0.1.0 This release

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