This release is a pre-release and may not be stable for production use.
Eozin Python: The dye-namic solution for digital pathology
A fast digital pathology image decoder powered by Rust. The library's primary purpose is to provide efficient access to individual tiles within digital pathology images. The name is derived from eosin, an essential dye solution used in pathological diagnosis.
Quickstart
This example demonstrates how to select the lowest resolution level from a digital pathology image in a native Rust environment, retrieve the central tile within that level, and save it as a JPEG file.
from eozin import Eozin
from PIL import Image
# Load a slide image
slide = Eozin("/some/slide.svs")
# Get dimensions of the slide at level 0 (full resolution)
slide_width, slide_height = slide.dimensions
# Get the index of the lowest resolution level
lowest_resolution_level = slide.level_count - 1
# level_tile_ranges returns a list of tuples:
# [(horizontal_tiles, vertical_tiles), ...]
lowres_tile_ranges = slide.level_tile_ranges[lowest_resolution_level]
# Retrieve the tile at the center of the level
# lowres_tile_ranges[0] is the width in tiles, and [1] is the height in tiles.
lowres_centered_tile: Image.Image = slide.read_tile(
lowest_resolution_level,
lowres_tile_ranges[0] // 2,
lowres_tile_ranges[1] // 2,
)
lowres_centered_tile.show()
# Extract a specific region (OpenSlide-like API)
# read_region(location, level, size)
region: Image.Image = slide.read_region((0, 0), 0, (1024, 1024))
Core Concept
Digital pathology images are captured using high-magnification microscopes, resulting in massive images that can reach hundreds of thousands of pixels in dimension. Because storing such large images in standard formats is impractical, they are designed as containers comprising small rectangular images called tiles.
Furthermore, since downscaling these images on the fly is computationally expensive, they typically store multiple lower-resolution versions, referred to as levels. Vendors have developed various proprietary formats, and libraries like OpenSlide and bioformats have been instrumental in handling them.
The motivation for Eozin is to provide lightweight and fast access to these tiles. Specifically, each tile is stored as a fragmented byte sequence; Eozin calculates the byte offset based on the requested level and coordinates, then appends the necessary headers so the buffer can be interpreted as a standard image format.
Pixel-level processing (such as intensity manipulation) is intentionally left
to established libraries—such as the image crate in Rust, Pillow in Python,
or Blob objects in JS/Web environments.
Since the I/O and decoding logic are completely decoupled, Eozin can be adapted to various environments. Client-side rendering in the browser achieves performant response times, and its efficiency is also ideal for high-throughput AI interpretation and analysis.
Notes
Vendor and file format names mentioned in this library are the property of their respective owners. This library is not certified for clinical use.
1 maintainer
Release files for eozin 0.1.0a2
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| eozin-0.1.0a2.tar.gz | 610.6 kB | Details |
Built distributions (wheels)
Total release size: 6.6 MB
Release files / eozin-0.1.0a2.tar.gz
| Download URL | eozin-0.1.0a2.tar.gz |
|---|---|
| Size | 610.6 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
b3386069eff51dd126cc0ef8d36848a6ead2ede866b3b2e65ef052b30226faf5
|
|
BLAKE2b-256 checksum How to use checksums |
656b0530a63f1f5c067b84ac6ebeccd8588f62e343933c582600761f4fa88eb2
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
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 Jun 20, 2026.
Transparency logRelease files / eozin-0.1.0a2-cp38-abi3-win_arm64.whl
| Download URL | eozin-0.1.0a2-cp38-abi3-win_arm64.whl |
|---|---|
| Size | 212.3 kB |
| Tags | CPython 3.8 Windows ARM64 abi3 |
|
SHA-256 checksum How to use checksums |
c1065ac8602a8a49e90edcf3e3db6bdb9a66736fc895e561f14835c64ec53025
|
|
BLAKE2b-256 checksum How to use checksums |
3e4561fd94f104d61c2bd36e9f2d4f560b0a16acfc4d9fedff3cf2becf99a2af
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
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 Jun 20, 2026.
Transparency logRelease files / eozin-0.1.0a2-cp38-abi3-win_amd64.whl
| Download URL | eozin-0.1.0a2-cp38-abi3-win_amd64.whl |
|---|---|
| Size | 219.1 kB |
| Tags | CPython 3.8 Windows x86-64 abi3 |
|
SHA-256 checksum How to use checksums |
17f6bdb413e50f96e0790851816b4fa0455bd958532233f46d45d1329340aa45
|
|
BLAKE2b-256 checksum How to use checksums |
9d52b7cf7ca6303e56c84d55b4614d56e6a6a9bab32846e30a5e8f82cb5c629b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
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 Jun 20, 2026.
Transparency logRelease files / eozin-0.1.0a2-cp38-abi3-win32.whl
| Download URL | eozin-0.1.0a2-cp38-abi3-win32.whl |
|---|---|
| Size | 210.9 kB |
| Tags | CPython 3.8 Windows x86-32 abi3 |
|
SHA-256 checksum How to use checksums |
62d50815039ef54b52fd2d5a7fc052b2ea54a5a6b1c25eac1ed938dc62b42173
|
|
BLAKE2b-256 checksum How to use checksums |
98fd6e75bc01ecc45a7e76b12ca293be4b57d9ca67e3496fc1b5136d7152a450
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
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 Jun 20, 2026.
Transparency logRelease files / eozin-0.1.0a2-cp38-abi3-musllinux_1_2_x86_64.whl
| Download URL | eozin-0.1.0a2-cp38-abi3-musllinux_1_2_x86_64.whl |
|---|---|
| Size | 568.7 kB |
| Tags | CPython 3.8 Linux musl 1.2+ x86-64 abi3 |
|
SHA-256 checksum How to use checksums |
572486f0294ec630b3e7de570ef07864dce55466bf2403d0e54e81ce8030dd95
|
|
BLAKE2b-256 checksum How to use checksums |
cbf6b65beaaa268b9536ab90c89bbb16f663beebf0ed82889f50708294f16a95
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
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 Jun 20, 2026.
Transparency logRelease files / eozin-0.1.0a2-cp38-abi3-musllinux_1_2_i686.whl
| Download URL | eozin-0.1.0a2-cp38-abi3-musllinux_1_2_i686.whl |
|---|---|
| Size | 606.0 kB |
| Tags | CPython 3.8 Linux musl 1.2+ x86-32 abi3 |
|
SHA-256 checksum How to use checksums |
2acd2f23603c883af0fc4587dc1202d688b31f0d20f8b7795a1180a30d3474ba
|
|
BLAKE2b-256 checksum How to use checksums |
9e46bb5f515831d260e8b45b4b676704672c6c2bf5aad2295335fbab0fd6ea2e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
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 Jun 20, 2026.
Transparency logRelease files / eozin-0.1.0a2-cp38-abi3-musllinux_1_2_armv7l.whl
| Download URL | eozin-0.1.0a2-cp38-abi3-musllinux_1_2_armv7l.whl |
|---|---|
| Size | 642.5 kB |
| Tags | CPython 3.8 Linux musl 1.2+ ARMv7l abi3 |
|
SHA-256 checksum How to use checksums |
20cd719d2c6fee9fb0d5b542c37d6b0bff5d60deb9ddb07a02ea4cb4264d26ed
|
|
BLAKE2b-256 checksum How to use checksums |
769aef320046c3a17cef64c26e476b6097c2adebac131c866d612d559aefabbe
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
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 Jun 20, 2026.
Transparency logRelease files / eozin-0.1.0a2-cp38-abi3-musllinux_1_2_aarch64.whl
| Download URL | eozin-0.1.0a2-cp38-abi3-musllinux_1_2_aarch64.whl |
|---|---|
| Size | 535.6 kB |
| Tags | CPython 3.8 Linux musl 1.2+ ARM64 abi3 |
|
SHA-256 checksum How to use checksums |
53290d2f144e97e5ecfbcfd12863694af67ba3c555efc5c8e6a8468806185356
|
|
BLAKE2b-256 checksum How to use checksums |
6666e11796b82ece23ea9d8f7b7c7b6ac0ea6b9a236036374d3d4443cff4a15b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
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 Jun 20, 2026.
Transparency logRelease files / eozin-0.1.0a2-cp38-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
| Download URL | eozin-0.1.0a2-cp38-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl |
|---|---|
| Size | 364.0 kB |
| Tags | CPython 3.8 Linux glibc 2.17+ x86-64 abi3 |
|
SHA-256 checksum How to use checksums |
570c6eb07271723e7c850ffa25e1667b735805aaf434a0253769df366eb245c8
|
|
BLAKE2b-256 checksum How to use checksums |
24164cab186b7df3c548e4b17dff8ab7c14855e2406fe2c66181ed8c9e82ef32
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
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 Jun 20, 2026.
Transparency logRelease files / eozin-0.1.0a2-cp38-abi3-manylinux_2_17_s390x.manylinux2014_s390x.whl
| Download URL | eozin-0.1.0a2-cp38-abi3-manylinux_2_17_s390x.manylinux2014_s390x.whl |
|---|---|
| Size | 390.2 kB |
| Tags | CPython 3.8 Linux glibc 2.17+ IBM System/390x abi3 |
|
SHA-256 checksum How to use checksums |
563cf702b35041ff4d694924734510fb8ea2562a650e159323fa7f652326178b
|
|
BLAKE2b-256 checksum How to use checksums |
fb1782db340f65ea3928ad7f4f9d9814d30b67b5c5bdb052735ea6dc0e86ca20
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
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 Jun 20, 2026.
Transparency logRelease files / eozin-0.1.0a2-cp38-abi3-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl
| Download URL | eozin-0.1.0a2-cp38-abi3-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl |
|---|---|
| Size | 480.9 kB |
| Tags | CPython 3.8 Linux glibc 2.17+ PowerPC 64-le abi3 |
|
SHA-256 checksum How to use checksums |
49429e7f066c2fe68454158a794eba030e56c15090075dd134de07e84bdccb47
|
|
BLAKE2b-256 checksum How to use checksums |
4b0675deea3cf873a581069c1ee4be179c58d32ead089c32c367652ed791421f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
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 Jun 20, 2026.
Transparency logRelease files / eozin-0.1.0a2-cp38-abi3-manylinux_2_17_armv7l.manylinux2014_armv7l.whl
| Download URL | eozin-0.1.0a2-cp38-abi3-manylinux_2_17_armv7l.manylinux2014_armv7l.whl |
|---|---|
| Size | 366.5 kB |
| Tags | CPython 3.8 Linux glibc 2.17+ ARMv7l abi3 |
|
SHA-256 checksum How to use checksums |
b1e9705ae9bfe2ecaae762853ef322040eb4f7e0e7f6fe268c451f51e45ecb08
|
|
BLAKE2b-256 checksum How to use checksums |
1e311e8512cf3dc7d6791a8992bc849e1e0f3caea838d29c9e95ea8e4b7a9862
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
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 Jun 20, 2026.
Transparency logRelease files / eozin-0.1.0a2-cp38-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
| Download URL | eozin-0.1.0a2-cp38-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl |
|---|---|
| Size | 359.8 kB |
| Tags | CPython 3.8 Linux glibc 2.17+ ARM64 abi3 |
|
SHA-256 checksum How to use checksums |
72edbe8c732c64503e60480548505caa931be6233c3cfdb1fb01f31de1115b2e
|
|
BLAKE2b-256 checksum How to use checksums |
161dd53349e0ca04507da42b855ee28049a0a0a365bdf033943c67d9da4a7afe
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
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 Jun 20, 2026.
Transparency logRelease files / eozin-0.1.0a2-cp38-abi3-manylinux_2_5_i686.manylinux1_i686.whl
| Download URL | eozin-0.1.0a2-cp38-abi3-manylinux_2_5_i686.manylinux1_i686.whl |
|---|---|
| Size | 392.5 kB |
| Tags | CPython 3.8 Linux glibc 2.5+ x86-32 abi3 |
|
SHA-256 checksum How to use checksums |
906219952dce33ce9f071d6a4d8575d4fe4378bf61a08c4020f1fa107c0e73a6
|
|
BLAKE2b-256 checksum How to use checksums |
3d985f9a0a26dc4e4dee995236cd8b67c27deba76c290d0af17d75ee8a6da0c7
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
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 Jun 20, 2026.
Transparency logRelease files / eozin-0.1.0a2-cp38-abi3-macosx_11_0_arm64.whl
| Download URL | eozin-0.1.0a2-cp38-abi3-macosx_11_0_arm64.whl |
|---|---|
| Size | 323.3 kB |
| Tags | CPython 3.8 abi3 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
16d96589845cf92c8014a4d6c02c80070737d37feee3fa2014f836fa4d1d3ac5
|
|
BLAKE2b-256 checksum How to use checksums |
f726d3af80c94ed76301d4a5b5b89dedd92691796295844b905aa6834e7f9b39
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
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 Jun 20, 2026.
Transparency logRelease files / eozin-0.1.0a2-cp38-abi3-macosx_10_12_x86_64.whl
| Download URL | eozin-0.1.0a2-cp38-abi3-macosx_10_12_x86_64.whl |
|---|---|
| Size | 321.9 kB |
| Tags | CPython 3.8 abi3 macOS 10.12+ x86-64 |
|
SHA-256 checksum How to use checksums |
fcf83b2e2e4eec49574ae6b17810674f62afcc0ba53b994dd497e402332fc01f
|
|
BLAKE2b-256 checksum How to use checksums |
4ae257c359df7b8a0cff4c9aef49d31dbc71476eae6bb99e9bd98f25a87c4607
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
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 Jun 20, 2026.
Transparency log
