numpy.ediff1d

numpy.ediff1d(ary, to_end=None, to_begin=None)

陣列中連續元素之間的差值。

參數:

aryarray_like

如有必要，將在計算差值之前展平。

to_endarray_like, optional

要附加到返回的差值末尾的數字。

to_beginarray_like, optional

要預先添加到返回的差值開頭的數字。

返回:

ediff1dndarray

差值。 粗略地說，這是 ary.flat[1:] - ary.flat[:-1]。

參見

diff, gradient

註解

當應用於遮罩陣列時，如果使用 to_begin 和/或 to_end 參數，此函數會捨棄遮罩資訊。

範例

>>> import numpy as np
>>> x = np.array([1, 2, 4, 7, 0])
>>> np.ediff1d(x)
array([ 1,  2,  3, -7])

>>> np.ediff1d(x, to_begin=-99, to_end=np.array([88, 99]))
array([-99,   1,   2, ...,  -7,  88,  99])

返回的陣列始終為 1D。

>>> y = [[1, 2, 4], [1, 6, 24]]
>>> np.ediff1d(y)
array([ 1,  2, -3,  5, 18])