SAGA-GIS Tool Library Documentation (v9.1.2)

Tool Polygon Categories to Grid

This tool has been designed to rasterize polygons representing categories and selects that category, which has maximum coverage of a cell. The advantage using this tool (instead the more simple 'Shapes to Grid' or 'Polygons to Grid' tools) is that it summarizes all polygon coverages belonging to the same category.

Parameters

 NameTypeIdentifierDescriptionConstraints
InputPolygonsShapes, inputPOLYGONS--
Target System (*)Grid, input, optional, CMDTARGET_TEMPLATEuse this grid's system for output grids-
OutputClassification (*)Table, output, optionalCLASSESClassification look-up table for interpretation of resulting grid cell values.-
CategoryGrid, outputCATEGORY--
Coverage (*)Grid, output, optionalCOVERAGE--
OptionsCategoryTable fieldFIELDThe attribute field that specifies the category a polygon belongs to.-
MethodChoiceMETHODChoose cell wise, if you have not many polygons. Polygon wise will show much better performance, if you have many (small) polygons.Available Choices:
[0] cell wise
[1] polygon wise
Default: 1
Multiple PolygonsChoiceMULTIPLEOutput value for cells that intersect wiht more than one polygon.Available Choices:
[0] minimum coverage
[1] maximum coverage
Default: 1
Target Grid SystemChoiceTARGET_DEFINITION-Available Choices:
[0] user defined
[1] grid or grid system
Default: 0
CellsizeFloating pointTARGET_USER_SIZE-Minimum: 0.000000
Default: 1.000000
WestFloating pointTARGET_USER_XMIN-Default: 0.000000
EastFloating pointTARGET_USER_XMAX-Default: 100.000000
SouthFloating pointTARGET_USER_YMIN-Default: 0.000000
NorthFloating pointTARGET_USER_YMAX-Default: 100.000000
ColumnsIntegerTARGET_USER_COLSNumber of cells in East-West direction.Minimum: 1
Default: 101
RowsIntegerTARGET_USER_ROWSNumber of cells in North-South direction.Minimum: 1
Default: 101
FitChoiceTARGET_USER_FITS-Available Choices:
[0] nodes
[1] cells
Default: 0
Grid SystemGrid systemTARGET_SYSTEM--
(*) optional

Command-line

Usage: saga_cmd grid_gridding 10 [-POLYGONS <str>] [-FIELD <str>] [-METHOD <str>] [-MULTIPLE <str>] [-CLASSES <str>] [-TARGET_DEFINITION <str>] [-TARGET_USER_SIZE <double>] [-TARGET_USER_XMIN <double>] [-TARGET_USER_XMAX <double>] [-TARGET_USER_YMIN <double>] [-TARGET_USER_YMAX <double>] [-TARGET_USER_COLS <num>] [-TARGET_USER_ROWS <num>] [-TARGET_USER_FITS <str>] [-TARGET_TEMPLATE <str>] [-CATEGORY <str>] [-COVERAGE <str>]
  -POLYGONS:<str>           	Polygons
	Shapes, input
  -FIELD:<str>              	Category
	Table field
  -METHOD:<str>             	Method
	Choice
	Available Choices:
	[0] cell wise
	[1] polygon wise
	Default: 1
  -MULTIPLE:<str>           	Multiple Polygons
	Choice
	Available Choices:
	[0] minimum coverage
	[1] maximum coverage
	Default: 1
  -CLASSES:<str>            	Classification
	Table, output, optional
  -TARGET_DEFINITION:<str>  	Target Grid System
	Choice
	Available Choices:
	[0] user defined
	[1] grid or grid system
	Default: 0
  -TARGET_USER_SIZE:<double>	Cellsize
	Floating point
	Minimum: 0.000000
	Default: 1.000000
  -TARGET_USER_XMIN:<double>	West
	Floating point
	Default: 0.000000
  -TARGET_USER_XMAX:<double>	East
	Floating point
	Default: 100.000000
  -TARGET_USER_YMIN:<double>	South
	Floating point
	Default: 0.000000
  -TARGET_USER_YMAX:<double>	North
	Floating point
	Default: 100.000000
  -TARGET_USER_COLS:<num>   	Columns
	Integer
	Minimum: 1
	Default: 101
  -TARGET_USER_ROWS:<num>   	Rows
	Integer
	Minimum: 1
	Default: 101
  -TARGET_USER_FITS:<str>   	Fit
	Choice
	Available Choices:
	[0] nodes
	[1] cells
	Default: 0
  -TARGET_TEMPLATE:<str>    	Target System
	Grid, input, optional, CMD
  -CATEGORY:<str>           	Category
	Grid, output
  -COVERAGE:<str>           	Coverage
	Grid, output, optional