Supported Formats

June 8, 2026 ยท View on GitHub

ASlide resolves formats through Aslide.registry.build_default_registry(). Some entries are selected purely by extension, while others use probes to distinguish multiplex containers from generic formats.

Capability Matrix

Format IDExtensionsSlide familyBackend/dependencyDeepZoomBiomarkersAssociated imagesLabel imageColor correctionBootstrap/native libs
czi.cziruntime-classifiedpylibCZIrw, Bio-Formats, or czifileBackend-dependentRuntime-dependentNo static supportNoNoOptional reader extra
ome_tiff.tif, .tiffmultiplextifffile probe-selected OME-like TIFFYesYesNoNoNoNo
mcd.mcdmultiplexreadimcNoYesNoNoNoNo
hdf5.h5, .hdf5, .h5admultiplexh5py, image-backed raster probeNoYesNoNoNoNo
ims.imsmultiplexh5py, IMS probeYesYesNoNoNoNo
qptiff.qptiffruntime-classifiedqptifffileYesYes for multiplexNoNoNoNo
kfb.kfbbrightfieldbundled KFB native SDKYesNoYesYesYesYes
tmap.tmapbrightfieldbundled TMAP native SDKYesNoYesYesYesYes
sdpc.sdpc, .dyqxbrightfieldbundled SDPC native SDKYesNoYesYesYesYes
vsi.vsibrightfieldBio-Formats and JavaBackend-dependentNoBackend-dependentNoNoBio-Formats extra
mds.mds, .mdsxbrightfieldnative MDS readerYesNoYesBackend-dependentYesNo
tron.tronbrightfieldbundled TRON native SDKYesNoYesNoNoYes
isyntax.isyntaxbrightfieldpyisyntaxYesNoYesNoNoNo
dyj.dyjbrightfieldnative DYJ readerYesNoBackend-dependentNoYesNo
ibl.iblbrightfieldnative iBL readerYesNoBackend-dependentNoNoNo
zyp.zypbrightfieldnative ZYP readerYesNoBackend-dependentNoNoNo
bif.bifbrightfieldBIF/OpenSlide-compatible readerYesNoBackend-dependentNoNoNo
openslide.svs, .svslide, .ndpi, .vms, .vmu, .scn, .mrxsbrightfieldOpenSlideYesNoYesBackend-dependentNoOpenSlide libraries
generic_tiff.tif, .tiffbrightfieldgeneric TIFF readerNoNoNoNoNoNo

Extension and Probe Notes

.tif and .tiff are shared by ome_tiff and generic_tiff. ASlide probes for an OME-like multiplex TIFF first. If the probe does not match, the file falls back to generic TIFF behavior.

.h5, .hdf5, and .h5ad are only supported when the container exposes image-backed channel data. Table-only AnnData files are not reconstructed into slide images.

.sdpc and .dyqx share the SDPC backend.

Runtime-Classified Formats

QPTIFF and CZI are resolved by extension but classified semantically after opening. A brightfield file supports read_region(). A multiplex file supports list_biomarkers() and read_biomarker_region().

Optional Dependencies

VSI and the Bio-Formats CZI path require python-bioformats, python-javabridge, and a working Java runtime. The lightweight CZI path uses the czi extra. Native SDK formats may require setup_runtime_environment() when shared libraries are not found automatically.