o :ήc @s*dZddlmZddlZddlmZddlmZm Z m Z m Z m Z ddl mZmZdd d d Zddd d dZddZddd ddZe dd ddZe dd ddZegdZegddZegdgdgdgZeeZegdgdgd gd!ZeeZeeZeeZegd"gd#gd#gZ egd$gd%gd&gZ!ee!Z"egd$gd'gd(gZ#ee#Z$egd$gd)gd*gZ%ee%Z&egd+gd,gd-gZ'ee'Z(egd$gd.gd/gZ)ee)Z*egd0Z+d1d2d1d3d4d5d4d3d6d7d6d3d8d9d:d3d;dd?d3d@dAd@d3dBdBdBd3dCZ,e-fdDdEZ.egdFgdGgdHgZ/ee/Z0egdIgdJgdKgZ1e2e1dddfe1dLddfe1dddf<ee1Z3egdMgdNgdKgZ4e2e4dddfe4dLddfe4dddf<ee4Z5egdOgdPgdKgZ6e2e6dddfe6dLddfe6dddf<ee6Z7egdQgdRgdJgZ8ee8Z9egdSgdJgdKgZ:e2e:dddfe:dLddfe:dddf<ee:Z;egdIgdTgdKgZee>Z?egdXgdYgdKgZ@e2e@dddfe@dLddfe@dddf<ee@ZAegdZgd[gdKgZBe2eBdddfeBdLddfeBdddf<eeBZCegd\gd]gdKgZDe2eDdddfeDdLddfeDdddf<eeDZEd^d_ZFe dd d`daZGe dd dbdcZHe dd dddeZIe dd dfdgZJe d dhdd didjZKddd dkdlZLdd dmdnZMe ddd dqdrZNe ddd dsdtZOe ddd dudvZPe ddd dwdxZQe ddd dydzZRe ddd d{d|ZSe dd d}d~ZTe dd ddZUe dd ddZVe dd ddZWe dd ddZXe dd ddZYe dd ddZZddZ[e dd ddZ\dddZ]e dd ddZ^e dd ddZ_e dd ddZ`e dd ddZae dd ddZbe dd ddZce dd ddZde dd ddZee dd ddZfe dd ddZgdS)aFunctions for converting between color spaces. The "central" color space in this module is RGB, more specifically the linear sRGB color space using D65 as a white-point [1]_. This represents a standard monitor (w/o gamma correction). For a good FAQ on color spaces see [2]_. The API consists of functions to convert to and from RGB as defined above, as well as a generic function to convert to and from any supported color space (which is done through RGB in most cases). Supported color spaces ---------------------- * RGB : Red Green Blue. Here the sRGB standard [1]_. * HSV : Hue, Saturation, Value. Uniquely defined when related to sRGB [3]_. * RGB CIE : Red Green Blue. The original RGB CIE standard from 1931 [4]_. Primary colors are 700 nm (red), 546.1 nm (blue) and 435.8 nm (green). * XYZ CIE : XYZ Derived from the RGB CIE color space. Chosen such that ``x == y == z == 1/3`` at the whitepoint, and all color matching functions are greater than zero everywhere. * LAB CIE : Lightness, a, b Colorspace derived from XYZ CIE that is intended to be more perceptually uniform * LUV CIE : Lightness, u, v Colorspace derived from XYZ CIE that is intended to be more perceptually uniform * LCH CIE : Lightness, Chroma, Hue Defined in terms of LAB CIE. C and H are the polar representation of a and b. The polar angle C is defined to be on ``(0, 2*pi)`` :author: Nicolas Pinto (rgb2hsv) :author: Ralf Gommers (hsv2rgb) :author: Travis Oliphant (XYZ and RGB CIE functions) :author: Matt Terry (lab2lch) :author: Alex Izvorski (yuv2rgb, rgb2yuv and related) :license: modified BSD References ---------- .. [1] Official specification of sRGB, IEC 61966-2-1:1999. .. [2] http://www.poynton.com/ColorFAQ.html .. [3] https://en.wikipedia.org/wiki/HSL_and_HSV .. [4] https://en.wikipedia.org/wiki/CIE_1931_color_space )warnN)linalg)_supported_float_typechannel_as_last_axisidentity reshape_nd slice_at_axis)dtype dtype_limits channel_axisc Cstttttttttd }tt t t t t tttd }|}|}||vr/d|}t|||vr>d|}t|||||||d|dS)a Convert an image array to a new color space. Valid color spaces are: 'RGB', 'HSV', 'RGB CIE', 'XYZ', 'YUV', 'YIQ', 'YPbPr', 'YCbCr', 'YDbDr' Parameters ---------- arr : (..., 3, ...) array_like The image to convert. By default, the final dimension denotes channels. fromspace : str The color space to convert from. Can be specified in lower case. tospace : str The color space to convert to. Can be specified in lower case. channel_axis : int, optional This parameter indicates which axis of the array corresponds to channels. .. versionadded:: 0.19 ``channel_axis`` was added in 0.19. Returns ------- out : (..., 3, ...) ndarray The converted image. Same dimensions as input. Raises ------ ValueError If fromspace is not a valid color space ValueError If tospace is not a valid color space Notes ----- Conversion is performed through the "central" RGB color space, i.e. conversion from XYZ to HSV is implemented as ``XYZ -> RGB -> HSV`` instead of directly. Examples -------- >>> from skimage import data >>> img = data.astronaut() >>> img_hsv = convert_colorspace(img, 'RGB', 'HSV') ) rgbhsvzrgb ciexyzyuvyiqypbprycbcrydbdrz`fromspace` has to be one of z`tospace` has to be one of r )rhsv2rgb rgbcie2rgbxyz2rgbyuv2rgbyiq2rgb ypbpr2rgb ycbcr2rgb ydbdr2rgbrgb2hsv rgb2rgbciergb2xyzrgb2yuvrgb2yiq rgb2ypbpr rgb2ycbcr rgb2ydbdrlowerkeys ValueError)arr fromspacetospacerfromdicttodictmsgr0>/tmp/pip-target-vg8gfxp4/lib/python/skimage/color/colorconv.pyconvert_colorspace?s(.r2FcCsZt|}|j|dkrd|j}t|t|j}|tjkr$tj}ntj}|||dS)zVCheck the shape of the array and convert it to floating point representation. z;the input array must have size 3 along `channel_axis`, got  force_copy) np asanyarrayshaper)rr float32img_as_float32img_as_float64)r*r5rr/ float_dtype_funcr0r0r1_prepare_colorarrays    r>cCs2t|ts td|| ks||krtddS)Nzchannel_axis must be an integerz%channel_axis exceeds array dimensions) isinstanceint TypeErrorr6 AxisError)rndimr0r0r1_validate_channel_axiss  rDrFrFc Cst|}t||j||j}|j|dkr!d|j}t|t|j}|tjkr1t |}nt |}t | |j}t |dkrOtdt |dt|dks]t|dkratdt||j|}|ttdd|d }|ttd|d }tjd||||ddd }|S) a&RGBA to RGB conversion using alpha blending [1]_. Parameters ---------- rgba : (..., 4, ...) array_like The image in RGBA format. By default, the final dimension denotes channels. background : array_like The color of the background to blend the image with (3 floats between 0 to 1 - the RGB value of the background). channel_axis : int, optional This parameter indicates which axis of the array corresponds to channels. .. versionadded:: 0.19 ``channel_axis`` was added in 0.19. Returns ------- out : (..., 3, ...) ndarray The image in RGB format. Same dimensions as input. Raises ------ ValueError If `rgba` is not at least 2D with shape (..., 4, ...). References ---------- .. [1] https://en.wikipedia.org/wiki/Alpha_compositing#Alpha_blending Examples -------- >>> from skimage import color >>> from skimage import data >>> img_rgba = data.logo() >>> img_rgb = color.rgba2rgb(img_rgba) z;the input array must have size 4 along `channel_axis`, got r3z>background must be an array-like containing 3 RGB values. Got z itemsrrFz5background RGB values must be floats between 0 and 1.axisa_mina_max)r6r7rDrCr8r)rr r9r:r;ravelastypelenanyrr sliceclip) rgba backgroundrr*r/r<alphachannelsoutr0r0r1rgba2rgbs4 '        rXc Csr|jdk}|r|tjdf}t|dd}t|}|d}|d}tjdd}||}d||dk<|d|k} || df|| d f|| || d f<|d |k} d || d f|| d f|| || d f<|d |k} d|| d f|| df|| || d f<|ddd} d| |dk<tjdi|| |d<||d <||d <d |t|<|rtj |d d}|S)aRGB to HSV color space conversion. Parameters ---------- rgb : (..., 3, ...) array_like The image in RGB format. By default, the final dimension denotes channels. channel_axis : int, optional This parameter indicates which axis of the array corresponds to channels. .. versionadded:: 0.19 ``channel_axis`` was added in 0.19. Returns ------- out : (..., 3, ...) ndarray The image in HSV format. Same dimensions as input. Raises ------ ValueError If `rgb` is not at least 2-D with shape (..., 3, ...). Notes ----- Conversion between RGB and HSV color spaces results in some loss of precision, due to integer arithmetic and rounding [1]_. References ---------- .. [1] https://en.wikipedia.org/wiki/HSL_and_HSV Examples -------- >>> from skimage import color >>> from skimage import data >>> img = data.astronaut() >>> img_hsv = color.rgb2hsv(img) rF.r r ignore)invalid.rrr.rFg@.r@g@?rHNr0) rCr6newaxisr> empty_likemaxptpseterrisnansqueeze) rrinput_is_one_pixelr*rWout_vdelta old_settingsout_sidxout_hr0r0r1rs4 *       ( , , rc Cs t|dd}t|dd}|dd|}|dd|d}|dd||d}|ddd||d}|d}tj|||gddtjd}t|ttj|||fddtj|||fddtj|||fddtj|||fddtj|||fddtj|||fddg} | S) aHSV to RGB color space conversion. Parameters ---------- hsv : (..., 3, ...) array_like The image in HSV format. By default, the final dimension denotes channels. channel_axis : int, optional This parameter indicates which axis of the array corresponds to channels. .. versionadded:: 0.19 ``channel_axis`` was added in 0.19. Returns ------- out : (..., 3, ...) ndarray The image in RGB format. Same dimensions as input. Raises ------ ValueError If `hsv` is not at least 2-D with shape (..., 3, ...). Notes ----- Conversion between RGB and HSV color spaces results in some loss of precision, due to integer arithmetic and rounding [1]_. References ---------- .. [1] https://en.wikipedia.org/wiki/HSL_and_HSV Examples -------- >>> from skimage import data >>> img = data.astronaut() >>> img_hsv = rgb2hsv(img) >>> img_rgb = hsv2rgb(img_hsv) r r r\r^rFr]rH)r>r6floorstackrNuint8choose) rrr*hifpqtvrWr0r0r1r>s$ * r)ig@g<{@)gmЦmz?gX0Ҏu?g߼xV4r?gj@)g ƈDe?g m9?gX9?)g_8?g m9?gUy?)gKJ̓?g8n?gtBh?)g\(\?gףp= ?g?)e/?gH.?g0r.Ņ?)r[g{Gz?Gz?rzg333333?gjq?gL F%u?)rrr)gA`"?gbX9?gv/?)gxÅ¿gx|ҿg}?)g>?gb!zgE)g6?gQ#VѿgԿ)g?gR4Ag(q?)g4($ſgm3տ?)r}gɑڿgܸд)gX9^P@gV-`@gK8@)gtBgER\@)r~gMrWgX962)gܿgK7AgS?)gSgB`"?g-?)g'@j?r`gyuk?)gJA(Q?rFgf?)gƿ`?rFga!?)210R)gN5z?rFgt L?)g;?rFg$?)gh}a?rFgr~?)gB\Vդ!?rFgJ?)gIf?rFgpBg?)g#Z?rFg%vu??)gW?rFgJA_?)gq@?rFg|?)g&?rFg~?)g5{v?rFgs"cr?)gO V?rFg7+?)gQ8D?rFg3l]?)gT芔d?rFgN?)gG6?rFg ?M?)r`r`r`)ABCD50D55D65D75Ec CsN|}|}z tjt|||dWSty&td|d|dw)a9Get 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. dtype: dtype, optional Output data type. Returns ------- out : array Array with 3 elements containing the XYZ coordinates of the given illuminant. Raises ------ ValueError If either the illuminant or the observer angle are not supported or unknown. References ---------- .. [1] https://en.wikipedia.org/wiki/Standard_illuminant r z*Unknown illuminant/observer combination (`z`, `z`))upperr6asarray illuminantsKeyErrorr)) illuminantobserverr r0r0r1get_xyz_coordss  r)?gffffff?g(\?)gQ?r{g)\(?)gHzG?= ףp=?g(\?)rgI +?gM?)gx&?rgE?)r[r[r[rF)g܋?g*& ?gPﹺ?)g +GN?gcl0?=?gh)'?)g5F?g} o?gZ9 Z!?)gm?g?g҈}?)g$+\b?gI n#K?gʨ2A?)g뉮?gFx $?g߽?)g&c`?g8?gH?)gq-s?g| ?g!?cCst|}||j|jS)a_Do the color space conversion. Parameters ---------- matrix : array_like The 3x3 matrix to use. arr : (..., 3, ...) array_like The input array. By default, the final dimension denotes channels. Returns ------- out : (..., 3, ...) ndarray The converted array. Same dimensions as input. )r>TrNr )matrixr*r0r0r1_convertusrcCsVtt|}|dk}dt||dd||<||d9<tj|dd|d|S) a$XYZ to RGB color space conversion. Parameters ---------- xyz : (..., 3, ...) array_like The image in XYZ format. By default, the final dimension denotes channels. channel_axis : int, optional This parameter indicates which axis of the array corresponds to channels. .. versionadded:: 0.19 ``channel_axis`` was added in 0.19. Returns ------- out : (..., 3, ...) ndarray The image in RGB format. Same dimensions as input. Raises ------ ValueError If `xyz` is not at least 2-D with shape (..., 3, ...). Notes ----- The CIE XYZ color space is derived from the CIE RGB color space. Note however that this function converts to sRGB. References ---------- .. [1] https://en.wikipedia.org/wiki/CIE_1931_color_space Examples -------- >>> from skimage import data >>> from skimage.color import rgb2xyz, xyz2rgb >>> img = data.astronaut() >>> img_xyz = rgb2xyz(img) >>> img_rgb = xyz2rgb(img_xyz) gsåi?zG?g?)\(?ףp= )@rrFrW)r rgb_from_xyzr6powerrR)rrr*maskr0r0r1rs -rcCsXt|dd}|dk}t||ddd||<||d<|tj|jS)aRGB to XYZ color space conversion. Parameters ---------- rgb : (..., 3, ...) array_like The image in RGB format. By default, the final dimension denotes channels. channel_axis : int, optional This parameter indicates which axis of the array corresponds to channels. .. versionadded:: 0.19 ``channel_axis`` was added in 0.19. Returns ------- out : (..., 3, ...) ndarray The image in XYZ format. Same dimensions as input. Raises ------ ValueError If `rgb` is not at least 2-D with shape (..., 3, ...). Notes ----- The CIE XYZ color space is derived from the CIE RGB color space. Note however that this function converts from sRGB. References ---------- .. [1] https://en.wikipedia.org/wiki/CIE_1931_color_space Examples -------- >>> from skimage import data >>> img = data.astronaut() >>> img_xyz = rgb2xyz(img) r r g?ܵ?rrg333333@r)r>copyr6r xyz_from_rgbrrNr )rrr*rr0r0r1r!s +r!cC tt|S)ayRGB to RGB CIE color space conversion. Parameters ---------- rgb : (..., 3, ...) array_like The image in RGB format. By default, the final dimension denotes channels. channel_axis : int, optional This parameter indicates which axis of the array corresponds to channels. .. versionadded:: 0.19 ``channel_axis`` was added in 0.19. Returns ------- out : (..., 3, ...) ndarray The image in RGB CIE format. Same dimensions as input. Raises ------ ValueError If `rgb` is not at least 2-D with shape (..., 3, ...). References ---------- .. [1] https://en.wikipedia.org/wiki/CIE_1931_color_space Examples -------- >>> from skimage import data >>> from skimage.color import rgb2rgbcie >>> img = data.astronaut() >>> img_rgbcie = rgb2rgbcie(img) )rrgbcie_from_rgbrrr0r0r1r s %r cCr)aRGB CIE to RGB color space conversion. Parameters ---------- rgbcie : (..., 3, ...) array_like The image in RGB CIE format. By default, the final dimension denotes channels. channel_axis : int, optional This parameter indicates which axis of the array corresponds to channels. .. versionadded:: 0.19 ``channel_axis`` was added in 0.19. Returns ------- out : (..., 3, ...) ndarray The image in RGB format. Same dimensions as input. Raises ------ ValueError If `rgbcie` is not at least 2-D with shape (..., 3, ...). References ---------- .. [1] https://en.wikipedia.org/wiki/CIE_1931_color_space Examples -------- >>> from skimage import data >>> from skimage.color import rgb2rgbcie, rgbcie2rgb >>> img = data.astronaut() >>> img_rgbcie = rgb2rgbcie(img) >>> img_rgb = rgbcie2rgb(img_rgbcie) )rrgb_from_rgbcie)rgbcierr0r0r1rs &r)multichannel_outputcCs$t|}tjgd|jd}||S)aCompute luminance of an RGB image. Parameters ---------- rgb : (..., 3, ...) array_like The image in RGB format. By default, the final dimension denotes channels. Returns ------- out : ndarray The luminance image - an array which is the same size as the input array, but with the channel dimension removed. Raises ------ ValueError If `rgb` is not at least 2-D with shape (..., 3, ...). Notes ----- The weights used in this conversion are calibrated for contemporary CRT phosphors:: Y = 0.2125 R + 0.7154 G + 0.0721 B If there is an alpha channel present, it is ignored. References ---------- .. [1] http://poynton.ca/PDFs/ColorFAQ.pdf Examples -------- >>> from skimage.color import rgb2gray >>> from skimage import data >>> img = data.astronaut() >>> img_gray = rgb2gray(img) r|r)r>r6arrayr )rrcoeffsr0r0r1rgb2grayBs)rcCst|}t|dd\}}|dur|}t||js%td|jjddt|r5tj|j ||jd}n |j |j kr?t dtj |fd |f|d }|S) aCreate a RGBA representation of a gray-level image. Parameters ---------- image : array_like Input image. alpha : array_like, optional Alpha channel of the output image. It may be a scalar or an array that can be broadcast to ``image``. If not specified it is set to the maximum limit corresponding to the ``image`` dtype. channel_axis : int, optional This parameter indicates which axis of the output array will correspond to channels. .. versionadded:: 0.19 ``channel_axis`` was added in 0.19. Returns ------- rgba : ndarray RGBA image. A new dimension of length 4 is added to input image shape. F) clip_negativeNz+alpha cannot be safely cast to image dtype r stacklevelrz"alpha.shape must match image.shaper3rH) r6rr can_castr rnameisscalarfullr8r)rq)imagerUrr* alpha_min alpha_maxrSr0r0r1 gray2rgbaps   rcCstjd|f|dS)aCreate an RGB representation of a gray-level image. Parameters ---------- image : array_like Input image. channel_axis : int, optional This parameter indicates which axis of the output array will correspond to channels. Returns ------- rgb : (..., 3, ...) ndarray RGB image. A new dimension of length 3 is added to input image. Notes ----- If the input is a 1-dimensional image of shape ``(M, )``, the output will be shape ``(M, 3)``. r3rH)r6rq)rrr0r0r1gray2rgbsrrrc Cst|dd}t|||j}||}|dk}t||||<d||d||<|d|d|d}}} d |d } d ||} d || } tjd d| | | fDddS)aCXYZ 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. channel_axis : int, optional This parameter indicates which axis of the array corresponds to channels. .. versionadded:: 0.19 ``channel_axis`` was added in 0.19. Returns ------- out : (..., 3, ...) ndarray The image in CIE-LAB format. Same dimensions as input. Raises ------ ValueError If `xyz` is not at least 2-D with shape (..., 3, ...). ValueError If either the illuminant or the observer angle is unsupported or unknown. Notes ----- By default Observer="2", Illuminant="D65". CIE XYZ tristimulus values x_ref=95.047, y_ref=100., z_ref=108.883. See function `get_xyz_coords` for a list of supported illuminants. References ---------- .. [1] http://www.easyrgb.com/index.php?X=MATH&H=07 .. [2] https://en.wikipedia.org/wiki/Lab_color_space Examples -------- >>> from skimage import data >>> from skimage.color import rgb2xyz, xyz2lab >>> img = data.astronaut() >>> img_xyz = rgb2xyz(img) >>> img_lab = xyz2lab(img_xyz) r r 玬2#?S%@{a?r\r]r^]@0@@@i@cSg|] }|dtjfqS.r6ra).0xr0r0r1 zxyz2lab..rH)r>rr r6cbrt concatenate) rrrrr* xyz_ref_whiterryzLabr0r0r1xyz2labs 5   rcCst|dd}|d|d|d}}}|dd}|d|} ||d } t| d krEt| d k} td | d jd d d | | <tj| || gdd} | dk} t| | d| | <| | dd| | <t ||}| |9} | S)alCIE-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. channel_axis : int, optional This parameter indicates which axis of the array corresponds to channels. .. versionadded:: 0.19 ``channel_axis`` was added in 0.19. Returns ------- out : (..., 3, ...) ndarray The image in XYZ format. Same dimensions as input. Raises ------ ValueError If `lab` is not at least 2-D with shape (..., 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 ----- By default Observer="2", Illuminant="D65". CIE XYZ tristimulus values x_ref = 95.047, y_ref = 100., z_ref = 108.883. See function 'get_xyz_coords' for a list of supported illuminants. References ---------- .. [1] http://www.easyrgb.com/index.php?X=MATH&H=07 .. [2] https://en.wikipedia.org/wiki/Lab_color_space r r r\r]r^rrrrrz+Color data out of range: Z < 0 in %s pixelsrrrHgSy{?@rr) r>rr6rPnonzerorsizerqrr)labrrrr*rrrrrrrZrWrrr0r0r1lab2xyzs$.    rcCstt|||S)aConversion 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. channel_axis : int, optional This parameter indicates which axis of the array corresponds to channels. .. versionadded:: 0.19 ``channel_axis`` was added in 0.19. Returns ------- out : (..., 3, ...) ndarray The image in Lab format. Same dimensions as input. Raises ------ ValueError If `rgb` is not at least 2-D with shape (..., 3, ...). Notes ----- RGB is a device-dependent color space so, if you use this function, be sure that the image you are analyzing has been mapped to the sRGB color space. This function uses rgb2xyz and xyz2lab. By default Observer="2", Illuminant="D65". CIE XYZ tristimulus values x_ref=95.047, y_ref=100., z_ref=108.883. See function `get_xyz_coords` for a list of supported illuminants. References ---------- .. [1] https://en.wikipedia.org/wiki/Standard_illuminant )rr!)rrrrr0r0r1rgb2labEs.rcCstt|||S)aLab 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. channel_axis : int, optional This parameter indicates which axis of the array corresponds to channels. .. versionadded:: 0.19 ``channel_axis`` was added in 0.19. Returns ------- out : (..., 3, ...) ndarray The image in RGB format. Same dimensions as input. Raises ------ ValueError If `lab` is not at least 2-D with shape (..., 3, ...). Notes ----- This function uses lab2xyz and xyz2rgb. By default Observer="2", Illuminant="D65". CIE XYZ tristimulus values x_ref=95.047, y_ref=100., z_ref=108.883. See function `get_xyz_coords` for a list of supported illuminants. References ---------- .. [1] https://en.wikipedia.org/wiki/Standard_illuminant )rr)rrrrr0r0r1lab2rgbvs)rcsD|jdk}|r|tjdf}t|dd}|d|d|d}}}ttjtt||} || d} | dk} d t | | d | | <d | | | | <d | d gd| } d| dgd| } fdd}fdd}d| ||||| }d| ||||| }tj | ||gdd}|rtj |d d}|S)a$XYZ to CIE-Luv 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 The aperture angle of the observer. channel_axis : int, optional This parameter indicates which axis of the array corresponds to channels. .. versionadded:: 0.19 ``channel_axis`` was added in 0.19. Returns ------- out : (..., 3, ...) ndarray The image in CIE-Luv format. Same dimensions as input. Raises ------ ValueError If `xyz` is not at least 2-D with shape (..., 3, ...). ValueError If either the illuminant or the observer angle are not supported or unknown. Notes ----- By default XYZ conversion weights use observer=2A. Reference whitepoint for D65 Illuminant, with XYZ tristimulus values of ``(95.047, 100., 108.883)``. See function 'get_xyz_coords' for a list of supported illuminants. References ---------- .. [1] http://www.easyrgb.com/index.php?X=MATH&H=16#text16 .. [2] https://en.wikipedia.org/wiki/CIELUV Examples -------- >>> from skimage import data >>> from skimage.color import rgb2xyz, xyz2luv >>> img = data.astronaut() >>> img_xyz = rgb2xyz(img) >>> img_luv = xyz2luv(img_xyz) rF.r r r\r]r^rrrfffff:@rGrrFr3 cs d||d|d|S)Nr_.@rr0XYZepsr0r1fu zxyz2luv..fucs d||d|d|S)Ng"@rrr0rrr0r1fvrzxyz2luv..fv*@rH) rCr6rar>finfofloatrrrrrqrg)rrrrrhr*rrrrrru0v0rruryrWr0rr1xyz2luvs* 5     rcCsTt|dd}|d|d|d}}}ttj}|} | dk} t| | ddd | | <| | d | | <t||} | | d 9} tgd } d | d| | } d| d | | }| |d||}||d||}d| d|d}|d |d||| d|}||d | }tj dd|| |fDddS)aECIE-Luv to XYZ color space conversion. Parameters ---------- luv : (..., 3, ...) array_like The image in CIE-Luv 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. channel_axis : int, optional This parameter indicates which axis of the array corresponds to channels. .. versionadded:: 0.19 ``channel_axis`` was added in 0.19. Returns ------- out : (..., 3, ...) ndarray The image in XYZ format. Same dimensions as input. Raises ------ ValueError If `luv` is not at least 2-D with shape (..., 3, ...). ValueError If either the illuminant or the observer angle are not supported or unknown. Notes ----- XYZ conversion weights use observer=2A. Reference whitepoint for D65 Illuminant, with XYZ tristimulus values of ``(95.047, 100., 108.883)``. See function 'get_xyz_coords' for a list of supported illuminants. References ---------- .. [1] http://www.easyrgb.com/index.php?X=MATH&H=16#text16 .. [2] https://en.wikipedia.org/wiki/CIELUV r r r\r]r^gV-@rrrrrFrrGrrrr3r cSrrr)rrwr0r0r1rGrzluv2xyz..rH) r>rr6rrrrrrr)luvrrrr*rrryrrrr uv_weightsrrrrcrrr0r0r1luv2xyzs$,   $rcC tt|S)a|RGB to CIE-Luv color space conversion. Parameters ---------- rgb : (..., 3, ...) array_like The image in RGB format. By default, the final dimension denotes channels. channel_axis : int, optional This parameter indicates which axis of the array corresponds to channels. .. versionadded:: 0.19 ``channel_axis`` was added in 0.19. Returns ------- out : (..., 3, ...) ndarray The image in CIE Luv format. Same dimensions as input. Raises ------ ValueError If `rgb` is not at least 2-D with shape (..., 3, ...). Notes ----- This function uses rgb2xyz and xyz2luv. References ---------- .. [1] http://www.easyrgb.com/index.php?X=MATH&H=16#text16 .. [2] http://www.easyrgb.com/index.php?X=MATH&H=02#text2 .. [3] https://en.wikipedia.org/wiki/CIELUV )rr!rr0r0r1rgb2luvJs $rcCr)aLuv to RGB color space conversion. Parameters ---------- luv : (..., 3, ...) array_like The image in CIE Luv format. By default, the final dimension denotes channels. Returns ------- out : (..., 3, ...) ndarray The image in RGB format. Same dimensions as input. Raises ------ ValueError If `luv` is not at least 2-D with shape (..., 3, ...). Notes ----- This function uses luv2xyz and xyz2rgb. )rr)rrr0r0r1luv2rgbqs rcC t|tS)aRGB to Haematoxylin-Eosin-DAB (HED) color space conversion. Parameters ---------- rgb : (..., 3, ...) array_like The image in RGB format. By default, the final dimension denotes channels. channel_axis : int, optional This parameter indicates which axis of the array corresponds to channels. .. versionadded:: 0.19 ``channel_axis`` was added in 0.19. Returns ------- out : (..., 3, ...) ndarray The image in HED format. Same dimensions as input. Raises ------ ValueError If `rgb` is not at least 2-D with shape (..., 3, ...). References ---------- .. [1] A. C. Ruifrok and D. A. Johnston, "Quantification of histochemical staining by color deconvolution.," Analytical and quantitative cytology and histology / the International Academy of Cytology [and] American Society of Cytology, vol. 23, no. 4, pp. 291-9, Aug. 2001. Examples -------- >>> from skimage import data >>> from skimage.color import rgb2hed >>> ihc = data.immunohistochemistry() >>> ihc_hed = rgb2hed(ihc) )separate_stains hed_from_rgbrr0r0r1rgb2heds (rcCr)aHaematoxylin-Eosin-DAB (HED) to RGB color space conversion. Parameters ---------- hed : (..., 3, ...) array_like The image in the HED color space. By default, the final dimension denotes channels. channel_axis : int, optional This parameter indicates which axis of the array corresponds to channels. .. versionadded:: 0.19 ``channel_axis`` was added in 0.19. Returns ------- out : (..., 3, ...) ndarray The image in RGB. Same dimensions as input. Raises ------ ValueError If `hed` is not at least 2-D with shape (..., 3, ...). References ---------- .. [1] A. C. Ruifrok and D. A. Johnston, "Quantification of histochemical staining by color deconvolution.," Analytical and quantitative cytology and histology / the International Academy of Cytology [and] American Society of Cytology, vol. 23, no. 4, pp. 291-9, Aug. 2001. Examples -------- >>> from skimage import data >>> from skimage.color import rgb2hed, hed2rgb >>> ihc = data.immunohistochemistry() >>> ihc_hed = rgb2hed(ihc) >>> ihc_rgb = hed2rgb(ihc_hed) )combine_stains rgb_from_hed)hedrr0r0r1hed2rgbs )rcCsNt|ddd}tj|d|dtd}t|||}tj|d|d|S)uRGB to stain color space conversion. Parameters ---------- rgb : (..., 3, ...) array_like The image in RGB format. By default, the final dimension denotes channels. conv_matrix: ndarray The stain separation matrix as described by G. Landini [1]_. channel_axis : int, optional This parameter indicates which axis of the array corresponds to channels. .. versionadded:: 0.19 ``channel_axis`` was added in 0.19. Returns ------- out : (..., 3, ...) ndarray The image in stain color space. Same dimensions as input. Raises ------ ValueError If `rgb` is not at least 2-D with shape (..., 3, ...). Notes ----- Stain separation matrices available in the ``color`` module and their respective colorspace: * ``hed_from_rgb``: Hematoxylin + Eosin + DAB * ``hdx_from_rgb``: Hematoxylin + DAB * ``fgx_from_rgb``: Feulgen + Light Green * ``bex_from_rgb``: Giemsa stain : Methyl Blue + Eosin * ``rbd_from_rgb``: FastRed + FastBlue + DAB * ``gdx_from_rgb``: Methyl Green + DAB * ``hax_from_rgb``: Hematoxylin + AEC * ``bro_from_rgb``: Blue matrix Anilline Blue + Red matrix Azocarmine + Orange matrix Orange-G * ``bpx_from_rgb``: Methyl Blue + Ponceau Fuchsin * ``ahx_from_rgb``: Alcian Blue + Hematoxylin * ``hpx_from_rgb``: Hematoxylin + PAS This implementation borrows some ideas from DIPlib [2]_, e.g. the compensation using a small value to avoid log artifacts when calculating the Beer-Lambert law. References ---------- .. [1] https://web.archive.org/web/20160624145052/http://www.mecourse.com/landinig/software/cdeconv/cdeconv.html .. [2] https://github.com/DIPlib/diplib/ .. [3] A. C. Ruifrok and D. A. Johnston, “Quantification of histochemical staining by color deconvolution,” Anal. Quant. Cytol. Histol., vol. 23, no. 4, pp. 291–299, Aug. 2001. Examples -------- >>> from skimage import data >>> from skimage.color import separate_stains, hdx_from_rgb >>> ihc = data.immunohistochemistry() >>> ihc_hdx = separate_stains(ihc, hdx_from_rgb) Tr )r5rư>rr)r>r6maximumlog)r conv_matrixr log_adjuststainsr0r0r1rs A rcCs@t|dd}td }|| |}t|}tj|dddS)ucStain to RGB color space conversion. Parameters ---------- stains : (..., 3, ...) array_like The image in stain color space. By default, the final dimension denotes channels. conv_matrix: ndarray The stain separation matrix as described by G. Landini [1]_. channel_axis : int, optional This parameter indicates which axis of the array corresponds to channels. .. versionadded:: 0.19 ``channel_axis`` was added in 0.19. Returns ------- out : (..., 3, ...) ndarray The image in RGB format. Same dimensions as input. Raises ------ ValueError If `stains` is not at least 2-D with shape (..., 3, ...). Notes ----- Stain combination matrices available in the ``color`` module and their respective colorspace: * ``rgb_from_hed``: Hematoxylin + Eosin + DAB * ``rgb_from_hdx``: Hematoxylin + DAB * ``rgb_from_fgx``: Feulgen + Light Green * ``rgb_from_bex``: Giemsa stain : Methyl Blue + Eosin * ``rgb_from_rbd``: FastRed + FastBlue + DAB * ``rgb_from_gdx``: Methyl Green + DAB * ``rgb_from_hax``: Hematoxylin + AEC * ``rgb_from_bro``: Blue matrix Anilline Blue + Red matrix Azocarmine + Orange matrix Orange-G * ``rgb_from_bpx``: Methyl Blue + Ponceau Fuchsin * ``rgb_from_ahx``: Alcian Blue + Hematoxylin * ``rgb_from_hpx``: Hematoxylin + PAS References ---------- .. [1] https://web.archive.org/web/20160624145052/http://www.mecourse.com/landinig/software/cdeconv/cdeconv.html .. [2] A. C. Ruifrok and D. A. Johnston, “Quantification of histochemical staining by color deconvolution,” Anal. Quant. Cytol. Histol., vol. 23, no. 4, pp. 291–299, Aug. 2001. Examples -------- >>> from skimage import data >>> from skimage.color import (separate_stains, combine_stains, ... hdx_from_rgb, rgb_from_hdx) >>> ihc = data.immunohistochemistry() >>> ihc_hdx = separate_stains(ihc, hdx_from_rgb) >>> ihc_rgb = combine_stains(ihc_hdx, rgb_from_hdx) r r rrrFrJ)r>r6rexprR)rrrrlog_rgbrr0r0r1r/s >  rcCs4t|}|d|d}}t||\|d<|d<|S)auCIE-LAB to CIE-LCH color space conversion. LCH is the cylindrical representation of the LAB (Cartesian) colorspace Parameters ---------- lab : (..., 3, ...) array_like The N-D image in CIE-LAB format. The last (``N+1``-th) dimension must have at least 3 elements, corresponding to the ``L``, ``a``, and ``b`` color channels. Subsequent elements are copied. channel_axis : int, optional This parameter indicates which axis of the array corresponds to channels. .. versionadded:: 0.19 ``channel_axis`` was added in 0.19. Returns ------- out : (..., 3, ...) ndarray The image in LCH format, in a N-D array with same shape as input `lab`. Raises ------ ValueError If `lch` does not have at least 3 color channels (i.e. l, a, b). Notes ----- The Hue is expressed as an angle between ``(0, 2*pi)`` Examples -------- >>> from skimage import data >>> from skimage.color import rgb2lab, lab2lch >>> img = data.astronaut() >>> img_lab = rgb2lab(img) >>> img_lch = lab2lch(img_lab) r]r^)_prepare_lab_array_cart2polar_2pi)rrlchrrr0r0r1lab2lchws)rcCs>t||t||}}|t|dkdtjd7}||fS)zconvert cartesian coordinates to polar (uses non-standard theta range!) NON-STANDARD RANGE! Maps to ``(0, 2*pi)`` rather than usual ``(-pi, +pi)`` r[rr)r6hypotarctan2wherepi)rrrrxr0r0r1rsrcCsDt|}|d|d}}|t||t||d<|d<|S)aDCIE-LCH to CIE-LAB color space conversion. LCH is the cylindrical representation of the LAB (Cartesian) colorspace Parameters ---------- lch : (..., 3, ...) array_like The N-D image in CIE-LCH format. The last (``N+1``-th) dimension must have at least 3 elements, corresponding to the ``L``, ``a``, and ``b`` color channels. Subsequent elements are copied. channel_axis : int, optional This parameter indicates which axis of the array corresponds to channels. .. versionadded:: 0.19 ``channel_axis`` was added in 0.19. Returns ------- out : (..., 3, ...) ndarray The image in LAB format, with same shape as input `lch`. Raises ------ ValueError If `lch` does not have at least 3 color channels (i.e. l, c, h). Examples -------- >>> from skimage import data >>> from skimage.color import rgb2lab, lch2lab, lab2lch >>> img = data.astronaut() >>> img_lab = rgb2lab(img) >>> img_lch = lab2lch(img_lab) >>> img_lab2 = lch2lab(img_lch) r]r^)rr6cossin)rrrhr0r0r1lch2labs&&r TcCsRt|}|j}|ddkrtdt|j}|tjkr tj}ntj}|||dS)zEnsure input for lab2lch, lch2lab are well-posed. Arrays must be in floating point and have at least 3 elements in last dimension. Return a new array. r r3z*Input array has less than 3 color channelsr4) r6rr8r)rr r9r:r;)r*r5r8r<r=r0r0r1rs     rcCr)aRRGB to YUV color space conversion. Parameters ---------- rgb : (..., 3, ...) array_like The image in RGB format. By default, the final dimension denotes channels. channel_axis : int, optional This parameter indicates which axis of the array corresponds to channels. .. versionadded:: 0.19 ``channel_axis`` was added in 0.19. Returns ------- out : (..., 3, ...) ndarray The image in YUV format. Same dimensions as input. Raises ------ ValueError If `rgb` is not at least 2-D with shape (..., 3, ...). Notes ----- Y is between 0 and 1. Use YCbCr instead of YUV for the color space commonly used by video codecs, where Y ranges from 16 to 235. References ---------- .. [1] https://en.wikipedia.org/wiki/YUV )r yuv_from_rgbrr0r0r1r" #r"cCr)agRGB to YIQ color space conversion. Parameters ---------- rgb : (..., 3, ...) array_like The image in RGB format. By default, the final dimension denotes channels. channel_axis : int, optional This parameter indicates which axis of the array corresponds to channels. .. versionadded:: 0.19 ``channel_axis`` was added in 0.19. Returns ------- out : (..., 3, ...) ndarray The image in YIQ format. Same dimensions as input. Raises ------ ValueError If `rgb` is not at least 2-D with shape (..., 3, ...). )r yiq_from_rgbrr0r0r1r# r#cCr)aRGB to YPbPr color space conversion. Parameters ---------- rgb : (..., 3, ...) array_like The image in RGB format. By default, the final dimension denotes channels. channel_axis : int, optional This parameter indicates which axis of the array corresponds to channels. .. versionadded:: 0.19 ``channel_axis`` was added in 0.19. Returns ------- out : (..., 3, ...) ndarray The image in YPbPr format. Same dimensions as input. Raises ------ ValueError If `rgb` is not at least 2-D with shape (..., 3, ...). References ---------- .. [1] https://en.wikipedia.org/wiki/YPbPr )rypbpr_from_rgbrr0r0r1r$3 r$cCs>tt|}|dd7<|dd7<|dd7<|S)aPRGB to YCbCr color space conversion. Parameters ---------- rgb : (..., 3, ...) array_like The image in RGB format. By default, the final dimension denotes channels. channel_axis : int, optional This parameter indicates which axis of the array corresponds to channels. .. versionadded:: 0.19 ``channel_axis`` was added in 0.19. Returns ------- out : (..., 3, ...) ndarray The image in YCbCr format. Same dimensions as input. Raises ------ ValueError If `rgb` is not at least 2-D with shape (..., 3, ...). Notes ----- Y is between 16 and 235. This is the color space commonly used by video codecs; it is sometimes incorrectly called "YUV". References ---------- .. [1] https://en.wikipedia.org/wiki/YCbCr r\r]r^)rycbcr_from_rgbrrr*r0r0r1r%Ts #r%cCstt|}|S)aDRGB to YDbDr color space conversion. Parameters ---------- rgb : (..., 3, ...) array_like The image in RGB format. By default, the final dimension denotes channels. channel_axis : int, optional This parameter indicates which axis of the array corresponds to channels. .. versionadded:: 0.19 ``channel_axis`` was added in 0.19. Returns ------- out : (..., 3, ...) ndarray The image in YDbDr format. Same dimensions as input. Raises ------ ValueError If `rgb` is not at least 2-D with shape (..., 3, ...). Notes ----- This is the color space commonly used by video codecs. It is also the reversible color transform in JPEG2000. References ---------- .. [1] https://en.wikipedia.org/wiki/YDbDr )rydbdr_from_rgbrr0r0r1r&~s #r&cCr)aYUV to RGB color space conversion. Parameters ---------- yuv : (..., 3, ...) array_like The image in YUV format. By default, the final dimension denotes channels. Returns ------- out : (..., 3, ...) ndarray The image in RGB format. Same dimensions as input. Raises ------ ValueError If `yuv` is not at least 2-D with shape (..., 3, ...). References ---------- .. [1] https://en.wikipedia.org/wiki/YUV )r rgb_from_yuv)rrr0r0r1rs rcCr)agYIQ to RGB color space conversion. Parameters ---------- yiq : (..., 3, ...) array_like The image in YIQ format. By default, the final dimension denotes channels. channel_axis : int, optional This parameter indicates which axis of the array corresponds to channels. .. versionadded:: 0.19 ``channel_axis`` was added in 0.19. Returns ------- out : (..., 3, ...) ndarray The image in RGB format. Same dimensions as input. Raises ------ ValueError If `yiq` is not at least 2-D with shape (..., 3, ...). )r rgb_from_yiq)rrr0r0r1rrrcCr)aYPbPr to RGB color space conversion. Parameters ---------- ypbpr : (..., 3, ...) array_like The image in YPbPr format. By default, the final dimension denotes channels. channel_axis : int, optional This parameter indicates which axis of the array corresponds to channels. .. versionadded:: 0.19 ``channel_axis`` was added in 0.19. Returns ------- out : (..., 3, ...) ndarray The image in RGB format. Same dimensions as input. Raises ------ ValueError If `ypbpr` is not at least 2-D with shape (..., 3, ...). References ---------- .. [1] https://en.wikipedia.org/wiki/YPbPr )rrgb_from_ypbpr)rrr0r0r1rrrcCsB|}|dd8<|dd8<|dd8<tt|S)aTYCbCr to RGB color space conversion. Parameters ---------- ycbcr : (..., 3, ...) array_like The image in YCbCr format. By default, the final dimension denotes channels. channel_axis : int, optional This parameter indicates which axis of the array corresponds to channels. .. versionadded:: 0.19 ``channel_axis`` was added in 0.19. Returns ------- out : (..., 3, ...) ndarray The image in RGB format. Same dimensions as input. Raises ------ ValueError If `ycbcr` is not at least 2-D with shape (..., 3, ...). Notes ----- Y is between 16 and 235. This is the color space commonly used by video codecs; it is sometimes incorrectly called "YUV". References ---------- .. [1] https://en.wikipedia.org/wiki/YCbCr r\rr]rr^)rrrgb_from_ycbcr)rrr*r0r0r1rs # rcCr)aIYDbDr to RGB color space conversion. Parameters ---------- ydbdr : (..., 3, ...) array_like The image in YDbDr format. By default, the final dimension denotes channels. channel_axis : int, optional This parameter indicates which axis of the array corresponds to channels. .. versionadded:: 0.19 ``channel_axis`` was added in 0.19. Returns ------- out : (..., 3, ...) ndarray The image in RGB format. Same dimensions as input. Raises ------ ValueError If `ydbdr` is not at least 2-D with shape (..., 3, ...). Notes ----- This is the color space commonly used by video codecs, also called the reversible color transform in JPEG2000. References ---------- .. [1] https://en.wikipedia.org/wiki/YDbDr )rrgb_from_ydbdr)rrr0r0r1r(rr)F)rE)N)rr)T)h__doc__warningsrnumpyr6scipyr _shared.utilsrrrrr utilr r r2r>rDrXrrr cie_primaries sb_primariesrinvrxyz_from_rgbciergbcie_from_xyzrr gray_from_rgbrrrrrrrrrr lab_ref_whiterrrrr rgb_from_hdxcross hdx_from_rgb rgb_from_fgx fgx_from_rgb rgb_from_bex bex_from_rgb rgb_from_rbd rbd_from_rgb rgb_from_gdx gdx_from_rgb rgb_from_hax hax_from_rgb rgb_from_bro bro_from_rgb rgb_from_bpx bpx_from_rgb rgb_from_ahx ahx_from_rgb rgb_from_hpx hpx_from_rgbrrr!r rrrrrrrrrrrrrrrrrrr rr"r#r$r%r&rrrrrr0r0r0r1s 3 DGYA                 ,  0  0  0    0  0    0  0  0 41'(-+JF0+\J&*+KG/  ,% )& )