CIE S 026 alpha-opic Toolbox User Guide.pdf
CIE Central Bureau Babenbergerstraße 9/9A, 1010 Vienna, Austria Phone: +43 1 714 31 87 E-Mail: ciecb@cie.co.at User Guide to the -opic Toolbox for implementing CIE S 026 This User Guide relates to the -opic Toolbox v1.049a, published by CIE Division 6. The Toolbox (DOI 10.25039/S026.2018.TB) and User Guide (DOI 10.25039/S026.2018.UG) are maintained under CIE Division Reportership (DR) 6-45. Last updated November 2020 © CIE 2020 - All rights reserved The -opic Toolbox and User Guide were designed by the International Commission on Illumination (CIE) to enable calculations and conversions of quantities related to ipRGC-influenced responses to light (IIL responses, or non-visual effects of light), following the international standard CIE S 026:2018. System for Metrology of Optical Radiation for ipRGC-Influenced Responses to Light. CIE, Vienna (DOI: 10.25039/S026.2018). Toolbox – Basis, disclaimer and contact 2 No liability is taken by CIE for any potential errors due to calculations with the -opic Toolbox. It is recommended that users check the results against manual calculations. Considered feedback is welcome and should be sent to the Reporter of DR 6-45 via ciecb@cie.co.at who will aim to answer any questions as quickly as possible. The -opic Toolbox is a CIE publication(DOI: 10.25039/S026.2018.TB) under the Division 6 Reportership DR 6-45 Publication and maintenance of the CIE S 026 Toolbox. The -opic Toolbox supports the usage of CIE S 026, but is not part of the official international standard. The toolbox was designed with feedback from experts including the participants of the Tutorial on CIE S 026. Use and application of the new metrology for ipRGC-influenced responses to light, 14-15 March 2019, Eindhoven. Toolbox – Author and advisors 3 • The following member of DR 6-45 took part in the preparation of the Toolbox and this User Guide – Price, L.L.A. Public Health England, United Kingdom • The following experts acted as advisors: – Peirson, S.N. University of Oxford, United Kingdom – Schlangen, L.J.M. Eindhoven University of Technology, The Netherlands – Spitschan, M. University of Oxford, United Kingdom – Lang, D. LEDVANCE, Munich, Germany – Blattner, P . METAS, Bern, Switzerland Toolbox – Main features • Selection of spectral data used for calculations Built-in illuminants A, D65, E, FL11, and LED-B3 (all: range 380 nm to 780 nm, step 1 nm) (CIE, 2018a); or User-defined spectral data with a choice of wavelength step (1 nm, 2 nm, 4 nm or 5 nm) • Choice of basic quantity Photon radiance, photon irradiance, radiance, irradiance, luminance, illuminance (CIE, 2011; BIPM, 2019) Control of SI prefixes, e.g. m in mWm-²sr-1, and c in Wcm-², k in klx, c in cdcm-² • CIE S 026 calculations and conversions (CIE, 2018b) Basic quantity and additional α-opic output quantities are calculated: α-opic irradiance, α-opic equivalent daylight (D65) illuminance (α-opic EDI), α-opic photon irradiance, or their radiance and luminance analogues, as well as the α-opic efficacy of luminous radiation (α-opic ELR) 4 Toolbox – Additional features • Charts and action spectra The test spectrum and the reference spectrum (default = D65) before and after -opic action spectra weighting • Glossary List of quantities, abbreviations and symbols from CIE S 026 (CIE, 2018b) • Advanced outputs Switch outputs between the quantities from CIE S 026 and the former Lucas et al., 2014 recommendations Displays values for the reference source, matched to the test source inputs Displays α-opic Daylight Efficacy Ratio (α-opic DER) Control of SI prefixes 5 Toolbox – Orientation 6Dark blue = data entry Instructions + warnings * = Errors see page 24 Inputs – Quick calculations Example for built-in spectra First enter a title 1. Select from list (5 CIE illuminants) 2. Select quantity (6 options) and units (SI prefixes) 3. Enter value (0.10 klx = 100 lx) Finally clear unused inputs (i.e. manually clear cells C24:C424) 7 User A D65 E FL11 LED-B3 photon radiance photon irradiance radiance irradiance luminance illuminance E P T G M k m μ n p f a c m μ LED-B3: Range 380 nm to 780 nm, step 1 nm All of A, D65, E, FL11, LED-B3 have a range 380 nm to 780 nm, and step 1 nm Inputs – Dealing with Error Messages 8 • Check whether there is red text under ‘Error messages’. • In case of (red) error messages, follow instructions relating to the input/cell (usually highlighted with a red asterisk). • If not, please go to the next page of the User Guide (Output Results). NOTE Use a comma or a dot as your decimal separator based on your Excel settings. Basic quantities irradiance, illuminance and log photon irradiance α-opic irradiance (in Wm-2) α-opic ELR efficacy of luminous radiation, (in mW.lm-1) α-opic EDI equivalent daylight (D65) illuminance, (in lx) α-opic photon irradiance (in s-1m-2) Each value is presented as the logarithm to base 10 (log10) of the α-opic photon irradiance, Q, divided by 1 s-1m-2 (log10 can also be written lg). Outputs – What results are provided? 9 irradiance (in Wm-2) illuminance (in lx) photon irradiance (in s-1m-2 and presented as a logarithm) Outputs – Basic quantities 10 Outputs – α-opic irradiance Eα (in Wm-2) "effective photobiological irradiance with the spectral irradiance, Ee,λ(λ), spectrally weighted with the α-opic action spectrum sα(λ)" 11 Example calculation – Melanopic irradiance 0.0 0.2 0.4 0.6 0.8 1.0 1.2 1.4 380 460 540 620 700 780 wavelength (nm) spectral irradiance, mW/m2/nm 0.0 0.2 0.4 0.6 0.8 1.0 1.2 380 460 540 620 700 780 wavelength (nm) melanopic action spectrum 0.0 0.2 0.4 0.6 0.8 1.0 1.2 380 460 540 620 700 780 wavelength (nm) melanopic spectral irradiance, mW/m2/nm 12 Outputs – α-opic ELR ELR = Efficacy of Luminous Radiation 13 Kα,v = Eα / Ev Eα Ev 14 EDI = Equivalent Daylight (D65) Illuminance "illuminance, produced by radiation conforming to standard daylight (D65), that provides an equal α-opic irradiance as the test source" Outputs – α-opic EDI Outputs – α-opic EDI calculati…