Registry / web-framework / large-image-source-dicom

large-image-source-dicom

library1.34.1pypypi✓ verified 80d ago

A DICOM tilesource plugin for large_image, enabling tile-based access to DICOM WSI (Whole Slide Imaging) and other DICOM images. Version 1.34.1 supports Python >=3.10. Part of the girder/large_image ecosystem, releases follow the main large-image package cadence.

web-framework database data

pip install large-image-source-dicom

github ↗package ↗

INSTALL

IMPORT

SIG · LARGE-IMAGE-SOURCE

large-image-source-dicom

web-frameworkpythonv1.34.1

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

DICOMFileTileSource

✓ from large_image_source_dicom import DICOMFileTileSource

✗ from large_image_source_dicom import DicomFileTileSource

Demonstrates opening a DICOM file as a large_image tile source, retrieving metadata, and fetching a tile.

from large_image import open from large_image_source_dicom import DicomFileTileSource ts = open('path/to/dicom.dcm') print(f'Tile source type: {type(ts).__name__}') print(f'Metadata: {ts.getMetadata()}') # Get a tile _, tile = ts.getTile(0, 0, 0) print(f'Tile shape: {tile.shape}') # Generate a thumbnail thumbnail = ts.getThumbnail(region=dict(width=512, height=512)) print(f'Thumbnail size: {len(thumbnail)} bytes')

Debug

Known issues

gotchaThe DICOM source requires gdcm for compressed transfer syntaxes (e.g., JPEG2000). Without gdcm installed, some DICOM files may not decode.

fix

Install gdcm: pip install gdcm or conda install -c conda-forge gdcm

affects: all

gotchaDICOM tile source expects a valid DICOM file; it does not support DICOMDIR or multi-file series. Use large-image-source-dicom only for single DICOM instances.

fix

For multi-file series, consider using large-image-source-tiff or convert series to a pyramidal TIFF.

affects: all

breakingAs of large-image v1.34.0, the DICOM source may require Python >=3.10. Older Python versions are no longer supported.

fix

Upgrade Python to 3.10 or later.

affects: >=1.34.0

Upgrade

Version history

1.34.1latest on PyPI · released Mar 24, 2026

Audit

Dependencies

large-imagerequiredCore framework; must be installed with compatible version.

pydicomrequiredFor reading DICOM files.

gdcmoptionalFor DICOM image decoding (decompression).

Agent activity

2 hits · last 30 days

node

Resources

githubhttps://github.com/girder/large_image ↗

packagehttps://pypi.org/project/large-image-source-dicom/ ↗