erlab.interactive.colors

Functions for manipulating colors in Qt.

Module Attributes

EXCLUDED_CMAPS

Colormaps to exclude from the list of available colormaps.

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, ...])

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

Bases: PlotItem

addImage(image)

color_changed()

image_changed()

image_level_changed()

level_change()

level_change_fin()

limit_changed()

mouseDragEvent(ev)

removeImage(image)

reset_levels()

setAutoLevels(value)

setImageItem(image, insert_in=None)

setLimits(limits)

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

set_width(width)

property images

property levels: Sequence[float]

property limits: tuple[float, float]

property primary_image

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

Bases: ImageItem

pyqtgraph.ImageItem with improved colormap support.

Parameters:

• image (npt.NDArray | None) – Image data

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

Signals:

• sigColorChanged()

• sigLimitChanged(float, float)

set_colormap(cmap, gamma, reverse=False, highContrast=False, zeroCentered=False, update=True)

set_pg_colormap(cmap, update=True)

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

Bases: QComboBox

hidePopup()

load_all()

load_thumbnail(index)

nextIndex()

previousIndex()

resetCmap()

setDefaultCmap(cmap)

setPopupMinimumWidthForItems()

showPopup()

LOAD_ALL_TEXT = 'Load all...'

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

Bases: QWidget

gamma_scale(y)

gamma_scale_inv(x)

setValue(value)

slider_changed(value)

spin_changed(value)

value()

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

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

Parameters:

• c (`ColorType <matplotlib.typing.ColorType>`) – A valid matplotlib color. See the matplotlib documentation for more information.

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

Return type:

PySide6.QtGui.QColor

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

Get a pyqtgraph.ColorMap from its name.

Parameters:

• name (str) – A valid colormap name.

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

Return type:

pyqtgraph.ColorMap

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

Get all valid pyqtgraph colormap names.

Parameters:

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

Return type:

list of str

erlab.interactive.colors.pg_colormap_powernorm(cmap, gamma, reverse=False, highContrast=False, zeroCentered=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) – Specifies the dimension of the pixmap.

• h (int) – Specifies the dimension of the pixmap.

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

Return type:

PySide6.QtGui.QPixmap