EasyMorph Help

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
{{ transformations:IntervalMergeAction.png}}
====== INTERVAL MERGE ======
Category: Transform / Advanced \\

\\ 
=====Description=====
This action merges two tables based on whether a value in one table falls into a range specified by two values in another table.

The lower boundary of a range is inclusive, the upper is exclusive. Ranges can overlap. In such cases, one row for each match will be inserted into the resulting table.\\

\\
=====Use cases=====
//Interval merge// can be used to categorize or "bucket" values in a dataset that fall within a given range or scale, such as survey responses (1-3 = "bad", 4-6 = "neutral", 7-10 = "good"), temperature ranges, size scales, etc.

This action is a good substitute for a [[transformations:lookup|Lookup]] action that uses multiple lookup values with similar return values (e.g., 1="good", 2="good", 3="neutral", 4="bad", 5="bad).

\\ 
=====Action settings=====
^Setting^Description^
|Merge table|Select the table to merge with the current dataset.|
|Columns|Select whether to merge all columns in the second dataset, or just selected columns.  Options:  //All columns// or\\ //Selected columns// (choose which columns to include in the merge).|
The reference to the second table will appear as a dotted line connecting this action to the second dataset in the application window.\\

\\ 
=====Remarks=====
To create a lookup set that doesn't contain any "gaps" be sure to set the "less than" value one higher than the last value you want to be included in the range, and start the //following// pairing with that same value.

^Low  ^High  ^Label  ^
|  0|  4| Range is 0 to __3__|
|  4|  8| Range is 4 to __7__ (don't start with "5" or you'll lose "4")|
|  8|  11| Range is 8 to __10__. (range end is "10" as "11" is excluded)|
\\ 
A lookup pair (low, high) cannot have a "high" value that is equal to the "low" value.  This pairing will not return a match as there is no upper threshold.  e.g. with "1" as the low value and "1" (//exclusive//) as the high value, no actual upper threshold has been defined.  In such cases, set a high value that is //just past// the intended upper limit. (i.e., 1.01, or "Zz" for text merges)\\
\\ 
//Interval merge// can also use text-based lookup ranges and values (see Example 2, below).\\

\\ 
=====Examples=====

====Example #1====
>Use a letter-based merge to assign Names to letter ranges.

===Before (source table)===
Table 1: Names
^Name  ^
|Sally  |
|Bruce  |
|Frank  |

Table 2: Lookup ranges
^Low  ^High  ^Label  ^
|A  |M  |Range A-M  |
|N  |Z  |Range N-Z  |

===After (result table)===
^Name  ^Label  ^
|Sally  |**Range N-Z**  |
|Bruce  |**Range A-M**  |
|Mario  |**Range A-M**  |

===Action parameters===
> Table to merge: Table 2
> Values in column: Name (Table 1)
> Are greater or equal: Low (Table 2)
> And less than: High (Table 2)
> Columns to merge: Label (Table 2)

\\
====Example #2====
>Find what it feels like in Toronto during the year.\\

===Before (source table)===
Table 1: Temperature in Toronto (Celsius)
^Month	^Temp High (C)^
|Jan	|   0|
|Feb	|   0|
|Mar	|   4|
|Apr	|  12|
|May	|  19|
|Jun	|  24|
|Jul	|  27|
|Aug	|  26|
|Sep	|  23|
|Oct	|  15|
|Nov	|   9|
|Dec	|   3|

Table 2: Boundaries
^ Lower ^ Upper ^ Feels ^
|      0|     15|Cold    |
|     15|     25|Comfortable |
|     25|     99|Hot   |

**Result table:**
^Month	^High, C^ Feels ^
|Jan	|   0|Cold  |
|Feb	|   0|Cold  |
|Mar	|   4|Cold  |
|Apr	|  12|Cold  |
|May	|  19|Comfortable|
|Jun	|  24|Comfortable|
|Jul	|  27|Hot  |
|Aug	|  26|Hot  |
|Sep	|  23|Comfortable|
|Oct	|  15|Comfortable|
|Nov	|   9|Cold  |
|Dec	|   3|Cold  |
 
===Action parameters===
> Table to merge: Table 2
> Values in column: Temp High (C) (Table 1)
> Are greater than or equal: Lower (Table 2)
> And less than: Upper (Table 2)


\\ 
=====Community examples=====
  * [[https://community.easymorph.com/t/rules-on-2-or-more-tables/952|Rules on 2 or more tables (with downloadable example)]]
  * [[https://community.easymorph.com/t//1851/1|Example of using Interval Merge]] ([[https://community.easymorph.com/uploads/short-url/3ROZA38vhs9S7bXLcNKPIjudF61.morph|Project]]; Module: //Main//; Group: //Tab 1//; Table: //Table 1//; Action position: //2//)
  * [[https://community.easymorph.com/t//2292/2|Assign value from conditions based on a table]] ([[https://community.easymorph.com/uploads/short-url/hsFachkdfbcKFoA2ZK8WcmOUfA9.morph|Project]]; Module: //Main//; Group: //Group 1//; Table: //Result//; Action position: //2//)

\\ 
=====See also=====
  * [[transformations:lookup|Lookup]]
  * [[transformations:merge|Merge another table]]
  * [[transformations:crossmerge|Cross merge]]