# colour.contrast_sensitivity_function¶

colour.contrast_sensitivity_function(method='Barten 1999', **kwargs)[source]

Returns the contrast sensitivity $$S$$ of the human eye according to the contrast sensitivity function (CSF) described by given method.

Parameters: Other Parameters: method (unicode, optional) – {‘Barten 1999’}, Computation method. E (numeric or array_like, optional) – {colour.contrast.contrast_sensitivity_function_Barten1999()}, Retinal illuminance $$E$$ in Trolands. N_max (numeric or array_like, optional) – {colour.contrast.contrast_sensitivity_function_Barten1999()}, Maximum number of cycles $$N_{max}$$ over which the eye can integrate the information. T (numeric or array_like, optional) – {colour.contrast.contrast_sensitivity_function_Barten1999()}, Integration time $$T$$ in seconds of the eye. X_0 (numeric or array_like, optional) – {colour.contrast.contrast_sensitivity_function_Barten1999()}, Angular size $$X_0$$ in degrees of the object in the x direction. Y_0 (numeric or array_like, optional) – {colour.contrast.contrast_sensitivity_function_Barten1999()}, Angular size $$Y_0$$ in degrees of the object in the y direction. X_max (numeric or array_like, optional) – {colour.contrast.contrast_sensitivity_function_Barten1999()}, Maximum angular size $$X_{max}$$ in degrees of the integration area in the x direction. Y_max (numeric or array_like, optional) – {colour.contrast.contrast_sensitivity_function_Barten1999()}, Maximum angular size $$Y_{max}$$ in degrees of the integration area in the y direction. k (numeric or array_like, optional) – {colour.contrast.contrast_sensitivity_function_Barten1999()}, Signal-to-noise (SNR) ratio $$k$$. n (numeric or array_like, optional) – {colour.contrast.contrast_sensitivity_function_Barten1999()}, Quantum efficiency of the eye $$n$$. p (numeric or array_like, optional) – {colour.contrast.contrast_sensitivity_function_Barten1999()}, Photon conversion factor $$p$$ in $$photons\div seconds\div degrees^2\div Trolands$$ that depends on the light source. phi_0 (numeric or array_like, optional) – {colour.contrast.contrast_sensitivity_function_Barten1999()}, Spectral density $$\phi_0$$ in $$seconds degrees^2$$ of the neural noise. sigma (numeric or array_like, optional) – {colour.contrast.contrast_sensitivity_function_Barten1999()}, Standard deviation $$\sigma$$ of the line-spread function resulting from the convolution of the different elements of the convolution process. u (numeric) – {colour.contrast.contrast_sensitivity_function_Barten1999()}, Spatial frequency $$u$$, the cycles per degree. u_0 (numeric or array_like, optional) – {colour.contrast.contrast_sensitivity_function_Barten1999()}, Spatial frequency $$u_0$$ in $$cycles\div degrees$$ above which the lateral inhibition ceases. Contrast sensitivity $$S$$. ndarray

References

Examples

>>> contrast_sensitivity_function(u=4)  # doctest: +ELLIPSIS
360.8691122...
>>> contrast_sensitivity_function('Barten 1999', u=4)  # doctest: +ELLIPSIS
360.8691122...