Image Formats

Preferred Extensions and Mime Types

Images can generally be read regardless of their name. By default, when opening an image with large_image.open(), each tile source reader is tried in turn until one source can open the file. Each source lists preferred file extensions and mime types with a priority level. If the file ends with one of these extensions or has one of these mimetypes, the order that the source readers are tried is adjusted based on the specified priority.

The file extensions and mime types that are listed by the core sources that can affect source processing order are listed below. See large_image.listSources() for details about priority of the different sources and the large_image.constants.SourcePriority for the priority meaning.

The following table describes the some of the formats supported by large-image and the common extensions for each format. This table also describes the large-image-source-* modules that can be used to read each format.

For a list of known mime types, see Mime Types (45). For a list of known extensions, see Extensions (342).

Common Formats

Format	Extension(s)	Tile Source	Multiframe	Geospatial	Writeable	Associated Images	Example File
TIFF 🔗	tiff, tif, ptif, ptiff, qptiff	tiff, tifffile	True	False	False	True	Download
TIFF 🔗	tiff, tif, ptif, ptiff, qptiff	openslide	False	False	False	True	Download
TIFF 🔗	tiff, tif, ptif, ptiff, qptiff	vips	True	False	True	False	Download
TIFF 🔗	tiff, tif, ptif, ptiff, qptiff	pil	True	False	False	False	Download
TIFF 🔗	tiff, tif, ptif, ptiff, qptiff	gdal, rasterio, mapnik	False	True	False	False	Download
SVS 🔗	svs, svslide	openslide	False	False	False	True	Download
SVS 🔗	svs, svslide	tiff, tifffile, bioformats	Unknown	False	False	True	Download
SVS 🔗	svs, svslide	gdal, rasterio, mapnik	Unknown	True	False	False	Download
OME-TIFF 🔗	ome.tiff, ome.tif, ome	ometiff	True	False	False	True	Download
OME-TIFF 🔗	ome.tiff, ome.tif, ome	vips	True	False	True	False	Download
OME-TIFF 🔗	ome.tiff, ome.tif, ome	pil	True	False	False	False	Download
OME-TIFF 🔗	ome.tiff, ome.tif, ome	gdal, rasterio, mapnik	False	True	False	False	Download
Zarr 🔗	zarr, zarray, zattrs, zgroup, zip, db, sqlite	zarr	True	False	True	True	Download
Zarr 🔗	zarr, zarray, zattrs, zgroup, zip, db, sqlite	zarr	True	False	True	True	Download
ND2 🔗	nd2	nd2	True	False	False	False	Download
CZI 🔗	czi	bioformats	True	False	False	True	Download
DICOM 🔗	dcm, dic, dicom	bioformats	True	False	False	True	Download
LIF 🔗	lif, liff	bioformats	True	False	False	True	Download
PNG 🔗	png	pil	True	False	False	False	Download
JPEG 🔗	jpeg, jpe, jpg	pil	Unknown	False	False	False	Download
JPEG 🔗	jpeg, jpe, jpg	vips	Unknown	False	True	False	Download
JPEG 🔗	jpeg, jpe, jpg	gdal, rasterio, mapnik	Unknown	True	False	False	Download
JPEG 2000 🔗	j2c, j2k, jp2, jpf, jpx	gdal, rasterio, mapnik	Unknown	True	False	False	Download
JPEG 2000 🔗	j2c, j2k, jp2, jpf, jpx	openjpeg	False	False	False	True	Download
JPEG 2000 🔗	j2c, j2k, jp2, jpf, jpx	vips	Unknown	False	True	False	Download
JPEG 2000 🔗	j2c, j2k, jp2, jpf, jpx	pil	Unknown	False	False	False	Download
JPEG 2000 🔗	j2c, j2k, jp2, jpf, jpx	bioformats	Unknown	False	False	True	Download
GIF 🔗	gif	vips	True	False	True	False	Download
GIF 🔗	gif	pil	True	False	False	False	Download
GIF 🔗	gif	bioformats	True	False	False	True	Download
GIF 🔗	gif	gdal, rasterio, mapnik	False	True	False	False	Download
Bitmap 🔗	bmp	pil	Unknown	False	False	False	Download
Bitmap 🔗	bmp	bioformats	Unknown	False	False	True	Download
Bitmap 🔗	bmp	gdal, rasterio, mapnik	Unknown	True	False	False	Download

Mime Types (45)

application/dicom, application/json, application/pdf, application/postscript, application/vnd+zarr, application/x-zarr, application/yaml, application/zip+zarr, image/avif, image/bmp, image/czi, image/geotiff, image/gif, image/heic, image/heif, image/icns, image/j2c, image/jls, image/jp2, image/jpeg, image/jpx, image/jxl, image/mirax, image/mpo, image/nd2, image/palm, image/png, image/rgb, image/scn, image/sgi, image/tiff, image/vnd.adobe.photoshop, image/vsi, image/webp, image/x-icon, image/x-pcx, image/x-portable-anymap, image/x-ptif, image/x-tga, image/x-tiff, image/x-xpixmap, image/xbm, image/xpm, text/yaml, video/mpeg

Extensions (342)

1sc, 2fl, ace2, acff, afi, afm, aim, al3d, ali, am, amiramesh, apl, apng, arf, asc, avi, avif, avs, b, bag, bif, bil, bin, bip, blp, blx, bmp, bt, btf, bufr, bw, byn, c01, cal, cfg, ch5, cif, cr2, crw, csv, ct1, cub, cur, cxd, czi, dat, db, dcm, dcx, ddf, dds, dem, dib, dic, dicom, dm2, dm3, dm4, dt0, dt1, dt2, dti, dv, dwg, dz, dzc, dzi, eer, emf, eps, epsi, err, ers, ets, exp, exr, fdf, fff, ffr, fit, fits, flc, flex, fli, frm, ftc, ftu, gbr, gdb, gel, gen, geotiff, gff, gif, gpkg, gpkg.zip, grb, grb2, grc, grd, grey, grib, grib2, gsb, gta, gti, gti.fgb, gti.gpkg, gtx, gvb, gxf, h5, hdf, hdf5, hdr, hdr.gz, hed, heic, heics, heif, heifs, hf2, hgt, hif, his, htd, html, hx, i2i, icb, icns, ico, ics, ids, iim, im, im3, img, img.gz, ims, ini, inr, ipl, ipm, ipw, isg, j2c, j2k, jfif, jls, jp2, jpc, jpe, jpeg, jpf, jpg, jpk, jpls, jpt, jpx, json, jxl, kap, kea, klb, kml, kmz, kro, l2d, labels, lbl, lcp, lei, lif, liff, lim, lms, lsm, map, mat, mbtiles, mdb, mea, mem, mnc, mng, mod, mov, mpeg, mpg, mpl, mpo, mpr, mrc, mrcs, mrf, mrw, mrxs, msp, msr, mtb, mvd2, n1, naf, nat, nc, nd, nd2, ndpi, ndpis, nef, nhdr, nia, nia.gz, nii, nii.gz, nitf, nrrd, ntf, obf, obsep, oib, oif, oir, ome, ome.btf, ome.tf2, ome.tf8, ome.tif, ome.tiff, ome.xml, palm, par, pbm, pcd, pcoraw, pcx, pdf, pds, pfm, pgm, pic, pict, pix, png, pnl, pnm, ppi, ppm, pr3, prf, ps, psd, ptif, ptiff, pxr, qoi, qpi, qptiff, r3d, ras, raw, rcpnl, rda, rec, res, rgb, rgba, rik, rst, rsw, scn, sdat, sdt, seq, sg-grd-z, sgi, sid, sif, sigdem, sld, sm2, sm3, spc, spe, spi, sqlite, st, stk, stp, svs, svslide, sxm, szi, tc, ter, tf2, tf8, tfr, tga, tif, tiff, tnb, toc, top, tpkx, txt, v, vda, vff, vips, vms, vmu, vrt, vsi, vst, vws, wat, webp, wlz, wmf, wpi, xbm, xdce, xml, xpm, xqd, xqf, xv, xys, xyz, yaml, yml, zarr, zarray, zattrs, zfp, zfr, zgroup, zif, zip, zvi