đŸ Xarray is now 10 years old! đ

# xarray.DataArray.diff#

DataArray.diff(dim, n=1, *, label='upper')[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 (`DataArray`) â The n-th order finite difference of this object.

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
```