colour.contrast.retinal_illuminance_Barten1999#
- colour.contrast.retinal_illuminance_Barten1999(L: ArrayLike, d: ArrayLike = 2.1, apply_stiles_crawford_effect_correction: bool = True) NDArrayFloat [source]#
Return the retinal illuminance \(E\) in Trolands for given average luminance \(L\) and pupil diameter \(d\) using Barten (1999) method.
- Parameters:
L (ArrayLike) – Average luminance \(L\) in \(cd/m^2\).
d (ArrayLike) – Pupil diameter \(d\) in millimeters.
apply_stiles_crawford_effect_correction (bool) – Whether to apply the correction for Stiles-Crawford effect.
- Returns:
Retinal illuminance \(E\) in Trolands.
- Return type:
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], [CKMW04], [InternationalTUnion15c],
Examples
>>> retinal_illuminance_Barten1999(100, 2.1) 330.4115803... >>> retinal_illuminance_Barten1999(100, 2.1, False) 346.3605900...