SAGA-GIS Tool Library Documentation (v6.3.0)

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 (input)POLYGONS--
Target System (*)Grid (optional input)TARGET_TEMPLATEuse this grid's system for output grids-
OutputCategoryGrid (output)CATEGORY--
Coverage (*)Grid (optional output)COVERAGE--
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
LeftFloating pointTARGET_USER_XMIN-Default: 0.000000
RightFloating pointTARGET_USER_XMAX-Default: 100.000000
BottomFloating pointTARGET_USER_YMIN-Default: 0.000000
TopFloating pointTARGET_USER_YMAX-Default: 100.000000
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>] [-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_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
  -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>	Left
	Floating point
	Default: 0.000000
  -TARGET_USER_XMAX:<double>	Right
	Floating point
	Default: 100.000000
  -TARGET_USER_YMIN:<double>	Bottom
	Floating point
	Default: 0.000000
  -TARGET_USER_YMAX:<double>	Top
	Floating point
	Default: 100.000000
  -TARGET_USER_FITS:<str>   	Fit
	Choice
	Available Choices:
	[0] nodes
	[1] cells
	Default: 0
  -TARGET_TEMPLATE:<str>    	Target System
	Grid (optional input)
  -CATEGORY:<str>           	Category
	Grid (output)
  -COVERAGE:<str>           	Coverage
	Grid (optional output)