Colorimetry¶
Spectral Data Structure¶
colour
|
Defines the base object for spectral distribution shape. |
|
Defines the spectral distribution: the base object for spectral computations. |
|
Defines the multi-spectral distributions: the base object for multi spectral computations. |
(360, 780, 1). |
|
(360, 780, 1). |
Spectral Data Generation¶
colour
|
CIE Standard Illuminant A is intended to represent typical, domestic, tungsten-filament lighting. |
|
Returns the spectral distribution of given CIE Illuminant D Series using given CIE xy chromaticity coordinates. |
|
Returns the spectral distribution of the planckian radiator for given temperature \(T[K]\). |
|
Returns a spectral distribution of given spectral shape filled with constant \(k\) values. |
|
Returns a spectral distribution of given spectral shape filled with ones. |
|
Returns a spectral distribution of given spectral shape filled with zeros. |
Supported gaussian spectral distribution computation methods. |
|
|
Returns a gaussian spectral distribution of given spectral shape using given method. |
Supported single LED spectral distribution computation methods. |
|
|
Returns a single LED spectral distribution of given spectral shape at given peak wavelength and full width at half maximum according to given method. |
Supported multi LED spectral distribution computation methods. |
|
|
Returns a multi LED spectral distribution of given spectral shape at given peak wavelengths and full widths at half maximum according to given method. |
colour.colorimetry
|
Returns the spectral radiance of a blackbody at thermodynamic temperature \(T[K]\) in a medium having index of refraction \(n\). |
Returns the daylight locus as CIE xy chromaticity coordinates. |
|
|
Returns a gaussian spectral distribution of given spectral shape at given mean wavelength \(\mu\) and standard deviation \(sigma\). |
|
Returns a gaussian spectral distribution of given spectral shape at given peak wavelength and full width at half maximum. |
|
Returns a single LED spectral distribution of given spectral shape at given peak wavelength and full width at half maximum according to Ohno (2005) method. |
|
Returns a multi LED spectral distribution of given spectral shape at given peak wavelengths and full widths at half maximum according to Ohno (2005) method. |
Converts given spectral and multi-spectral distributions to a flat list of spectral distributions. |
Aliases
colour.colorimetry
|
Returns the spectral radiance of a blackbody at thermodynamic temperature \(T[K]\) in a medium having index of refraction \(n\). |
Conversion to Tristimulus Values¶
colour
|
Converts given spectral distribution to CIE XYZ tristimulus values using given colour matching functions, illuminant and method. |
Supported spectral distribution to CIE XYZ tristimulus values conversion methods. |
|
|
Converts given multi-spectral distributions to CIE XYZ tristimulus values using given colour matching functions and illuminant. |
Supported multi-spectral array to CIE XYZ tristimulus values conversion methods. |
|
|
Converts given wavelength \(\lambda\) to CIE XYZ tristimulus values using given colour matching functions. |
ASTM E308-15¶
colour.colorimetry
|
Converts given spectral distribution to CIE XYZ tristimulus values using given colour matching functions and illuminant according to practise ASTM E308-15 method. |
|
Converts given multi-spectral distributions to CIE XYZ tristimulus values using given colour matching functions and illuminant according to practise ASTM E308-15 method. |
Ancillary Objects
colour.colorimetry
Converts given spectral distribution to CIE XYZ tristimulus values using given colour matching functions and illuminant using a table of tristimulus weighting factors according to practise ASTM E308-15 method. |
|
Adjusts given table of tristimulus weighting factors to account for a shorter wavelengths range of the test spectral shape compared to the reference spectral shape using practise ASTM E308-15 method: Weights at the wavelengths for which data are not available are added to the weights at the shortest and longest wavelength for which spectral data are available. |
|
|
Computes the Lagrange Coefficients for given interval size using practise ASTM E2022-11 method. |
Returns a table of tristimulus weighting factors for given colour matching functions and illuminant using practise ASTM E2022-11 method. |
Integration¶
colour.colorimetry
|
Converts given spectral distribution to CIE XYZ tristimulus values using given colour matching functions and illuminant according to classical integration method. |
|
Converts given multi-spectral distributions to CIE XYZ tristimulus values using given colour matching functions and illuminant. |
Spectral Bandpass Dependence Correction¶
colour
|
Implements spectral bandpass dependence correction on given spectral distribution using given method. |
Supported spectral bandpass dependence correction methods. |
Stearns and Stearns (1988)¶
colour.colorimetry
Implements spectral bandpass dependence correction on given spectral distribution using Stearns and Stearns (1988) method. |
Colour Matching Functions¶
colour.colorimetry
|
Implements support for the Stockman and Sharpe LMS cone fundamentals colour matching functions. |
|
Implements support for the CIE RGB colour matching functions. |
|
Implements support for the CIE Standard Observers XYZ colour matching functions. |
Dataset
colour
Aggregated colour matching functions. |
|
LMS colour matching functions. |
|
CIE RGB colour matching functions. |
|
CIE Standard Observers XYZ colour matching functions. |
Colour Matching Functions Transformations¶
Ancillary Objects
colour.colorimetry
Converts Wright & Guild 1931 2 Degree RGB CMFs colour matching functions into the CIE 1931 2 Degree Standard Observer colour matching functions. |
|
Converts Stiles & Burch 1959 10 Degree RGB CMFs colour matching functions into the CIE 1964 10 Degree Standard Observer colour matching functions. |
|
Converts Stiles & Burch 1959 10 Degree RGB CMFs colour matching functions into the Stockman & Sharpe 10 Degree Cone Fundamentals spectral sensitivity functions. |
|
Converts Stockman & Sharpe 2 Degree Cone Fundamentals colour matching functions into the CIE 2012 2 Degree Standard Observer colour matching functions. |
|
Converts Stockman & Sharpe 10 Degree Cone Fundamentals colour matching functions into the CIE 2012 10 Degree Standard Observer colour matching functions. |
Illuminants and Light Sources¶
Dataset
colour
Aggregated CIE illuminants chromaticity coordinates. |
|
CIE illuminants spectral distributions. |
|
Aggregated Hunter L,a,b illuminant datasets. |
|
Aggregated light sources chromaticity coordinates. |
|
Aggregated light sources spectral distributions. |
Dominant Wavelength and Purity¶
colour
|
Returns the dominant wavelength \(\lambda_d\) for given colour stimulus \(xy\) and the related \(xy_wl\) first and \(xy_{cw}\) second intersection coordinates with the spectral locus. |
|
Returns the complementary wavelength \(\lambda_c\) for given colour stimulus \(xy\) and the related \(xy_wl\) first and \(xy_{cw}\) second intersection coordinates with the spectral locus. |
|
Returns the excitation purity \(P_e\) for given colour stimulus \(xy\). |
|
Returns the colorimetric purity \(P_c\) for given colour stimulus \(xy\). |
Luminous Efficiency Functions¶
colour
|
Returns the luminous efficacy in \(lm\cdot W^{-1}\) of given spectral distribution using given luminous efficiency function. |
|
Returns the luminous efficiency of given spectral distribution using given luminous efficiency function. |
|
Returns the luminous flux for given spectral distribution using given luminous efficiency function. |
Returns the mesopic luminous efficiency function \(V_m(\lambda)\) for given photopic luminance \(L_p\). |
Dataset
colour
Aggregated luminous efficiency functions. |
|
Photopic luminous efficiency functions. |
|
Scotopic luminous efficiency functions. |
Lightness Computation¶
colour
|
Returns the Lightness \(L\) of given luminance \(Y\) using given method. |
Supported Lightness computation methods. |
Glasser, Mckinney, Reilly and Schnelle (1958)¶
colour.colorimetry
Returns the Lightness \(L\) of given luminance \(Y\) using Glasser et al.(1958) method.. |
Wyszecki (1963)¶
colour.colorimetry
Returns the Lightness \(W\) of given luminance \(Y\) using Wyszecki (1963) method. |
CIE 1976¶
colour.colorimetry
|
Returns the Lightness \(L^*\) of given luminance \(Y\) using given reference white luminance \(Y_n\) as per CIE 1976 recommendation. |
|
Returns the intermediate value \(f(Y/Yn)\) in the Lightness \(L^*\) computation for given luminance \(Y\) using given reference white luminance \(Y_n\) as per CIE 1976 recommendation. |
Fairchild and Wyble (2010)¶
colour.colorimetry
|
Computes Lightness \(L_{hdr}\) of given luminance \(Y\) using Fairchild and Wyble (2010) method according to Michealis-Menten kinetics. |
Fairchild and Chen (2011)¶
colour.colorimetry
|
Computes Lightness \(L_{hdr}\) of given luminance \(Y\) using Fairchild and Chen (2011) method according to Michealis-Menten kinetics. |
Luminance Computation¶
colour
|
Returns the luminance \(Y\) of given Lightness \(L^*\) or given Munsell value \(V\). |
Supported luminance computation methods. |
Newhall, Nickerson and Judd (1943)¶
colour.colorimetry
Returns the luminance \(R_Y\) of given Munsell value \(V\) using Newhall et al.(1943) method.. |
CIE 1976¶
colour.colorimetry
|
Returns the luminance \(Y\) of given Lightness \(L^*\) with given reference white luminance \(Y_n\). |
Returns the luminance \(Y\) in the luminance \(Y\) computation for given intermediate value \(f(Y/Yn)\) using given reference white luminance \(Y_n\) as per CIE 1976 recommendation. |
ASTM D1535-08e1¶
colour.colorimetry
Returns the luminance \(Y\) of given Munsell value \(V\) using ASTM D1535-08e1 method. |
Fairchild and Wyble (2010)¶
colour.colorimetry
|
Computes luminance \(Y\) of given Lightness \(L_{hdr}\) using Fairchild and Wyble (2010) method according to Michealis-Menten kinetics. |
Fairchild and Chen (2011)¶
colour.colorimetry
|
Computes luminance \(Y\) of given Lightness \(L_{hdr}\) using Fairchild and Chen (2011) method according to Michealis-Menten kinetics. |
Whiteness Computation¶
colour
|
Returns the whiteness \(W\) using given method. |
Supported whiteness computation methods. |
Berger (1959)¶
colour.colorimetry
|
Returns the whiteness index \(WI\) of given sample CIE XYZ tristimulus values using Berger (1959) method. |
Taube (1960)¶
colour.colorimetry
|
Returns the whiteness index \(WI\) of given sample CIE XYZ tristimulus values using Taube (1960) method. |
Stensby (1968)¶
colour.colorimetry
Returns the whiteness index \(WI\) of given sample CIE L*a*b* colourspace array using Stensby (1968) method. |
ASTM E313¶
colour.colorimetry
|
Returns the whiteness index \(WI\) of given sample CIE XYZ tristimulus values using ASTM E313 method. |
Ganz and Griesser (1979)¶
colour.colorimetry
|
Returns the whiteness index \(W\) and tint \(T\) of given sample CIE xy chromaticity coordinates using Ganz and Griesser (1979) method. |
CIE 2004¶
colour.colorimetry
|
Returns the whiteness \(W\) or \(W_{10}\) and tint \(T\) or \(T_{10}\) of given sample CIE xy chromaticity coordinates using CIE 2004 method. |
Yellowness Computation¶
colour
|
Returns the yellowness \(W\) using given method. |
Supported yellowness computation methods. |
ASTM D1925¶
colour.colorimetry
|
Returns the yellowness index \(YI\) of given sample CIE XYZ tristimulus values using ASTM D1925 method. |
ASTM E313¶
colour.colorimetry
|
Returns the yellowness index \(YI\) of given sample CIE XYZ tristimulus values using ASTM E313 method. |