A Python library for working with iSyntax file format images
MIT License
A Python library for working with pathology images in the iSyntax file format, powered by libisyntax.
$ pip install pyisyntax
Read and display a region of the WSI via Pillow.
from isyntax import ISyntax
import PIL.Image
with ISyntax.open("my_file.isyntax") as isyntax:
# Read pixels from the specified region into a numpy array
pixels = isyntax.read_region(500, 500, 400, 200, level=4)
# Convert numpy array into a PIL image
pil_image = PIL.Image.fromarray(pixels)
# Show the image
pil_image.show()
Extract and save the associated macro image.
from isyntax import ISyntax
with ISyntax.open("my_file.isyntax") as isyntax:
# The macro image will be returned as compressed JPEG data.
jpeg_data = isyntax.read_macro_image_jpeg()
# This JPEG data can be written directly to a file.
with open("macro_image.jpg", "wb") as f:
f.write(jpeg_data)
# Alternatively, you could decompress the data using Pillow:
# pil_image = PIL.Image.open(io.BytesIO(jpeg_data), formats=["JPEG"])
To set up a development environment from the lock file:
$ micromamba create -n pyisyntax -f conda-lock.yml --category main --category dev
$ micromamba activate pyisyntax
To modify pyisyntax project dependencies:
$ conda-lock lock -f pyproject.toml -p linux-64 --micromamba