mxnet.np.ediff1d

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

The differences between consecutive elements of an array.

Parameters
  • ary (ndarray) – If necessary, will be flattened before the differences are taken.

  • to_end (ndarray or scalar, optional) – Number(s) to append at the end of the returned differences.

  • to_begin (ndarray or scalar, optional) – Number(s) to prepend at the beginning of the returned differences.

Returns

ediff1d – The differences. Loosely, this is ary.flat[1:] - ary.flat[:-1].

Return type

ndarray

Examples

>>> 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]))
rray([-99.,   1.,   2.,   3.,  -7.,  88.,  99.])

The returned array is always 1D.

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