get_fringe_visibility

hcipy.metrics.get_fringe_visibility(intensity)[source]

Get the Michelson fringe visibility from intensity samples.

The visibility is calculated from the maximum and minimum intensity values as

\[V = \frac{I_\mathrm{max} - I_\mathrm{min}} {I_\mathrm{max} + I_\mathrm{min}}.\]
Parameters:
intensityField or array_like

The non-negative intensity samples of an interference pattern.

Returns:
scalar

The Michelson fringe visibility.

Raises:
ValueError

If the input is empty, contains non-finite or negative values, or contains only zero-valued intensities.