large-image-source-tifffile

1.34.1 verified Sat May 09 auth: no python

A tifffile tilesource for large_image. Current version is 1.34.1. Release cadence is irregular but typically multiple minor releases per year, with patches as needed.

pip install large-image-source-tifffile

Common errors

error ModuleNotFoundError: No module named 'large_image_source_tifffile' ↓

cause The package is not installed or installed under a different name.

fix

Install correctly: pip install large-image-source-tifffile

error ImportError: cannot import name 'TiffFileTileSource' from 'large_image_source_tifffile' ↓

cause Incorrect class name or outdated version.

fix

Use the correct class: from large_image_source_tifffile import TiffFileTileSource

Warnings

gotcha The package requires large_image to be installed; using this source without it will cause import errors. ↓

fix Install large-image alongside: pip install large-image large-image-source-tifffile

deprecated Python 3.9 support was dropped; requires Python >=3.10. ↓

fix Upgrade your Python environment to 3.10 or newer.

gotcha The source is case-sensitive: use large_image_source_tifffile, not large-image-source-tifffile. ↓

fix Use underscores in imports: from large_image_source_tifffile import ...

Imports

TiffFileTileSource

wrong

from large_image.tilesource import TiffFileTileSource

correct

from large_image_source_tifffile import TiffFileTileSource

The tilesource module is in a separate package; using large_image.tilesource will fail.

Quickstart

Basic usage of TiffFileTileSource to get metadata and a tile from a TIFF file.

from large_image_source_tifffile import TiffFileTileSource
import os

# Path to a TIFF file
file_path = os.environ.get('TIFF_PATH', '')
ts = TiffFileTileSource(file_path)

# Get metadata
metadata = ts.getMetadata()
print(metadata)

# Get a tile at level 0, x=0, y=0
import base64
tile = ts.getTile(0, 0, 0)
print(type(tile))  # bytes, PNG image