### window.variance

Supported in:

    window.variance(values)

#### Description

This function returns the specified variance of the input values.

#### Param data types

`INT|FLOAT`

#### Return type

`FLOAT`

#### Code samples

##### Example 1

This example returns the variance of all integers.

    // This rule creates a detection when the file size variance in 5 minutes for a user is over a threshold.
    events:
     $e.user.userid = $userid
    match:
     $userid over 5m
    outcome:
      $p1 = window.variance($e.file.size) // yields 16 if the event file size values in the match window are [10, 14, 18].
    condition:
      $e and #p1 > 10

##### Example 2

This example returns the variance of all floats.

    events:
     $e.user.userid = $userid
    match:
     $userid over 5m
    outcome:
      $p1 = window.variance($e.file.size) // yields 20.148300 if the event file size values in the match window are [10.00, 14.80, 18.97].
    condition:
      $e and #p1 > 10

##### Example 3

This example returns the variance of negative numbers.

    events:
     $e.user.userid = $userid
    match:
     $userid over 5m
    outcome:
      $p1 = window.variance($e.file.size) // yields 2366.333333 if the event file size values in the match window are [-1, -56, -98].
    condition:
      $e and #p1 > 10

##### Example 4

This example returns a small variance value.

    events:
     $e.user.userid = $userid
    match:
     $userid over 5m
    outcome:
      $p1 = window.variance($e.file.size) // yields 0.000000 if the event file size values in the match window are [0.000000, 0.000000, 0.000100].
    condition:
      $e and #p1 > 10

##### Example 5

This example returns a zero variance.

    events:
     $e.user.userid = $userid
    match:
     $userid over 5m
    outcome:
      $p1 = window.variance($e.file.size) // yields 0.000000 if the event file size values in the match window are [1, 1, 1].
    condition:
      $e and #p1 > 10

##### Example 6

This example returns the variance of positive and negative numbers.

    events:
     $e.user.userid = $userid
    match:
     $userid over 5m
    outcome:
      $p1 = window.variance($e.file.size) // yields 1.000000 if the event file size values in the match window are [1, 0, -1].
    condition:
      $e and #p1 > 10