napari.utils¶

Classes

`Colormap`	Colormap that relates intensity values to colors.
`nbscreenshot`	alias of `napari.utils.notebook_display.NotebookScreenshot`
`cancelable_progress`	This class inherits from progress, providing the additional ability to cancel expensive executions.
`progress`	This class inherits from tqdm and provides an interface for progress bars in the napari viewer.

Functions

napari.utils.resize_dask_cache(nbytes: Optional[int] = None, mem_fraction: Optional[float] = None) → dask.cache.Cache[source]¶

Create or resize the dask cache used for opportunistic caching.

The cache object is an instance of a Cache, (which wraps a cachey.Cache).

Parameters

nbytes (int, optional) – The desired size of the cache, in bytes. If None, the cache size will autodetermined as fraction of the total memory in the system, using mem_fraction. If nbytes is 0. The cache is turned off. by default, cache size is autodetermined using mem_fraction.
mem_fraction (float, optional) – The fraction (from 0 to 1) of total memory to use for the dask cache.

Returns

dask_cache – An instance of a Dask Cache

Return type

dask.cache.Cache

Examples

>>> from napari.utils import resize_dask_cache
>>> cache = resize_dask_cache()  # use 25% of total memory by default

>>> # dask.Cache wraps cachey.Cache
>>> assert isinstance(cache.cache, cachey.Cache)

>>> # useful attributes
>>> cache.cache.available_bytes  # full size of cache
>>> cache.cache.total_bytes   # currently used bytes

napari.utils.sys_info(as_html=False)[source]¶

Gathers relevant module versions for troubleshooting purposes.

Parameters: as_html (bool) – if True, info will be returned as HTML, suitable for a QTextEdit widget

napari.utils.progrange(*args, **kwargs)[source]¶

Shorthand for progress(range(*args), **kwargs).

Adds tqdm based progress bar to napari viewer, if it exists, and returns the wrapped range object.

napari.types.ArrayBase

napari.utils.Colormap