This functor calculates a map of destination cells by selecting suitable cells in an attractiveness map.
| Name | Type | Description |
|---|---|---|
| Attraction | Map Type | Map of attractiveness. Attractiveness values less than or equal to zero are ignored. |
| Horizontal Quadrants | Positive Integer Value Type | Number of horizontal quadrants into which Attraction is divided. |
| Vertical Quadrants | Positive Integer Value Type | Number of vertical quadrants into which Attraction is divided. |
| Name | Type | Description | Default Value |
|---|---|---|---|
| Minimum Distance Between Destinations | Non Negative Integer Value Type | Minimum distance, in meters, between adjacent destinations. | 0 |
| Maximum Attempts Per Destination | Positive Integer Value Type | Maximum number of draws attempted for each destination to be chosen, until one is found that does not violate the minimum-distance constraint. This is an advanced port. | 15 |
| Destinations Per Quadrant | Non Negative Integer Value Type | Maximum number of destinations chosen in each quadrant. This is an advanced port. | 1 |
| Cell Type | Cell Type Type | Cell type of the destination map. | Unsigned 8 Bit Integer |
| Null Value | Null Value Type | Null value of the destination map. | .default |
| Destination Is Sparse | Boolean Value Type | If true, the destination map is stored as a sparse raster. This is an advanced port. | Yes |
| Name | Type | Description |
|---|---|---|
| Destination | Map Type | Map of the cells chosen as destinations. Destination has the same dimensions as Attraction, and cells chosen as destinations carry their attractiveness value. |
This functor is outdated; prefer Select Random Points, Select Random Point Cluster, Patcher, or Expander instead.
For each quadrant into which Attraction is divided, as many destination cells are drawn as specified by Destinations Per Quadrant. A quadrant may draw fewer than that, or none at all, when it has no valid (non-null, greater-than-zero) attractiveness cells left, or when its remaining candidate cells all lie closer than Minimum Distance Between Destinations to a destination already drawn.
Attractiveness is used as a selection probability for each cell: the higher the attractiveness, the greater the chance that the corresponding cell is selected.
Attraction cannot have real-numbered values.
CalcDestinationMap