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:

numpy.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], [CKMW04], [InternationalTUnion15c],

Examples

>>> retinal_illuminance_Barten1999(100, 2.1)  
330.4115803...
>>> retinal_illuminance_Barten1999(100, 2.1, False)  
346.3605900...