colour.contrast.retinal_illuminance_Barten1999¶
-
colour.contrast.
retinal_illuminance_Barten1999
(L, d=2.1, apply_stiles_crawford_effect_correction=True)[source]¶ Returns the retinal illuminance \(E\) in Trolands for given average luminance \(L\) and pupil diameter \(d\) using Barten (1999) method.
Parameters: - L (numeric or array_like) – Average luminance \(L\) in \(cd/m^2\).
- d (numeric or array_like, optional) – Pupil diameter \(d\) in millimeters.
- apply_stiles_crawford_effect_correction (bool, optional) – Whether to apply the correction for Stiles-Crawford effect.
Returns: Retinal illuminance \(E\) in Trolands.
Return type: ndarray
Notes
- This definition is for use with photopic viewing conditions and thus corrects for the Stiles-Crawford effect by default, i.e. directional sensitivity of the cone cells with lower response of cone cells receiving light from the edge of the pupil.
References
[Bar99], [Bar03], [CKM+04], [InternationalTUnion15c],
Examples
>>> retinal_illuminance_Barten1999(100, 2.1) # doctest: +ELLIPSIS 330.4115803... >>> retinal_illuminance_Barten1999(100, 2.1, False) # doctest: +ELLIPSIS 346.3605900...