from ..color_conversion import rgb_to_sda
from .separate_stains_macenko_pca import separate_stains_macenko_pca
[docs]
def rgb_separate_stains_macenko_pca(im_rgb, I_0, *args, **kwargs):
"""Compute the stain matrix for color deconvolution with the "Macenko"
method from an RGB image or matrix.
Parameters
----------
im_rgb : array_like
Image (MxNx3) or matrix (3xN) in RGB space for which to compute the
stain matrix.
I_0 : float or array_like
Per-channel background intensities, or one intensity to use for all
channels if a float.
Returns
-------
w : array_like
A 3x3 matrix of stain column vectors, in SDA space
Note
----
For additional input arguments and documentation, please see
histomicstk.preprocessing.color_deconvolution.separate_stains_macenko_pca.
im_sda is computed and passed as part of this routine.
See Also
--------
histomicstk.preprocessing.color_deconvolution.separate_stains_macenko_pca
"""
im_sda = rgb_to_sda(im_rgb, I_0)
return separate_stains_macenko_pca(im_sda, *args, **kwargs)