This is an old revision of the document!

PHP's gd library is missing or unable to create PNG images

# Calc Destination Map

## Description

This functor calculates destination cells taking into account some measure of attraction, as depicted on an attractiveness map. Non-null value cells represent selected destination cells.

## Inputs

Name Type Description
Attraction Map Attractiveness map. Values equal to or less than zero will be ignored.
Horizontal Quadrants Positive Int Number of horizontal segments into which the attractiveness map is divided.
Vertical Quadrants Positive Int Number of vertical segments into which the attractiveness map is divided.

## Optional Inputs

Name Type Description Default Value
Minimum Distance Between Destinations Non Negative Int Minimum distance buffer between adjacent destinations, in meters, is used as a constraint to impede the selection of additional destinations within this buffer. 0
Maximum Attempts Per Destinations Positive Int Maximum number of draws realized in order to pinpoint a valid destination. 15
Destinations Per Quadrant Non Negative Int Maximum number of destinations chosen in each map quadrant. 1
Cell Type Cell Type Data cell type of the output map. Unsigned 8 Bit Integer
Null Value Int Null value of the output map. 0
Destination Is Sparse Bool If true, map of destination is represented as a sparse image. Sparse images have the advantage of storing only the cells containing non-null values, but they have worse access time. True

## Outputs

Name Type Description
Destination Map Map depicting destination cells. Destination cells are depicted using their attractiveness value. Map has the same dimensions of the attractiveness map.

Map Algebra

## Notes

The number of destination cells is specified by the number of destinations per quadrant but not all potential destinations may be selected because some map regions do not show attractiveness greater than zero and some potential destinations are located within the minimum distance buffer.

An attractiveness value represents a probability of a cell to be selected based on some desired quality.

The attractiveness map must have integer values.

Example calculating destinations used by road construction simulation

## Internal Name

CalcDestinationMap