====== Calc Combination Map ======

===== Description =====

Calculates a map combining two other maps. The calculation assigns an unique value for each possible combination of values from co-registered cells in the input maps. Each unique value used is stored in a dictionary of combinations. The combination dictionary is a table with format "Combination*#real, Initial#real and Final#real" where the key represents the combined value, and the data values represent the two original values from each one of the input maps.

===== Inputs =====

^ Name  ^ Type  ^ Description  ^
| Initial Map  | [[Categorical Map Type]]  | The initial map. This map corresponds to the "Initial" value column in the resulting dictionary table.  |
| Final Map  | [[Categorical Map Type]]  | The final map. This map corresponds to the "Final" value column of in resulting dictionary table.  |

===== Output =====

^ Name  ^ Type  ^ Description  ^
| Combination Map  | [[Categorical Map Type]]  | Map depicting the combination of the two input maps.  |
| Combination Map Dictionary | [[Table Type]]  | Dictionary table used to translate the values assigned to each combination back into their corresponding initial and final value from the input maps. This table has format "Combination*#real, Initial#real and Final#real" where the key represents the combined value, and the data values represent the two original values from each one of the input maps.  |

===== Notes =====

The cell type of the output map is optimized to be the minimum cell type required to represent the combination of the two input maps.

===== Group =====

[[Functor List#Map Algebra | Map Algebra]]

===== Internal Name =====

CalcCombinationMap