mars.dataframe.Series.diff

Series.diff(periods=1)

元素的第一次离散差异。 计算序列中一个元素与另一个元素的差值（默认是前一行中的元素）。

Parameters

periods (int, 默认值 1) – 计算差异时的偏移周期，可以接受负值。

Returns

序列的第一差分。

Return type

系列

另请参阅

Series.pct_change

在给定的若干周期内的百分比变化。

Series.shift

按所需的周期数移位索引，并可选择时间频率。

DataFrame.diff

对象的第一次离散差异。

备注

对于布尔数据类型，这使用 operator.xor() 而不是 operator.sub()。

示例

与前一行的区别

>>> import mars.dataframe as md
>>> s = md.Series([1, 1, 2, 3, 5, 8])
>>> s.diff().execute()
0    NaN
1    0.0
2    1.0
3    1.0
4    2.0
5    3.0
dtype: float64

与第三前一行的差异

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

与以下行的差异

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