colour.colour_fidelity_index

colour.colour_fidelity_index(sd_test: SpectralDistribution | MultiSpectralDistributions, additional_data: bool = False, method: Literal['CIE 2017', 'ANSI/IES TM-30-18'] | str = 'CIE 2017') → float | NDArrayFloat | ColourRendering_Specification_CIE2017 | ColourQuality_Specification_ANSIIESTM3018

Compute the Colour Fidelity Index (CFI) \(R_f\) of the specified spectral distribution using the specified method.

Parameters:

• sd_test (SpectralDistribution | MultiSpectralDistributions) – Test spectral distribution.

• additional_data (bool) – 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, numpy.ndarray, 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)
np.float64(70.1208244...)