Differences
This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision | ||
select_sub_table [2013/08/09 19:50] admin [Description] |
select_sub_table [2015/10/14 03:09] (current) admin |
||
---|---|---|---|
Line 7: | Line 7: | ||
If a sub-table corresponding to the given step is not found, the sub-table corresponding to the greatest key smaller than the given step is returned. | If a sub-table corresponding to the given step is not found, the sub-table corresponding to the greatest key smaller than the given step is returned. | ||
- | ===== Inputs ===== | + | ===== Inputs ===== |
- | ^ Name ^ Type ^ Description ^ | + | ^ Name ^ Type ^ Description ^ |
- | | Input Table | [[Table Type|Map]] | The table containing the sub-tables corresponding to steps. | | + | | Input Table | [[Table Type]] | The table containing the sub-tables corresponding to steps. | |
- | | Step | [[Double Type|Double]] | The input step. | | + | | Step | [[Real Value Type]] | The input step. | |
===== Outputs ===== | ===== Outputs ===== | ||
- | ^ Name ^ Type ^ Description ^ | + | ^ Name ^ Type ^ Description ^ |
- | | Result | [[Table Type|Table]] | The resulting sub-table. | | + | | Result | [[Table Type]] | The resulting sub-table. | |
===== Group ===== | ===== Group ===== | ||
Line 24: | Line 24: | ||
===== Notes ===== | ===== Notes ===== | ||
- | This submodel is similar to functor [[Get Table From Key]], except that if a key is not found, it retrieves the sub-table corresponding to the greatest key smaller than the given step. This is the same behavior found in operators like [[Select Lookup Table]] and [[Select Transition Matrix]]. Thus, the use of this submodel is advised as a better replacement to the Select family of functors. | + | This submodel is similar to functor [[Get Table From Key]], except that if a key is not found, it retrieves the sub-table corresponding to the greatest key smaller than the given step. This is the same behavior adopted by functors like [[Select Lookup Table]] and [[Select Transition Matrix]]. Thus, the use of this submodel is advised as a suitable replacement for that functor family. |
+ | |||
+ | The differences between Select Sub Table and [[Get Table From Key]] can be seen below: | ||
+ | |||
+ | ^ Key1* ^ Key2* ^ Value1 ^ Value2 ^ | ||
+ | |@lightyellow: 1 |@yellow: 12 |@yellow: "bbbb" |@yellow: 23 | | ||
+ | |@#CCFFCC: 5 |@#C5D9FF: 12 |@#C5D9FF: "cccc" |@#C5D9FF: 23 | | ||
+ | |@#CCFFCC: 5 |@#C5D9FF: 11 |@#C5D9FF: "bbbb" |@#C5D9FF: 14 | | ||
+ | | 12 | 22 | "aaaa" | 23 | | ||
+ | |||
+ | Retrieving the sub-table corresponding to Key1 5 returns the following table for both operators: | ||
+ | |||
+ | ^ Key2* ^ Value1 ^ Value2 ^ | ||
+ | |@#C5D9FF: 12 |@#C5D9FF: "cccc" |@#C5D9FF: 23 | | ||
+ | |@#C5D9FF: 11 |@#C5D9FF: "bbbb" |@#C5D9FF: 14 | | ||
+ | |||
+ | However, retrieving the sub-table corresponding to Key1 4 fails for [[Get Table From Key]], but returns | ||
+ | |||
+ | ^ Key2* ^ Value1 ^ Value2 ^ | ||
+ | |@yellow: 12 |@yellow: "bbbb" |@yellow: 23 | | ||
===== Internal Name ===== | ===== Internal Name ===== | ||
- | GetTableValue | + | SelectSubTable |