W3cubDocs

/Nushell

window for filters

Creates a sliding window of `window_size` that slide by n rows/elements across input.

Signature

> window {flags} (window_size)

Flags

  • --stride, -s {int}: the number of rows to slide over between windows
  • --remainder, -r: yield last chunks even if they have fewer elements than size

Parameters

  • window_size: the size of each window

Input/output types:

input output
list<any> list<list<any>>

Examples

A sliding window of two elements

> [1234] |window2
╭───┬───────────╮
0╭───┬───╮
01
12
╰───┴───╯
1╭───┬───╮
02
13
╰───┴───╯
2╭───┬───╮
03
14
╰───┴───╯
╰───┴───────────╯

A sliding window of two elements, with a stride of 3

> [1, 2, 3, 4, 5, 6, 7, 8] |window2--stride3
╭───┬───────────╮
0╭───┬───╮
01
12
╰───┴───╯
1╭───┬───╮
04
15
╰───┴───╯
2╭───┬───╮
07
18
╰───┴───╯
╰───┴───────────╯

A sliding window of equal stride that includes remainder. Equivalent to chunking

> [1, 2, 3, 4, 5] |window3--stride3--remainder
╭───┬───────────╮
0╭───┬───╮
01
12
23
╰───┴───╯
1╭───┬───╮
04
15
╰───┴───╯
╰───┴───────────╯

Copyright © 2019–2023 The Nushell Project DevelopersLicensed under the MIT License.
https://www.nushell.sh/commands/docs/window.html