> ## Documentation Index
> Fetch the complete documentation index at: https://mintlify-poc.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# stddev_y() | stddev_x()

> Calculate the standard deviation from a two-dimensional statistical aggregate for the dimension specified

<Icon icon="tag" iconType="duotone" /> Since [1.3.0][toolkit-1.3.0]

Calculate the standard deviation from a two-dimensional statistical aggregate for the given dimension. For example,
`stddev_y()` calculates the skewness for all the values of the `y` variable, independent of values of the `x` variable.

## Samples

Calculate the standard deviation of a sample containing the integers from 0 to 100:

```sql theme={"dark"}
SELECT stddev_y(stats_agg(data, data))
  FROM generate_series(0, 100) data;
```

```
stddev_y
--------
29.3002
```

## Arguments

The syntax is:

```sql theme={"dark"}
stddev_y(
  summary StatsSummary2D,
  [ method TEXT ]
) RETURNS DOUBLE PRECISION
```

```sql theme={"dark"}
stddev_x(
  summary StatsSummary2D,
    [ method TEXT ]
) RETURNS DOUBLE PRECISION
```

| Name    | Type           | Default  | Required | Description                                                                                                                                        |
| ------- | -------------- | -------- | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------- |
| summary | StatsSummary2D | -        | ✔        | The statistical aggregate produced by a `stats_agg` call                                                                                           |
| method  | TEXT           | `sample` | -        | The method used for calculating the standard deviation. The two options are `population` and `sample`, which can be abbreviated to `pop` or `samp` |

## Returns

| Column                 | Type             | Description                                                       |
| ---------------------- | ---------------- | ----------------------------------------------------------------- |
| stddev\_y \| stddev\_x | DOUBLE PRECISION | The standard deviation of the values in the statistical aggregate |

[toolkit-1.3.0]: https://github.com/timescale/timescaledb-toolkit/releases/tag/1.3.0
