colour.sd_blackbody#

colour.sd_blackbody(temperature: float, shape: SpectralShape = SPECTRAL_SHAPE_DEFAULT, c1: float = CONSTANT_C1, c2: float = CONSTANT_C2, n: float = CONSTANT_N) SpectralDistribution[source]#

Generate the spectral distribution of the planckian radiator for the specified temperature \(T[K]\) with values in watts per steradian per square metre per nanometre (\(W/sr/m^2/nm\)).

Parameters:
  • temperature (float) – Temperature \(T[K]\) in kelvins.

  • shape (SpectralShape) – Spectral shape used to create the spectral distribution of the planckian radiator.

  • c1 (float) – The official value of \(c_1\) is provided by the Committee on Data for Science and Technology (CODATA) and is \(c_1=3.741771 \times 10^{16}\ W/m^2\) (Mohr and Taylor, 2000).

  • c2 (float) – Since \(T\) is measured on the International Temperature Scale, the value of \(c_2\) used in colorimetry should follow that adopted in the current International Temperature Scale (ITS-90) (Preston-Thomas, 1990; Mielenz et al., 1991), namely \(c_2=1.4388 \times 10^{-2}\ m \cdot K\).

  • n (float) – Medium index of refraction. For dry air at 15°C and 101 325 Pa, containing 0.03 percent by volume of carbon dioxide, it is approximately 1.00028 throughout the visible region although CIE 15:2004 recommends using \(n=1\).

Returns:

Blackbody spectral distribution with values in watts per steradian per square metre per nanometre (\(W/sr/m^2/nm\)).

Return type:

colour.SpectralDistribution

Examples

>>> from colour.utilities import numpy_print_options
>>> with numpy_print_options(suppress=True):
...     sd_blackbody(5000, shape=SpectralShape(400, 700, 20))
...
SpectralDistribution([[   400.        ,   8742.5713329...],
                      [   420.        ,   9651.6810212...],
                      [   440.        ,  10447.3423137...],
                      [   460.        ,  11121.8597759...],
                      [   480.        ,  11673.7121534...],
                      [   500.        ,  12106.0645344...],
                      [   520.        ,  12425.4166118...],
                      [   540.        ,  12640.4550541...],
                      [   560.        ,  12761.1284859...],
                      [   580.        ,  12797.9345572...],
                      [   600.        ,  12761.3938171...],
                      [   620.        ,  12661.6795247...],
                      [   640.        ,  12508.3723863...],
                      [   660.        ,  12310.3119640...],
                      [   680.        ,  12075.5205176...],
                      [   700.        ,  11811.1793602...]],
                     SpragueInterpolator,
                     {},
                     Extrapolator,
                     {'method': 'Constant', 'left': None, 'right': None})