Differences
This shows you the differences between two versions of the page.
| Both sides previous revision Previous revision Next revision | Previous revision | ||
|
patcher_continuous_state [2018/10/15 13:35] britaldo [Outputs] |
patcher_continuous_state [2026/08/28 03:29] (current) hermann Sync from local documentation review |
||
|---|---|---|---|
| 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. | + | This functor generates new patches of a certain class or category, allocating a continuous quantity of stock, rather than a discrete number of cells, up to a specified quota. |
| ===== Inputs ===== | ===== Inputs ===== | ||
| - | ^ Name ^ Type ^ Description ^ | + | ^ Name ^ Type ^ Description ^ |
| - | | Landscape | [[Categorical Map Type]] | Map of continuous values of a stock variable. | | + | | Continuous Landscape | [[Map Type]] | Map of stocks. Each cell represents 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. This is an advanced port. | 3 | |
| - | | Neighbor Window Columns | [[Positive Integer Value Type]] | ::: | 3 | | + | | Neighbor Window Columns | [[Positive Integer Value Type]] | Number of columns of the neighborhood search window. This is an advanced port. | 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 stock to be allocated, used to size the vector where cells are ranked for the subsequent draw. This is an advanced port. | 10 | |
| ===== Outputs ===== | ===== Outputs ===== | ||
| - | ^ 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 of volume for each type of transition in case the functor does not succeed in making all the specified changes. | | + | | Remaining Quota | [[Real Value Type]] | Quota that could not be accumulated. | |
| ===== Group ===== | ===== Group ===== | ||
| Line 29: | Line 33: | ||
| [[Functor List#Simulation | Simulation]] | [[Functor List#Simulation | Simulation]] | ||
| - | ===== Notes ===== | + | ===== Notes ===== |
| + | This functor works like Patcher, but accumulates a continuous quantity of stock into new patches, up to Quota, instead of transitioning a discrete number of cells. | ||
| - | ===== Internal Name ===== | + | Patch isometry is a number varying from 0 to 2. Patches assume a more isometric form as this number increases. |
| - | Patcher Continuous State | + | ===== Internal Name ===== |
| + | PatcherContinuousState | ||