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.

Author: O.Conrad (c) 2018
Menu: Grid|Gridding|Polygons

Parameters

	Name	Type	Identifier	Description	Constraints
Input	Polygons	shapes, input	`POLYGONS`	-	-
Input	Target System (*)	grid, input, optional, CMD	`TARGET_TEMPLATE`	use this grid's system for output grids	-
Output	Classification (*)	table, output, optional	`CLASSES`	Classification look-up table for interpretation of resulting grid cell values.	-
	Category	grid, output	`CATEGORY`	-	-
	Coverage (*)	grid, output, optional	`COVERAGE`	-	-
Options	Category	table field	`FIELD`	The attribute field that specifies the category a polygon belongs to.	-
	Method	choice	`METHOD`	Choose 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 Polygons	choice	`MULTIPLE`	Output value for cells that intersect wiht more than one polygon.	Available Choices: [0] minimum coverage [1] maximum coverage Default: 1
	Target Grid System	choice	`TARGET_DEFINITION`	-	Available Choices: [0] user defined [1] grid or grid system Default: 0
	Cellsize	floating point number	`TARGET_USER_SIZE`	-	Minimum: 0.000000 Default: 1.000000
	West	floating point number	`TARGET_USER_XMIN`	-	Default: 0.000000
	East	floating point number	`TARGET_USER_XMAX`	-	Default: 100.000000
	South	floating point number	`TARGET_USER_YMIN`	-	Default: 0.000000
	North	floating point number	`TARGET_USER_YMAX`	-	Default: 100.000000
	Columns	integer number	`TARGET_USER_COLS`	Number of cells in East-West direction.	Minimum: 1 Default: 101
	Rows	integer number	`TARGET_USER_ROWS`	Number of cells in North-South direction.	Minimum: 1 Default: 101
	Fit	choice	`TARGET_USER_FITS`	-	Available Choices: [0] nodes [1] cells Default: 0
	Grid System	grid system	`TARGET_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 number
	Minimum: 0.000000
	Default: 1.000000
  -TARGET_USER_XMIN:<double>	West
	floating point number
	Default: 0.000000
  -TARGET_USER_XMAX:<double>	East
	floating point number
	Default: 100.000000
  -TARGET_USER_YMIN:<double>	South
	floating point number
	Default: 0.000000
  -TARGET_USER_YMAX:<double>	North
	floating point number
	Default: 100.000000
  -TARGET_USER_COLS:<num>   	Columns
	integer number
	Minimum: 1
	Default: 101
  -TARGET_USER_ROWS:<num>   	Rows
	integer number
	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