SAGA-GIS Tool Library Documentation (v8.2.1)

Tool Universal Image Quality Index

The Universal Image Quality Index compares two grids (greyscale images) using the three parameters luminance, contrast and structure. This is done for each pixel using a moving window as specified by the kernel radius.


References


Parameters

 NameTypeIdentifierDescriptionConstraints
InputFirst GridGrid, inputGRID_A--
Second GridGrid, inputGRID_B--
OutputUniversal Image Quality IndexGrid, outputQUALITYThe product of correlation, luminance and contrast similarity.-
Correlation (*)Grid, output, optionalCORRELATIONThe correlation coefficient.-
Luminance (*)Grid, output, optionalLUMINANCEThe similarity of mean luminance.-
Contrast (*)Grid, output, optionalCONTRASTThe similarity of contrast.-
OptionsGrid SystemGrid systemPARAMETERS_GRID_SYSTEM--
k1Floating pointK1-Minimum: 0.000000
Maximum: 1.000000
Default: 0.010000
k2Floating pointK2-Minimum: 0.000000
Maximum: 1.000000
Default: 0.030000
LIntegerLThe dynamic range for the image pixel, i.e. the number of different grey values.Minimum: 1
Default: 255
Kernel TypeChoiceKERNEL_TYPEThe kernel's shape.Available Choices:
[0] Square
[1] Circle
Default: 1
RadiusIntegerKERNEL_RADIUScellsMinimum: 0
Default: 2
(*) optional

Command-line

Usage: saga_cmd imagery_tools 13 [-GRID_A <str>] [-GRID_B <str>] [-QUALITY <str>] [-CORRELATION <str>] [-LUMINANCE <str>] [-CONTRAST <str>] [-K1 <double>] [-K2 <double>] [-L <num>] [-KERNEL_TYPE <str>] [-KERNEL_RADIUS <num>]
  -GRID_A:<str>       	First Grid
	Grid, input
  -GRID_B:<str>       	Second Grid
	Grid, input
  -QUALITY:<str>      	Universal Image Quality Index
	Grid, output
  -CORRELATION:<str>  	Correlation
	Grid, output, optional
  -LUMINANCE:<str>    	Luminance
	Grid, output, optional
  -CONTRAST:<str>     	Contrast
	Grid, output, optional
  -K1:<double>        	k1
	Floating point
	Minimum: 0.000000
	Maximum: 1.000000
	Default: 0.010000
  -K2:<double>        	k2
	Floating point
	Minimum: 0.000000
	Maximum: 1.000000
	Default: 0.030000
  -L:<num>            	L
	Integer
	Minimum: 1
	Default: 255
  -KERNEL_TYPE:<str>  	Kernel Type
	Choice
	Available Choices:
	[0] Square
	[1] Circle
	Default: 1
  -KERNEL_RADIUS:<num>	Radius
	Integer
	Minimum: 0
	Default: 2