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...