SAGA-GIS Tool Library Documentation (v7.3.0)

Tool Wa-Tor

Wa-Tor - an ecological simulation of predator-prey populations - is based upon A. K. Dewdney's 'Computer Recreations' article in the December 1984 issue of Scientific American.

Parameters

 NameTypeIdentifierDescriptionConstraints
InputTarget System (*)Grid (optional input)TARGET_TEMPLATEuse this grid's system for output grids-
OutputWa-TorGrid (output)GRID--
CyclesTable (output)TABLE--
OptionsTarget 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
WestFloating pointTARGET_USER_XMIN-Default: 0.000000
EastFloating pointTARGET_USER_XMAX-Default: 100.000000
SouthFloating pointTARGET_USER_YMIN-Default: 0.000000
NorthFloating pointTARGET_USER_YMAX-Default: 100.000000
ColumnsIntegerTARGET_USER_COLSNumber of cells in East-West direction.Minimum: 1
Default: 100
RowsIntegerTARGET_USER_ROWSNumber of cells in North-South direction.Minimum: 1
Default: 100
FitChoiceTARGET_USER_FITS-Available Choices:
[0] nodes
[1] cells
Default: 0
Grid SystemGrid systemTARGET_SYSTEM--
RefreshBooleanREFRESH-Default: 1
Initial Number of Fishes [%]Floating pointINIT_FISH-Minimum: 0.000000
Maximum: 100.000000
Default: 30.000000
Initial Number of Sharks [%]Floating pointINIT_SHARK-Minimum: 0.000000
Maximum: 100.000000
Default: 7.500000
Birth Rate of FishesIntegerFISH_BIRTH-Minimum: 0
Default: 3
Birth Rate of SharksIntegerSHARK_BIRTH-Minimum: 0
Default: 12
Max. Starvation Time for SharksIntegerSHARK_STARVE-Minimum: 0
Default: 4
(*) optional

Command-line

Usage: saga_cmd sim_cellular_automata 1 [-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>] [-GRID <str>] [-REFRESH <str>] [-INIT_FISH <double>] [-INIT_SHARK <double>] [-TABLE <str>] [-FISH_BIRTH <num>] [-SHARK_BIRTH <num>] [-SHARK_STARVE <num>]
  -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>	West
	Floating point
	Default: 0.000000
  -TARGET_USER_XMAX:<double>	East
	Floating point
	Default: 100.000000
  -TARGET_USER_YMIN:<double>	South
	Floating point
	Default: 0.000000
  -TARGET_USER_YMAX:<double>	North
	Floating point
	Default: 100.000000
  -TARGET_USER_COLS:<num>   	Columns
	Integer
	Minimum: 1
	Default: 100
  -TARGET_USER_ROWS:<num>   	Rows
	Integer
	Minimum: 1
	Default: 100
  -TARGET_USER_FITS:<str>   	Fit
	Choice
	Available Choices:
	[0] nodes
	[1] cells
	Default: 0
  -TARGET_TEMPLATE:<str>    	Target System
	Grid (optional input)
  -GRID:<str>               	Wa-Tor
	Grid (output)
  -REFRESH:<str>            	Refresh
	Boolean
	Default: 1
  -INIT_FISH:<double>       	Initial Number of Fishes [%]
	Floating point
	Minimum: 0.000000
	Maximum: 100.000000
	Default: 30.000000
  -INIT_SHARK:<double>      	Initial Number of Sharks [%]
	Floating point
	Minimum: 0.000000
	Maximum: 100.000000
	Default: 7.500000
  -TABLE:<str>              	Cycles
	Table (output)
  -FISH_BIRTH:<num>         	Birth Rate of Fishes
	Integer
	Minimum: 0
	Default: 3
  -SHARK_BIRTH:<num>        	Birth Rate of Sharks
	Integer
	Minimum: 0
	Default: 12
  -SHARK_STARVE:<num>       	Max. Starvation Time for Sharks
	Integer
	Minimum: 0
	Default: 4