colour.recovery.RGB_to_msds_camera_sensitivities_Jiang2013#

colour.recovery.RGB_to_msds_camera_sensitivities_Jiang2013(RGB: ArrayLike, illuminant: colour.colorimetry.spectrum.SpectralDistribution, reflectances: colour.colorimetry.spectrum.MultiSpectralDistributions, basis_functions=BASIS_FUNCTIONS_DYER2017, shape: colour.colorimetry.spectrum.SpectralShape | None = None) → colour.colorimetry.spectrum.MultiSpectralDistributions[source]#

Recover the camera RGB sensitivities for given camera RGB values using Jiang et al. (2013) method.

Parameters

  • RGB (ArrayLike) – Camera RGB values corresponding with reflectances.

  • illuminant (colour.colorimetry.spectrum.SpectralDistribution) – Illuminant spectral distribution used to produce the camera RGB values.

  • reflectances (colour.colorimetry.spectrum.MultiSpectralDistributions) – Reflectance spectral distributions used to produce the camera RGB values.

  • basis_functions – Basis functions for the method. The default is to use the built-in sRGB basis functions, i.e. colour.recovery.BASIS_FUNCTIONS_DYER2017.

  • shape (colour.colorimetry.spectrum.SpectralShape | None) – Spectral shape of the recovered camera RGB sensitivities, illuminant and reflectances will be aligned to it if passed, otherwise, illuminant shape is used.

Returns

Recovered camera RGB sensitivities.

Return type

colour.RGB_CameraSensitivities

Examples

>>> from colour.colorimetry import (
...     SDS_ILLUMINANTS,
...     msds_to_XYZ,
...     sds_and_msds_to_msds,
... )
>>> from colour.characterisation import (
...     MSDS_CAMERA_SENSITIVITIES,
...     SDS_COLOURCHECKERS,
... )
>>> from colour.recovery import SPECTRAL_SHAPE_BASIS_FUNCTIONS_DYER2017
>>> illuminant = SDS_ILLUMINANTS["D65"]
>>> sensitivities = MSDS_CAMERA_SENSITIVITIES["Nikon 5100 (NPL)"]
>>> reflectances = [
...     sd.copy().align(SPECTRAL_SHAPE_BASIS_FUNCTIONS_DYER2017)
...     for sd in SDS_COLOURCHECKERS["BabelColor Average"].values()
... ]
>>> reflectances = sds_and_msds_to_msds(reflectances)
>>> RGB = msds_to_XYZ(
...     reflectances,
...     method="Integration",
...     cmfs=sensitivities,
...     illuminant=illuminant,
...     k=1,
...     shape=SPECTRAL_SHAPE_BASIS_FUNCTIONS_DYER2017,
... )
>>> RGB_to_msds_camera_sensitivities_Jiang2013(
...     RGB,
...     illuminant,
...     reflectances,
...     BASIS_FUNCTIONS_DYER2017,
...     SPECTRAL_SHAPE_BASIS_FUNCTIONS_DYER2017,
... ).values  
array([[  7.2281577...e-03,   9.2250648...e-03,  -9.8836897...e-03],
       [ -8.5045760...e-03,   1.1277748...e-02,   3.8624865...e-03],
       [  4.5819113...e-02,   7.1552094...e-02,   4.0406829...e-01],
       [  7.5745635...e-02,   1.1530030...e-01,   7.1177452...e-01],
       [  6.7651854...e-02,   1.5311354...e-01,   8.5161378...e-01],
       [  5.1872905...e-02,   1.8828774...e-01,   9.3658053...e-01],
       [  4.3753995...e-02,   2.6093723...e-01,   9.7049828...e-01],
       [  4.5323885...e-02,   3.7531459...e-01,   9.5883525...e-01],
       [  5.0708454...e-02,   4.4750685...e-01,   8.8451412...e-01],
       [  4.2900523...e-02,   4.5047800...e-01,   7.5069924...e-01],
       [  4.1222513...e-02,   6.1672868...e-01,   5.5327277...e-01],
       [  5.3027385...e-02,   7.8015416...e-01,   3.8368507...e-01],
       [  9.4506252...e-02,   9.1751657...e-01,   2.4143664...e-01],
       [  1.3945472...e-01,   1.0000000...e+00,   1.5616071...e-01],
       [  7.7784852...e-02,   9.2719372...e-01,   1.0462050...e-01],
       [  4.4865285...e-02,   8.5627976...e-01,   6.5035086...e-02],
       [  5.1515558...e-02,   7.5193757...e-01,   3.3979292...e-02],
       [  1.0239098...e-01,   6.2562412...e-01,   2.0583993...e-02],
       [  5.1884509...e-01,   4.9264953...e-01,   1.4571020...e-02],
       [  9.5935619...e-01,   3.4322427...e-01,   1.0656116...e-02],
       [  9.7488799...e-01,   2.0857245...e-01,   6.8892462...e-03],
       [  8.2012477...e-01,   1.1178699...e-01,   4.3808407...e-03],
       [  6.7630666...e-01,   6.5977834...e-02,   4.0420907...e-03],
       [  5.5598866...e-01,   4.4719007...e-02,   4.2502316...e-03],
       [  4.1829651...e-01,   3.3471790...e-02,   4.6139542...e-03],
       [  2.9375101...e-01,   2.4044889...e-02,   4.7376860...e-03],
       [  2.2564606...e-01,   1.8870707...e-02,   4.6336440...e-03],
       [  1.3441624...e-01,   1.0702974...e-02,   3.4919622...e-03],
       [  4.0827617...e-02,   5.5529047...e-03,   1.3990786...e-03],
       [ -3.7143757...e-03,   2.5093564...e-03,   3.9765262...e-04],
       [ -5.6225656...e-03,   1.5643397...e-03,   5.8472693...e-04]])