SAGA-GIS Tool Library Documentation (v9.2.0)

Tool Histogram Matching

This tool alters the values of a grid so that its value distribution (its histogram), matches that of a reference grid. The first method simply uses arithmetic mean and standard deviation for adjustment, which usually is sufficient for normal distributed values. The second method performs a more precise adjustment based on the grids' histograms.

Parameters

 NameTypeIdentifierDescriptionConstraints
InputGridgrid, inputGRID--
Reference Gridgrid, inputREFERENCE--
OutputAdjusted Grid (*)grid, output, optionalMATCHED--
OptionsGrid Systemgrid systemPARAMETERS_GRID_SYSTEM--
Grid systemgrid systemREFERENCE_GRIDSYSTEM--
MethodchoiceMETHOD-Available Choices:
[0] standard deviation
[1] histogram
Default: 1
Histogramm Classesinteger numberNCLASSESNumber of histogram classes for internal use.Minimum: 100
Default: 10
Maximum Sample Sizeinteger numberMAXSAMPLESIf set to zero all data will be used to build the histograms.Minimum: 0
Default: 1000000
(*) optional

Command-line

Usage: saga_cmd grid_calculus 21 [-GRID <str>] [-MATCHED <str>] [-REFERENCE <str>] [-METHOD <str>] [-NCLASSES <num>] [-MAXSAMPLES <num>]
  -GRID:<str>      	Grid
	grid, input
  -MATCHED:<str>   	Adjusted Grid
	grid, output, optional
  -REFERENCE:<str> 	Reference Grid
	grid, input
  -METHOD:<str>    	Method
	choice
	Available Choices:
	[0] standard deviation
	[1] histogram
	Default: 1
  -NCLASSES:<num>  	Histogramm Classes
	integer number
	Minimum: 100
	Default: 10
  -MAXSAMPLES:<num>	Maximum Sample Size
	integer number
	Minimum: 0
	Default: 1000000