Coverage for colour/models/rgb/datasets/russell_rgb.py: 100%

1""" 

2Russell RGB Colourspace 

3======================= 

4 

5Define the *Russell RGB* colourspace: 

6 

7- :attr:`colour.models.RGB_COLOURSPACE_RUSSELL_RGB`. 

8 

9References 

10---------- 

11- :cite:`Cottrella` : Cottrell, R. (n.d.). The Russell RGB working color 

12 space. http://www.russellcottrell.com/photo/downloads/RussellRGB.icc 

13""" 

14 

15from __future__ import annotations 

16 

17import typing 

18from functools import partial 

19 

20import numpy as np 

21 

22from colour.colorimetry.datasets import CCS_ILLUMINANTS 

23 

24if typing.TYPE_CHECKING: 

25 from colour.hints import NDArrayFloat 

26 

27from colour.models.rgb import RGB_Colourspace, gamma_function, normalised_primary_matrix 

28 

29__author__ = "Colour Developers" 

30__copyright__ = "Copyright 2013 Colour Developers" 

31__license__ = "BSD-3-Clause - https://opensource.org/licenses/BSD-3-Clause" 

32__maintainer__ = "Colour Developers" 

33__email__ = "colour-developers@colour-science.org" 

34__status__ = "Production" 

35 

36__all__ = [ 

37 "PRIMARIES_RUSSELL_RGB", 

38 "WHITEPOINT_NAME_RUSSELL_RGB", 

39 "CCS_WHITEPOINT_RUSSELL_RGB", 

40 "MATRIX_RUSSELL_RGB_TO_XYZ", 

41 "MATRIX_XYZ_TO_RUSSELL_RGB", 

42 "RGB_COLOURSPACE_RUSSELL_RGB", 

43] 

44 

45PRIMARIES_RUSSELL_RGB: NDArrayFloat = np.array( 

46 [ 

47 [0.6900, 0.3100], 

48 [0.1800, 0.7700], 

49 [0.1000, 0.0200], 

50 ] 

51) 

52"""*Russell RGB* colourspace primaries.""" 

53 

54WHITEPOINT_NAME_RUSSELL_RGB: str = "D55" 

55"""*Russell RGB* colourspace whitepoint name.""" 

56 

57CCS_WHITEPOINT_RUSSELL_RGB: NDArrayFloat = CCS_ILLUMINANTS[ 

58 "CIE 1931 2 Degree Standard Observer" 

59][WHITEPOINT_NAME_RUSSELL_RGB] 

60"""*Russell RGB* colourspace whitepoint chromaticity coordinates.""" 

61 

62MATRIX_RUSSELL_RGB_TO_XYZ: NDArrayFloat = normalised_primary_matrix( 

63 PRIMARIES_RUSSELL_RGB, CCS_WHITEPOINT_RUSSELL_RGB 

64) 

65"""*Russell RGB* colourspace to *CIE XYZ* tristimulus values matrix.""" 

66 

67MATRIX_XYZ_TO_RUSSELL_RGB: NDArrayFloat = np.linalg.inv(MATRIX_RUSSELL_RGB_TO_XYZ) 

68"""*CIE XYZ* tristimulus values to *Russell RGB* colourspace matrix.""" 

69 

70RGB_COLOURSPACE_RUSSELL_RGB: RGB_Colourspace = RGB_Colourspace( 

71 "Russell RGB", 

72 PRIMARIES_RUSSELL_RGB, 

73 CCS_WHITEPOINT_RUSSELL_RGB, 

74 WHITEPOINT_NAME_RUSSELL_RGB, 

75 MATRIX_RUSSELL_RGB_TO_XYZ, 

76 MATRIX_XYZ_TO_RUSSELL_RGB, 

77 partial(gamma_function, exponent=1 / 2.2), 

78 partial(gamma_function, exponent=2.2), 

79) 

80RGB_COLOURSPACE_RUSSELL_RGB.__doc__ = """ 

81*Russell RGB* colourspace. 

82 

83References 

84---------- 

85:cite:`Cottrella` 

86"""