def test_n_dimensional_XYZ_to_UVW(self):
"""
Tests :func:`colour.models.cie_uvw.XYZ_to_UVW` definition n-dimensions
support.
"""
XYZ = np.array([0.07049534, 0.10080000, 0.09558313]) * 100
illuminant = np.array([0.34570, 0.35850])
UVW = np.array([-28.05797333, -0.88194493, 37.00411491])
np.testing.assert_almost_equal(XYZ_to_UVW(XYZ, illuminant),
UVW,
decimal=7)
XYZ = np.tile(XYZ, (6, 1))
UVW = np.tile(UVW, (6, 1))
np.testing.assert_almost_equal(XYZ_to_UVW(XYZ, illuminant),
UVW,
decimal=7)
illuminant = np.tile(illuminant, (6, 1))
np.testing.assert_almost_equal(XYZ_to_UVW(XYZ, illuminant),
UVW,
decimal=7)
XYZ = np.reshape(XYZ, (2, 3, 3))
illuminant = np.reshape(illuminant, (2, 3, 2))
UVW = np.reshape(UVW, (2, 3, 3))
np.testing.assert_almost_equal(XYZ_to_UVW(XYZ, illuminant),
UVW,
decimal=7)
def test_n_dimensional_XYZ_to_UVW(self):
"""
Tests :func:`colour.models.cie_uvw.XYZ_to_UVW` definition n-dimensional
support.
"""
XYZ = np.array([0.20654008, 0.12197225, 0.05136952]) * 100
illuminant = np.array([0.31270, 0.32900])
UVW = XYZ_to_UVW(XYZ, illuminant)
XYZ = np.tile(XYZ, (6, 1))
UVW = np.tile(UVW, (6, 1))
np.testing.assert_almost_equal(XYZ_to_UVW(XYZ, illuminant),
UVW,
decimal=7)
illuminant = np.tile(illuminant, (6, 1))
np.testing.assert_almost_equal(XYZ_to_UVW(XYZ, illuminant),
UVW,
decimal=7)
XYZ = np.reshape(XYZ, (2, 3, 3))
illuminant = np.reshape(illuminant, (2, 3, 2))
UVW = np.reshape(UVW, (2, 3, 3))
np.testing.assert_almost_equal(XYZ_to_UVW(XYZ, illuminant),
UVW,
decimal=7)
def test_domain_range_scale_XYZ_to_UVW(self):
"""
Tests :func:`colour.models.cie_uvw.XYZ_to_UVW` definition domain and
range scale support.
"""
XYZ = np.array([0.20654008, 0.12197225, 0.05136952]) * 100
illuminant = np.array([0.31270, 0.32900])
UVW = XYZ_to_UVW(XYZ, illuminant)
d_r = (('reference', 1), (1, 0.01), (100, 1))
for scale, factor in d_r:
with domain_range_scale(scale):
np.testing.assert_almost_equal(XYZ_to_UVW(
XYZ * factor, illuminant),
UVW * factor,
decimal=7)
def test_nan_XYZ_to_UVW(self):
"""
Tests :func:`colour.models.cie_uvw.XYZ_to_UVW` definition nan support.
"""
cases = [-1.0, 0.0, 1.0, -np.inf, np.inf, np.nan]
cases = set(permutations(cases * 3, r=3))
for case in cases:
XYZ = np.array(case)
illuminant = np.array(case[0:2])
XYZ_to_UVW(XYZ, illuminant)
def test_XYZ_to_UVW(self):
"""
Tests :func:`colour.models.cie_uvw.XYZ_to_UVW` definition.
"""
np.testing.assert_almost_equal(
XYZ_to_UVW(np.array([0.07049534, 0.10080000, 0.09558313]) * 100),
np.array([-28.05797333, -0.88194493, 37.00411491]),
decimal=7)
np.testing.assert_almost_equal(
XYZ_to_UVW(np.array([0.47097710, 0.34950000, 0.11301649]) * 100),
np.array([85.91004857, 17.74103859, 64.73769793]),
decimal=7)
np.testing.assert_almost_equal(
XYZ_to_UVW(np.array([0.25506814, 0.19150000, 0.08849752]) * 100),
np.array([59.34788373, 8.59000007, 49.88513399]),
decimal=7)
np.testing.assert_almost_equal(
XYZ_to_UVW(
np.array([0.07049534, 0.10080000, 0.09558313]) * 100,
np.array([0.44757, 0.40745])),
np.array([-50.56405108, -12.49600540, 37.00411491]),
decimal=7)
np.testing.assert_almost_equal(
XYZ_to_UVW(
np.array([0.07049534, 0.10080000, 0.09558313]) * 100,
np.array([0.31270, 0.32900])),
np.array([-22.59840563, 5.45505477, 37.00411491]),
decimal=7)
np.testing.assert_almost_equal(
XYZ_to_UVW(
np.array([0.07049534, 0.10080000, 0.09558313]) * 100,
np.array([0.37208, 0.37529])),
np.array([-33.35371445, -4.60753245, 37.00411491]),
decimal=7)
np.testing.assert_almost_equal(
XYZ_to_UVW(
np.array([0.07049534, 0.10080000, 0.09558313]) * 100,
np.array([0.37208, 0.37529, 0.10080])),
np.array([-33.35371445, -4.60753245, 37.00411491]),
decimal=7)
def test_XYZ_to_UVW(self):
"""
Tests :func:`colour.models.cie_uvw.XYZ_to_UVW` definition.
"""
np.testing.assert_almost_equal(
XYZ_to_UVW(np.array([0.07049534, 0.10080000, 0.09558313]) * 100),
np.array([-28.04832770, -0.88052424, 37.00411491]),
decimal=7)
np.testing.assert_almost_equal(
XYZ_to_UVW(np.array([0.47097710, 0.34950000, 0.11301649]) * 100),
np.array([85.92692334, 17.74352405, 64.73769793]),
decimal=7)
np.testing.assert_almost_equal(
XYZ_to_UVW(np.array([0.25506814, 0.19150000, 0.08849752]) * 100),
np.array([59.36088697, 8.5919153, 49.88513399]),
decimal=7)
np.testing.assert_almost_equal(
XYZ_to_UVW(
np.array([0.07049534, 0.10080000, 0.09558313]) * 100,
np.array([0.44757, 0.40745])),
np.array([-50.56405108, -12.4960054, 37.00411491]),
decimal=7)
np.testing.assert_almost_equal(
XYZ_to_UVW(
np.array([0.07049534, 0.10080000, 0.09558313]) * 100,
np.array([0.31271, 0.32902])),
np.array([-22.59813763, 5.45115077, 37.00411491]),
decimal=7)
np.testing.assert_almost_equal(
XYZ_to_UVW(
np.array([0.07049534, 0.10080000, 0.09558313]) * 100,
np.array([0.37208, 0.37529])),
np.array([-33.35371445, -4.60753245, 37.00411491]),
decimal=7)
np.testing.assert_almost_equal(
XYZ_to_UVW(
np.array([0.07049534, 0.10080000, 0.09558313]) * 100,
np.array([0.37208, 0.37529, 0.10080])),
np.array([-33.35371445, -4.60753245, 37.00411491]),
decimal=7)
def test_XYZ_to_UVW(self):
"""
Tests :func:`colour.models.cie_uvw.XYZ_to_UVW` definition.
"""
np.testing.assert_almost_equal(
XYZ_to_UVW(np.array([0.20654008, 0.12197225, 0.05136952]) * 100),
np.array([94.55035725, 11.55536523, 40.54757405]),
decimal=7)
np.testing.assert_almost_equal(
XYZ_to_UVW(np.array([0.14222010, 0.23042768, 0.10495772]) * 100),
np.array([-36.92762376, 28.90425105, 54.14071478]),
decimal=7)
np.testing.assert_almost_equal(
XYZ_to_UVW(np.array([0.07818780, 0.06157201, 0.28099326]) * 100),
np.array([-10.60111550, -41.94580000, 28.82134002]),
decimal=7)
np.testing.assert_almost_equal(
XYZ_to_UVW(
np.array([0.20654008, 0.12197225, 0.05136952]) * 100,
np.array([0.44757, 0.40745])),
np.array([63.90676310, -8.11466183, 40.54757405]),
decimal=7)
np.testing.assert_almost_equal(
XYZ_to_UVW(
np.array([0.20654008, 0.12197225, 0.05136952]) * 100,
np.array([0.34570, 0.35850])),
np.array([88.56798946, 4.61154385, 40.54757405]),
decimal=7)
np.testing.assert_almost_equal(
XYZ_to_UVW(
np.array([0.20654008, 0.12197225, 0.05136952]) * 100,
np.array([0.34570, 0.35850, 1.00000])),
np.array([88.56798946, 4.61154385, 40.54757405]),
decimal=7)
def test_XYZ_to_UVW(self):
"""
Tests :func:`colour.models.cie_uvw.XYZ_to_UVW` definition.
"""
np.testing.assert_almost_equal(XYZ_to_UVW(
np.array([0.96907232, 1, 1.12179215])),
np.array([-0.90199113, -1.56588889,
8.]),
decimal=7)
np.testing.assert_almost_equal(XYZ_to_UVW(
np.array([1.92001986, 1, -0.1241347])),
np.array([26.5159289, 3.8694711, 8.]),
decimal=7)
np.testing.assert_almost_equal(XYZ_to_UVW(
np.array([1.0131677, 1, 2.11217686])),
np.array([-2.89423113, -5.92004891,
8.]),
decimal=7)
np.testing.assert_almost_equal(XYZ_to_UVW(
np.array([1.0131677, 1, 2.11217686]), (0.44757, 0.40745)),
np.array([-7.76195429, -8.43122502,
8.]),
decimal=7)
np.testing.assert_almost_equal(XYZ_to_UVW(
np.array([1.0131677, 1, 2.11217686]), (1 / 3, 1 / 3)),
np.array([-3.03641679, -4.92226526,
8.]),
decimal=7)
np.testing.assert_almost_equal(XYZ_to_UVW(
np.array([1.0131677, 1, 2.11217686]), (0.31271, 0.32902)),
np.array([-1.7159427, -4.55119033, 8.]),
decimal=7)
def XYZ_to_colourspace_model(XYZ, illuminant, model, **kwargs):
"""
Converts from *CIE XYZ* tristimulus values to given colourspace model.
Parameters
----------
XYZ : array_like
*CIE XYZ* tristimulus values.
illuminant : array_like
*CIE XYZ* tristimulus values *illuminant* *xy* chromaticity
coordinates.
model : unicode
**{'CIE XYZ', 'CIE xyY', 'CIE xy', 'CIE Lab', 'CIE LCHab', 'CIE Luv',
'CIE Luv uv', 'CIE LCHuv', 'CIE UCS', 'CIE UCS uv', 'CIE UVW',
'DIN 99', 'Hunter Lab', 'Hunter Rdab', 'IPT', 'JzAzBz, 'OSA UCS',
'hdr-CIELAB', 'hdr-IPT'}**,
Colourspace model to convert the *CIE XYZ* tristimulus values to.
Other Parameters
----------------
\\**kwargs : dict, optional
Keywords arguments.
Returns
-------
ndarray
Colourspace model values.
Examples
--------
>>> import numpy as np
>>> XYZ = np.array([0.20654008, 0.12197225, 0.05136952])
>>> W = np.array([0.31270, 0.32900])
>>> XYZ_to_colourspace_model( # doctest: +ELLIPSIS
... XYZ, W, 'CIE XYZ')
array([ 0.2065400..., 0.1219722..., 0.0513695...])
>>> XYZ_to_colourspace_model( # doctest: +ELLIPSIS
... XYZ, W, 'CIE xyY')
array([ 0.5436955..., 0.3210794..., 0.1219722...])
>>> XYZ_to_colourspace_model( # doctest: +ELLIPSIS
... XYZ, W, 'CIE xy')
array([ 0.5436955..., 0.3210794...])
>>> XYZ_to_colourspace_model( # doctest: +ELLIPSIS
... XYZ, W, 'CIE Lab')
array([ 0.4152787..., 0.5263858..., 0.2692317...])
>>> XYZ_to_colourspace_model( # doctest: +ELLIPSIS
... XYZ, W, 'CIE LCHab')
array([ 0.4152787..., 0.5912425..., 0.0752458...])
>>> XYZ_to_colourspace_model( # doctest: +ELLIPSIS
... XYZ, W, 'CIE Luv')
array([ 0.4152787..., 0.9683626..., 0.1775210...])
>>> XYZ_to_colourspace_model( # doctest: +ELLIPSIS
... XYZ, W, 'CIE Luv uv')
array([ 0.3772021..., 0.5012026...])
>>> XYZ_to_colourspace_model( # doctest: +ELLIPSIS
... XYZ, W, 'CIE LCHuv')
array([ 0.4152787..., 0.9844997..., 0.0288560...])
>>> XYZ_to_colourspace_model( # doctest: +ELLIPSIS
... XYZ, W, 'CIE UCS uv')
array([ 0.3772021..., 0.3341350...])
>>> XYZ_to_colourspace_model( # doctest: +ELLIPSIS
... XYZ, W, 'CIE UVW')
array([ 0.9455035..., 0.1155536..., 0.4054757...])
>>> XYZ_to_colourspace_model( # doctest: +ELLIPSIS
... XYZ, W, 'DIN 99')
array([ 0.5322822..., 0.2841634..., 0.0389839...])
>>> XYZ_to_colourspace_model( # doctest: +ELLIPSIS
... XYZ, W, 'Hunter Lab')
array([ 0.3492452..., 0.4703302..., 0.1439330...])
>>> XYZ_to_colourspace_model( # doctest: +ELLIPSIS
... XYZ, W, 'Hunter Rdab')
array([ 0.1219722..., 0.5709032..., 0.1747109...])
>>> XYZ_to_colourspace_model( # doctest: +ELLIPSIS
... XYZ, W, 'IPT')
array([ 0.3842619..., 0.3848730..., 0.1888683...])
>>> XYZ_to_colourspace_model( # doctest: +ELLIPSIS
... XYZ, W, 'JzAzBz')
array([ 0.0053504..., 0.0092430..., 0.0052600...])
>>> XYZ_to_colourspace_model( # doctest: +ELLIPSIS
... XYZ, W, 'OSA UCS')
array([-0.0300499..., 0.0299713..., -0.0966784...])
>>> XYZ_to_colourspace_model( # doctest: +ELLIPSIS
... XYZ, W, 'hdr-CIELAB')
array([ 0.5187002..., 0.6047633..., 0.3214551...])
>>> XYZ_to_colourspace_model( # doctest: +ELLIPSIS
... XYZ, W, 'hdr-IPT')
array([ 0.4839376..., 0.4244990..., 0.2201954...])
"""
with domain_range_scale(1):
values = None
if model == 'CIE XYZ':
values = XYZ
elif model == 'CIE xyY':
values = XYZ_to_xyY(XYZ, illuminant)
elif model == 'CIE xy':
values = XYZ_to_xy(XYZ, illuminant)
elif model == 'CIE Lab':
values = XYZ_to_Lab(XYZ, illuminant)
elif model == 'CIE LCHab':
values = Lab_to_LCHab(XYZ_to_Lab(XYZ, illuminant))
elif model == 'CIE Luv':
values = XYZ_to_Luv(XYZ, illuminant)
elif model == 'CIE Luv uv':
values = Luv_to_uv(XYZ_to_Luv(XYZ, illuminant), illuminant)
elif model == 'CIE LCHuv':
values = Luv_to_LCHuv(XYZ_to_Luv(XYZ, illuminant))
elif model == 'CIE UCS':
values = XYZ_to_UCS(XYZ)
elif model == 'CIE UCS uv':
values = UCS_to_uv(XYZ_to_UCS(XYZ))
elif model == 'CIE UVW':
values = XYZ_to_UVW(XYZ, illuminant)
elif model == 'DIN 99':
values = Lab_to_DIN99(XYZ_to_Lab(XYZ, illuminant))
elif model == 'Hunter Lab':
values = XYZ_to_Hunter_Lab(XYZ, xy_to_XYZ(illuminant))
elif model == 'Hunter Rdab':
values = XYZ_to_Hunter_Rdab(XYZ, xy_to_XYZ(illuminant))
elif model == 'IPT':
values = XYZ_to_IPT(XYZ)
elif model == 'JzAzBz':
values = XYZ_to_JzAzBz(XYZ)
elif model == 'OSA UCS':
values = XYZ_to_OSA_UCS(XYZ)
elif model == 'hdr-CIELAB':
values = XYZ_to_hdr_CIELab(XYZ, illuminant, **kwargs)
elif model == 'hdr-IPT':
values = XYZ_to_hdr_IPT(XYZ, **kwargs)
if values is None:
raise ValueError(
'"{0}" not found in colourspace models: "{1}".'.format(
model, ', '.join(COLOURSPACE_MODELS)))
return values
def XYZ_to_colourspace_model(XYZ, illuminant, model, **kwargs):
"""
Converts from *CIE XYZ* tristimulus values to given colourspace model.
Parameters
----------
XYZ : array_like
*CIE XYZ* tristimulus values.
illuminant : array_like
Reference *illuminant* *CIE xy* chromaticity coordinates or *CIE xyY*
colourspace array.
model : unicode
**{'CIE XYZ', 'CIE xyY', 'CIE xy', 'CIE Lab', 'CIE LCHab', 'CIE Luv',
'CIE Luv uv', 'CIE LCHuv', 'CIE UCS', 'CIE UCS uv', 'CIE UVW',
'DIN 99', 'Hunter Lab', 'Hunter Rdab', 'IPT', 'JzAzBz, 'OSA UCS',
'hdr-CIELAB', 'hdr-IPT'}**,
Colourspace model to convert the *CIE XYZ* tristimulus values to.
Other Parameters
----------------
\\**kwargs : dict, optional
Keywords arguments.
Returns
-------
ndarray
Colourspace model values.
Warnings
--------
This definition is is deprecated and will be removed in a future release.
:func:`colour.convert` definition should be used instead.
Examples
--------
>>> import numpy as np
>>> XYZ = np.array([0.20654008, 0.12197225, 0.05136952])
>>> W = np.array([0.31270, 0.32900])
>>> XYZ_to_colourspace_model( # doctest: +ELLIPSIS
... XYZ, W, 'CIE XYZ')
array([ 0.2065400..., 0.1219722..., 0.0513695...])
>>> XYZ_to_colourspace_model( # doctest: +ELLIPSIS
... XYZ, W, 'CIE xyY')
array([ 0.5436955..., 0.3210794..., 0.1219722...])
>>> XYZ_to_colourspace_model( # doctest: +ELLIPSIS
... XYZ, W, 'CIE xy')
array([ 0.5436955..., 0.3210794...])
>>> XYZ_to_colourspace_model( # doctest: +ELLIPSIS
... XYZ, W, 'CIE Lab')
array([ 0.4152787..., 0.5263858..., 0.2692317...])
>>> XYZ_to_colourspace_model( # doctest: +ELLIPSIS
... XYZ, W, 'CIE LCHab')
array([ 0.4152787..., 0.5912425..., 0.0752458...])
>>> XYZ_to_colourspace_model( # doctest: +ELLIPSIS
... XYZ, W, 'CIE Luv')
array([ 0.4152787..., 0.9683626..., 0.1775210...])
>>> XYZ_to_colourspace_model( # doctest: +ELLIPSIS
... XYZ, W, 'CIE Luv uv')
array([ 0.3772021..., 0.5012026...])
>>> XYZ_to_colourspace_model( # doctest: +ELLIPSIS
... XYZ, W, 'CIE LCHuv')
array([ 0.4152787..., 0.9844997..., 0.0288560...])
>>> XYZ_to_colourspace_model( # doctest: +ELLIPSIS
... XYZ, W, 'CIE UCS')
array([ 0.1376933..., 0.1219722..., 0.1053731...])
>>> XYZ_to_colourspace_model( # doctest: +ELLIPSIS
... XYZ, W, 'CIE UCS uv')
array([ 0.3772021..., 0.3341350...])
>>> XYZ_to_colourspace_model( # doctest: +ELLIPSIS
... XYZ, W, 'CIE UVW')
array([ 0.9455035..., 0.1155536..., 0.4054757...])
>>> XYZ_to_colourspace_model( # doctest: +ELLIPSIS
... XYZ, W, 'DIN 99')
array([ 0.5322822..., 0.2841634..., 0.0389839...])
>>> XYZ_to_colourspace_model( # doctest: +ELLIPSIS
... XYZ, W, 'Hunter Lab')
array([ 0.3492452..., 0.4703302..., 0.1439330...])
>>> XYZ_to_colourspace_model( # doctest: +ELLIPSIS
... XYZ, W, 'Hunter Rdab')
array([ 0.1219722..., 0.5709032..., 0.1747109...])
>>> XYZ_to_colourspace_model( # doctest: +ELLIPSIS
... XYZ, W, 'IPT')
array([ 0.3842619..., 0.3848730..., 0.1888683...])
>>> XYZ_to_colourspace_model( # doctest: +ELLIPSIS
... XYZ, W, 'JzAzBz')
array([ 0.0053504..., 0.0092430..., 0.0052600...])
>>> XYZ_to_colourspace_model( # doctest: +ELLIPSIS
... XYZ, W, 'OSA UCS')
array([-0.0300499..., 0.0299713..., -0.0966784...])
>>> XYZ_to_colourspace_model( # doctest: +ELLIPSIS
... XYZ, W, 'hdr-CIELAB')
array([ 0.5187002..., 0.6047633..., 0.3214551...])
>>> XYZ_to_colourspace_model( # doctest: +ELLIPSIS
... XYZ, W, 'hdr-IPT')
array([ 0.4839376..., 0.4244990..., 0.2201954...])
>>> try:
... XYZ_to_colourspace_model(XYZ, W, 'Undefined')
... except ValueError as error:
... print(error)
"Undefined" not found in colourspace models: "CIE XYZ, CIE xyY, CIE Lab, \
CIE LCHab, CIE Luv, CIE Luv uv, CIE LCHuv, CIE UCS, CIE UCS uv, CIE UVW, \
DIN 99, Hunter Lab, Hunter Rdab, IPT, JzAzBz, OSA UCS, hdr-CIELAB, hdr-IPT".
"""
from colour.models import (
Lab_to_DIN99, Lab_to_LCHab, Luv_to_LCHuv, Luv_to_uv, UCS_to_uv,
XYZ_to_IPT, XYZ_to_Hunter_Lab, XYZ_to_Hunter_Rdab, XYZ_to_Lab,
XYZ_to_Luv, XYZ_to_OSA_UCS, XYZ_to_UCS, XYZ_to_UVW, XYZ_to_hdr_CIELab,
XYZ_to_hdr_IPT, XYZ_to_JzAzBz, XYZ_to_xy, XYZ_to_xyY, xy_to_XYZ)
with domain_range_scale(1):
values = None
if model == 'CIE XYZ':
values = XYZ
elif model == 'CIE xyY':
values = XYZ_to_xyY(XYZ, illuminant)
elif model == 'CIE xy':
values = XYZ_to_xy(XYZ, illuminant)
elif model == 'CIE Lab':
values = XYZ_to_Lab(XYZ, illuminant)
elif model == 'CIE LCHab':
values = Lab_to_LCHab(XYZ_to_Lab(XYZ, illuminant))
elif model == 'CIE Luv':
values = XYZ_to_Luv(XYZ, illuminant)
elif model == 'CIE Luv uv':
values = Luv_to_uv(XYZ_to_Luv(XYZ, illuminant), illuminant)
elif model == 'CIE LCHuv':
values = Luv_to_LCHuv(XYZ_to_Luv(XYZ, illuminant))
elif model == 'CIE UCS':
values = XYZ_to_UCS(XYZ)
elif model == 'CIE UCS uv':
values = UCS_to_uv(XYZ_to_UCS(XYZ))
elif model == 'CIE UVW':
values = XYZ_to_UVW(XYZ, illuminant)
elif model == 'DIN 99':
values = Lab_to_DIN99(XYZ_to_Lab(XYZ, illuminant))
elif model == 'Hunter Lab':
values = XYZ_to_Hunter_Lab(XYZ, xy_to_XYZ(illuminant))
elif model == 'Hunter Rdab':
values = XYZ_to_Hunter_Rdab(XYZ, xy_to_XYZ(illuminant))
elif model == 'IPT':
values = XYZ_to_IPT(XYZ)
elif model == 'JzAzBz':
values = XYZ_to_JzAzBz(XYZ)
elif model == 'OSA UCS':
values = XYZ_to_OSA_UCS(XYZ)
elif model == 'hdr-CIELAB':
values = XYZ_to_hdr_CIELab(XYZ, illuminant, **kwargs)
elif model == 'hdr-IPT':
values = XYZ_to_hdr_IPT(XYZ, **kwargs)
if values is None:
raise ValueError(
'"{0}" not found in colourspace models: "{1}".'.format(
model, ', '.join(COLOURSPACE_MODELS)))
return values
def XYZ_to_reference_colourspace(XYZ, illuminant, reference_colourspace):
"""
Converts from *CIE XYZ* tristimulus values to given reference colourspace.
Parameters
----------
XYZ : array_like
*CIE XYZ* tristimulus values.
illuminant : array_like
*CIE XYZ* tristimulus values *illuminant* *xy* chromaticity
coordinates.
reference_colourspace : unicode
**{'CIE XYZ', 'CIE xyY', 'CIE xy', 'CIE Lab', 'CIE Luv', 'CIE Luv uv',
'CIE UCS', 'CIE UCS uv', 'CIE UVW', 'IPT'}**,
Reference colourspace to convert the *CIE XYZ* tristimulus values to.
Returns
-------
ndarray
Reference colourspace values.
Examples
--------
>>> import numpy as np
>>> XYZ = np.array([0.07049534, 0.10080000, 0.09558313])
>>> W = np.array([0.34567, 0.35850])
>>> XYZ_to_reference_colourspace( # doctest: +ELLIPSIS
... XYZ, W, 'CIE XYZ')
array([ 0.0704953..., 0.1008 , 0.0955831...])
>>> XYZ_to_reference_colourspace( # doctest: +ELLIPSIS
... XYZ, W, 'CIE xyY')
array([ 0.2641477..., 0.3777000..., 0.1008 ])
>>> XYZ_to_reference_colourspace( # doctest: +ELLIPSIS
... XYZ, W, 'CIE xy')
array([ 0.2641477..., 0.3777000...])
>>> XYZ_to_reference_colourspace( # doctest: +ELLIPSIS
... XYZ, W, 'CIE Lab')
array([-23.6230288..., -4.4141703..., 37.9856291...])
>>> XYZ_to_reference_colourspace( # doctest: +ELLIPSIS
... XYZ, W, 'CIE LCHab')
array([ 24.0319036..., 190.5841597..., 37.9856291...])
>>> XYZ_to_reference_colourspace( # doctest: +ELLIPSIS
... XYZ, W, 'CIE Luv')
array([-28.7922944..., -1.3558195..., 37.9856291...])
>>> XYZ_to_reference_colourspace( # doctest: +ELLIPSIS
... XYZ, W, 'CIE Luv uv')
array([ 0.1508531..., 0.4853297...])
>>> XYZ_to_reference_colourspace( # doctest: +ELLIPSIS
... XYZ, W, 'CIE LCHuv')
array([ 28.82419932, 182.69604747, 37.9856291 ])
>>> XYZ_to_reference_colourspace( # doctest: +ELLIPSIS
... XYZ, W, 'CIE UCS uv')
array([ 0.1508531..., 0.32355314...])
>>> XYZ_to_reference_colourspace( # doctest: +ELLIPSIS
... XYZ, W, 'CIE UVW')
array([-28.0483277..., -0.8805242..., 37.0041149...])
>>> XYZ_to_reference_colourspace( # doctest: +ELLIPSIS
... XYZ, W, 'IPT')
array([-0.1111479..., 0.0159474..., 0.3657112...])
"""
value = None
if reference_colourspace == 'CIE XYZ':
value = XYZ
if reference_colourspace == 'CIE xyY':
value = XYZ_to_xyY(XYZ, illuminant)
if reference_colourspace == 'CIE xy': # Used for Chromaticity Diagram.
value = XYZ_to_xy(XYZ, illuminant)
if reference_colourspace == 'CIE Lab':
L, a, b = tsplit(XYZ_to_Lab(XYZ, illuminant))
value = tstack((a, b, L))
if reference_colourspace == 'CIE LCHab':
L, CH, ab = tsplit(Lab_to_LCHab(XYZ_to_Lab(XYZ, illuminant)))
value = tstack((CH, ab, L))
if reference_colourspace == 'CIE Luv':
L, u, v = tsplit(XYZ_to_Luv(XYZ, illuminant))
value = tstack((u, v, L))
if reference_colourspace == 'CIE Luv uv': # Used for Chromaticity Diagram.
u, v = tsplit(Luv_to_uv(XYZ_to_Luv(XYZ, illuminant), illuminant))
value = tstack((u, v))
if reference_colourspace == 'CIE LCHuv':
L, CH, uv = tsplit(Luv_to_LCHuv(XYZ_to_Luv(XYZ, illuminant)))
value = tstack((CH, uv, L))
if reference_colourspace == 'CIE UCS':
value = XYZ_to_UCS(XYZ)
if reference_colourspace == 'CIE UCS uv': # Used for Chromaticity Diagram.
u, v = tsplit(UCS_to_uv(XYZ_to_UCS(XYZ)))
value = tstack((u, v))
if reference_colourspace == 'CIE UVW':
value = XYZ_to_UVW(XYZ * 100, illuminant)
if reference_colourspace == 'IPT':
I, P, T = tsplit(XYZ_to_IPT(XYZ))
value = tstack((P, T, I))
if value is None:
raise ValueError(('"{0}" not found in reference colourspace models: '
'"{1}".').format(reference_colourspace,
', '.join(REFERENCE_COLOURSPACES)))
return value
def XYZ_to_colourspace_model(XYZ, illuminant, model):
"""
Converts from *CIE XYZ* tristimulus values to given colourspace model.
Parameters
----------
XYZ : array_like
*CIE XYZ* tristimulus values.
illuminant : array_like
*CIE XYZ* tristimulus values *illuminant* *xy* chromaticity
coordinates.
model : unicode
**{'CIE XYZ', 'CIE xyY', 'CIE xy', 'CIE Lab', 'CIE LCHab', 'CIE Luv',
'CIE Luv uv', 'CIE LCHuv', 'CIE UCS', 'CIE UCS uv', 'CIE UVW', 'IPT',
'Hunter Lab', 'Hunter Rdab'}**,
Colourspace model to convert the *CIE XYZ* tristimulus values to.
Returns
-------
ndarray
Colourspace model values.
Examples
--------
>>> import numpy as np
>>> XYZ = np.array([0.07049534, 0.10080000, 0.09558313])
>>> W = np.array([0.34570, 0.35850])
>>> XYZ_to_colourspace_model( # doctest: +ELLIPSIS
... XYZ, W, 'CIE XYZ')
array([ 0.0704953..., 0.1008 , 0.0955831...])
>>> XYZ_to_colourspace_model( # doctest: +ELLIPSIS
... XYZ, W, 'CIE xyY')
array([ 0.2641477..., 0.3777000..., 0.1008 ])
>>> XYZ_to_colourspace_model( # doctest: +ELLIPSIS
... XYZ, W, 'CIE xy')
array([ 0.2641477..., 0.3777000...])
>>> XYZ_to_colourspace_model( # doctest: +ELLIPSIS
... XYZ, W, 'CIE Lab')
array([ 37.9856291..., -23.6290768..., -4.4174661...])
>>> XYZ_to_colourspace_model( # doctest: +ELLIPSIS
... XYZ, W, 'CIE LCHab')
array([ 37.9856291..., 24.0384542..., 190.5892337...])
>>> XYZ_to_colourspace_model( # doctest: +ELLIPSIS
... XYZ, W, 'CIE Luv')
array([ 37.9856291..., -28.8021959..., -1.3580070...])
>>> XYZ_to_colourspace_model( # doctest: +ELLIPSIS
... XYZ, W, 'CIE Luv uv')
array([ 0.1508531..., 0.4853297...])
>>> XYZ_to_colourspace_model( # doctest: +ELLIPSIS
... XYZ, W, 'CIE LCHuv')
array([ 37.9856291..., 28.8341927..., 182.6994640...])
>>> XYZ_to_colourspace_model( # doctest: +ELLIPSIS
... XYZ, W, 'CIE UCS uv')
array([ 0.1508531..., 0.32355314...])
>>> XYZ_to_colourspace_model( # doctest: +ELLIPSIS
... XYZ, W, 'CIE UVW')
array([-28.0579733..., -0.8819449..., 37.0041149...])
>>> XYZ_to_colourspace_model( # doctest: +ELLIPSIS
... XYZ, W, 'IPT')
array([ 0.3657112..., -0.1111479..., 0.0159474...])
>>> XYZ_to_colourspace_model( # doctest: +ELLIPSIS
... XYZ, W, 'Hunter Lab')
array([ 31.7490157..., -15.1351736..., -2.7709606...])
>>> XYZ_to_colourspace_model( # doctest: +ELLIPSIS
... XYZ, W, 'Hunter Rdab')
array([ 10.08..., -18.7019271..., -3.4239649...])
"""
values = None
if model == 'CIE XYZ':
values = XYZ
elif model == 'CIE xyY':
values = XYZ_to_xyY(XYZ, illuminant)
elif model == 'CIE xy':
values = XYZ_to_xy(XYZ, illuminant)
elif model == 'CIE Lab':
values = XYZ_to_Lab(XYZ, illuminant)
elif model == 'CIE LCHab':
values = Lab_to_LCHab(XYZ_to_Lab(XYZ, illuminant))
elif model == 'CIE Luv':
values = XYZ_to_Luv(XYZ, illuminant)
elif model == 'CIE Luv uv':
values = Luv_to_uv(XYZ_to_Luv(XYZ, illuminant), illuminant)
elif model == 'CIE LCHuv':
values = Luv_to_LCHuv(XYZ_to_Luv(XYZ, illuminant))
elif model == 'CIE UCS':
values = XYZ_to_UCS(XYZ)
elif model == 'CIE UCS uv':
values = UCS_to_uv(XYZ_to_UCS(XYZ))
elif model == 'CIE UVW':
values = XYZ_to_UVW(XYZ * 100, illuminant)
elif model == 'IPT':
values = XYZ_to_IPT(XYZ)
elif model == 'Hunter Lab':
values = XYZ_to_Hunter_Lab(XYZ * 100, xy_to_XYZ(illuminant) * 100)
elif model == 'Hunter Rdab':
values = XYZ_to_Hunter_Rdab(XYZ * 100, xy_to_XYZ(illuminant) * 100)
if values is None:
raise ValueError(
'"{0}" not found in colourspace models: "{1}".'.format(
model, ', '.join(COLOURSPACE_MODELS)))
return values