Differences
This shows you the differences between two versions of the page.
| Both sides previous revision Previous revision | |||
|
patcher_continuous_state [2018/10/15 13:36] britaldo [Outputs] |
patcher_continuous_state [2026/07/14 19:25] (current) chrystian Fix functor documentation. |
||
|---|---|---|---|
| Line 1: | Line 1: | ||
| + | ===== Patcher Continuous State ===== | ||
| + | |||
| ===== Description ===== | ===== Description ===== | ||
| - | 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. | + | Generate new patches of a certain class or category. |
| ===== Inputs ===== | ===== Inputs ===== | ||
| ^ Name ^ Type ^ Description ^ | ^ Name ^ Type ^ Description ^ | ||
| - | | Landscape | [[Map Type]] | Map of continuous values of a stock variable. | | + | | Continuous Landscape | [[Map Type]] | Map of stocks. Each cell represent the amount of stock stored (in units per hectare). | |
| | Probabilities | [[Map Type]] | Map of spatial probabilities. | | | Probabilities | [[Map Type]] | Map of spatial probabilities. | | ||
| - | | Changes | [[Change Matrix Type]] | Matrix of change volume. | | + | | Quota | [[Real Value Type]] | Accumulation quota (in units). | |
| - | | 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|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. | | + | | Mean | [[Real Value Type]] | Patch mean (in hectares). | |
| + | | Variance | [[Real Value Type]] | Patch variance (in hectares). | | ||
| + | | Isometry | [[Real Value Type]] | Patch isometry. | | ||
| ===== Optional Inputs ===== | ===== Optional Inputs ===== | ||
| ^ Name ^ Type ^ Description ^ Default Value ^ | ^ 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 3x3 window corresponds to the Moore neighborhood. | 3 | | + | | Neighbor Window Lines | [[Positive Integer Value Type]] | Number of lines of the neighborhood search window. | 3 | |
| - | | Neighbor Window Columns | [[Positive Integer Value Type]] | ::: | 3 | | + | | Neighbor Window Columns | [[Positive Integer Value Type]] | Number of lines of the neighborhood search window. | 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 | | | 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 | | ||
| Line 21: | Line 25: | ||
| ^ Name ^ Type ^ Description ^ | ^ Name ^ Type ^ Description ^ | ||
| - | | Changed Landscape | [[ Map Type]] | Map of continuous values of a stock variable. | | + | | Modified Continuous Landscape | [[ Map Type]] | Map of remaining stocks. | |
| - | | Corroded Probabilities | [[Map Type]] | Map of depleted spatial probabilities. Where a change occurred, the probability value is set to zero. | | + | | Modified Probabilities | [[Map Type]] | Map of depleted spatial probabilities. | |
| - | | 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. | | + | | Remaining Quota | [[Real Value Type]] | ::: | |
| ===== Group ===== | ===== Group ===== | ||
| [[Functor List#Simulation | Simulation]] | [[Functor List#Simulation | Simulation]] | ||
| - | |||
| - | ===== Notes ===== | ||
| - | |||
| ===== Internal Name ===== | ===== Internal Name ===== | ||
| - | Patcher Continuous State | + | PatcherContinuousState |