colour.colour_fidelity_index#

colour.colour_fidelity_index(sd_test: SpectralDistribution, additional_data=False, method: Union[Literal['CIE 2017', 'ANSI/IES TM-30-18'], str] = 'CIE 2017') Union[float, ColourRendering_Specification_CIE2017, ColourQuality_Specification_ANSIIESTM3018][source]#

Return the Colour Fidelity Index (CFI) \(R_f\) of given spectral distribution using given method.

Parameters:
  • sd_test (SpectralDistribution) – Test spectral distribution.

  • additional_data – Whether to output additional data.

  • method (Union[Literal['CIE 2017', 'ANSI/IES TM-30-18'], str]) – Computation method.

Returns:

Colour Fidelity Index (CFI) \(R_f\).

Return type:

numpy.floating or colour.quality.ColourRendering_Specification_CIE2017 or colour.quality.ColourQuality_Specification_ANSIIESTM3018

References

[CIET19017], [ANSIIESCCommittee18]

Examples

>>> from colour.colorimetry import SDS_ILLUMINANTS
>>> sd = SDS_ILLUMINANTS["FL2"]
>>> colour_fidelity_index(sd)  
70.1208254...