SAGA-GIS Tool Library Documentation (v7.8.2)

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 pointXMIN-Default: 0.000000
RightFloating pointXMAX-Default: 0.000000
BottomFloating pointYMIN-Default: 0.000000
TopFloating pointYMAX-Default: 0.000000
ColumnsIntegerNX-Minimum: 1
Default: 1
RowsIntegerNY-Minimum: 1
Default: 1
BufferFloating pointBUFFERadd buffer (map units) to extentMinimum: 0.000000
Default: 0.000000
Number of PointsIntegerCOUNT-Minimum: 1
Default: 100
Number for...ChoiceDISTRIBUTE-Available Choices:
[0] all polygons
[1] each polygon
Default: 0
IterationsIntegerITERATIONSMaximum number of iterations to find a suitable place for a point.Minimum: 1
Default: 1000
DistanceFloating pointDISTANCEMinimum 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
	Default: 0.000000
  -XMAX:<double>        	Right
	Floating point
	Default: 0.000000
  -YMIN:<double>        	Bottom
	Floating point
	Default: 0.000000
  -YMAX:<double>        	Top
	Floating point
	Default: 0.000000
  -NX:<num>             	Columns
	Integer
	Minimum: 1
	Default: 1
  -NY:<num>             	Rows
	Integer
	Minimum: 1
	Default: 1
  -BUFFER:<double>      	Buffer
	Floating point
	Minimum: 0.000000
	Default: 0.000000
  -COUNT:<num>          	Number of Points
	Integer
	Minimum: 1
	Default: 100
  -DISTRIBUTE:<str>     	Number for...
	Choice
	Available Choices:
	[0] all polygons
	[1] each polygon
	Default: 0
  -ITERATIONS:<num>     	Iterations
	Integer
	Minimum: 1
	Default: 1000
  -DISTANCE:<double>    	Distance
	Floating point
	Minimum: 0.000000
	Default: 0.000000