colour.colour_quality_scale

colour.colour_quality_scale(sd_test: SpectralDistribution, additional_data: Literal[False] = False, method: Literal['NIST CQS 7.4', 'NIST CQS 9.0'] | str = 'NIST CQS 9.0') → float

colour.colour_quality_scale(sd_test: SpectralDistribution, additional_data: Literal[True], method: Literal['NIST CQS 7.4', 'NIST CQS 9.0'] | str = 'NIST CQS 9.0') → ColourRendering_Specification_CQS

colour.colour_quality_scale(sd_test: MultiSpectralDistributions, additional_data: Literal[False] = False, method: Literal['NIST CQS 7.4', 'NIST CQS 9.0'] | str = 'NIST CQS 9.0') → NDArrayFloat

Compute the Colour Quality Scale (CQS) of the specified spectral distribution using the specified method.

Parameters:

• sd_test (SpectralDistribution | MultiSpectralDistributions) – Test spectral distribution. A colour.MultiSpectralDistributions of N test illuminants is also accepted, in which case additional_data must be False and the return value is a numpy.ndarray of N \(Q_a\) values.

• additional_data (bool) – Whether to output additional data.

• method (Literal['NIST CQS 7.4', 'NIST CQS 9.0'] | str) – Computation method.

Returns:

Colour Quality Scale (CQS).

Return type:

float, numpy.ndarray or colour.quality.ColourRendering_Specification_CQS

References

[DO10], [OD08], [OD13]

Examples

>>> from colour import SDS_ILLUMINANTS
>>> sd = SDS_ILLUMINANTS["FL2"]
>>> colour_quality_scale(sd)
np.float64(64.1118220...)