{"id":27904,"library":"large-image-source-deepzoom","title":"large-image-source-deepzoom","description":"A tilesource for large-image that reads deepzoom pyramid images. Currently at version 1.34.1, released as part of the large-image ecosystem. Released irregularly alongside the main large-image package.","status":"active","version":"1.34.1","language":"python","source_language":"en","source_url":"https://github.com/girder/large_image","tags":["large-image","deepzoom","tilesource","image-pyramid"],"install":[{"cmd":"pip install large-image-source-deepzoom","lang":"bash","label":"Install from PyPI"}],"dependencies":[{"reason":"Core framework; this module is a tile source plugin.","package":"large-image","optional":false},{"reason":"Image handling required by deepzoom.","package":"PIL","optional":false}],"imports":[{"note":"Correct module name uses underscores, not hyphens.","symbol":"DeepZoomFileTileSource","correct":"from large_image_source_deepzoom import DeepZoomFileTileSource"}],"quickstart":{"code":"from large_image_source_deepzoom import DeepZoomFileTileSource\nimport os\n\n# Replace with your deepzoom file path\nfile_path = os.environ.get('DEEPZOOM_FILE', 'path/to/image.dzi')\nts = DeepZoomFileTileSource(file_path)\nprint(f'Tile source metadata: {ts.getMetadata()}')","lang":"python","description":"Creates a DeepZoomFileTileSource from a .dzi file and prints metadata."},"warnings":[{"fix":"Use 'from large_image_source_deepzoom import DeepZoomFileTileSource'.","message":"The module name is 'large_image_source_deepzoom' (underscores), not 'large-image-source-deepzoom' (hyphens). Import errors occur when using hyphens.","severity":"gotcha","affected_versions":"all"},{"fix":"Ensure you provide a local file path string to the constructor.","message":"DeepZoomFileTileSource expects a file path, not a URL or bytes. Using invalid input causes cryptic errors.","severity":"gotcha","affected_versions":"all"},{"fix":"Keep up to date with the large-image package: pip install large-image large-image-source-deepzoom --upgrade","message":"The 'large_image_source_deepzoom' package is rarely updated independently; it follows large-image releases. Older versions may lack recent fixes.","severity":"deprecated","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":"Install with 'pip install large-image-source-deepzoom' and import as 'large_image_source_deepzoom'.","cause":"Attempting to import with hyphen instead of underscore, or package not installed.","error":"ModuleNotFoundError: No module named 'large_image_source_deepzoom'"},{"fix":"Verify that the file is a valid .dzi or .json deepzoom file. Use PIL or openslide to test if the file is corrupt.","cause":"File is not a valid deepzoom image (not DZI or incompatible format).","error":"large_image_source_deepzoom.open: error while reading the file: OSError: cannot identify image file"},{"fix":"Use 'getTile(tile_x, tile_y, z)' or check the large-image API for the correct method. Refer to large-image documentation.","cause":"Attempting to call getRegion on a tile source that uses getTile instead.","error":"AttributeError: 'DeepZoomFileTileSource' object has no attribute 'getRegion'"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}