# dask.dataframe.DataFrame.memory_usage

#### DataFrame.memory_usage(deep=False, index=True)

Return the memory usage of each column in bytes.

This docstring was copied from pandas.DataFrame.memory_usage.

Some inconsistencies with the Dask version may exist.

The memory usage can optionally include the contribution of
the index and elements of object dtype.

This value is displayed in DataFrame.info by default. This can be
suppressed by setting `pandas.options.display.memory_usage` to False.

* **Parameters:**
  **index**
  : Specifies whether to include the memory usage of the DataFrame’s
    index in returned Series. If `index=True`, the memory usage of
    the index is the first item in the output.

  **deep**
  : If True, introspect the data deeply by interrogating
    object dtypes for system-level memory consumption, and include
    it in the returned values.
* **Returns:**
  Series
  : A Series whose index is the original column names and whose values
    is the memory usage of each column in bytes.

#### SEE ALSO
[`numpy.ndarray.nbytes`](https://numpy.org/doc/stable/reference/generated/numpy.ndarray.nbytes.html#numpy.ndarray.nbytes)
: Total bytes consumed by the elements of an ndarray.

[`Series.memory_usage`](dask.dataframe.Series.memory_usage.html.md#dask.dataframe.Series.memory_usage)
: Bytes consumed by a Series.

`Categorical`
: Memory-efficient array for string values with many repeated values.

[`DataFrame.info`](dask.dataframe.DataFrame.info.html.md#dask.dataframe.DataFrame.info)
: Concise summary of a DataFrame.

### Notes

See the [Frequently Asked Questions](https://pandas.pydata.org/pandas-docs/stable/user_guide/gotchas.html#df-memory-usage) for more
details.

### Examples

```pycon
>>> dtypes = ["int64", "float64", "complex128", "object", "bool"]
>>> data = dict([(t, np.ones(shape=5000, dtype=int).astype(t)) for t in dtypes])
>>> df = pd.DataFrame(data)
>>> df.head()
   int64  float64            complex128  object  bool
0      1      1.0              1.0+0.0j       1  True
1      1      1.0              1.0+0.0j       1  True
2      1      1.0              1.0+0.0j       1  True
3      1      1.0              1.0+0.0j       1  True
4      1      1.0              1.0+0.0j       1  True
```

```pycon
>>> df.memory_usage()
Index           132
int64         40000
float64       40000
complex128    80000
object        40000
bool           5000
dtype: int64
```

```pycon
>>> df.memory_usage(index=False)
int64         40000
float64       40000
complex128    80000
object        40000
bool           5000
dtype: int64
```

The memory footprint of object dtype columns is ignored by default:

```pycon
>>> df.memory_usage(deep=True)
Index            132
int64          40000
float64        40000
complex128     80000
object        180000
bool            5000
dtype: int64
```

Use a Categorical for efficient storage of an object-dtype column with
many repeated values.

```pycon
>>> df["object"].astype("category").memory_usage(deep=True)
5140
```

<!-- !! processed by numpydoc !! -->
