🍾 Xarray is now 10 years old! 🎉

xarray.core.resample.DataArrayResample.max

xarray.core.resample.DataArrayResample.max#

DataArrayResample.max(dim=None, *, skipna=None, keep_attrs=None, **kwargs)[source]#

Reduce this DataArray’s data by applying max along some dimension(s).

Parameters:
  • dim (str, Iterable of Hashable, "..." or None, default: None) – Name of dimension[s] along which to apply max. For e.g. dim="x" or dim=["x", "y"]. If None, will reduce over the Resample dimensions. If “…”, will reduce over all dimensions.

  • skipna (bool or None, optional) – If True, skip missing values (as marked by NaN). By default, only skips missing values for float dtypes; other dtypes either do not have a sentinel missing value (int) or skipna=True has not been implemented (object, datetime64 or timedelta64).

  • keep_attrs (bool or None, optional) – If True, attrs will be copied from the original object to the new one. If False, the new object will be returned without attributes.

  • **kwargs (Any) – Additional keyword arguments passed on to the appropriate array function for calculating max on this object’s data. These could include dask-specific kwargs like split_every.

Returns:

reduced (DataArray) – New DataArray with max applied to its data and the indicated dimension(s) removed

See also

numpy.max, dask.array.max, DataArray.max

Resampling and grouped operations

User guide on resampling operations.

Notes

Use the flox package to significantly speed up resampling computations, especially with dask arrays. Xarray will use flox by default if installed. Pass flox-specific keyword arguments in **kwargs. The default choice is method="cohorts" which generalizes the best, method="blockwise" might work better for your problem. See the flox documentation for more.

Examples

>>> da = xr.DataArray(
...     np.array([1, 2, 3, 0, 2, np.nan]),
...     dims="time",
...     coords=dict(
...         time=("time", pd.date_range("2001-01-01", freq="ME", periods=6)),
...         labels=("time", np.array(["a", "b", "c", "c", "b", "a"])),
...     ),
... )
>>> da
<xarray.DataArray (time: 6)> Size: 48B
array([ 1.,  2.,  3.,  0.,  2., nan])
Coordinates:
  * time     (time) datetime64[ns] 48B 2001-01-31 2001-02-28 ... 2001-06-30
    labels   (time) <U1 24B 'a' 'b' 'c' 'c' 'b' 'a'
>>> da.resample(time="3ME").max()
<xarray.DataArray (time: 3)> Size: 24B
array([1., 3., 2.])
Coordinates:
  * time     (time) datetime64[ns] 24B 2001-01-31 2001-04-30 2001-07-31

Use skipna to control whether NaNs are ignored.

>>> da.resample(time="3ME").max(skipna=False)
<xarray.DataArray (time: 3)> Size: 24B
array([ 1.,  3., nan])
Coordinates:
  * time     (time) datetime64[ns] 24B 2001-01-31 2001-04-30 2001-07-31