colour.sd_CIE_illuminant_D_series#

colour.sd_CIE_illuminant_D_series(xy: ArrayLike, M1_M2_rounding: bool = True, shape: SpectralShape | None = None) SpectralDistribution[source]#

Return the spectral distribution of the specified CIE Illuminant D Series using the specified CIE xy chromaticity coordinates.

Parameters:
  • xy (ArrayLike) – CIE xy chromaticity coordinates.

  • M1_M2_rounding (bool) – Whether to round \(M1\) and \(M2\) variables to 3 decimal places in order to yield the internationally agreed values.

  • shape (SpectralShape | None) – Specifies the shape of the returned SpectralDistribution. Optional, default None.

Returns:

CIE Illuminant D Series spectral distribution.

Return type:

colour.SpectralDistribution

Notes

  • The nominal CIE xy chromaticity coordinates which have been computed with colour.temperature.CCT_to_xy_CIE_D() must be specified according to CIE 015:2004 recommendation and thus multiplied by 1.4388 / 1.4380.

  • \(M1\) and \(M2\) variables are rounded to 3 decimal places according to CIE 015:2004 recommendation.

References

[CIET14804i], [WS00k]

Examples

>>> from colour.utilities import numpy_print_options
>>> from colour.temperature import CCT_to_xy_CIE_D
>>> CCT_D65 = 6500 * 1.4388 / 1.4380
>>> xy = CCT_to_xy_CIE_D(CCT_D65)
>>> with numpy_print_options(suppress=True):
...     sd_CIE_illuminant_D_series(xy)
SpectralDistribution([[300.     ,   0.0341...],
                      [305.     ,   1.6643...],
                      [310.     ,   3.2945...],
                      [315.     ,  11.7652...],
                      [320.     ,  20.236 ...],
                      [325.     ,  28.6447...],
                      [330.     ,  37.0535...],
                      [335.     ,  38.5011...],
                      [340.     ,  39.9488...],
                      [345.     ,  42.4302...],
                      [350.     ,  44.9117...],
                      [355.     ,  45.775 ...],
                      [360.     ,  46.6383...],
                      [365.     ,  49.3637...],
                      [370.     ,  52.0891...],
                      [375.     ,  51.0323...],
                      [380.     ,  49.9755...],
                      [385.     ,  52.3118...],
                      [390.     ,  54.6482...],
                      [395.     ,  68.7015...],
                      [400.     ,  82.7549...],
                      [405.     ,  87.1204...],
                      [410.     ,  91.486 ...],
                      [415.     ,  92.4589...],
                      [420.     ,  93.4318...],
                      [425.     ,  90.0570...],
                      [430.     ,  86.6823...],
                      [435.     ,  95.7736...],
                      [440.     , 104.8649...],
                      [445.     , 110.9362...],
                      [450.     , 117.0076...],
                      [455.     , 117.4099...],
                      [460.     , 117.8122...],
                      [465.     , 116.3365...],
                      [470.     , 114.8609...],
                      [475.     , 115.3919...],
                      [480.     , 115.9229...],
                      [485.     , 112.3668...],
                      [490.     , 108.8107...],
                      [495.     , 109.0826...],
                      [500.     , 109.3545...],
                      [505.     , 108.5781...],
                      [510.     , 107.8017...],
                      [515.     , 106.2957...],
                      [520.     , 104.7898...],
                      [525.     , 106.2396...],
                      [530.     , 107.6895...],
                      [535.     , 106.0475...],
                      [540.     , 104.4055...],
                      [545.     , 104.2258...],
                      [550.     , 104.0462...],
                      [555.     , 102.0231...],
                      [560.     , 100.    ...],
                      [565.     ,  98.1671...],
                      [570.     ,  96.3342...],
                      [575.     ,  96.0611...],
                      [580.     ,  95.788 ...],
                      [585.     ,  92.2368...],
                      [590.     ,  88.6856...],
                      [595.     ,  89.3459...],
                      [600.     ,  90.0062...],
                      [605.     ,  89.8026...],
                      [610.     ,  89.5991...],
                      [615.     ,  88.6489...],
                      [620.     ,  87.6987...],
                      [625.     ,  85.4936...],
                      [630.     ,  83.2886...],
                      [635.     ,  83.4939...],
                      [640.     ,  83.6992...],
                      [645.     ,  81.863 ...],
                      [650.     ,  80.0268...],
                      [655.     ,  80.1207...],
                      [660.     ,  80.2146...],
                      [665.     ,  81.2462...],
                      [670.     ,  82.2778...],
                      [675.     ,  80.281 ...],
                      [680.     ,  78.2842...],
                      [685.     ,  74.0027...],
                      [690.     ,  69.7213...],
                      [695.     ,  70.6652...],
                      [700.     ,  71.6091...],
                      [705.     ,  72.9790...],
                      [710.     ,  74.349 ...],
                      [715.     ,  67.9765...],
                      [720.     ,  61.604 ...],
                      [725.     ,  65.7448...],
                      [730.     ,  69.8856...],
                      [735.     ,  72.4863...],
                      [740.     ,  75.087 ...],
                      [745.     ,  69.3398...],
                      [750.     ,  63.5927...],
                      [755.     ,  55.0054...],
                      [760.     ,  46.4182...],
                      [765.     ,  56.6118...],
                      [770.     ,  66.8054...],
                      [775.     ,  65.0941...],
                      [780.     ,  63.3828...],
                      [785.     ,  63.8434...],
                      [790.     ,  64.304 ...],
                      [795.     ,  61.8779...],
                      [800.     ,  59.4519...],
                      [805.     ,  55.7054...],
                      [810.     ,  51.959 ...],
                      [815.     ,  54.6998...],
                      [820.     ,  57.4406...],
                      [825.     ,  58.8765...],
                      [830.     ,  60.3125...]],
                     LinearInterpolator,
                     {},
                     Extrapolator,
                     {'method': 'Constant', 'left': None, 'right': None})