xarray.Dataset.shift

Dataset.shift(shifts=None, fill_value=<NA>, **shifts_kwargs)

Shift this dataset by an offset along one or more dimensions.

Only data variables are moved; coordinates stay in place. This is consistent with the behavior of shift in pandas.

Parameters:
shifts : Mapping with the form of {dim: offset}

Integer offset to shift along each of the given dimensions. Positive offsets shift to the right; negative offsets shift to the left.

fill_value: scalar, optional

Value to use for newly missing values

**shifts_kwargs:

The keyword arguments form of shifts. One of shifts or shifts_kwarg must be provided.

Returns:
shifted : Dataset

Dataset with the same coordinates and attributes but shifted data variables.

See also

roll

Examples

>>> ds = xr.Dataset({'foo': ('x', list('abcde'))})
>>> ds.shift(x=2)
<xarray.Dataset>
Dimensions:  (x: 5)
Coordinates:
  * x        (x) int64 0 1 2 3 4
Data variables:
    foo      (x) object nan nan 'a' 'b' 'c'