# xarray.DataTree.sum

#### DataTree.sum(dim=None, , skipna=None, min_count=None, keep_attrs=None, \*\*kwargs)[[source]](https://github.com/pydata/xarray/blob/main/xarray/core/_aggregations.py#L690-L804)

Reduce this DataTree’s data by applying `sum` 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 `sum`. For e.g. `dim="x"`
    or `dim=["x", "y"]`. If “…” or None, 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).
  * **min_count** ([`int`](https://docs.python.org/3/builtins/functions.html#int) or [`None`](https://docs.python.org/3/builtins/constants.html#None), *optional*) – The required number of valid values to perform the operation. If
    fewer than min_count non-NA values are present the result will be
    NA. Only used if skipna is set to True or defaults to True for the
    array’s dtype. Changed in version 0.17.0: if specified on an integer
    array and skipna=True, the result will be a float array.
  * **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 `sum` on this object’s data.
    These could include dask-specific kwargs like `split_every`.
* **Returns:**
  **reduced** ([`DataTree`](xarray.DataTree.html.md#xarray.DataTree)) – New DataTree with `sum` applied to its data and the
  indicated dimension(s) removed

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

[Aggregation](../user-guide/computation.html.md#agg)
: User guide on reduction or aggregation operations.

### Notes

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

### Examples

<div class="try_examples_button_container"><button class="try_examples_button" onclick="window.tryExamplesShowIframe('26c911c7-08b3-4c5d-96ee-3443d671286f','efffe792-d169-441f-a98d-a3a42cfaf940','ac2554a4-39e0-4050-8333-a42b4121e276','../lite/tree/../notebooks/index.html?path=1dd3f253_7957_4cd2_8a26_a5d81e7b1fdb.ipynb','None')">Try it in your browser!</button></div>
```pycon
>>> dt = xr.DataTree(
...     xr.Dataset(
...         data_vars=dict(foo=("time", np.array([1, 2, 3, 0, 2, np.nan]))),
...         coords=dict(
...             time=(
...                 "time",
...                 pd.date_range("2001-01-01", freq="ME", periods=6),
...             ),
...             labels=("time", np.array(["a", "b", "c", "c", "b", "a"])),
...         ),
...     ),
... )
>>> dt
<xarray.DataTree>
Group: /
    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:
        foo      (time) float64 48B 1.0 2.0 3.0 0.0 2.0 nan
```

```pycon
>>> dt.sum()
<xarray.DataTree>
Group: /
    Dimensions:  ()
    Data variables:
        foo      float64 8B 8.0
```

Use `skipna` to control whether NaNs are ignored.

```pycon
>>> dt.sum(skipna=False)
<xarray.DataTree>
Group: /
    Dimensions:  ()
    Data variables:
        foo      float64 8B nan
```

Specify `min_count` for finer control over when NaNs are ignored.

```pycon
>>> dt.sum(skipna=True, min_count=2)
<xarray.DataTree>
Group: /
    Dimensions:  ()
    Data variables:
        foo      float64 8B 8.0
```

<div id="ac2554a4-39e0-4050-8333-a42b4121e276" class="try_examples_outer_iframe  hidden"><div class="try_examples_button_container"><button class="try_examples_button" onclick="window.tryExamplesHideIframe('26c911c7-08b3-4c5d-96ee-3443d671286f','ac2554a4-39e0-4050-8333-a42b4121e276')">Go Back</button><button class="try_examples_button" onclick="window.openInNewTab('26c911c7-08b3-4c5d-96ee-3443d671286f','ac2554a4-39e0-4050-8333-a42b4121e276')">Open In Tab</button></div><div id="efffe792-d169-441f-a98d-a3a42cfaf940" class="jupyterlite_sphinx_iframe_container"></div></div><script>document.addEventListener("DOMContentLoaded", function() {window.loadTryExamplesConfig("../try_examples.json");});</script>