Differences

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

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
mux_map [2013/08/23 22:10]
admin [Notes]
mux_map [2026/08/28 03:27] (current)
hermann Sync from local documentation review
Line 1: Line 1:
-====== Mux Map ====== ​+====== Mux Map ======
  
 ===== Description ===== ===== Description =====
  
-This functor makes map dynamic, feeding ​it back with a map output ​from a model stepIn the beginning ​of the first iteration, it reads map input from the initial port+Initializes ​loop variable and feeds it back with the map produced by the previous step, letting ​a map carry over from one iteration of loop to the nextAt 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 ​ | [[Map Type|Map]]  | The initial ​map.  | +| Initial ​ | [[Map Type]] ​ | Initial ​map, used on the first iteration.  | 
-| Feedback ​ | [[Map Type|Map]]  | Map generated ​from model step.  |+| Feedback ​ | [[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  | [[Map Type| Map]]  | The output ​map.  |+| Map  | [[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 =====
  
-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.+This functor ​must always be placed directly inside a loop container, such as [[Repeat]], [[For]], or [[For Each Category]]. Placing it anywhere else reports ​warning.
  
-<WRAP center round box 80%> +Feedback should ​be connected to a functor evaluated later in the same iterationso that it can supply the map produced by that step. Setting it to a fixed constant reports a warningsince a constant defeats the purpose of feeding a map back from the previous step.
-**Muxes must always ​be placed directly inside loop containers like [[Repeat]][[For]][[For Each Category]] etc.**</​WRAP>​+
  
-===== Internal Name ===== +===== Internal Name =====
  
 MuxMap MuxMap