This functor treats cell values (landscape map) as stocks of a continuous variable by multiplying the cell values per its spatial dimension (ha). It then harvests quantities of these cells based on a total demand quantity (quota) and a probability map for choosing the cells to be harvested (e.g. profitability), resulting in a depleted map of stock values. The harvest is split in patches whose dimension distribution and forms are inputs.


Name Type Description
Landscape Map Type Map of continuous values of a stock variable.
Probabilities Map Type Map of spatial probabilities.
Changes Change Matrix Type Matrix of change volume.
Transition Parameters Transition Function Parameter Matrix Type Matrix of transition function parameters consisting of Mean Patch size, Patch size variance, and isometry. By varying these parameters, various spatial patterns can be reproduced (see examples on Patterns of Change). Increase the patch size for a less-fragmented landscape. Increase the patch size variance for a more diverse landscape, and set isometry greater than one for more isometric patches. Tipically, the isometry defines the aggregation level of a patch. Assuming that v is the current isometry value, 0<v<1 forces disaggregation, v>1 forces aggregation and v=1 is ignored. The mean patch size and the variance define the size of the new patches.

Optional Inputs

Name Type Description Default Value
Neighbor Window Lines Positive Integer Value Type Number of lines and columns of the neighbor search window. Patches can be created in a diffuse way by increasing the neighbor search window to values greater than 3 for lines and columns; a 3×3 window corresponds to the Moore neighborhood. 3
Neighbor Window Columns Positive Integer Value Type 3
Prune Factor Real Value Type A multiple of the quantity of cells to be changed. This is used in order to specify the size of the vector where cells are ranked for subsequent draw. Prune factor multiplies the expected number of cells to be changed to set the quantity of possible cells, based on their spatial probability, that take part in the selection mechanism of new patch nuclei. Typically, increasing this value also increases the stochasticity of selection of patch pivot cells. 10


Name Type Description
Changed Landscape Map Type Map of continuous values of a stock variable.
Corroded Probabilities Map Type Map of depleted spatial probabilities. Where a change occurred, the probability value is set to zero.
Remaining Changes Change Matrix Type Matrix of remaining volume for each type of transition in case the functor does not succeed in making all the specified changes.



Internal Name

Patcher Continuous State