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]#

Compute the retinal illuminance \(E\) in Trolands for the specified average luminance \(L\) and pupil diameter \(d\) using the 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 the Stiles-Crawford effect.

Returns:

Retinal illuminance \(E\) in Trolands.

Return type:

numpy.ndarray

Notes

  • This definition is designed for photopic viewing conditions and applies the Stiles-Crawford effect correction by default. This effect accounts for the directional sensitivity of cone cells, which exhibit reduced response to light entering 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...