LED ColorCalculator

Version History

The ColorCalculator software was developed by OSRAM SYLVANIA to aid designers develop color mixing LED lighting solutions. The ColorCalculator software is a standalone program that allows designers to estimate the photometric performance of color mixing schemes.

Version 7.77

  • You can change the line width in the spectrum plots under the "Image Options" menu item.

Version 7.75

  • Added support for importing "Argyll CMS" formatted spectra.
  • All of the output values from the 5 main output tabs are now written to the photometry.xls file, previously only selected values were written.
  • You can control which values are written to the photometry.xls file as well as the order they are written. Use the "Outputs->Set the order of the photometry data written to the Excel (tab delimited) file (photometry.xls)" menu item.
  • The "Academy Spectral Similarity Index 2019 (SSI)" can be calculated using either a black body, daylight or user defined reference light source. Use the options under the "Outputs" menu item to select between these three source types. This metric is displayed on the 5th output tab. There are two ways to do this calculation.
    • If you use either a blackbody or daylight reference you can change these desired CCT in the UI or use the mouse wheel to change them.
    • If you select "user" as the reference spectrum type, enable "Matching mode" under the "Matching" menu. Then under the "Matching" menu select which type of matching spectrum you want to use. You can select between blackbody, daylight or "user entered". If you select either blackbody or daylight you can enter these values in the UI. If you select "user entered" you can paste your own spectrum into the table in the "Matching" column. This method has the advantage of displaying the reference spectrum in the spectrum plot.
    • As a note: an easy way to enter a matching spectrum is to select it, do a calculation, then right-click in the matching column of the table and select the "Copy spectrum into the matching column" option.

Version 7.73

  • The white point used to calculate the dominate wavelength and purity of a spectrum in the "Other Calculations->Calculate CCT, Duv, dominant WL and purity from x, y..." menu item dialog can now be selected by the user.

Version 7.71

  • Up to 10 user defined ellipses can now be entered. There are more details on defining your own ellipses in the \"Help\" menu (click the question mark icon) of the "Custom CIE" dialog.

Version 7.69

  • You can now define your own ellipses to use on the CIE plot. This is only available in the "Custom CIE" dialog. You can enter either: a, b, and theta or g11, 2g12 and g22 to define your ellipse. If you right-click on the table you will see a popup menu with several short-cuts. You can enter multiple steps to draw several ellipses, e.g., you can enter "2 2.5 3" for the "# steps" to draw these 3 ellipses.

Version 7.67

  • If you enter a user spectrum for the matching spectrum it will be saved when you exit the program.
  • Fixed some bugs in the "Match spectrum" optimization method.

Version 7.63

  • The color of the matching curve in the spectrum plot can now be selected to be black, red or blue.

Version 7.61

  • Fixed bug where the line of the matching curve in the spectrum plot was not thick as displayed in the legend.
  • Windows XP is no longer supported.

Version 7.59

  • The TM-30-18 chroma and hue shifts are written to a new results tab in the main window.

Version 7.57

  • The CQS calculation was mistakenly disabled. This has been restored. All values are displayed.

Version 7.55

  • Added toolbar icon "TM-30" which will display the TM-30 summary report for quick viewing. You can still use the "IES TM-30-18" menu item to save and customize this report.

Version 7.53

  • Added the ability to define your own point colors in the "Other Calculations->3D CIE L*a*b* plot with user inputted values..." menu item function. You can also right-click in the table for a pop-up color selection list.
  • 4-step ANSI C78.376-2001 MacAdam ellipses are available for plotting on the CIE diagrams.

Version 7.51

  • You can change the column order of the data input table in the "Other Calculations->3D CIE L*a*b* plot with user inputted values..." menu item function.

Version 7.49

  • Fixed several bugs in the "Other Calculations->3D CIE L*a*b* plot with user inputted values..." menu item function.

Version 7.47

  • In the Custom CIE window you can save all of your data points and other settings to a file for reuse later. Use the "File->Read all from a file" and/or "File->Save all to a file" menu items.

Version 7.45

  • New output was added for horticulture spectra. The output in umol/s in predefined wavelength bins is calculated. You can see these results using the "leaf" icon on the menu toolbar (right-most icon) or by clicking the "Other Calculations->Calculate spectrum photon flux by regions" menu item.
  • The program can now automatically include the IR region if the spectrum has intensity above 830 nm. You can enable/disable this by checking the "Inputs->Include IR if any selected spectra have more then 0.5% of their intensity beyond 830 nm" menu item. It is enabled by default.

Version 7.43

  • In the Custom CIE plot window you can now position the point labels individually.

Version 7.41

  • When making a TM-30 report you can view the report within the ColorCalculator software before saving it to a file or the clipboard.
  • Fixed a bug that would crash the program when reading in a spectrum file with a large number of data points..

Version 7.39

  • You can now make 3D plots of the the R, Q and TM-30 colors. Use the "Other Options->3D CIE L*a*b* & CAM02-UCS J*a*b* plots with current spectrum" menu item. You can use your mouse to pan and zoom the plot.
  • You can read in *.isd type files to define a filter.

Version 7.37

  • Replaced the IES TM-30-15 calculation with the new TM-30-18 standard.
  • Fixed some bugs in the "Other Calculations->Multi-design optimization..." routines.
  • Removed the CIE 224 2017 calculations added in v7.19. The updated IES TM-30-18 covers this.
  • Added calculation of the "Well Building Melanopic Ratio" (WBMR) to tab #4.
  • Added calculation of the scotopic lumens and S/P ratio (scotopic lumens / photopic lumens) to tab #4.
  • Changed the "Other Calculations->Calculate the gamut area coverage..." routine so that if your gamut covers all of the standard gamut and more, the coverage value will be > 100%. Previously this was erroneously capped at 100%. Note that if your gamut is larger than the standard gamut but does not cover all of the standard gamut the coverage value will still be less than 100%.
  • Added 3D plots of CIEL*a*b* and J*a*b* spaces, see "Other Calculations->3D CIE L*a*b* && CAM02-UCS J*a*b* plots with current spectrum".
  • Added calculation for the dominant wave length and purity from the x,y coordinates, see "Other Calculations->Calculate CCT, Duv, dominant WL and purity from x,y...".
  • The x,y coordinates of the predefined gamuts can be written to a file, see "Other Options->Write the predefined gamut points to a file".

Version 7.25

  • Added calculation of the "Full Spectrum Index" (FSI) and "Full Spectum Color Index" (FSCI) to tab #4.

Version 7.23

  • Fixed bug in the "Other Calculations->Calculate binning from x,y, and lumens..." routine where some wavelength ranges were being flagged as being outside of the allowed range.
  • Allow filters to be using in the optimization method.
  • Added Rf,i histogram plots for the 99 TM-30 colors.
  • MacAdams ellipse can no longer be drawn on the CIE 170-2:2015 10° diagrams.

Version 7.21

  • Fixed problems reading spectral data saved in non-UFT-8 file formats.

Version 7.19

  • Added CIE 224 2017 calculations. This standard is based on the IES TM-30 work.
  • Updated link to new OSRAM web site.
  • Fixed a bug in the OS X version that caused the user settings to be ignored and the startup screens to always be displayed.
  • Added a verison for 32-bit Linux.
  • Fixed a few minor bugs.

Version 7.15

  • When saving images and plots to the clipboard or a file, you can now specify a magnification factor of 1x, 2x, 4x or 8x. This will save the image/file at a larger size for higher resolution.
  • You can now select between a uniform and a normal distribution for the binning spreads in the "binning from x, y, and lumens" routine.
  • You can write the Cx and Cy points to a file in the "binning from x, y, and lumens" routine and read them in to the table in the "Custom CIE" window.
  • Added the Rec. 709 gamut as a standard selection.
  • Added gamut area calculations. Use the "Other Calculations->Calculate gamut area coverage..." menu item. Enter your color points and the percentage coverage of several standard gamuts is calculated.
  • The color of the MacAdam and u'v' ellipses can be changed to black, red or blue.

Version 7.05

  • Repositioned the CCT labels in the CIE plots.
  • Added the ability to save the CIE and spectrum plots in the "Mix by sliders" function to use in animations.

Version 7.03

  • Fixed bug introduced in v6.97 which prevented importing of some spectrum files.
  • Added black body and daylight options for the matching spectra plots. You can use your mouse wheel to scroll through the CCTs.
  • Added more positioning options and control of what text gets written to the spectrum plot legend.
  • In the CIE plots you can use the background color (white or black) as the out-of-gamut fill color.
  • In the CIE plots you can force the MacAdams text to always be black. This can help with the visibility in certain situations.
  • Added Pointer's gamut.

Version 6.97

  • Added support to import spectrum files in the IES XML format.

Version 6.95

  • The out-of-gamut region shading on the CIE plot now works when multiple gamuts are selected.
  • When using the TLCI optimization method you can now also specify the minimum CRI and/or CQS and the individual R-values and/or Q-values.
  • The 32-bit Windows version was reintroduced since a surprisingly large number of people are still using the 32-bit OS.

Version 6.93

  • When only one gamut is selected to display on the CIE diagram and the out-of-gamut region is shaded you can select whether or not to draw the gamut boundary line.
  • Fixed a bug that prevented the x,y points plot symbols, colors and labels from being saved and read from a file in the Custom CIE plot window.

Version 6.91

  • User gamuts can now have up to 20 vertices. Hover your mouse over the "User gamut" checkbox in the custom CIE window for some usage tips.

Version 6.89

  • User gamut points can now be saved to and read from files in the custom CIE window. Right-click on the user gamut table to see a list of options.
  • User gamuts can now have up to 10 vertices and the out-of-gamut shading will be applied. If your gamut looks strange try the reorder gamut points option to have the program put them into the proper order for display. Right-click on the user gamut table to see a list of options.
  • Fixed bug where the cursor would be stuck in the waiting mode after reading in certain files.

Version 6.87

  • Condensed some menus and added some splitters and scrollbars for window resizing to better fit smaller (laptop) screens.

Version 6.85

  • Added the ability of entering the minimum and maximum Duv values in the optimization routine. This allows the targeting of color points not centered in the black body line.

Version 6.83

  • Added the DCI-P3 gamut.

Version 6.75

  • A routine has been added to resample a spectrum to any desired wavelength interval. Use the "Other Calculations->Resample spectrum..." menu item to open a new window for this.
  • The axis labels in the CIE plots for the new CIE 170-2:2015 10° color space have been fixed, the "F,10" is now properly subscripted.

Version 6.71

  • Color mixing can now be performed using sliders for the intensity and for the wavelength of the selected LEDs. Use the "Other Calculations->Mix by sliders..." menu item to open a new window to do this. This new method works best with at least two monitors, arranged with one window in each monitor.

Version 6.69

  • Two new CIE plots based on the CIE 170-2:2015 10° color space were added. The color coordinates of these color spaces are labeled xF,10, yF,10 and u'F,10, v'F,10.
  • These new values can be used in the standard optimization methods.
  • Horizontal and vertical splitters (light gray bars) were added to the main window so the individual sections of the window can be independently resized.

Version 6.65

  • Added option to select between entering lumens or visible watts when neither is entered for a spectrum. This new option is available under the "Inputs" menu item.

Version 6.51

  • In CIE plots, when both MacAdam and u'v' ellipses are displayed, the u'v' ellipses are drawn with a heavier line.
  • In the table in the custom CIE plot window the plot symbol can now be entered as numbers, where the first number is the color and the second is the shape. For example, if "2 2" (a space between the numbers and no quotes) is entered, the blue square will be used. This makes it easier to define the symbols in a program like Excel and paste them into the table without having to select each symbol individually.
  • Removed some unused commands in the "Calculate photometry from x, y and lumens..." window.
  • Fixed some issues when reading text files from OS X on Windows and from Windows on OS X.
  • The "Image Options" menu in the CIE plot window was growing too long, it was split into two menus.
  • Renamed the "Data" and "Colors" menus to "Inputs" and "Outputs" and moved some commands between them.

Version 6.49

  • The CIE and spectrum plots in the main window can be resized by dragging the horizontal separator up or down.
  • A box can be drawn around the spectrum plots using the "Spectrum Plot Options->Show box around plot" menu item.

Version 6.47

  • Added a new TLCI calculation. This one lets you pick a user spectrum to use as the reference light source. This is useful for a direct comparison between different light sources. After a calculation, click the toolbar TV icon with the "u". In the new window select the user spectrum to use as the reference light source. Click OK.
  • The Windows version is now 64-bit.

Version 6.39

  • Fixed units bug when reading in spectra from files. This bug was introduced in v6.35.
  • Added the ANSI C78.377-2015 quadrangles to the CIE plots.
  • In the custom CIE table you can enter a CCT and the x,y of this point (on the black body, Duv=0) will be calculated and added to the table. This is useful for adding reference points to your plots.

Version 6.35

  • Fixed units bug when reading in filters or colors from files. This bug was introduced in v6.31.
  • The bug in the MAC OS X version with pasting data into tables has been fixed.

Version 6.33

  • Fixed units bug when reading in spectra from files. This bug was introduced in v6.31.
  • Fixed bug when reading in spectra from CSV files.
  • There is a known bug in the MAC OS X version with pasting data into tables. This is under review.

Version 6.31

  • Added TM-30 gamut plot.
  • Cleaned up some of the labeling in the TM-30 plots.
  • User filters and colors can now be read-in from delimited data files.
  • The ColorChecker colors used in the TLCI-2012 standard can be exported a user colors.
  • User spectra, filters and colors can now be exported to data files in column format.

Version 6.29

  • Added option to automatically check for new versions every 30 days. This can be enabled under the "Help" menu item.
  • Added option to draw the TM-30 locus on the CIE diagram.
  • Added option to write the ΔC* and ΔH* values for user colors to the data file in a combinations run.
  • Changed layout of some controls.

Version 6.25

  • Added optimization method using the TM-30 metrics.
  • The TM-30 plots are now listed under the menu item "TM-30".
  • The TM-30 results are displayed on their own results tab.

Version 6.23

  • Fix bug that prevented the custom CIE plotting routine working properly.

Version 6.21

  • The results of the photometric calculations have been split onto 2 tabs for better organization and clarity.
  • Added the new metrics Rf and Rg from IES TM-30-15. Plots can be shown using the "Other Calculations->IES TM-30-15..." menu items. When an image is displayed you can change the image type using the toolbar command.
  • Added the FCI (Feeling of contrast index) from NIST.
  • When editing user spectra you can right-click on a spectra to pop-up a window with commands to rename, change the LPW, scale the spectra in terms of lumens or visible watts, or delete it.
  • Added routines to convert between RGB, HSV and HSV systems, "Other Calculations->Convert between RGB, HSV and HSV systems..." menu item.
  • Added a new standard LED called "Far red (724nm centroid)" for use in horticulture applications.
  • The "Run combinations" method has been reworked to take better advantage of multicore processors. Speed-ups of 3x on a 4 core machine are typical.
  • The TLCI-2012 metric was previously based on v2.013i which contained an error. This has been corrected and updated to agree with v2.015e8.
  • In the color patch image text can be displayed on top of the patch, this is helpful in saving space when displaying many colors.
  • Spectra for current LEDs from OSRAM Opto Semiconductors can be downloaded from https://apps.osram-os.com/Characteristic.
  • Several bug fixes in the OS X version.

Version 6.03

  • Added a new method for performing multiple optimization runs. See the "Other Calculations->Multi-design optimization..." menu item.
  • A new top level menu called "Other Calculations" was added. Some items from the "Other Options" menu were moved to this new menu.
  • Fixed bug that prevented the spectrum plot from being updated automatically after a calculation is performed.
  • When you press the middle mouse button in the CIE diagram in the CIE plot window the Cx, Cy values are written to the window title bar.

Version 5.95

  • Fixed a few minor issues with the "Other Options->Calculate binning from x, y, and lumens..." method.
  • Added more user control over the CCT lines and labels.
  • You can pan and zoom the CIE plot in the main CIE window using the mouse wheel or click-and-drag methods.

Version 5.91

  • Fixed bug introduced in the last release which prevented plotting of points in the custom CIE window for computers using a comma as a decimal point.
  • Added a new method for more a more sophisticated analysis of binning. Under the "Other Options->Calculate binning from x, y, and lumens..." menu item. A new window opens where you can use any combination of the standard pure color LEDs, your existing user LEDs and/or x,y and lumen values you enter.
  • Added ability to enter different output variation in the main window for binning analysis.

Version 5.83

  • In the custom CIE window you can have the point labels be the same color as the point symbols.
  • You can pan and zoom the CIE plot in the custom CIE window using the mouse wheel or click-and-drag methods.

Version 5.79

  • In the custom CIE window you can now save the plot symbols and labels to a file. This will make it easier to make similar looking plots using different datasets. The data points are not saved. More details are given in the user guide.
  • In the custom CIE window additional points, shapes and colors were added.

Version 5.77

  • The parameter μmol/s-W can be constrained to the range of 400-700nm. This is turned on by default and can be changed in the "Data" menu item.
  • The Du'v' is now calculated. This is the distance of a point to the black body line in u'v' space.
  • u'v' circles (as defined in CIE TN 001:2014) can now be plotted in addition to the standard MacAdam ellipses.
  • The old "Duv" menu button has been replaced with a button with a CIE icon with the letter "C". This allows highly customized CIE plots to be made.
  • In the window which contains the CIE plot you can now save the plot settings to a file. This will make it easier to make similar looking plots using different datasets. All of the plot setting except for the data points, colors, symbols and labels are saved.

Version 5.53

  • Spectra can now be input with units of photons/s. The input units are selected using the "Data->Input units for spectra" menu item.
  • A new output parameter has been added, μmol/s/W. This is used in the field of horticulture.
  • Fixed a bug that prevented the selection of individual NCS colors.

Version 5.49

  • Fixed a bug introduced in v5.45 where the lumens for imported user spectra were calculated incorrectly.

Version 5.45

  • The user can define gambit points and a gambit can be drawn on the CIE diagram. The gambit can contain up to 6 points. The gambit points are defined in the "Duv" window and it can be displayed/hidden using the "Image Options->Gambits" menu command on the "CIE plot" window.
  • A memory leak was fixed that caused the program bombing occasionally.

Version 5.43

  • The maximum lumens calculation has been added to the "Run Combinations" method. You need to enter the maximum power each LED can provide in terms of watts for this calculation be occur.
  • The algorithm to sample spectra has been improved. This mainly affects spectra with very narrow lines.

Version 5.41

  • Added a command to calculate the maximum lumens achievable for a set of LEDs based on color mixing. Use the menu command "Other Options->Calculate maximum lumens from color mix...". To use this calculation you need to know the maximum visible watts and lumens that each LED channel can provide. More details are given in the User Guide.

Version 5.37

  • Added a command to check the web site for a new version of the program. Use the menu command "Help->Check the web site for update".
  • When the "Include binning effects" option is checked you can now enter a variation on the brightness of each spectrum.
  • Fixed a bug that would cause the program to sometimes crash when closing the "About" dialog.
  • If you have user filters or user colors you can scroll through these using your mouse wheel. Check either "Plot filter" or "Plot color" analysis type then on the Filters or Colors tab check 1 and only 1 filter/color then press the "Shift" or "Ctrl" key on Windows or the "command" key on Mac OS X, scroll the mouse wheel to move through your filters/colors and plot them.

Version 5.33

  • Fixed a few bugs in the UI.
  • Fixed a bug that would cause the program to hang when plotting a matching spectrum.

Version 5.31

  • Added Circadian/melatonin suppression metric based on work by M.S. Rea, M.G. Figueiro, J.D. Bullough, A. Bierman and R. Hamner at the Lighting Research Center, Rensselaer Polytechnic Institute, Troy, New York, USA. After calculating a spectrum use the "Other Options->Calculate circadian system response..." menu item.
  • Added ability to mix spectra in a table format. After selecting up to 4 spectra in the main window use the "Other Options->Calculate color mixing based on spectra..." menu item. Enter the intensity values and the photometry will be calculated.
  • Added back support for Windows XP.
  • Fixed a bug in the Duv window that prevented the selection of some of the plot symbols.
  • Fixed a bug that would cause the program to hang when plotting a matching spectrum.

Version 5.27

  • In the color patch plots you can now display the color differences (dE*).
  • The background of the CIE plot can be switched between white and black.

Version 5.23

  • Fixed some bugs in the UI.
  • Updated the license.

Version 5.21

  • A major change for MAC OS X users. The way the program is packaged has been changed. Because of this the default directory the program uses has also been changed. The program will create a new directory called /%HOME%/ColorCalculator_OSI where your user files will be stored. If you are already using a version of the ColorCalculator you may need to move your user files to this new directory. The user files are: ColorCalculator.ini, ColorCalculatorCombo.ini, userSpectra.spec, userFilters.fils, userColors.cols. You may not have any of the last 4 files depending on how you use the program. The process would be to download and run the new version of the ColorCalculator, this will create the new directory. Exit the new version of the program. If you have any of these user files just open a Finder window and drag (or copy) them from the old directory to this new directory. If you are installing the ColorCalculator for the first time or do not have any of the user files do you not have to worry about this and can just use the program as is.
  • On the MAC, if you start the ColorCalculator program and nothing happens you need to install XQuartz for X11 support. https://xquartz.macosforge.org/landing/

Version 5.19

  • Fixed several minor bugs in the user interface.

Version 5.17

  • Fixed a bug that would crash the program when deleting rows in some of the data tables.
  • Fixed an error in the MacAdam ellipse calculation. This error caused a small shift in the ellipse for points far away from the black body, this primarily effected the ellipse around pure color LEDs.
  • For the Duv and some other routines the color coordinates can be entered as x,y or u'v'.
  • In the "Other Options->Calculate coordinates of MacAdam ellipse..." routine the ellipse parameters (a, b, theta, g11, 2g12, g22) are displayed.

Version 5.15

  • Fixed a bug that would crash the program when using the "Run combinations..." feature. This bug was accidently introduced in v5.07.
  • Fixed a bug that would give obviously meaningless results when using a spectrum with pure color LEDs along with an IR LED when the "Include IR (830-1050nm)" option was checked. This bug was accidently introduced in v5.07.

Version 5.11

  • You can display a color patch representing the filter you are plotting on the spectrum plot. Check the "Spectrum Plot Options->Draw color patch (at 6500K) on plot when plotting colors/filters" menu item.
  • The gambit areas are now calculated for both the u'v' 1976 and the uv 1960 space. select which values to display using the "Data->Gambit based on..." menu item. The value of the gambit does not change on going from uv to u'v' space since the gambit is a ratio of the individual areas, however, the gambit areas do change.

Version 5.09

  • The program will now convert between the various coordinate systems. User the "Other Options->Convert coordinates (xy/uv/u'v'/XYZ/L*a*b*)..." menu item.
  • You can display a color patch representing the color you are plotting on the spectrum plot. Check the "Spectrum Plot Options->Draw color patch (at 6500K) on plot when plotting colors" menu item.
  • You can scroll through your user filters and user colors. Check either "Plot filter" or "Plot Color" then change to the appropriate tab, hold down the control or shift key and use the mouse scroll wheel to move among the filters/colors, your mouse must be over a filter/color label. Each one will be plotted in turn.
  • There are new options under the "Spectrum Plot Options" menu to keep the plot scale at 1 (or 100%) and to write the filter/color name to the plot.

Version 5.07

  • Fixed a bug in the Television Lighting Consistency Index 2012 (TLCI-2012) calculation. This only affected computers using a comma instead of a dot for the decimal symbol.
  • Added two IR peaks to the set of standard LED. To include the IR range (830-1050nm) in the calculations and plots the "Include IR (830-1050nm)" option must be checked.
  • Some of the menu items and controls were rearranged.
  • Added explanations of the menu commands to the User Guide.

Version 5.01

  • The Television Lighting Consistency Index 2012 (TLCI-2012) metric has been added. After calculating a spectrum, click the TV icon on the toolbar to display the results. The calculated values are also available under the "File->Save numeric results as..." menu item.
  • The CIEDE2000 color difference calculation is now available. From the main window under the "Other Options" menu see the "CIEDE2000 with user inputted values..." command.
  • You can read in multiple spectra from the same file. From the main window under the "User Spectra" menu see the "Import data file (1st column is nm, 2nd column is intensity..." command. The data can be separated by spaces or tabs. You can copy and paste the data (no column headers) from an Excel spreadsheet and paste it directly into a txt file then import all of the spectra at once.

Version 4.97

  • The individual x,y points can be labeled in the CIE plots. This option is available from the "Duv" window. You can choose to have the program generate the labels for you or enter any text you like in the table in this window. If you have the program generate the labels automatically you can choose between numerical or alphabetic labels. In the CIE plot window under the "Image Options" menu you can turn these labels on or off and position them around the points (top, bottom, left, right).

Version 4.95

  • The u'v' coordinates of the CRI, CQS and User colors can be written to a file. See the "Data->"Write u'v' for the R-values and Q-values..." menu item.
  • The gamut areas for the R1-R8 colors and the Q1-Q15 colors are written in the GUI. See the "GA CRI" and "GA CQS" boxes. The gamut area is calculated for the test source on 1976 UCS (u',v') chromaticity diagram. The values for the test and reference sources are also written to the photometry.txt file.

Version 4.91

  • Added a command to write the spectrum data displayed in the table to a text file. See the "Data->Write current spectrum data to a text file..." menu item.
  • Added commands to import spectra from a text file. See the "User Spectra->Import file data..." menu items.
  • Prevent the "matching spectrum" from being automatically cleared in certain situations.
  • Added a script to install a required library file for Mac OS X systems. See the READ_ME in the dmg file for more details.

Version 4.89

  • Added the "Class A" color designation for light sources from the Lighting Research Center, Rensselaer Polytechnic Institute, online at https://www.lrc.rpi.edu/programs/solidstate/colorResearch.asp.
  • The Gamut Area Index (GAI) metric is calculated. This is the ratio of the gamut CRI for the test source to the gamut CRI of an equal energy spectrum. See v8(2), March 2010 of ASSIST recommends from the Lighting Research Center, Rensselaer Polytechnic Institute, online at https://www.lrc.rpi.edu.
  • The spectrum data can be hidden, use the "Data->Hide the spectrum data when possible" menu item. For certain types of operations the spectrum table needs to be visible; such as direct spectrum, filter and color input, the "Matching spectrum" optimization method and when "Matching mode" option is checked. For these operations the table will be visible regardless of whether this option is checked.
  • Fixed some minor bugs in the CIE plotting routine.

Version 4.85

  • The individual R or Q values can be displayed on the R-value and Q-value plots. This option is available under the "Image Options" menu item.
  • The COI (Cyanosis Observation Index) index is calculated. This metric is from the AS/NZS 1680.2.5:1997 standard on interior lighting for hospital and medical tasks.

Version 4.83

  • The title of the main spectrum in the spectrum plots can now be changed by the user. This can only be done when the spectrum is displayed in its own window, not in the main window.
  • Tightened up the tolerances in the routine to find the size and center point of the MacAdam ellipse to contain all of the entered x,y points in the Duv window. The values calculated will be slightly different from those calculated in previous versions.
  • Added help information to the Duv window to explain some of the customization of CIE diagrams possible.
  • Several minor bug fixes.

Version 4.81

  • A function was added to reach a color target by mixing 3 colors/channels. Use the "Other Options->Calculate 3 color mixing..." menu item. You enter the x and y values of these colors, then enter the color point and total lumens you want to reach. The lumens required of each of the colors are calculated.
  • Fixed bug that caused the program to crash when using the "Other Options->CIEL*a*b* plot with user inputted values" command.

Version 4.79

  • You can now show/hide grid lines in the spectrum and CIEL*a*b* plots.
  • When a matching spectrum is entered a new metric which describes how well the two spectra match is calculated. The metric is called "RMS" and is the RMS difference. It is calculated by first normalizing each spectra to a maximum intensity of 1.0, then the square root of the sum of the square of the differences at each wavelength is calculated. A value of 0 is a perfect match and larger numbers indicate poorer matches.

Version 4.77

  • Added the ANSI C78.377-2011 quadrangles to the CIE plots.
  • Fixed some minor issues in the grid lines routines and accounted for large font sizes in the plots.

Version 4.73

  • The font used by the program can be selected by the user. Use the "Other Options->Program font..." menu item.
  • The size of the fonts used in the CIE and spectrum plots in the main window are not affected when these font sizes are changed.
  • The ̄x and ̄z color matching functions can be used as matching curves.

Version 4.69

  • The Natural Colour System®© of standard colors was added to the software. Any or all of these 1950 colors can be used to define "user colors". These are especially useful in making color rendering vector (CRV) plots can be made in the CIEL*a*b* plots to evaluate how a spectrum will render a wide range of colors.
    NCS - Natural Colour System®© property of and used on license from NCS Colour AB, Stockholm 2013.
  • Added scrollbars for some feature to support smaller screen sizes.
  • When you click on a color patch in the color patch plot the RGB values are displayed.

Version 4.59

  • The size of the plot symbols in the CIE plots can now be changed under the CIE "Image Options" menu item.
  • A conversion from CCT and Duv to x,y has been added. Click the "Other Options->Calculate x,y from CCT and Duv..." menu item and a new window pops up where you can enter in pairs of CCT and Duv and the program will calculate the corresponding x,y values. This is done by a root finding algorithm. After the calculation is done the program then uses the calculated x,y values to recalculate the CCT and Duv values as a check. If the results differ from the values inputted by a significant amount they will be highlighted in red.
  • The L* value in the CIEL*a*b* plots can be changed. The color scale has also been improved. The points can be outlined in white for better visibility, this can be turned on or off under the "Image Options" menu item.
  • Color rendering vector (CRV) plots can be made in the CIEL*a*b* plots. The vectors point from the reference to the test color. A vector pointing toward the center indicates that a particular color is under saturated, a vector pointing away from the center indicates that the color is oversaturated. Vectors pointing in a rotational direction indicate that there is a shift in hue for a color. Longer vectors indicate larger shifts in color and/or saturation.
  • You can enter your own values for CIEL*a*b* plots under the "Other Options->CIEL*a*b* plot with user inputted values" menu item.
  • You can access all of the underlying data used to make these plots. Use the "Save Image->Show the data values in a table" menu item to display the values in a new window.
  • The plot symbols in the CIE plots made from the "Delta(uv)" window can now be numbered using the "Image Options->Number points" menu item.
  • Generic peaks have been added for UV and deep red LED. The UV peak fit is based on a very limited number of actual samples and provides only a rough approximation to the real peak. The deep red was extrapolated from the red LED and should also be considered as a rough approximation.

Version 4.51

  • A bug has been fixed where certain very narrow spectra would cause the program to crash.
  • Calculation of the peak centroid has been added.

Version 4.49

  • CIE 1960 plots have been added.
  • You can enter a user defined MacAdam ellipse in the "Delta(uv)" window for plotting in the CIE diagrams.
  • In all of the plots the direction of the zoom using the mouse wheel has been changed to reflect the industry standard.
  • The file names of spectra data files are parsed and the characters "V" and "mA" are looked for. If they are present the LPW will be calculated. The characters "VA" are now also looked for. "VA" is typically obtained from a fixture using a watt meter. Files names like "test_3.2V_100mA_data.isd" or "test_0.32VA_data.isd" will be parsed to get the input watts (0.32W in both cases.)

Version 4.43

  • In the CIEL*a*b* plots the legend symbols were mixed up. This has been corrected.
  • You can now specify the wavelength range and tick mark spacing of the x-axis on the spectrum plots. These can only be customized in the "Spectrum plot" window. See the "Plot Options" menu item. You can also use the mouse wheel to zoom in/out. If you are outside of the x-axis at the low end only the maximum value will zoom. If you are outside of the x-axis at the high end only the minimum value will zoom. If you are within the plot the zoom will take place around the cursor. Go slow since the plot may jump around depending on the position of your mouse. In the main window this zooming effect can be disabled under the "Spectrum plot options" menu item.
  • You can now specify the font size used in each plot individually.
  • In the "Run combinations" method you can specify spectra that must be included in any combination. If you can use this option it can significantly reduce the number of combinations that must be run.
  • Ldom is now written to the photometry.xls file.
  • Support for non-ascii characters (ü, ö, etc.) for use in file names has been improved.

Version 4.37

  • On computers running Windows XP a system error message would pop-up when exiting the program. This has been fixed.
  • After an optimization run the new intensities values are returned. However, the plots were not updated correctly, this has been fixed. If the "Calculate" button is clicked everything is updated properly.

Version 4.35

  • In the "Run Combinations" method the starting range for the pure color LED wavelengths were taken from the main GUI and not from the "Run Combinations" input fields as would be expected. This has been fixed. The calculations were not affected.

Version 4.33

  • The program now allows you to read-in an *.ids file from a luminance measurement. Previously, the program would give an error: "Do not understand intensity units". Now the program will read the units from the *.isd file (W/cm2 sr nm or W/m2 sr nm) and calculate the photometry in terms of candela/m2 not lumens. To alert you to this the program will append "cd/m2" to the end of the spectrum name.

Version 4.31

  • In the "Run combinations" method when you selected "accept all" for the min CRI or min R9 the program actually only accepted designs with values greater than 0. This has been fixed so all values are accepted.

Version 4.29

  • In the output file written in "Run combinations" method the x, y color coordinates were written incorrectly. Instead of x, y being written x, x was written. The calculations themselves were not affected. However, if you use the "x, y color coordinates" Screening method you would miss some designs.

Version 4.27

  • In the "Delta(uv)" window the algorithm used to calculate the "Centered MacAdam ellipse" and the "# MacAdam ellipses to contain all points" has been improved. It is now accurate to within 0.01 MacAdam ellipse and the center to within 0.0001 in x and y.
  • The following changes have been made to the "Run combinations" method:
    • A series of CCT values can be specified instead of just a range of CCT. This can be used to help reduce the amount of data written to the output file.
    • You can select whether you want the individual R-values, Q-values and Gamut values written to the output file. The CRI, R9 and CQS are always written.
    • You can specify a minimum and maximum intensity for the spectra, previously 0 and 100 were used.
  • In the "Create Gaussian peak user spectrum..." function the created peak is now scaled to 1 watt.

Version 4.15

  • The scotopic curve is now an option as the matching curve.
  • R15 (from the JIS) was added as an additional reference color and represents Asian skin color.
  • For user colors the CRI and CQS values are calculated.

Version 4.09

  • An error was introduced in v4.05 which only affects the spectra of the pure color LEDs. This has been fixed.
  • The CRI and CQS constraints in the optimization were not enforced properly. This has been fixed.

Version 4.07

  • The color and shape of the plot symbols used on the CIE plots made from the Delta(uv) window can now be individually customized. When you click on a plot symbol in the table a new window will pop-up where you can pick the color and shape of the plot symbol from several predefined ones.

Version 4.05

  • There was an error in the CQS calculation. The CMCCAT2000 chromatic adaptation was left out. This only effects the results "far" from the black body, delta(uv) larger than about 0.02. This has been fixed.
  • There was an error in the CIEL*a*b* plots and color patches. A chromatic adaptation was left out. This only effects the results "far" from the black body, delta(uv) larger than about 0.02. This has been fixed.
  • A new button was added, "Cal Individual". This button will result in each checked spectra being calculated individually (not summed together) and written to the photometry.txt and photometry.xls files.
  • The "Abort" button will now abort the optimization or combination run immediately. In previous versions there could be a long delay before the run was actually aborted.

Version 4.03

  • The CIE diagram in the main window can be zoomed in and out using the scroll wheel on the mouse.
  • You can now make CIEL*a*b* plots with your custom colors.

Version 3.97

  • The program has been localized (Windows only). It will detect whether to use a comma or a dot as the decimal symbol. If you change the decimal setting while the program is open you must click the menu item "Data->Update decimal format" to have the change take place immediately. Otherwise it will take effect the next time you do a calculation.
  • Multiple MacAdam ellipse can now be plotted on the same CIE diagram.
  • A new photometry tool was added. The menu item "Other options->Calculate photometry from x, y and lumens..." opens a new window where you can input x and y data and the program will calculate X, Y, Z values and the resultant photometry from summing these light sources. If lumen values are not entered than all of the sources are assumed to have the same value. If only some are left out then the missing values are assigned the average lumen value.
  • You can now specify the number of color patches displayed in a row when making a user color patch plot. This will allow some control over the arrangement of the color patches in the plot.

Version 3.93

  • Numbers with commas for decimal points would not paste correctly into some tables. This has been fixed.

Version 3.91

  • The MacAdam ellipses were drawn incorrectly in the 1976 CIE diagram. This has been fixed.
  • Change in the binning calculation. The wavelength range is now sampled in a random way and many more points are calculated. The distribution of wavelengths is assumed to be uniform across the bin width. Also, after a binning run if you click the "x,y" button to save the x,y pair for use in the "D(uv)" window, all of the binning points will be copied, not just the center point.

Version 3.89

  • Added chromatic adaptation CMCCAT2000 to correct the color patches.
  • A separation line can be drawn between the test and reference color patch, although this tends to make color differences harder to detect.
  • The program will now remember the size of each plot/figure. Also, there is a new resizing menu command so the desired size of a plot/figure can be entered directly.

Version 3.85

  • Upgraded from v7.5 of the NIST CQS to v9.0.
  • Fixed several bugs in the optimization routines.

Version 3.79

  • You can enter user spectra/filters/colors at any wavelength interval. In previous versions the interval had to be less than 2nm.
  • You can now copy the plots to the clipboard instead of having to save them to a file first. (Windows version only)
  • Gamut lines can be drawn in the color difference plots.
  • Fixed problem when saving the spectrum to a file. The file is now actually saved.
  • Added calculation of the Gamut CQS.
  • Fixed minor issues when clearing rows in the "Calculate delta(uv)" table.

Version 3.75

  • You can specify your own reference colors in addition to the standard colors R1-R14 and Q1-Q15. You enter the desired reflectance spectrum as a user color, reflectance values range from 0 to 1. A rendering metric will be calculated for each user color checked using the CQS formulation and written to the photometry.txt output file.
  • Color patches can be displayed to visualize the R1-R14, Q1-Q15 and user colors under the test and reference light sources. sRGB is used as the color gambit. Use the "Other plots->Show color patches of R, Q or user colors" menu item. The colors are only guides due to limitations of the gamut of monitors and printers. The color differences may appear small but can be very significant in a real application.
  • The "delta(uv)" metric was replaced by the "delta BB" metric, but the name "delta(uv)" was kept. The black body line is always used as the reference. Formerly, the black body line was used as the reference below 5000K and above 25000K. From 5000-25000K the reconstituted daylight line was used (as is done with the CRI metric). A general consensus is forming to always use black body line when referring to the delta(uv).
  • Moved some plots to the "Other plots" menu item.
  • Better zoom and pan response for the CIE diagrams, most noticeable on older machines.
  • Numerical inputs can use either . or , as the decimal point.
  • Fixed a number of memory leaks.

Version 3.55

  • Added the ability to select which x,y points to plot and which MacAdam ellipses to plot on the CIE diagram in the Delta(uv) window.
  • Added a "delta BB" metric. This is the distance from the black body line to the x,y point in u-v color space.

Send us your comments about additions or improvements to the ColorCalculator software.