Calc Cost Allocation Map

Description

This functor identifies a region of influence for each source feature, used as one of the foci points from which an accumulated cost surface is calculated. For each source feature, a region is allocated by assigning to it every cell that has a lower cost to reach that feature than any other.

Inputs

Name	Type	Description
Sources	Categorical Map Type	Map whose non-null cells correspond to source features. If Sources does not define a null value, this functor reports an error.
Costs Or Directions	Map Type	Map of accumulated cost per cell, or of its corresponding cost directions.
Input Represents Directions	Boolean Value Type	If true, Costs Or Directions is assumed to represent cost directions; otherwise, it is assumed to represent costs. A cost-direction cell can only take the eight values corresponding to the directions of a Moore neighborhood: None=0, NW=1, N=2, NE=3, E=4, SE=5, S=6, SW=7, and W=8.

Optional Inputs

Name	Type	Description	Default Value
Use Lottery	Boolean Value Type	If true, ties for the lowest cost are broken randomly. This is an advanced port.	No

Outputs

Name	Type	Description
Allocation	Categorical Map Type	Map of cost regions, one per source feature — similar to a watershed. Each region is identified by the category of its source feature. Allocation has the same dimensions as Sources.

Group

Map Algebra

Notes

This functor reports an error if a local minimum is found on the cost map.

Internal Name

CalcCostAllocationMap