Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
merge_regional_categorical_maps [2026/08/27 03:50]
hermann
merge_regional_categorical_maps [2026/08/28 03:27] (current)
hermann Sync from local documentation review
Line 1: Line 1:
 ====== Merge Regional Categorical Maps ====== ====== Merge Regional Categorical Maps ======
  
-=== Description ===+===== Description ​=====
  
 Rebuilds a single categorical map by merging together all the regional categorical maps that [[Regional Categorical Map]] registered under a given name in the same region manager. Rebuilds a single categorical map by merging together all the regional categorical maps that [[Regional Categorical Map]] registered under a given name in the same region manager.
  
-=== Inputs ===+===== Inputs ​=====
  
-^ Name ^ Type ^ Description ^ +^ Name  ^ Type  ^ Description ​ 
-| Global Map Name | [[name_type|Name Type]] | Name under which the regional categorical maps to merge were registered by [[Regional Categorical Map]]. |+| Global Map Name  | [[Name Type]] ​ | Name under which the regional categorical maps to merge were registered by [[Regional Categorical Map]]. ​ |
  
-=== Optional Inputs ===+===== Optional Inputs ​=====
  
-^ Name ^ Type ^ Default ​^ Description ^ +^ Name  ^ Type  ^ Description ​ ^ Default Value  ​
-| Merge Non Region Cells | [[boolean_value_type|Boolean Value Type]] ​| No | If true, cells located outside a region'​s mask — including its extra border — are merged in as well. If false, those cells are ignored. Merging two cells only works when they carry the same value, or when one of them is null. | +| Merge Non Region Cells  | [[Boolean Value Type]] ​ | If true, cells located outside a region'​s mask — including its extra border — are merged in as well. If false, those cells are ignored. Merging two cells only works when they carry the same value, or when one of them is null.  | No  ​
-| Region Manager | [[region_manager_type|Region Manager Type]] ​| Provided automatically ​| The region manager to read. When this functor is placed inside a [[Region Manager]] or [[Region]] container, this port connects to that container'​s region manager automatically. |+| Region Manager ​ | [[Region Manager Type]] ​ | The region manager to read. When this functor is placed inside a [[Region Manager]] or [[Region]] container, this port connects to that container'​s region manager automatically. ​ | Provided automatically  ​|
  
-=== Outputs ===+===== Outputs ​=====
  
-^ Name ^ Type ^ Description ^ +^ Name  ^ Type  ^ Description ​ 
-| Global Map | [[categorical_map_type|Categorical Map Type]] | Mosaic of the regional categorical maps registered under Global Map Name. |+| Global Map  | [[Categorical Map Type]] ​ | Mosaic of the regional categorical maps registered under Global Map Name.  |
  
-=== Group ===+===== Group =====
  
-[[functor_list#region|Region]]+[[Functor List#Region ​| Region]]
  
-=== Notes ===+===== Notes =====
  
-  * This functor raises an error if no [[Regional Categorical Map]] registered a map under Global Map Name in the same region manager+This functor raises an error if no [[Regional Categorical Map]] registered a map under Global Map Name in the same region manager.
-  * Merging cells outside the region masks raises an error if two different regional maps disagree on the value of the same cell — that is, both give it a non-null value, and the values differ. +
-  * Placing this functor inside a [[For Each Region]] container raises an error, since the region manager that container exposes does not store regional maps — it only splits a map into regions, it does not collect them back together. Use a [[Region Manager]] (or [[Region]]) instead, with [[Regional Categorical Map]] registering each region'​s map inside it.+
  
-=== Internal Name ===+Merging cells outside the region masks raises an error if two different regional maps disagree on the value of the same cell — that is, both give it a non-null value, and the values differ. 
 + 
 +Placing this functor inside a [[For Each Region]] container raises an error, since the region manager that container exposes does not store regional maps — it only splits a map into regions, it does not collect them back together. Use a [[Region Manager]] (or [[Region]]) instead, with [[Regional Categorical Map]] registering each region'​s map inside it. 
 + 
 +===== Internal Name =====
  
 MergeRegionalCategoricalMaps MergeRegionalCategoricalMaps