colour.quality.ColourRendering_Specification_CQS#

class colour.quality.ColourRendering_Specification_CQS(name: str, Q_a: float, Q_f: float, Q_p: float | None, Q_g: float, Q_d: float | None, Q_as: Dict[int, DataColourQualityScale_VS], colorimetry_data: Tuple[Tuple[DataColorimetry_VS, ...], Tuple[DataColorimetry_VS, ...]])[source]#

Define the Colour Quality Scale (CQS) colour rendering (quality) specification.

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

  • Q_a (float) – Colour quality scale \(Q_a\).

  • Q_f (float) – Colour fidelity scale \(Q_f\) intended to evaluate the fidelity of object colour appearances (compared to the reference illuminant of the same correlated colour temperature and illuminance).

  • Q_p (float | None) – Colour preference scale \(Q_p\) similar to colour quality scale \(Q_a\) but placing additional weight on preference of object colour appearance, set to None in NIST CQS 9.0 method. This metric is based on the notion that increases in chroma are generally preferred and should be rewarded.

  • Q_g (float) – Gamut area scale \(Q_g\) representing the relative gamut formed by the (\(a^*\), \(b^*\)) coordinates of the 15 samples illuminated by the test light source in the CIE L*a*b* object colourspace.

  • Q_d (float | None) – Relative gamut area scale \(Q_d\), set to None in NIST CQS 9.0 method.

  • Q_as (Dict[int, colour.quality.cqs.DataColourQualityScale_VS]) – Individual Colour Quality Scale (CQS) data for each sample.

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

References

[DO10], [OD08], [OD13]

__init__(name: str, Q_a: float, Q_f: float, Q_p: float | None, Q_g: float, Q_d: float | None, Q_as: Dict[int, DataColourQualityScale_VS], colorimetry_data: Tuple[Tuple[DataColorimetry_VS, ...], Tuple[DataColorimetry_VS, ...]]) None#
Parameters:
  • name (str) –

  • Q_a (float) –

  • Q_f (float) –

  • Q_p (float | None) –

  • Q_g (float) –

  • Q_d (float | None) –

  • Q_as (Dict[int, DataColourQualityScale_VS]) –

  • colorimetry_data (Tuple[Tuple[DataColorimetry_VS, ...], Tuple[DataColorimetry_VS, ...]]) –

Return type:

None

Methods

__init__(name, Q_a, Q_f, Q_p, Q_g, Q_d, ...)

Attributes

name

Q_a

Q_f

Q_p

Q_g

Q_d

Q_as

colorimetry_data