{"id":27905,"library":"large-image-source-dicom","title":"large-image-source-dicom","description":"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.","status":"active","version":"1.34.1","language":"python","source_language":"en","source_url":"https://github.com/girder/large_image","tags":["dicom","whole-slide-imaging","large-image","tile-source","pyramid"],"install":[{"cmd":"pip install large-image-source-dicom","lang":"bash","label":"Install from PyPI"}],"dependencies":[{"reason":"Core framework; must be installed with compatible version.","package":"large-image","optional":false},{"reason":"For reading DICOM files.","package":"pydicom","optional":false},{"reason":"For DICOM image decoding (decompression).","package":"gdcm","optional":true}],"imports":[{"note":"The correct import path from the plugin.","symbol":"DicomFileTileSource","correct":"from large_image_source_dicom import DicomFileTileSource"},{"note":"The open function is provided by large_image, not the DICOM source directly.","wrong":"from large_image_source_dicom import open","symbol":"open","correct":"from large_image import open"}],"quickstart":{"code":"from large_image import open\nfrom large_image_source_dicom import DicomFileTileSource\n\nts = open('path/to/dicom.dcm')\nprint(f'Tile source type: {type(ts).__name__}')\nprint(f'Metadata: {ts.getMetadata()}')\n# Get a tile\n_, tile = ts.getTile(0, 0, 0)\nprint(f'Tile shape: {tile.shape}')\n# Generate a thumbnail\nthumbnail = ts.getThumbnail(region=dict(width=512, height=512))\nprint(f'Thumbnail size: {len(thumbnail)} bytes')","lang":"python","description":"Demonstrates opening a DICOM file as a large_image tile source, retrieving metadata, and fetching a tile."},"warnings":[{"fix":"Install gdcm: pip install gdcm or conda install -c conda-forge gdcm","message":"The DICOM source requires gdcm for compressed transfer syntaxes (e.g., JPEG2000). Without gdcm installed, some DICOM files may not decode.","severity":"gotcha","affected_versions":"all"},{"fix":"For multi-file series, consider using large-image-source-tiff or convert series to a pyramidal TIFF.","message":"DICOM 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.","severity":"gotcha","affected_versions":"all"},{"fix":"Upgrade Python to 3.10 or later.","message":"As of large-image v1.34.0, the DICOM source may require Python >=3.10. Older Python versions are no longer supported.","severity":"breaking","affected_versions":">=1.34.0"}],"env_vars":null,"last_verified":"2026-05-09T00:00:00.000Z","next_check":"2026-08-07T00:00:00.000Z","problems":[{"fix":"Run: pip install large-image-source-dicom","cause":"Package not installed or installed in wrong environment.","error":"ModuleNotFoundError: No module named 'large_image_source_dicom'"},{"fix":"Verify the file is a valid DICOM instance (not DICOMDIR). Ensure gdcm is installed if needed.","cause":"The DICOM file could not be recognized as a supported format (e.g., missing DICOM metadata or unsupported encoding).","error":"RuntimeError: No tilesource found for this file"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}