polars.Series.pct_change

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

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

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

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

Параметры:

n

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

Примечания

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

Примеры

>>> pl.Series(range(10)).pct_change()
shape: (10,)
Series: '' [f64]
[
    null
    inf
    1.0
    0.5
    0.333333
    0.25
    0.2
    0.166667
    0.142857
    0.125
]

>>> pl.Series([1, 2, 4, 8, 16, 32, 64, 128, 256, 512]).pct_change(2)
shape: (10,)
Series: '' [f64]
[
    null
    null
    3.0
    3.0
    3.0
    3.0
    3.0
    3.0
    3.0
    3.0
]