{"id":27909,"library":"large-image-source-ometiff","title":"large-image-source-ometiff","description":"An OMETiff tilesource for large_image, a Python framework for reading and serving large multiresolution images. Version 1.34.1 supports Python >=3.10, releases monthly via the girder/large_image monorepo.","status":"active","version":"1.34.1","language":"python","source_language":"en","source_url":"https://github.com/girder/large_image","tags":["large-image","ometiff","tilesource","bioimaging","tiff"],"install":[{"cmd":"pip install large-image-source-ometiff","lang":"bash","label":"Install from PyPI"}],"dependencies":[{"reason":"Core framework; source plugins depend on it.","package":"large-image","optional":false},{"reason":"Used for reading OME-TIFF files.","package":"tifffile","optional":false},{"reason":"Optional for serving images via Girder (versions <5).","package":"girder","optional":true}],"imports":[{"note":"Source classes are exported from their own package, not the top-level large_image module.","wrong":"from large_image import OMETiffGirderTileSource","symbol":"OMETiffGirderTileSource","correct":"from large_image_source_ometiff import OMETiffGirderTileSource"}],"quickstart":{"code":"from large_image_source_ometiff import OMETiffGirderTileSource\nfrom large_image import getTileSource\n\n# Open an OME-TIFF file\nts = getTileSource('path/to/image.ome.tif')\ntile = ts.getTile(0, 0, format='PNG')  # fetch tile at level 0, position (0,0)\nprint(tile[:10])  # raw bytes preview","lang":"python","description":"Basic usage: open an OME-TIFF file and get a tile."},"warnings":[{"fix":"Use `import large_image_source_ometiff` or `from large_image_source_ometiff import ...`","message":"The package name uses underscores in imports (large_image_source_ometiff), not hyphens.","severity":"gotcha","affected_versions":"all"},{"fix":"Use the standalone large-image framework without Girder, or migrate to Girder 5+ if needed.","message":"Girder integration is deprecated. Girder versions <5 are supported, but future releases may drop support.","severity":"deprecated","affected_versions":">=1.34.0"},{"fix":"Upgrade to Python 3.10 or later.","message":"Python 3.10 is the minimum required version starting from v1.34.0.","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-ometiff` and ensure you're using the correct Python environment.","cause":"Installed the wrong package or forgot to install the source plugin.","error":"ModuleNotFoundError: No module named 'large_image_source_ometiff'"},{"fix":"Use `from large_image_source_ometiff import OMETiffGirderTileSource`.","cause":"Attempting to import the class from the top-level `large_image` package.","error":"AttributeError: module 'large_image' has no attribute 'OMETiffGirderTileSource'"},{"fix":"Verify the file is a valid OME-TIFF and install large-image-source-ometiff: `pip install large-image-source-ometiff`.","cause":"The file is not recognized as a valid OME-TIFF or the source plugin is not installed.","error":"large_image.common.TileSourceException: No available tile source for 'file.ome.tif'"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}