erlab.interactive.colors

Functions for manipulating colors in Qt.

Functions

color_to_QColor(c[, alpha])	Convert a matplotlib color to a PySide6.QtGui.QColor.
pg_colormap_from_name(name[, skipCache, ...])	Get a pyqtgraph.ColorMap from its name.
pg_colormap_names([source, exclude_local])	Get all valid pyqtgraph colormap names.
pg_colormap_powernorm(cmap, gamma[, ...])
pg_colormap_to_QPixmap(cmap[, w, h, skipCache])	Convert a pyqtgraph.ColorMap to a w-by-h QPixmap thumbnail.

Classes

BetterColorBarItem([parent, image, ...])
BetterImageItem([image])	pyqtgraph.ImageItem with improved colormap support.
ColorMapComboBox(*args, **kwargs)
ColorMapGammaWidget([parent, value, ...])	Slider and spinbox for adjusting colormap gamma.

class erlab.interactive.colors.BetterColorBarItem(parent=None, image=None, autoLevels=False, limits=None, pen='c', hoverPen='m', hoverBrush='#FFFFFF33', **kargs)

Bases: PlotItem

property images

property primary_image

property levels: Sequence[float]

property limits: tuple[float, float]

set_width(width)

set_dimensions(horiz_pad=None, vert_pad=None, font_size=11.0)

level_change()

level_change_fin()

spanRegion()

setSpanRegion(levels)

setLimits(limits)

addImage(image)

removeImage(image)

setImageItem(image, insert_in=None)

image_level_changed()

image_changed()

reset_levels()

setAutoLevels(value)

color_changed()

limit_changed()

mouseDragEvent(ev)

class erlab.interactive.colors.BetterImageItem(image=None, **kwargs)

Bases: ImageItem

pyqtgraph.ImageItem with improved colormap support.

Parameters:

• image (ndarray[tuple[int, ...], dtype[TypeVar(_ScalarType_co, bound= generic, covariant=True)]] | None, default: None) – Image data

• **kwargs – Additional arguments to pyqtgraph.ImageItem.

Signals:

• sigColorChanged()

• sigLimitChanged(float, float)

set_colormap(cmap, gamma, reverse=False, high_contrast=False, zero_centered=False, update=True)

set_pg_colormap(cmap, update=True)

class erlab.interactive.colors.ColorMapComboBox(*args, **kwargs)

Bases: QComboBox

load_thumbnail(index)

load_all()

showPopup()

setPopupMinimumWidthForItems()

hidePopup()

setDefaultCmap(cmap)

resetCmap()

class erlab.interactive.colors.ColorMapGammaWidget(parent=None, value=1.0, slider_cls=None, spin_cls=None)

Bases: QWidget

Slider and spinbox for adjusting colormap gamma.

Signals:

valueChanged(float)

value()

setValue(value)

spin_changed(value)

slider_changed(value)

gamma_scale(y)

gamma_scale_inv(x)

erlab.interactive.colors.color_to_QColor(c, alpha=None)

Convert a matplotlib color to a PySide6.QtGui.QColor.

Parameters:

• c (tuple[float, float, float] | str | tuple[float, float, float, float] | tuple[tuple[float, float, float] | str, float] | tuple[tuple[float, float, float, float], float]) – A valid matplotlib color. See the matplotlib documentation for more information.

• alpha (float | None, default: None) – If supplied, applies transparency to the color.

Returns:

PySide6.QtGui.QColor

Return type:

QColor

erlab.interactive.colors.pg_colormap_from_name(name, skipCache=True, _loaded_all=False)

Get a pyqtgraph.ColorMap from its name.

Parameters:

• name (str) – A valid colormap name.

• skipCache (bool, default: True) – Whether to skip cache, by default True. Passed onto pyqtgraph.colormap.get().

Returns:

pyqtgraph.ColorMap

Return type:

ColorMap

erlab.interactive.colors.pg_colormap_names(source='all', exclude_local=False)

Get all valid pyqtgraph colormap names.

Parameters:

source (Literal['local', 'all', 'matplotlib'], default: "all") – If 'all', includes all colorcet colormaps.

Returns:

list of str

Return type:

list[str]

erlab.interactive.colors.pg_colormap_powernorm(cmap, gamma, reverse=False, high_contrast=False, zero_centered=False, N=65536)

erlab.interactive.colors.pg_colormap_to_QPixmap(cmap, w=64, h=16, skipCache=True)

Convert a pyqtgraph.ColorMap to a w-by-h QPixmap thumbnail.

Parameters:

• cmap (str | ColorMap) – The colormap.

• w (int, default: 64) – Specifies the dimension of the pixmap.

• h (int, default: 16) – Specifies the dimension of the pixmap.

• skipCache (bool, optional) – Whether to skip cache, by default True. Passed onto pg_colormap_from_name().

Returns:

PySide6.QtGui.QPixmap

Return type:

QPixmap