# xarray.core.groupby.DatasetGroupBy.cumprod

#### DatasetGroupBy.cumprod(dim=None, , skipna=None, keep_attrs=None, \*\*kwargs)[[source]](https://github.com/pydata/xarray/blob/main/xarray/core/_aggregations.py#L5163-L5270)

Reduce this Dataset’s data by applying `cumprod` (i.e., cumulative product) along some dimension(s).

* **Parameters:**
  * **dim** ([`str`](https://docs.python.org/3/builtins/stdtypes.html#str), `Iterable` of `Hashable`, `"..."` or [`None`](https://docs.python.org/3/builtins/constants.html#None), *default*: [`None`](https://docs.python.org/3/builtins/constants.html#None)) – Name of dimension[s] along which to apply `cumprod`. For e.g. `dim="x"`
    or `dim=["x", "y"]`. If None, will reduce over the GroupBy dimensions.
    If “…”, will reduce over all dimensions.
  * **skipna** ([`bool`](https://docs.python.org/3/builtins/functions.html#bool) or [`None`](https://docs.python.org/3/builtins/constants.html#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`](https://docs.python.org/3/builtins/functions.html#bool) or [`None`](https://docs.python.org/3/builtins/constants.html#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 `cumprod` on this object’s data.
    These could include dask-specific kwargs like `split_every`.
* **Returns:**
  **reduced** ([`Dataset`](xarray.Dataset.html.md#xarray.Dataset)) – New Dataset with `cumprod` applied to its data and the
  indicated dimension(s) removed

#### SEE ALSO
[`numpy.cumprod`](https://numpy.org/doc/stable/reference/generated/numpy.cumprod.html#numpy.cumprod), [`dask.array.cumprod`](https://docs.dask.org/en/latest/generated/dask.array.cumprod.html#dask.array.cumprod), `Dataset.cumprod`, `Dataset.cumulative`

[GroupBy: Group and Bin Data](../user-guide/groupby.html.md#groupby)
: User guide on groupby operations.

### Notes

Use the `flox` package to significantly speed up groupby computations,
especially with dask arrays. Xarray will use flox by default if installed.
Pass flox-specific keyword arguments in `**kwargs`.
See the [flox documentation](https://flox.readthedocs.io) for more.

Non-numeric variables will be removed prior to reducing. datetime64 and timedelta64 dtypes are treated as numeric for aggregation operations.

Note that the methods on the `cumulative` method are more performant (with numbagg installed)
and better supported. `cumsum` and `cumprod` may be deprecated
in the future.

### Examples

<div class="try_examples_button_container"><button class="try_examples_button" onclick="window.tryExamplesShowIframe('3553496c-6914-4447-84df-6eb3ae9bf4c1','0fa5aeeb-8511-4a78-a61b-dd9b96ee212f','bad66f36-85a4-4d8b-95fb-a05ae0dd9943','../lite/tree/../notebooks/index.html?path=c7ed5049_3400_4459_97d2_cffa7733adf0.ipynb','None')">Try it in your browser!</button></div>
```pycon
>>> 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"])),
...     ),
... )
>>> ds = xr.Dataset(dict(da=da))
>>> ds
<xarray.Dataset> Size: 120B
Dimensions:  (time: 6)
Coordinates:
  * time     (time) datetime64[us] 48B 2001-01-31 2001-02-28 ... 2001-06-30
    labels   (time) <U1 24B 'a' 'b' 'c' 'c' 'b' 'a'
Data variables:
    da       (time) float64 48B 1.0 2.0 3.0 0.0 2.0 nan
```

```pycon
>>> ds.groupby("labels").cumprod()
<xarray.Dataset> Size: 120B
Dimensions:  (time: 6)
Coordinates:
  * time     (time) datetime64[us] 48B 2001-01-31 2001-02-28 ... 2001-06-30
    labels   (time) <U1 24B 'a' 'b' 'c' 'c' 'b' 'a'
Data variables:
    da       (time) float64 48B 1.0 2.0 3.0 0.0 4.0 1.0
```

Use `skipna` to control whether NaNs are ignored.

```pycon
>>> ds.groupby("labels").cumprod(skipna=False)
<xarray.Dataset> Size: 120B
Dimensions:  (time: 6)
Coordinates:
  * time     (time) datetime64[us] 48B 2001-01-31 2001-02-28 ... 2001-06-30
    labels   (time) <U1 24B 'a' 'b' 'c' 'c' 'b' 'a'
Data variables:
    da       (time) float64 48B 1.0 2.0 3.0 0.0 4.0 nan
```

<div id="bad66f36-85a4-4d8b-95fb-a05ae0dd9943" class="try_examples_outer_iframe  hidden"><div class="try_examples_button_container"><button class="try_examples_button" onclick="window.tryExamplesHideIframe('3553496c-6914-4447-84df-6eb3ae9bf4c1','bad66f36-85a4-4d8b-95fb-a05ae0dd9943')">Go Back</button><button class="try_examples_button" onclick="window.openInNewTab('3553496c-6914-4447-84df-6eb3ae9bf4c1','bad66f36-85a4-4d8b-95fb-a05ae0dd9943')">Open In Tab</button></div><div id="0fa5aeeb-8511-4a78-a61b-dd9b96ee212f" class="jupyterlite_sphinx_iframe_container"></div></div><script>document.addEventListener("DOMContentLoaded", function() {window.loadTryExamplesConfig("../try_examples.json");});</script>