colormap#

Lookup table for the colormap.

Parameters:

scale_rangetuple

It can be anything e.g. (0, 1) or (0, 255). Usually it is the minimum and maximum value of your data. Default is (0, 1).

hue_rangetuple of floats

HSV values (min 0 and max 1). Default is (0.8, 0).

saturation_rangetuple of floats

HSV values (min 0 and max 1). Default is (1, 1).

value_rangetuple of floats

HSV value (min 0 and max 1). Default is (0.8, 0.8).

Returns:

lookup_tableLookupTable

Boys 2 rgb cool colormap

Maps a given field of undirected lines (line field) to rgb colors using Boy’s Surface immersion of the real projective plane. Boy’s Surface is one of the three possible surfaces obtained by gluing a Mobius strip to the edge of a disk. The other two are the crosscap and Roman surface, Steiner surfaces that are homeomorphic to the real projective plane (Pinkall 1986). The Boy’s surface is the only 3D immersion of the projective plane without singularities. Visit http://www.cs.brown.edu/~cad/rp2coloring for further details. Cagatay Demiralp, 9/7/2008.

Code was initially in matlab and was rewritten in Python for fury by the FURY Team. Thank you Cagatay for putting this online.

Parameters:

varray, shape (N, 3) of unit vectors (e.g., principal eigenvectors of

tensor data) representing one of the two directions of the undirected lines in a line field.

Returns:

carray, shape (N, 3) matrix of rgb colors corresponding to the vectors

given in V.

Examples

>>> from fury import colormap
>>> v = np.array([[1, 0, 0], [0, 1, 0], [0, 0, 1]])
>>> c = colormap.boys2rgb(v)

Get Standard orientation 2 rgb colormap.

v : array, shape (N, 3) of vectors not necessarily normalized

Returns:

carray, shape (N, 3) matrix of rgb colors corresponding to the vectors

given in V.

Examples

>>> from fury import colormap
>>> v = np.array([[1, 0, 0], [0, 1, 0], [0, 0, 1]])
>>> c = colormap.orient2rgb(v)

Create colors for streamlines to be used in actor.line.

Parameters:

streamlinessequence of ndarrays

cmap(‘rgb_standard’, ‘boys_standard’)

Returns:

colorsndarray

Make a callable, similar to maptlotlib.pyplot.get_cmap.

Create colors from a specific colormap and return it as an array of shape (N,3) where every row gives the corresponding r,g,b value. The colormaps we use are similar with those of matplotlib.

Parameters:

v(N,) array

vector of values to be mapped in RGB colors according to colormap

namestr.

Name of the colormap. Currently implemented: ‘jet’, ‘blues’, ‘accent’, ‘bone’ and matplotlib colormaps if you have matplotlib installed. For example, we suggest using ‘plasma’, ‘viridis’ or ‘inferno’. ‘jet’ is popular but can be often misleading and we will deprecate it the future.

autobool,

if auto is True then v is interpolated to [0, 1] from v.min() to v.max()

Notes

FURY supports a few colormaps for those who do not use Matplotlib, for more colormaps consider downloading Matplotlib (see matplotlib.org).

Generate colors that are maximally perceptually distinct.

This function generates a set of colors which are distinguishable by reference to the “Lab” color space, which more closely matches human color perception than RGB. Given an initial large list of possible colors, it iteratively chooses the entry in the list that is farthest (in Lab space) from all previously-chosen entries. While this “greedy” algorithm does not yield a global maximum, it is simple and efficient. Moreover, the sequence of colors is consistent no matter how many you request, which facilitates the users’ ability to learn the color order and avoids major changes in the appearance of plots when adding or removing lines.

Parameters:

bgtuple (optional)

Background RGB color, to make sure that your colors are also distinguishable from the background. Default: (0, 0, 0).

excludelist of tuples (optional)

Additional RGB colors to be distinguishable from.

nb_colorsint (optional)

Number of colors desired. Default: generate as many colors as needed.

Returns:

iterable of ndarray

If nb_colors is provided, returns a list of RBG colors. Otherwise, yields the next RBG color maximally perceptually distinct from previous ones.

Notes

Code was initially in matlab and was rewritten in Python for dipy by the Dipy Team. Thank you Tim Holy for putting this online. Visit http://www.mathworks.com/matlabcentral/fileexchange/29702 for the original implementation (v1.2), 14 Dec 2010 (Updated 07 Feb 2011).

Examples

>>> from fury.colormap import distinguishable_colormap
>>> # Generate 5 colors
>>> _ = [c for i, c in zip(range(5), distinguishable_colormap())]

Converts Hexadecimal color code to rgb()

color : string containing hexcode of color (can also start with a hash)

Returns:

carray, shape(1, 3) matrix of rbg colors corresponding to the

hexcode string given in color.

Examples

>>> from fury import colormap
>>> color = "#FFFFFF"
>>> c = colormap.hex_to_rgb(color)

>>> from fury import colormap
>>> color = "FFFFFF"
>>> c = colormap.hex_to_rgb(color)

RGB to HSV color space conversion.

Parameters:

rgb(…, 3, …) array_like

The image in RGB format. By default, the final dimension denotes channels.

Returns:

out(…, 3, …) ndarray

The image in HSV format. Same dimensions as input.

Notes

Original Implementation from scikit-image package. it can be found at: scikit-image/scikit-image This implementation might have been modified.

HSV to RGB color space conversion.

Parameters:

hsv(…, 3, …) array_like

The image in HSV format. By default, the final dimension denotes channels.

Returns:

out(…, 3, …) ndarray

The image in RGB format. Same dimensions as input.

Notes

Original Implementation from scikit-image package. it can be found at: scikit-image/scikit-image This implementation might have been modified.

XYZ to RGB color space conversion.

Parameters:

xyz(…, 3, …) array_like

The image in XYZ format. By default, the final dimension denotes channels.

Returns:

out(…, 3, …) ndarray

The image in RGB format. Same dimensions as input.

Notes

Original Implementation from scikit-image package. it can be found at: scikit-image/scikit-image This implementation might have been modified.

RGB to XYZ color space conversion.

Parameters:

rgb(…, 3, …) array_like

The image in RGB format. By default, the final dimension denotes channels.

Returns:

out(…, 3, …) ndarray

The image in XYZ format. Same dimensions as input.

Notes

Original Implementation from scikit-image package. it can be found at: scikit-image/scikit-image This implementation might have been modified.

Get the XYZ coordinates of the given illuminant and observer [1].

Parameters:

illuminant{“A”, “B”, “C”, “D50”, “D55”, “D65”, “D75”, “E”}, optional

The name of the illuminant (the function is NOT case sensitive).

observer{“2”, “10”, “R”}, optional

One of: 2-degree observer, 10-degree observer, or ‘R’ observer as in R function grDevices::convertColor.

Returns:

outarray

Array with 3 elements containing the XYZ coordinates of the given illuminant.

Notes

Original Implementation from scikit-image package. it can be found here: scikit-image/scikit-image This implementation might have been modified.

References

XYZ to CIE-LAB color space conversion.

Parameters:

xyz(…, 3, …) array_like

The image in XYZ format. By default, the final dimension denotes channels.

illuminant{“A”, “B”, “C”, “D50”, “D55”, “D65”, “D75”, “E”}, optional

The name of the illuminant (the function is NOT case sensitive).

observer{“2”, “10”, “R”}, optional

One of: 2-degree observer, 10-degree observer, or ‘R’ observer as in R function grDevices::convertColor.

Returns:

out(…, 3, …) ndarray

The image in CIE-LAB format. Same dimensions as input.

Notes

Original Implementation from scikit-image package. it can be found at: scikit-image/scikit-image This implementation might have been modified.

CIE-LAB to XYZcolor space conversion.

Parameters:

lab(…, 3, …) array_like

The image in Lab format. By default, the final dimension denotes channels.

illuminant{“A”, “B”, “C”, “D50”, “D55”, “D65”, “D75”, “E”}, optional

The name of the illuminant (the function is NOT case-sensitive).

observer{“2”, “10”, “R”}, optional

The aperture angle of the observer.

Returns:

out(…, 3, …) ndarray

The image in XYZ format. Same dimensions as input.

Notes

Original Implementation from scikit-image package. it can be found at: scikit-image/scikit-image This implementation might have been modified.

Conversion from the sRGB color space (IEC 61966-2-1:1999) to the CIE Lab colorspace under the given illuminant and observer.

Parameters:

rgb(…, 3, …) array_like

The image in RGB format. By default, the final dimension denotes channels.

illuminant{“A”, “B”, “C”, “D50”, “D55”, “D65”, “D75”, “E”}, optional

The name of the illuminant (the function is NOT case sensitive).

observer{“2”, “10”, “R”}, optional

The aperture angle of the observer.

Returns:

out(…, 3, …) ndarray

The image in Lab format. Same dimensions as input.

Notes

Original Implementation from scikit-image package. it can be found at: scikit-image/scikit-image This implementation might have been modified.

Lab to RGB color space conversion.

Parameters:

lab(…, 3, …) array_like

The image in Lab format. By default, the final dimension denotes channels.

illuminant{“A”, “B”, “C”, “D50”, “D55”, “D65”, “D75”, “E”}, optional

The name of the illuminant (the function is NOT case sensitive).

observer{“2”, “10”, “R”}, optional

The aperture angle of the observer.

Returns:

out(…, 3, …) ndarray

The image in RGB format. Same dimensions as input.

Notes

Original Implementation from scikit-image package. it can be found at: scikit-image/scikit-image This implementation might have been modified.