{"id":27916,"library":"large-image-source-vips","title":"large-image-source-vips","description":"A libvips tile source for the large-image framework, enabling efficient reading and tiling of large images using the libvips library. Current version 1.34.1, with a cadence of several minor releases per year.","status":"active","version":"1.34.1","language":"python","source_language":"en","source_url":"https://github.com/girder/large_image","tags":["large-image","tilesource","vips","pyvips","image-tiling"],"install":[{"cmd":"pip install large-image-source-vips","lang":"bash","label":"Install from PyPI"}],"dependencies":[{"reason":"Core framework required; source modules are loaded via large-image's plugin system.","package":"large-image","optional":false},{"reason":"Python bindings for libvips, required for image processing.","package":"pyvips","optional":false}],"imports":[{"note":"Direct module import doesn't register the source; you must use the class or rely on large_image's autoload.","wrong":"import large_image_source_vips","symbol":"VipsTileSource","correct":"from large_image_source_vips import VipsTileSource"}],"quickstart":{"code":"from large_image_source_vips import VipsTileSource\nfrom large_image import getTileSource\n# Open an image file\nts = getTileSource('path/to/image.tif')\nprint(ts.getMetadata())\n# Get a tile (256x256 pixels at zoom level 0)\ntile = ts.getTile(0, 0, 0)\nprint(tile.shape)","lang":"python","description":"Opens an image using the Vips tile source and prints metadata and a tile shape."},"warnings":[{"fix":"Run 'pip install large-image-source-vips' and import the source class explicitly.","message":"The source module must be imported or installed for large_image to discover it; use 'from large_image_source_vips import VipsTileSource' or ensure it's in an installed package.","severity":"gotcha","affected_versions":"all"},{"fix":"Install libvips using your system package manager (e.g., 'apt install libvips' on Ubuntu, 'brew install vips' on macOS).","message":"libvips must be installed system-wide (e.g., via apt, brew, or conda) separately from the Python bindings.","severity":"gotcha","affected_versions":"all"},{"fix":"Use Python 3.10 or later.","message":"Support for Python <3.10 was dropped in v1.34.0.","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":"Run 'pip install large-image-source-vips'.","cause":"The package is not installed.","error":"ModuleNotFoundError: No module named 'large_image_source_vips'"},{"fix":"Add 'from large_image_source_vips import VipsTileSource' before using getTileSource, and ensure libvips is installed.","cause":"The Vips tile source is not registered; you may have forgotten to import the module or libvips is missing.","error":"ValueError: No tile source found for file"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}