pandas.Series.diff

Series.diff(periods=1)[source]

Первое дискретное различие элементов.

Вычисляет разницу элемента Series по сравнению с другим элементом в Series (по умолчанию — элемент в предыдущей строке).

Параметры:

periods:int, по умолчанию 1

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

Возвращает:

Series

Первые разности Series.

См. также

Series.pct_change

Процентное изменение за заданное количество периодов.

Series.shift

Смещение индекса на нужное количество периодов с необязательной временной частотой.

DataFrame.diff

Первое дискретное различие объекта.

Примечания

Для булевых типов данных это использует operator.xor() вместо operator.sub(). Результат рассчитывается в соответствии с текущим типом данных в Series, однако тип данных результата всегда float64.

Примеры

Разница с предыдущей строкой

>>> s = pd.Series([1, 1, 2, 3, 5, 8])
>>> s.diff()
0    NaN
1    0.0
2    1.0
3    1.0
4    2.0
5    3.0
dtype: float64

Разница с третьей предыдущей строкой

>>> s.diff(periods=3)
0    NaN
1    NaN
2    NaN
3    2.0
4    4.0
5    6.0
dtype: float64

Разница со следующей строкой

>>> s.diff(periods=-1)
0    0.0
1   -1.0
2   -1.0
3   -2.0
4   -3.0
5    NaN
dtype: float64

Переполнение в входном типе данных

>>> s = pd.Series([1, 0], dtype=np.uint8)
>>> s.diff()
0      NaN
1    255.0
dtype: float64