cgohlke/tifffile: v2026.5.2

Read and write TIFF files

Tifffile is a comprehensive Python library to

1. store NumPy arrays in TIFF (Tagged Image File Format) files, and
2. read image and metadata from TIFF-like files used in bioimaging.

Image and metadata can be read from TIFF, BigTIFF, OME-TIFF, GeoTIFF, Adobe DNG, ZIF (Zoomable Image File Format), MetaMorph STK, Zeiss LSM, ImageJ hyperstack, Micro-Manager MMStack and NDTiff, SGI, NIHImage, Olympus FluoView and SIS, ScanImage, Molecular Dynamics GEL, Aperio SVS, Leica SCN, Roche BIF, PerkinElmer QPTIFF (QPI, PKI), Hamamatsu NDPI, Argos AVS, Philips DP, and ThermoFisher EER formatted files.

Image data can be read as NumPy arrays or Zarr arrays/groups from strips, tiles, pages (IFDs), SubIFDs, higher order series, and pyramidal levels.

Image data can be written to TIFF, BigTIFF, OME-TIFF, and ImageJ hyperstack compatible files in multi-page, volumetric, pyramidal, memory-mappable, tiled, predicted, or compressed form.

Many compression and predictor schemes are supported via the imagecodecs library, including LZW, PackBits, Deflate, CCITT, PIXTIFF, LZMA, LERC, Zstd, JPEG (8 and 12-bit, lossless), JPEG 2000, JPEG XR, JPEG XL, WebP, PNG, EER, Jetraw, 24-bit floating-point, and horizontal differencing.

Tifffile can also be used to inspect TIFF structures, read image data from multi-dimensional file sequences, write fsspec ReferenceFileSystem for TIFF files and image file sequences, patch TIFF tag values, and parse many proprietary metadata formats.

Changes

• Change TiffFile.series from list to callable TiffSeries sequence (breaking).
• Remove TiffPageSeries squeeze dual-state (breaking).
• Remove TiffPageSeries.get_shape, get_axes, and get_coords (breaking).
• Remove ZarrTiffStore squeeze parameter (breaking).
• Update ZarrTiffStore to zarr format 3 and multiscales to NGFF 0.5 (breaking).
• Update multiscales zarr format 2 fsspec files to NGFF 0.4 (breaking).
• Remove generic TiffPage coords (breaking).
• Change dims and sizes to use single-char axis codes (breaking).
• Add zarr format 3 compatible Tiff codec.
• Add asxarray methods to TiffFile, TiffPage, TiffPageSeries (requires xarray).
• Add geotiff kind of TiffPageSeries.
• Add mpp and coord_offsets/scales/units properties to TiffPageSeries.
• Add attrs property to TiffPage and TiffPageSeries.
• Add kind and squeeze parameters to memmap.
• Add kind parameter to imwrite and TiffFile; deprecate ome, imagej, shaped.
• Add return_as parameter to imread; deprecate aszarr.
• Fix writing TIFF trees (#326).
• Fix wrong TiffTagRegistry entries (#323).
• Implement TiffPageSeries.coords property.
• Deprecate kwargs to FileSequence.asarray; use imreadargs.
• Require zarr>=3.2.0 for zarr support.
• Drop support for numpy 2.0 (SPEC0, #324).