"DIN99",
"Hunter Lab",
"Hunter Rdab",
"ICaCb",
"ICtCp",
"IPT",
"IgPgTg",
"Jzazbz",
"OSA UCS",
"Oklab",
"hdr-CIELAB",
"hdr-IPT",
)
if is_documentation_building(): # pragma: no cover
COLOURSPACE_MODELS = DocstringTuple(COLOURSPACE_MODELS)
COLOURSPACE_MODELS.__doc__ = """
Colourspace models supporting a direct conversion to *CIE XYZ* tristimulus
values.
"""
COLOURSPACE_MODELS_AXIS_LABELS: CaseInsensitiveMapping = (
CaseInsensitiveMapping({
"CAM02LCD": ("$J^\\prime$", "$a^\\prime$", "$b^\\prime$"),
"CAM02SCD": ("$J^\\prime$", "$a^\\prime$", "$b^\\prime$"),
"CAM02UCS": ("$J^\\prime$", "$a^\\prime$", "$b^\\prime$"),
"CAM16LCD": ("$J^\\prime$", "$a^\\prime$", "$b^\\prime$"),
"CAM16SCD": ("$J^\\prime$", "$a^\\prime$", "$b^\\prime$"),
"CAM16UCS": ("$J^\\prime$", "$a^\\prime$", "$b^\\prime$"),
"CIE XYZ": ("X", "Y", "Z"),
"CIE xyY": ("x", "y", "Y"),
"CIE Lab": ("$L^*$", "$a^*$", "$b^*$"),
__license__ = "New BSD License - https://opensource.org/licenses/BSD-3-Clause"
__maintainer__ = "Colour Developers"
__email__ = "*****@*****.**"
__status__ = "Production"
__all__ = [
"HDR_CIELAB_METHODS",
"exponent_hdr_CIELab",
"XYZ_to_hdr_CIELab",
"hdr_CIELab_to_XYZ",
]
HDR_CIELAB_METHODS: Tuple = ("Fairchild 2010", "Fairchild 2011")
if is_documentation_building(): # pragma: no cover
HDR_CIELAB_METHODS = DocstringTuple(HDR_CIELAB_METHODS)
HDR_CIELAB_METHODS.__doc__ = """
Supported *hdr-CIELAB* colourspace computation methods.
References
----------
:cite:`Fairchild2010`, :cite:`Fairchild2011`
"""
def exponent_hdr_CIELab(
Y_s: FloatingOrArrayLike,
Y_abs: FloatingOrArrayLike,
method: Union[Literal["Fairchild 2011", "Fairchild 2010"],
str] = "Fairchild 2011",
) -> FloatingOrNDArray:
"""
dot_vector)
from colour.utilities.documentation import DocstringTuple
__author__ = 'Colour Developers'
__copyright__ = 'Copyright (C) 2013-2019 - Colour Developers'
__license__ = 'New BSD License - https://opensource.org/licenses/BSD-3-Clause'
__maintainer__ = 'Colour Developers'
__email__ = '*****@*****.**'
__status__ = 'Production'
__all__ = [
'HDR_IPT_METHODS', 'exponent_hdr_IPT', 'XYZ_to_hdr_IPT', 'hdr_IPT_to_XYZ'
]
HDR_IPT_METHODS = DocstringTuple(('Fairchild 2010', 'Fairchild 2011'))
HDR_IPT_METHODS.__doc__ = """
Supported *hdr-IPT* colourspace computation methods.
References
----------
:cite:`Fairchild2010`, :cite:`Fairchild2011`
HDR_IPT_METHODS : tuple
**{'Fairchild 2011', 'Fairchild 2010'}**
"""
def exponent_hdr_IPT(Y_s, Y_abs, method='Fairchild 2011'):
"""
Computes *hdr-IPT* colourspace *Lightness* :math:`\\epsilon` exponent using
*Fairchild and Wyble (2010)* or *Fairchild and Chen (2011)* method.
dot_vector)
from colour.utilities.documentation import DocstringTuple
__author__ = 'Colour Developers'
__copyright__ = 'Copyright (C) 2013-2019 - Colour Developers'
__license__ = 'New BSD License - https://opensource.org/licenses/BSD-3-Clause'
__maintainer__ = 'Colour Developers'
__email__ = '*****@*****.**'
__status__ = 'Production'
__all__ = [
'HDR_IPT_METHODS', 'exponent_hdr_IPT', 'XYZ_to_hdr_IPT', 'hdr_IPT_to_XYZ'
]
HDR_IPT_METHODS = DocstringTuple(('Fairchild 2010', 'Fairchild 2011'))
HDR_IPT_METHODS.__doc__ = """
Supported *hdr-IPT* colourspace computation methods.
References
----------
:cite:`Fairchild2010`, :cite:`Fairchild2011`
HDR_IPT_METHODS : tuple
**{'Fairchild 2011', 'Fairchild 2010'}**
"""
def exponent_hdr_IPT(Y_s, Y_abs, method='Fairchild 2011'):
"""
Computes *hdr-IPT* colourspace *Lightness* :math:`\\epsilon` exponent using
*Fairchild and Wyble (2010)* or *Fairchild and Chen (2011)* method.
Q_d : numeric
Relative gamut area scale :math:`Q_d`, set to *None* in *NIST CQS 9.0*
method.
Q_as : dict
Individual *Colour Quality Scale* (CQS) data for each sample.
colorimetry_data : tuple
Colorimetry data for the test and reference computations.
References
----------
:cite:`Davis2010a`, :cite:`Ohno2008a`, :cite:`Ohno2013`
"""
COLOUR_QUALITY_SCALE_METHODS = DocstringTuple(['NIST CQS 7.4', 'NIST CQS 9.0'])
COLOUR_QUALITY_SCALE_METHODS.__doc__ = """
Supported *Colour Quality Scale* (CQS) computation methods.
References
----------
:cite:`Davis2010a`, :cite:`Ohno2008a`, :cite:`Ohno2013`
COLOUR_QUALITY_SCALE_METHODS : tuple
**{ 'NIST CQS 9.0', 'NIST CQS 7.4'}**
"""
def colour_quality_scale(sd_test,
additional_data=False,
method='NIST CQS 9.0'):
"""
Q_d : numeric
Relative gamut area scale :math:`Q_d`, set to *None* in *NIST CQS 9.0*
method.
Q_as : dict
Individual *Colour Quality Scale* (CQS) data for each sample.
colorimetry_data : tuple
Colorimetry data for the test and reference computations.
References
----------
:cite:`Davis2010a`, :cite:`Ohno2008a`, :cite:`Ohno2013`
"""
COLOUR_QUALITY_SCALE_METHODS = DocstringTuple(['NIST CQS 7.4', 'NIST CQS 9.0'])
COLOUR_QUALITY_SCALE_METHODS.__doc__ = """
Supported *Colour Quality Scale* (CQS) computation methods.
References
----------
:cite:`Davis2010a`, :cite:`Ohno2008a`, :cite:`Ohno2013`
COLOUR_QUALITY_SCALE_METHODS : tuple
**{ 'NIST CQS 9.0', 'NIST CQS 7.4'}**
"""
def colour_quality_scale(sd_test, additional_data=False,
method='NIST CQS 9.0'):
"""
Returns the *Colour Quality Scale* (CQS) of given spectral distribution
from colour.utilities.documentation import DocstringTuple
__author__ = 'Colour Developers'
__copyright__ = 'Copyright (C) 2013-2019 - Colour Developers'
__license__ = 'New BSD License - https://opensource.org/licenses/BSD-3-Clause'
__maintainer__ = 'Colour Developers'
__email__ = '*****@*****.**'
__status__ = 'Production'
__all__ = [
'HDR_CIELAB_METHODS', 'exponent_hdr_CIELab', 'XYZ_to_hdr_CIELab',
'hdr_CIELab_to_XYZ'
]
HDR_CIELAB_METHODS = DocstringTuple(('Fairchild 2010', 'Fairchild 2011'))
HDR_CIELAB_METHODS.__doc__ = """
Supported *hdr-CIELAB* colourspace computation methods.
References
----------
:cite:`Fairchild2010`, :cite:`Fairchild2011`
HDR_CIELAB_METHODS : tuple
**{'Fairchild 2011', 'Fairchild 2010'}**
"""
def exponent_hdr_CIELab(Y_s, Y_abs, method='Fairchild 2011'):
"""
Computes *hdr-CIELAB* colourspace *Lightness* :math:`\\epsilon` exponent
using *Fairchild and Wyble (2010)* or *Fairchild and Chen (2011)* method.
MATRIX_JZAZBZ_IZAZBZ_TO_LMS_P_SAFDAR2021: NDArray = np.linalg.inv(
MATRIX_JZAZBZ_LMS_P_TO_IZAZBZ_SAFDAR2021
)
"""
:math:`I_za_zb_z` intermediate colourspace to :math:`LMS_p`
*SMPTE ST 2084:2014* encoded normalised cone responses matrix.
References
----------
:cite:`Safdar2021`
"""
IZAZBZ_METHODS: Tuple = ("Safdar 2017", "Safdar 2021", "ZCAM")
if is_documentation_building(): # pragma: no cover
IZAZBZ_METHODS = DocstringTuple(IZAZBZ_METHODS)
IZAZBZ_METHODS.__doc__ = """
Supported :math:`I_za_zb_z` computation methods.
References
----------
:cite:`Safdar2017`, :cite:`Safdar2021`
"""
def XYZ_to_Izazbz(
XYZ_D65: ArrayLike,
constants: Optional[Structure] = None,
method: Union[
Literal["Safdar 2017", "Safdar 2021", "ZCAM"], str
] = "Safdar 2017",
) -> NDArray: