pybsm.metrics.functional.giqe3

pybsm.metrics.functional.giqe3(*, rer: float, gsd: float, eho: float, ng: float, snr: float) → float

IBSM Equation 3-56. The General Image Quality Equation version 3.0.

The GIQE returns values on the National Image Interpretability Rating Scale. Note: geometric mean values are simply sqrt(value_x * value_y), where x and y are orthogonal directions in the image.

Parameters:

  • rer – geometric mean relative edge response (unitless)

  • gsd – geometric mean ground sample distance (m)

  • eho – geometric mean edge height overshoot (unitless)

  • ng – noises gain, i.e. increase in noise due to sharpening (unitless); if no sharpening is applied, then ng = 1

  • snr – contrast signal-to-noise ratio (unitless)

Returns:

niirs :

a National Image Interpretability Rating Scale value (unitless)

Raises:
ZeroDivisionError:

error raised when gsd or snr is 0