papyri
{ } Raw JSON

bundles / skimage 0.26.1rc0.dev0+git20260530.b607368ff / skimage / color / colorconv / lab2xyz

function

skimage.color.colorconv:lab2xyz

source: /dev/scikit-image/src/skimage/color/colorconv.py:1129

Signature

def lab2xyz(lab, illuminant = D65, observer = 2, *, channel_axis = -1)

Summary

Convert image in CIE-LAB to XYZ color space.

Parameters

lab : array_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_axis : int, optional

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

Returns

out : ndarray 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).

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.

See also

xyz2lab

Aliases

  • skimage.color.lab2xyz