SAGA-GIS Tool Library Documentation (v9.2.0)

Tool Create Random Points

Create a layer with randomly distributed points.

Parameters

 NameTypeIdentifierDescriptionConstraints
InputShapes Extentshapes, inputSHAPES--
Polygonsshapes, inputPOLYGONS--
OutputPointsshapes, outputPOINTS--
OptionsTarget AreachoiceEXTENT-Available Choices:
[0] user defined
[1] grid system
[2] shapes extent
[3] polygons
Default: 0
Grid System Extentgrid systemGRIDSYSTEM--
Leftfloating point numberXMIN-Default: 0.000000
Rightfloating point numberXMAX-Default: 0.000000
Bottomfloating point numberYMIN-Default: 0.000000
Topfloating point numberYMAX-Default: 0.000000
Columnsinteger numberNX-Minimum: 1
Default: 1
Rowsinteger numberNY-Minimum: 1
Default: 1
Bufferfloating point numberBUFFERadd buffer (map units) to extentMinimum: 0.000000
Default: 0.000000
Number of Pointsinteger numberCOUNT-Minimum: 1
Default: 100
Number for...choiceDISTRIBUTE-Available Choices:
[0] all polygons
[1] each polygon
Default: 0
Iterationsinteger numberITERATIONSMaximum number of iterations to find a suitable place for a point.Minimum: 1
Default: 1000
Distancefloating point numberDISTANCEMinimum distance a point should keep to each other.Minimum: 0.000000
Default: 0.000000

Command-line

Usage: saga_cmd shapes_points 21 [-POINTS <str>] [-EXTENT <str>] [-GRIDSYSTEM_D <double>] [-GRIDSYSTEM_X <double>] [-GRIDSYSTEM_Y <double>] [-GRIDSYSTEM_NX <num>] [-GRIDSYSTEM_NY <num>] [-GRIDSYSTEM_FILE <str>] [-SHAPES <str>] [-POLYGONS <str>] [-XMIN <double>] [-XMAX <double>] [-YMIN <double>] [-YMAX <double>] [-NX <num>] [-NY <num>] [-BUFFER <double>] [-COUNT <num>] [-DISTRIBUTE <str>] [-ITERATIONS <num>] [-DISTANCE <double>]
  -POINTS:<str>         	Points
	shapes, output
  -EXTENT:<str>         	Target Area
	choice
	Available Choices:
	[0] user defined
	[1] grid system
	[2] shapes extent
	[3] polygons
	Default: 0
  -GRIDSYSTEM_D:<double>	Cell Size
  -GRIDSYSTEM_X:<double>	Lower Left Center Cell X-Coordinate
  -GRIDSYSTEM_Y:<double>	Lower Left Center Cell Y-Coordinate
  -GRIDSYSTEM_NX:<num>  	Number of Columns
  -GRIDSYSTEM_NY:<num>  	Number of Rows
  -GRIDSYSTEM_FILE:<str>	Grid File
  -SHAPES:<str>         	Shapes Extent
	shapes, input
  -POLYGONS:<str>       	Polygons
	shapes, input
  -XMIN:<double>        	Left
	floating point number
	Default: 0.000000
  -XMAX:<double>        	Right
	floating point number
	Default: 0.000000
  -YMIN:<double>        	Bottom
	floating point number
	Default: 0.000000
  -YMAX:<double>        	Top
	floating point number
	Default: 0.000000
  -NX:<num>             	Columns
	integer number
	Minimum: 1
	Default: 1
  -NY:<num>             	Rows
	integer number
	Minimum: 1
	Default: 1
  -BUFFER:<double>      	Buffer
	floating point number
	Minimum: 0.000000
	Default: 0.000000
  -COUNT:<num>          	Number of Points
	integer number
	Minimum: 1
	Default: 100
  -DISTRIBUTE:<str>     	Number for...
	choice
	Available Choices:
	[0] all polygons
	[1] each polygon
	Default: 0
  -ITERATIONS:<num>     	Iterations
	integer number
	Minimum: 1
	Default: 1000
  -DISTANCE:<double>    	Distance
	floating point number
	Minimum: 0.000000
	Default: 0.000000