EpistaBase Docs
SDK

Image reads

Read thumbnails, bounded image regions, and annotations through governed image access.

guideReviewed 2026-06-26

Use the optional image extra when notebooks need arrays or thumbnails:

pip install "epistabase[image]"

Then read through biolake.image:

import biolake as bl

img = bl.assets(kind="IMAGE")[0]

info = bl.image.info(img)
thumbnail = bl.image.thumbnail(img, max_px=1024)
region = bl.image.read_region(img, 0, 0, 2048, 2048, level=2, channels=["DAPI"])
rois = bl.image.annotations(img)

Why this is separate from open()

Whole-slide and pyramidal microscopy data should not be loaded as one raw blob for normal inspection. Image reads go through catalog and tile/session APIs that can serve bounded regions and enforce access controls.

Use bl.open() for whole raw blobs. Use biolake.image for tiled or pyramidal images.

On this page