colour.camera_RGB_to_ACES2065_1#

colour.camera_RGB_to_ACES2065_1(RGB: ArrayLike, B: ArrayLike, b: ArrayLike, k: ArrayLike = np.ones(3), clip: bool = False) numpy.ndarray[source]#

Convert given camera RGB colourspace array to ACES2065-1 colourspace using the Input Device Transform (IDT) matrix \(B\), the white balance multipliers \(b\) and the exposure factor \(k\) according to P-2013-001 procedure.

Parameters
  • RGB (ArrayLike) – Camera RGB colourspace array.

  • B (ArrayLike) – Input Device Transform (IDT) matrix \(B\).

  • b (ArrayLike) – White balance multipliers \(b\).

  • k (ArrayLike) – Exposure factor \(k\) that results in a nominally “18% gray” object in the scene producing ACES values [0.18, 0.18, 0.18].

  • clip (bool) – Whether to clip the white balanced camera RGB colourspace array between \(-\infty\) and 1. The intent is to keep sensor saturated values achromatic after white balancing.

Returns

ACES2065-1 colourspace relative exposure values array.

Return type

numpy.ndarray

References

[TheAoMPAaSciencesScienceaTCouncilAcademyCESACESPSubcommittee15]

Examples

>>> path = os.path.join(
...     RESOURCES_DIRECTORY_RAWTOACES,
...     'CANON_EOS_5DMark_II_RGB_Sensitivities.csv')
>>> sensitivities = sds_and_msds_to_msds(
...     read_sds_from_csv_file(path).values())
>>> illuminant = SDS_ILLUMINANTS['D55']
>>> B, b = matrix_idt(sensitivities, illuminant)
>>> camera_RGB_to_ACES2065_1(np.array([0.1, 0.2, 0.3]), B, b)
... 
array([ 0.2646811...,  0.1528898...,  0.4944335...])