frudawski

Lighting Toolbox

for MATlaB and Octave

Version 1.16

Various functions for lighting research calculations, colorimetry, plotting, lighting control and measurements.

96

Functions

2

Comments

270

Examples

How to cite:

Rudawski, Frederic, Lighting Toolbox for Matlab and Octave, 2022, version 1.16, URL: https://github.com/Frudawski/LightingToolbox

Lighting Toolbox setup with MATLAB:

Tested with Matlab version 2022a:

  1. Download the Lighting Toolbox and move it to a location of your choice.
  2. Start Matlab
  3. Add the Lighting Toolbox to Matlab’s search path:
    • Type: “addpath(‘path_to_lighting_toolbox/functions’)” in the command window
    • Or click “Set Path” button under Matlab HOME tab -> “Add Folder…” -> select folder -> confirm -> “Save”
  4. Test the Lighting Toolbox functionality:
    • Type: “plotciexy” in the command window
    • A plot of the CIE x and y chromaticity should appear 

Lighting Toolbox setup with GNU Octave:

Tested with GNU Octave version 7.1.0:

  1. Download the Lighting Toolbox and move it to a location of your choice.
  2. Start GNU Octave
  3. Add the Lighting Toolbox to Octave’s search path:
    • type: “addpath(‘path_to_lighting_toolbox/functions’)” in the command window
  4. Optional: install image package:
    • Type: “install package -forge image” in the command window
    • Recommended: load image package at startup:
      1. Type: “edit octaverc” in command window
      2. Add line: “pkg load image” to octaverc file
      3. Save -> close Octave -> start Octave
  5. Test the Lighting Toolbox functionality:
    • Type: “plotciexy” in the command window
    • A plot of the CIE x and y chromaticity should appear

Changelog:

Version 1.16 – 12.11.2022

- Added huedel function
- Updated Philips HUE functions

Version 1.15 – 03.11.2022

- added speceval function

Version 1.14 – 02.11.2022

- removed need for image toolbox from:
- cieplotxy
- cieplotuv
- cieplotuv_
- ciecri now with decimals

Version 1.13 – 28.10.2022

- updated huenew for Octave compability
- updated huecon for Octave compability

Version 1.12 – 27.10.2022

- removed polyshape function from plotciexy,uv,uv_ functions
- added multiple input/output support to cielab2lch
- added ciespec2xyz10 function
- fixed error of u,v return values in ciespec2cct function
- added single x,y,z return values to cieXYZ2xyz function

Version 1.11 – 25.10.2022

- no changes - ciecfi error fix already in version 1.09

Version 1.10 – 18.10.2022

- Added missing readjson function for HUE control functions

Version 1.09 – 18.10.2022

- Fixed error in ciecfi for CCTs 4000 K <= T <= 5000 K and Duv output format

Version 1.08 – 29.09.2022

- Updated plotgrid funtion and the description

Version 1.07 – 23.09.2022

- Fixed error in ciespec when getting several spectra at once

Version 1.06 – 19.07.2022

- Added mixYxy function

Version 1.05 – 18.07.2022

- Fixed error in south function: daytime saving time
- Added functions:
- suntime
- sunsrise
- sunset
- sundiagram

Version 1.04 – 28.06.2022

- Fixed reference whitepoint error in CIE chromaticity plots plotcieuv & plotcieuv_

Version 1.03 – 21.06.2022

- Added HUE  control functions
- Added LT_location file for personal location preference setting
- Adapted sunpos, south and TST function for personal location preference setting
- Rewritten south function for speed optimization
- Added weighting parameter to ciespec and ciecct2spec functions

Version 1.02 – 25.05.2022

- Updated plotpolarE and plotpolarCCT functions
- Added specsky function

Version 1.01 – 13.05.2022

- Added CIECAM02 and CIECAM02inv functions

Version 1.00 – 05.05.2022

- Initial release