Differences
This shows you the differences between two versions of the page.
| 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 | ||