Differences
This shows you the differences between two versions of the page.
| Next revision | Previous revision | ||
|
mux_categorical_map [2011/07/31 18:49] hermann created |
mux_categorical_map [2026/08/28 03:27] (current) hermann Sync from local documentation review |
||
|---|---|---|---|
| Line 1: | Line 1: | ||
| - | ====== Mux Categorical Map ====== | + | ====== Mux Categorical Map ====== |
| ===== Description ===== | ===== Description ===== | ||
| - | This functor makes a categorical map dynamic, feeding it back with a map output from a model step. In the beginning of the first iteration, it reads map input from the initial port. | + | Initializes a loop variable and feeds it back with the categorical map produced by the previous step, letting a map carry over from one iteration of a loop to the next. At the start of the first iteration, it reads its initial map from Initial. The use of this functor is central to building dynamic models whose variables are updated from one step to the next through feedback. |
| ===== Inputs ===== | ===== Inputs ===== | ||
| - | ^ Name ^ Type ^ Description ^ | + | ^ Name ^ Type ^ Description ^ |
| - | | Initial | [[ Categorical Map Type|Categorical Map ]] | The initial map. | | + | | Initial | [[Categorical Map Type]] | Initial map, used on the first iteration. | |
| - | | Feedback | [[Categorical Map Type|Categorical Map ]] | Map of classes or categories generated from model step. | | + | | Feedback | [[Categorical Map Type]] | Map generated by the previous model step. This port must be connected to a functor placed later in the same loop, which supplies the map produced by that iteration. | |
| ===== Optional Inputs ===== | ===== Optional Inputs ===== | ||
| + | |||
| + | None. | ||
| ===== Outputs ===== | ===== Outputs ===== | ||
| - | ^ Name ^ Type ^ Description ^ | + | ^ Name ^ Type ^ Description ^ |
| - | | Map | [[ Categorical Map Type| Categorical Map ]] | The output map. | | + | | Map | [[Categorical Map Type]] | Map for the current iteration: Initial on the first iteration, and the map received through Feedback on every iteration after that. | |
| ===== Group ===== | ===== Group ===== | ||
| Line 22: | Line 24: | ||
| [[Functor List#Control | Control]] | [[Functor List#Control | Control]] | ||
| - | ===== Notes ===== | + | ===== Notes ===== |
| + | |||
| + | This functor must always be placed directly inside a loop container, such as [[Repeat]], [[For]], or [[For Each Category]]. Placing it anywhere else reports a warning. | ||
| - | The use of this functor is critical for the development of dynamic models whose map variables are dynamically updated as a result of the model feedback. | + | Feedback should be connected to a functor evaluated later in the same iteration, so that it can supply the map produced by that step. Setting it to a fixed constant reports a warning, since a constant defeats the purpose of feeding a map back from the previous step. |
| - | ===== Internal Name ===== | + | ===== Internal Name ===== |
| MuxCategoricalMap | MuxCategoricalMap | ||