colour.colour_fidelity_index#

colour.colour_fidelity_index(sd_test: SpectralDistribution, additional_data=False, method: Literal['CIE 2017', 'ANSI/IES TM-30-18'] | str = 'CIE 2017') 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 (Literal['CIE 2017', 'ANSI/IES TM-30-18'] | str) – Computation method.

Returns:

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

Return type:

float 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.1208244...