SAGA 9.6.1 | Tool Library Documentation

Mosaicking


Description

The tool allows one to merge multiple grids into one single grid. This involves resampling if the input grids have different cell sizes or are not aligned to each other. Besides different resampling methods, the tool provides several options on how to handle overlapping areas. It is also possible to apply a histogram matching. In order to be able to also merge a large amount of grids, which, for example, would exceed the maximum command line length, the tools has the option to provide a file list as input (instead of using the input grid list). This is a text file with the full path to an input grid on each line. Please note the limitations: (i) the target grid system is set automatically in this case (the extent is calculated from all inputs and the cell size is set to the smallest one detected) and (ii) the input grids must still fit into memory, i.e. are all loaded at once.


Parameters

 NameTypeIdentifierDescriptionConstraints
InputGridsgrid list, input, optionalGRIDS--
Target Systemgrid, input, optionalTARGET_TEMPLATEuse this grid's system for output grids-
OutputTarget Gridgrid, outputTARGET_OUT_GRID--
OptionsInput File Listfile pathFILE_LISTA text file with the full path to an input grid on each line-
Nametext [GUI]NAME-Default: Mosaic
Data Storage Typedata typeTYPE-Available Choices: [0] bit [1] unsigned 1 byte integer [2] signed 1 byte integer [3] unsigned 2 byte integer [4] signed 2 byte integer [5] unsigned 4 byte integer [6] signed 4 byte integer [7] unsigned 8 byte integer [8] signed 8 byte integer [9] 4 byte floating point number [10] 8 byte floating point number [11] same as first grid in list Default: 11
ResamplingchoiceRESAMPLING-Available Choices: [0] Nearest Neighbour [1] Bilinear Interpolation [2] Bicubic Spline Interpolation [3] B-Spline Interpolation Default: 3
Overlapping AreaschoiceOVERLAP-Available Choices: [0] first [1] last [2] minimum [3] maximum [4] mean [5] blend boundary [6] feathering Default: 1
Blending Distancefloating point numberBLEND_DISTblending distance given in map unitsMinimum: 0.000000 Default: 10.000000
Blending BoundarychoiceBLEND_BNDblending boundary for distance calculationAvailable Choices: [0] valid data cells [1] grid boundaries [2] vertical grid boundaries [3] horizontal grid boundaries Default: 0
MatchchoiceMATCH-Available Choices: [0] none [1] match histogram of first grid in list [2] match histogram of overlapping area [3] regression Default: 0
Target Grid SystemchoiceTARGET_DEFINITION-Available Choices: [0] user defined [1] grid or grid system Default: 0
Cellsizefloating point numberTARGET_USER_SIZE-Minimum: 0.000000 Default: 1.000000
Westfloating point numberTARGET_USER_XMIN-Default: 0.000000
Eastfloating point numberTARGET_USER_XMAX-Default: 100.000000
Southfloating point numberTARGET_USER_YMIN-Default: 0.000000
Northfloating point numberTARGET_USER_YMAX-Default: 100.000000
Columnsinteger numberTARGET_USER_COLSNumber of cells in East-West direction.Minimum: 1 Default: 101
Rowsinteger numberTARGET_USER_ROWSNumber of cells in North-South direction.Minimum: 1 Default: 101
RoundingbooleanTARGET_USER_FLATRound bounding coordinates to multiples of cell size. Ignored if cell size has decimal places.Default: 1
FitchoiceTARGET_USER_FITS-Available Choices: [0] nodes [1] cells Default: 0
Grid Systemgrid systemTARGET_SYSTEM--

Command Line


Usage: saga_cmd grid_tools 3 [-GRIDS ] [-FILE_LIST ] [-TYPE ] [-RESAMPLING ] [-OVERLAP ] [-BLEND_DIST ] [-BLEND_BND ] [-MATCH ] [-TARGET_DEFINITION ] [-TARGET_USER_SIZE ] [-TARGET_USER_XMIN ] [-TARGET_USER_XMAX ] [-TARGET_USER_YMIN ] [-TARGET_USER_YMAX ] [-TARGET_USER_COLS ] [-TARGET_USER_ROWS ] [-TARGET_USER_FLAT ] [-TARGET_USER_FITS ] [-TARGET_TEMPLATE ] [-TARGET_OUT_GRID ]
  -GRIDS:              	Grids
	grid list, input, optional
  -FILE_LIST:          	Input File List
	file path
  -TYPE:               	Data Storage Type
	data type
	Available Choices:
	[0] bit
	[1] unsigned 1 byte integer
	[2] signed 1 byte integer
	[3] unsigned 2 byte integer
	[4] signed 2 byte integer
	[5] unsigned 4 byte integer
	[6] signed 4 byte integer
	[7] unsigned 8 byte integer
	[8] signed 8 byte integer
	[9] 4 byte floating point number
	[10] 8 byte floating point number
	[11] same as first grid in list
	Default: 11
  -RESAMPLING:         	Resampling
	choice
	Available Choices:
	[0] Nearest Neighbour
	[1] Bilinear Interpolation
	[2] Bicubic Spline Interpolation
	[3] B-Spline Interpolation
	Default: 3
  -OVERLAP:            	Overlapping Areas
	choice
	Available Choices:
	[0] first
	[1] last
	[2] minimum
	[3] maximum
	[4] mean
	[5] blend boundary
	[6] feathering
	Default: 1
  -BLEND_DIST:      	Blending Distance
	floating point number
	Minimum: 0.000000
	Default: 10.000000
  -BLEND_BND:          	Blending Boundary
	choice
	Available Choices:
	[0] valid data cells
	[1] grid boundaries
	[2] vertical grid boundaries
	[3] horizontal grid boundaries
	Default: 0
  -MATCH:              	Match
	choice
	Available Choices:
	[0] none
	[1] match histogram of first grid in list
	[2] match histogram of overlapping area
	[3] regression
	Default: 0
  -TARGET_DEFINITION:  	Target Grid System
	choice
	Available Choices:
	[0] user defined
	[1] grid or grid system
	Default: 0
  -TARGET_USER_SIZE:	Cellsize
	floating point number
	Minimum: 0.000000
	Default: 1.000000
  -TARGET_USER_XMIN:	West
	floating point number
	Default: 0.000000
  -TARGET_USER_XMAX:	East
	floating point number
	Default: 100.000000
  -TARGET_USER_YMIN:	South
	floating point number
	Default: 0.000000
  -TARGET_USER_YMAX:	North
	floating point number
	Default: 100.000000
  -TARGET_USER_COLS:   	Columns
	integer number
	Minimum: 1
	Default: 101
  -TARGET_USER_ROWS:   	Rows
	integer number
	Minimum: 1
	Default: 101
  -TARGET_USER_FLAT:   	Rounding
	boolean
	Default: 1
  -TARGET_USER_FITS:   	Fit
	choice
	Available Choices:
	[0] nodes
	[1] cells
	Default: 0
  -TARGET_TEMPLATE:    	Target System
	grid, input, optional
  -TARGET_OUT_GRID:    	Target Grid
	grid, output