SAGA-GIS Tool Library Documentation (v9.2.0)

Tool Copy Shapes from Region

Copies all shapes that belong to the specified region.

Parameters

 NameTypeIdentifierDescriptionConstraints
InputShapesshapes list, inputSHAPES--
Shapesshapes, inputSHAPES_EXT--
Polygonsshapes, inputPOLYGONS--
OutputCopyshapes list, outputCUT--
OptionsMethodchoiceMETHOD-Available Choices:
[0] completely contained
[1] intersects
[2] center
Default: 1
RegionchoiceEXTENT-Available Choices:
[0] user defined
[1] grid project
[2] shapes layer extent
[3] polygons
Default: 0
Leftfloating point numberAX-Default: 0.000000
Rightfloating point numberBX-Default: 1.000000
Bottomfloating point numberAY-Default: 0.000000
Topfloating point numberBY-Default: 1.000000
Horizontal Rangefloating point numberDX-Minimum: 0.000000
Default: 1.000000
Vertical Rangefloating point numberDY-Minimum: 0.000000
Default: 1.000000
Grid Systemgrid systemGRID_SYS--
Minimum Overlapfloating point numberOVERLAPminimum overlapping area as percentage of the total size of the input shape. applies to polygon layers only.Minimum: 0.000000
Maximum: 100.000000
Default: 50.000000

Command-line

Usage: saga_cmd shapes_tools 13 [-SHAPES <str>] [-CUT <str>] [-METHOD <str>] [-EXTENT <str>] [-AX <double>] [-BX <double>] [-AY <double>] [-BY <double>] [-DX <double>] [-DY <double>] [-GRID_SYS_D <double>] [-GRID_SYS_X <double>] [-GRID_SYS_Y <double>] [-GRID_SYS_NX <num>] [-GRID_SYS_NY <num>] [-GRID_SYS_FILE <str>] [-SHAPES_EXT <str>] [-POLYGONS <str>] [-OVERLAP <double>]
  -SHAPES:<str>       	Shapes
	shapes list, input
  -CUT:<str>          	Copy
	shapes list, output
  -METHOD:<str>       	Method
	choice
	Available Choices:
	[0] completely contained
	[1] intersects
	[2] center
	Default: 1
  -EXTENT:<str>       	Region
	choice
	Available Choices:
	[0] user defined
	[1] grid project
	[2] shapes layer extent
	[3] polygons
	Default: 0
  -AX:<double>        	Left
	floating point number
	Default: 0.000000
  -BX:<double>        	Right
	floating point number
	Default: 1.000000
  -AY:<double>        	Bottom
	floating point number
	Default: 0.000000
  -BY:<double>        	Top
	floating point number
	Default: 1.000000
  -DX:<double>        	Horizontal Range
	floating point number
	Minimum: 0.000000
	Default: 1.000000
  -DY:<double>        	Vertical Range
	floating point number
	Minimum: 0.000000
	Default: 1.000000
  -GRID_SYS_D:<double>	Cell Size
  -GRID_SYS_X:<double>	Lower Left Center Cell X-Coordinate
  -GRID_SYS_Y:<double>	Lower Left Center Cell Y-Coordinate
  -GRID_SYS_NX:<num>  	Number of Columns
  -GRID_SYS_NY:<num>  	Number of Rows
  -GRID_SYS_FILE:<str>	Grid File
  -SHAPES_EXT:<str>   	Shapes
	shapes, input
  -POLYGONS:<str>     	Polygons
	shapes, input
  -OVERLAP:<double>   	Minimum Overlap
	floating point number
	Minimum: 0.000000
	Maximum: 100.000000
	Default: 50.000000