large-image-source-test

1.34.1 verified Sat May 09 auth: no python

A fractal test tilesource for large_image. Provides a synthetic image source that generates fractal-like tiles for testing purposes. Part of the large_image ecosystem. Version 1.34.1, release cadence follows large_image releases (approximately monthly).

pip install large-image-source-test

Common errors

error ModuleNotFoundError: No module named 'large_image_source_test' ↓

cause The package is not installed or the import name is wrong.

fix

Install with 'pip install large-image-source-test' and import as 'large_image_source_test' (underscores not hyphens).

error AttributeError: module 'large_image_source_test' has no attribute 'TestTileSource' ↓

cause The class may have been renamed or not exposed in the module's top-level.

fix

Check the module contents with 'dir(large_image_source_test)' and use the correct class name (e.g., 'from large_image_source_test import TestTileSource').

error TypeError: __init__() got an unexpected keyword argument 'tileWidth' ↓

cause Constructor parameters may differ from version to version; 'tileWidth' might be 'tile_width'.

fix

Use keyword arguments as per documentation: e.g., TestTileSource(tileWidth=256) – check the source for exact parameter names.

Warnings

gotcha The test source generates fractal images, not real microscopy or satellite imagery. It is for testing only. ↓

fix Use large-image-source-* for actual image formats.

deprecated This source may not support all features of tilesources (e.g., metadata, region extraction). Check your feature compatibility. ↓

fix For a full-featured test, consider large-image-source-rgb8.

gotcha The source does not require any image files; it generates tiles on the fly. Do not expect it to read from disk. ↓

fix Use large-image-source-tiff or large-image-source-openslide for file-based sources.

Imports

TestTileSource

from large_image_source_test import TestTileSource

Direct import from source module.

Quickstart

Create a test tilesource and fetch the top-left tile at zoom 0.

from large_image_source_test import TestTileSource

source = TestTileSource(tileWidth=256, tileHeight=256)
tile = source.getTile(0, 0, 0)
print('Tile shape:', tile.shape)