girder_large_image.models package¶
Submodules¶
girder_large_image.models.image_item module¶
- class girder_large_image.models.image_item.ImageItem(*args, **kwargs)[source]¶
Bases:
Item
- createImageItem(item, fileObj, user=None, token=None, createJob=True, notify=False, **kwargs)[source]¶
- getAssociatedImage(item, imageKey, checkAndCreate=False, *args, **kwargs)[source]¶
Return an associated image.
- Parameters
item – the item with the tile source.
imageKey – the key of the associated image to retrieve.
kwargs – optional arguments. Some options are width, height, encoding, jpegQuality, jpegSubsampling, and tiffCompression.
- Returns
imageData, imageMime: the image data and the mime type, or None if the associated image doesn’t exist.
- getAssociatedImagesList(item, **kwargs)[source]¶
Return a list of associated images.
- Parameters
item – the item with the tile source.
- Returns
a list of keys of associated images.
- getBandInformation(item, statistics=True, **kwargs)[source]¶
Using a tile source, get band information of the image.
- Parameters
item – the item with the tile source.
kwargs – optional arguments. See the tilesource getBandInformation method.
- Returns
band information.
- getPixel(item, **kwargs)[source]¶
Using a tile source, get a single pixel from the image.
- Parameters
item – the item with the tile source.
kwargs – optional arguments. Some options are left, top.
- Returns
a dictionary of the color channel values, possibly with additional information
- getRegion(item, **kwargs)[source]¶
Using a tile source, get an arbitrary region of the image, optionally scaling the results. Aspect ratio is preserved.
- Parameters
item – the item with the tile source.
kwargs – optional arguments. Some options are left, top, right, bottom, regionWidth, regionHeight, units, width, height, encoding, jpegQuality, jpegSubsampling, and tiffCompression. This is also passed to the tile source.
- Returns
regionData, regionMime: the image data and the mime type.
- getThumbnail(item, checkAndCreate=False, width=None, height=None, **kwargs)[source]¶
Using a tile source, get a basic thumbnail. Aspect ratio is preserved. If neither width nor height is given, a default value is used. If both are given, the thumbnail will be no larger than either size.
- Parameters
item – the item with the tile source.
checkAndCreate – if the thumbnail is already cached, just return True. If it does not, create, cache, and return it. If ‘nosave’, return values from the cache, but do not store new results in the cache.
width – maximum width in pixels.
height – maximum height in pixels.
kwargs – optional arguments. Some options are encoding, jpegQuality, jpegSubsampling, tiffCompression, fill. This is also passed to the tile source.
- Returns
thumbData, thumbMime: the image data and the mime type OR a generator which will yield a file.
- histogram(item, **kwargs)[source]¶
Using a tile source, get a histogram of the image.
- Parameters
item – the item with the tile source.
kwargs – optional arguments. See the tilesource histogram method.
- Returns
histogram object.
- initialize()[source]¶
Subclasses should override this and set the name of the collection as self.name. Also, they should set any indexed fields that they require.
- removeThumbnailFiles(item, keep=0, sort=None, imageKey=None, **kwargs)[source]¶
Remove all large image thumbnails from an item.
- Parameters
item – the item that owns the thumbnails.
keep – keep this many entries.
sort – the sort method used. The first (keep) records in this sort order are kept.
imageKey – None for the basic thumbnail, otherwise an associated imageKey.
kwargs – additional parameters to determine which files to remove.
- Returns
a tuple of (the number of files before removal, the number of files removed).
- tileFrames(item, checkAndCreate='nosave', **kwargs)[source]¶
Given the parameters for getRegion, plus a list of frames and the number of frames across, make a larger image composed of a region from each listed frame composited together.
- Parameters
item – the item with the tile source.
checkAndCreate – if False, use the cache. If True and the result is already cached, just return True. If it does not, create, cache, and return it. If ‘nosave’, return values from the cache, but do not store new results in the cache.
kwargs – optional arguments. Some options are left, top, right, bottom, regionWidth, regionHeight, units, width, height, encoding, jpegQuality, jpegSubsampling, and tiffCompression. This is also passed to the tile source. These also include frameList and framesAcross.
- Returns
regionData, regionMime: the image data and the mime type.