colors

Colors definitions and printing methods.

buildLUT

vedo.colors.buildLUT(colorlist, vmin=None, vmax=None, belowColor=None, aboveColor=None, nanColor=None, belowAlpha=1, aboveAlpha=1, nanAlpha=1, interpolate=False)

Generate colors in a lookup table (LUT).

Parameters

• colorlist (list) – a list in the form [(scalar1, [r,g,b]), (scalar2, 'blue'), ...].

• vmin (float) – specify minimum value of scalar range

• vmax (float) – specify maximum value of scalar range

• belowColor – color for scalars below the minimum in range

• belowAlpha – alpha for scalars below the minimum in range

• aboveColor – color for scalars above the maximum in range

• aboveAlpha – alpha for scalars above the maximum in range

• nanColor – color for invalid (nan) scalars

• nanAlpha – alpha for invalid (nan) scalars

• interpolate (bool) – interpolate or not intermediate scalars

Returns

the lookup table object vtkLookupTable. This can be fed into cmap.

Hint

Example: mesh_lut.py

buildPalette

vedo.colors.buildPalette(color1, color2, N, hsv=True)

Generate N colors starting from color1 to color2 by linear interpolation in HSV or RGB spaces.

Parameters

• N (int) – number of output colors.

• color1 – first rgb color.

• color2 – second rgb color.

• hsv (bool) – if False, interpolation is calculated in RGB space.

Hint

Example: colorpalette.py

colorMap

vedo.colors.colorMap(value, name='jet', vmin=None, vmax=None)

Map a real value in range [vmin, vmax] to a (r,g,b) color scale.

Parameters

• value (float, list) – scalar value to transform into a color

• name (str, matplotlib.colors.LinearSegmentedColormap) – color map name

Returns

(r,g,b) color, or a list of (r,g,b) colors.

Note

Most frequently used color maps:

Color maps list:

Tip

Can also directly use and customize a matplotlib color map:

Example

from vedo import colorMap
import matplotlib.cm as cm
print( colorMap(0.2, cm.flag, 0, 1) )

(1.0, 0.809016994374948, 0.6173258487801733)

getColor

vedo.colors.getColor(rgb=None, hsv=None)

Convert a color or list of colors to (r,g,b) format from many different input formats.

Parameters

hsv (bool) – if set to True, rgb is assumed as (hue, saturation, value).

Example

• RGB = (255, 255, 255), corresponds to white

• rgb = (1,1,1) is white

• hex = #FFFF00 is yellow

• string = ‘white’

• string = ‘w’ is white nickname

• string = ‘dr’ is darkred

• int = 7 picks color nr. 7 in a predefined color list

• int = -7 picks color nr. 7 in a different predefined list

colorcubes.py

getColorName

vedo.colors.getColorName(c)

Find the name of a color.

colorpalette.py

printc

vedo.colors.printc(*strings, c=None, bc=None, bold=True, italic=False, blink=False, underline=False, strike=False, dim=False, invert=False, box='', end='\n', flush=True)

Print to terminal in color (any color!).

Parameters

• c – foreground color name or (r,g,b)

• bc – background color name or (r,g,b)

• bold (bool) – boldface [True]

• italic (bool) – italic [False]

• blink (bool) – blinking text [False]

• underline (bool) – underline text [False]

• strike (bool) – strike through text [False]

• dim (bool) – make text look dimmer [False]

• invert (bool) – invert background and forward colors [False]

• box – print a box with specified text character [‘’]

• flush (bool) – flush buffer after printing [True]

• end (str) – the end character to be printed [newline]

Example

from vedo.colors import printc
printc('anything', c='tomato', bold=False, end=' ')
printc('anything', 455.5, c='lightblue')
printc(299792.48, c=4)

printc.py

printd

vedo.colors.printd(*strings, q=False)

Print debug information about the evironment where the printd() is called. Local variables are printed out with their current values.

Parameters

q (bool) – quit (exit) python session after the printd call.