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})