polars.Expr.ewm_std

Expr.ewm_std(
    *,
    com: float | None = None,
    span: float | None = None,
    half_life: float | None = None,
    alpha: float | None = None,
    adjust: bool = True,
    bias: bool = False,
    min_samples: int = 1,
    ignore_nulls: bool = False,
) → Expr

Вычисляет экспоненциально взвешенное скользящее стандартное отклонение.

движок:В памяти

Изменено в версии 1.21.0: Параметр min_periods был переименован в min_samples.

Параметры:

com

Задаёт затухание через центр масс, \(\gamma\), где

\[\alpha = \frac{1}{1 + \gamma} \; \forall \; \gamma \geq 0\]

span

Задаёт затухание через интервал, \(\theta\), где

\[\alpha = \frac{2}{\theta + 1} \; \forall \; \theta \geq 1\]

half_life

Задаёт затухание через период полураспада, \(\lambda\), где

\[\alpha = 1 - \exp \left\{ \frac{ -\ln(2) }{ \lambda } \right\} \; \forall \; \lambda > 0\]

alpha

Задаёт непосредственно коэффициент сглаживания alpha, \(0 < \alpha \leq 1\).

adjust

Делит на корректирующий коэффициент затухания в начальных периодах, чтобы учесть дисбаланс относительных весов

• Когда adjust=True (по умолчанию) функция EW вычисляется с использованием весов \(w_i = (1 - \alpha)^i\)

• Когда adjust=False функция EW вычисляется рекурсивно по формуле

  \[\begin{split}y_0 &= x_0 \\ y_t &= (1 - \alpha)y_{t - 1} + \alpha x_t\end{split}\]

bias

Если bias=False, применяется поправка, чтобы оценка была статистически несмещённой.

min_samples

Минимальное количество наблюдений в окне, необходимое для получения значения (в противном случае результат равен null).

ignore_nulls

Игнорировать отсутствующие значения при вычислении весов.

• Если ignore_nulls=False (по умолчанию), веса основаны на абсолютных позициях. Например, веса \(x_0\) и \(x_2\), используемые при вычислении итогового взвешенного среднего [\(x_0\), None, \(x_2\)], равны \((1-\alpha)^2\) и \(1\), если adjust=True, и \((1-\alpha)^2\) и \(\alpha\), если adjust=False.
• Если ignore_nulls=True, веса основаны на относительных позициях. Например, веса \(x_0\) и \(x_2\), используемые при вычислении итогового взвешенного среднего [\(x_0\), None, \(x_2\)], равны \(1-\alpha\) и \(1\), если adjust=True, и \(1-\alpha\) и \(\alpha\), если adjust=False.

Примеры

>>> df = pl.DataFrame({"a": [1, 2, 3]})
>>> df.select(pl.col("a").ewm_std(com=1, ignore_nulls=False))
shape: (3, 1)
┌──────────┐
│ a        │
│ ---      │
│ f64      │
╞══════════╡
│ null     │
│ 0.707107 │
│ 0.963624 │
└──────────┘