====== Assign Map Categories ====== 

===== Description =====

This functor assigns a set of categories to a map. The functor also allows combination or replacement of the existing map categories with a given set of categories.

===== Inputs =====

^ Name  ^ Type  ^ Description  ^
| Input Map  | [[Map Type]]  | The map that receives new categories requires an integer as the map cell type, except for an unsigned 32-bit integer. |
| Input Categories  | [[Categorization Type]]  | Categorization set (classes) to be assigned to the input map.  |

===== Optional Inputs =====

^ Name  ^ Type  ^ Description  ^ Default Value  ^
| Combine Categories | [[Boolean Value Type]]  | If true, the functor will combine the categories of the input map with the given category set. Otherwise, the categories in the input map will be replaced by the given category set.  | False  |

===== Output =====

^ Name  ^ Type  ^ Description  ^
| Output Map  | [[Map Type]]  | A copy of the input map with a new categorization.  |

===== Group =====

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

===== Notes =====

When "Combine Categories" is set, the functor combines the category sets, one from the input port and other from the input map. The main one is that passed as a parameter, thus, if both have an identical name or value, the category from the map will be replaced with the new one.

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

AssignMapCategories