colour.quality.ColourQuality_Specification_ANSIIESTM3018#

class colour.quality.ColourQuality_Specification_ANSIIESTM3018(name: str, sd_test: SpectralDistribution, sd_reference: SpectralDistribution, R_f: float, R_s: NDArrayFloat, CCT: float, D_uv: float, colorimetry_data: Tuple[DataColorimetry_TCS_CIE2017, DataColorimetry_TCS_CIE2017], R_g: float, bins: NDArrayInt, averages_test: NDArrayFloat, averages_reference: NDArrayFloat, average_norms: NDArrayFloat, R_fs: NDArrayFloat, R_cs: NDArrayFloat, R_hs: NDArrayFloat)[source]#

Define the ANSI/IES TM-30-18 Colour Fidelity Index (CFI) colour quality specification.

Parameters:
  • name (str) – Name of the test spectral distribution.

  • sd_test (colour.colorimetry.spectrum.SpectralDistribution) – Spectral distribution of the tested illuminant.

  • sd_reference (colour.colorimetry.spectrum.SpectralDistribution) – Spectral distribution of the reference illuminant.

  • R_f (float) – Colour Fidelity Index (CFI) \(R_f\).

  • R_s (NDArrayFloat) – Individual colour fidelity indexes data for each sample.

  • CCT (float) – Correlated colour temperature \(T_{cp}\).

  • D_uv (float) – Distance from the Planckian locus \(\Delta_{uv}\).

  • colorimetry_data (Tuple[colour.quality.cfi2017.DataColorimetry_TCS_CIE2017, colour.quality.cfi2017.DataColorimetry_TCS_CIE2017]) – Colorimetry data for the test and reference computations.

  • R_g (float) – Gamut index \(R_g\).

  • bins (NDArrayInt) – List of 16 lists, each containing the indexes of colour samples that lie in the respective hue bin.

  • averages_test (NDArrayFloat) – Averages of CAM02-UCS a’, b’ coordinates for each hue bin for test samples.

  • averages_reference (NDArrayFloat) – Averages for reference samples.

  • average_norms (NDArrayFloat) – Distance of averages for reference samples from the origin.

  • R_fs (NDArrayFloat) – Local colour fidelities for each hue bin.

  • R_cs (NDArrayFloat) – Local chromaticity shifts for each hue bin, in percents.

  • R_hs (NDArrayFloat) – Local hue shifts for each hue bin.

__init__(name: str, sd_test: SpectralDistribution, sd_reference: SpectralDistribution, R_f: float, R_s: NDArrayFloat, CCT: float, D_uv: float, colorimetry_data: Tuple[DataColorimetry_TCS_CIE2017, DataColorimetry_TCS_CIE2017], R_g: float, bins: NDArrayInt, averages_test: NDArrayFloat, averages_reference: NDArrayFloat, average_norms: NDArrayFloat, R_fs: NDArrayFloat, R_cs: NDArrayFloat, R_hs: NDArrayFloat) None#
Parameters:
  • name (str) –

  • sd_test (SpectralDistribution) –

  • sd_reference (SpectralDistribution) –

  • R_f (float) –

  • R_s (NDArrayFloat) –

  • CCT (float) –

  • D_uv (float) –

  • colorimetry_data (Tuple[DataColorimetry_TCS_CIE2017, DataColorimetry_TCS_CIE2017]) –

  • R_g (float) –

  • bins (NDArrayInt) –

  • averages_test (NDArrayFloat) –

  • averages_reference (NDArrayFloat) –

  • average_norms (NDArrayFloat) –

  • R_fs (NDArrayFloat) –

  • R_cs (NDArrayFloat) –

  • R_hs (NDArrayFloat) –

Return type:

None

Methods

__init__(name, sd_test, sd_reference, R_f, ...)

Attributes

name

sd_test

sd_reference

R_f

R_s

CCT

D_uv

colorimetry_data

R_g

bins

averages_test

averages_reference

average_norms

R_fs

R_cs

R_hs