skimage2.color.lab2xyz#

skimage2.color.lab2xyz(lab, illuminant='D65', observer='2', *, channel_axis=-1)[source]#

Convert image in CIE-LAB to XYZ color space.

Parameters:
labarray_like of shape (…, C=3, …)

The input image in CIE-LAB color space. Unless channel_axis is set, the final dimension denotes the CIE-LAB channels. The L* values range from 0 to 100; the a* and b* values range from -128 to 127.

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.

channel_axisint, optional

This parameter indicates which axis of the array corresponds to channels.

Added in version 0.19: channel_axis was added in 0.19.

Returns:
outndarray of shape (…, C=3, …)

The image in XYZ color space, of same shape as input.

Raises:
ValueError

If lab is not at least 2-D with shape (…, C=3, …).

ValueError

If either the illuminant or the observer angle are not supported or unknown.

UserWarning

If any of the pixels are invalid (Z < 0).

See also

xyz2lab

Notes

The CIE XYZ tristimulus values are x_ref = 95.047, y_ref = 100., and z_ref = 108.883. See function xyz_tristimulus_values() for a list of supported illuminants.

References