====== For Each Region ====== 

===== Description =====

This container creates and manages regions identified by a categorical map, whose classes represent regions. It manages both the processes of splitting a map into several maps, each one comprising a region, and the subsequent merging of all regional maps in a mosaic, that is a new map. The container also calls the functors inside it to each region. 

===== Inputs =====

^ Name  ^ Type  ^ Description  ^
| Regions  | [[Categorical Map Type]]  | Map of subregions, e.g, countries, states, counties, etc.  |

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

^ Name  ^ Type  ^ Description  ^ Default Value  ^
| Border Cells  | [[Non Negative Integer Value Type]]  | Number of lines and columns used to create an additional border around each region.  | 0  |

===== Outputs =====

None.

===== Internal Outputs =====

^ Name  ^ Type  ^ Description  ^
| Step  | [[Integer Value Type]]  | Current region identifier.  |

===== Group =====

[[Functor List#Region | Region]]

===== Notes ===== 

Since a Boolean representation is used as a mask for a region, it is advisable to use "Unsigned 1 Bit Integer" as the cell type for the region mask map.

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

ForEachRegion