polars.Expr.pct_change

Expr.pct_change(
    n: int | IntoExprColumn = 1,
) → Expr

Вычисляет процентное изменение между значениями.

Процентное изменение (в виде дроби) между текущим элементом и ближайшим предыдущим ненулевым элементом, расположенным не менее чем на n период(а) раньше текущего элемента.

По умолчанию вычисляет изменение относительно предыдущей строки.

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

Параметры:

n

Количество периодов для сдвига при вычислении процентного изменения.

Примечания

Значения null сохраняются. Если вы переходите с pandas, это соответствует их поведению fill_method=None.

Примеры

>>> df = pl.DataFrame(
...     {
...         "a": [10, 11, 12, None, 12],
...     }
... )
>>> df.with_columns(pl.col("a").pct_change().alias("pct_change"))
shape: (5, 2)
┌──────┬────────────┐
│ a    ┆ pct_change │
│ ---  ┆ ---        │
│ i64  ┆ f64        │
╞══════╪════════════╡
│ 10   ┆ null       │
│ 11   ┆ 0.1        │
│ 12   ┆ 0.090909   │
│ null ┆ null       │
│ 12   ┆ null       │
└──────┴────────────┘