unpivot

unpivot(obj, keyColNames, valueColNames, [func])

obj 是一个表。

keyColNames 是表示列名的标量或向量，用于指定要在输出表中保留的列。

valueColNames 是一个列名向量。valueColNames 中的数据将转换成一列。 请注意 valueColNames 各列的数据类型应一致。

func 是一个函数。如果指定了 func 函数，该函数将会应用到 valueColNames 上，再将其合并。

把多列的数据转换成一列。

返回一个表，列的顺序依次为 keyColNames 指定的各列，valueType 列和 value 列。其中，若未指定 func 参数，则 valueType 列存储 valueColNames 中的列名，否则 ，valueType 列存储 func 应用于 valueColNames 中各列的结果；value 列存储 valueColNames 中各列的值。

t=table(1..3 as id, 2010.01.01 + 1..3 as time, 4..6 as col1, 7..9 as col2, 10..12 as col3, `aaa`bbb`ccc as col4, `ddd`eee`fff as col5, 'a' 'b' 'c' as col6);
t;

保留表 t 中的 id 列，将 col1 列和 col2 列转换为一列：

t.unpivot(keyColNames=`id, valueColNames=`col1`col2);

保留表 t 中的 id 列，将 col1 列和 col2 列转换为一列，且将自定义函数应用于 col1 列和 col2 列：

f = def(x): x.split("col")[1];
t.unpivot(keyColNames=`id, valueColNames=`col1`col2, func=f);

不保留其它列，仅仅将 col1 列和 col2 列转换为一列：

t.unpivot(, valueColNames=`col1`col2);

保留表 t 中的 id 列，将 col1 列、col2 列 和 col3 列转换为一列，且将自定义函数应用于 col1 列、col2 列和 col3 列：

f = def(x): x.regexReplace("col", "var")
t.unpivot(keyColNames=`id, valueColNames=`col1`col2`col3, func=f);

t.unpivot(keyColNames=`time, valueColNames=`col4`col5)

t = table(1..3 as id, 2010.01.01 + 1..3 as time, 8.1 9.2 11.3 as bid1, 12.4 11.1 10.5 as bid2, 10.1 10.2 10.3 as bid3, 10.1 10.2 10.3 as bid4, 10.1 11.2 9.3 as bid5, 7.7 8.2 10.5 as ask1, 11.4 10.1 9.5 as ask2, 9.6 9.2 11.3 as ask3, 12.1 7.2 8.3 as ask4, 10.1 12.5 8.9 as ask5);
t;
//保留 id 和 time 列，将 bid1~bid5 列转换到一个列
t1 = t.unpivot(`id`time, `bid1`bid2`bid3`bid4`bid5);
//不保留其它列，仅仅将 ask1~ask5 列转换到一个列
t2 = t.unpivot(, `ask1`ask2`ask3`ask4`ask5);
//分别将 t1 和 t2 的 valueType 和 value 列重命名后进行合并
re = rename!(t1, `valueType`value, `bid_type`bid_value) join rename!(t2, `valueType`value, `ask_type`ask_value)
re;