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 given CIE Illuminant D Series using given 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 given 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})