W3cubDocs

/Nushell

`rotate` for filters

Rotates a table or record clockwise (default) or counter-clockwise (use --ccw flag).

Signature

> rotate {flags} ...rest

Flags

--ccw, -: rotate counter clockwise

Parameters

...rest: the names to give columns once rotated

Input/output types:

input	output
record	table
table	table

Examples

Rotate a record clockwise, producing a table (like transpose but with column order reversed)

> {a:1, b:2} |rotate
╭───┬─────────┬─────────╮
│# │ column0 │ column1 │
├───┼─────────┼─────────┤
│0│1│a│
│1│2│b│
╰───┴─────────┴─────────╯

Rotate 2x3 table clockwise

> [[ab]; [12] [34] [56]] |rotate
╭───┬─────────┬─────────┬─────────┬─────────╮
│# │ column0 │ column1 │ column2 │ column3 │
├───┼─────────┼─────────┼─────────┼─────────┤
│0│5│3│1│a│
│1│6│4│2│b│
╰───┴─────────┴─────────┴─────────┴─────────╯

Rotate table clockwise and change columns names

> [[ab]; [12]] |rotatecol_acol_b
╭───┬───────┬───────╮
│# │ col_a │ col_b │
├───┼───────┼───────┤
│0│1│a│
│1│2│b│
╰───┴───────┴───────╯

Rotate table counter clockwise

> [[ab]; [12]] |rotate--ccw
╭───┬─────────┬─────────╮
│# │ column0 │ column1 │
├───┼─────────┼─────────┤
│0│b│2│
│1│a│1│
╰───┴─────────┴─────────╯

Rotate table counter-clockwise

> [[ab]; [12] [34] [56]] |rotate--ccw
╭───┬─────────┬─────────┬─────────┬─────────╮
│# │ column0 │ column1 │ column2 │ column3 │
├───┼─────────┼─────────┼─────────┼─────────┤
│0│b│2│4│6│
│1│a│1│3│5│
╰───┴─────────┴─────────┴─────────┴─────────╯

Rotate table counter-clockwise and change columns names

> [[ab]; [12]] |rotate--ccwcol_acol_b
╭───┬───────┬───────╮
│# │ col_a │ col_b │
├───┼───────┼───────┤
│0│b│2│
│1│a│1│
╰───┴───────┴───────╯