diff

UnitsAwareDataArray.diff(*args, **kwargs)[source]

Calculate the n-th order discrete difference along given axis.

Parameters:
  • dim (Hashable) – Dimension over which to calculate the finite difference.

  • n (int, default: 1) – The number of times values are differenced.

  • label ({"upper", "lower"}, default: "upper") – The new coordinate in dimension dim will have the values of either the minuend’s or subtrahend’s coordinate for values ‘upper’ and ‘lower’, respectively.

Returns:

difference – The n-th order finite difference of this object.

Return type:

DataArray

Notes

n matches numpy’s behavior and is different from pandas’ first argument named periods.

Examples

>>> arr = xr.DataArray([5, 5, 6, 6], [[1, 2, 3, 4]], ["x"])
>>> arr.diff("x")
<xarray.DataArray (x: 3)> Size: 24B
array([0, 1, 0])
Coordinates:
  * x        (x) int64 24B 2 3 4
>>> arr.diff("x", 2)
<xarray.DataArray (x: 2)> Size: 16B
array([ 1, -1])
Coordinates:
  * x        (x) int64 16B 3 4

See also

DataArray.differentiate