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_axisis 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_axiswas added in 0.19.
- Returns:
- outndarray of shape (…, C=3, …)
The image in XYZ color space, of same shape as input.
- Raises:
- ValueError
If
labis 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
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