# maxframe.dataframe.DataFrame.plot.hist

#### DataFrame.plot.hist(\*args, \*\*kwargs)

Draw one histogram of the DataFrame’s columns.

A histogram is a representation of the distribution of data.
This function groups the values of all given Series in the DataFrame
into bins and draws all bins in one [`matplotlib.axes.Axes`](https://matplotlib.org/stable/api/_as_gen/matplotlib.axes.Axes.html#matplotlib.axes.Axes).
This is useful when the DataFrame’s Series are in a similar scale.

* **Parameters:**
  * **by** ([*str*](https://docs.python.org/3/library/stdtypes.html#str) *or* *sequence* *,* *optional*) – 

    Column in the DataFrame to group by.

    #### Versionchanged
    Changed in version 1.4.0: Previously, by is silently ignore and makes no groupings
  * **bins** ([*int*](https://docs.python.org/3/library/functions.html#int) *,* *default 10*) – Number of histogram bins to be used.
  * **\*\*kwargs** – Additional keyword arguments are documented in
    [`DataFrame.plot()`](maxframe.dataframe.DataFrame.plot.md#maxframe.dataframe.DataFrame.plot).
* **Returns:**
  **class** – Return a histogram plot.
* **Return type:**
  matplotlib.AxesSubplot

#### SEE ALSO
`DataFrame.hist`
: Draw histograms per DataFrame’s Series.

`Series.hist`
: Draw a histogram with Series’ data.

### Examples

When we roll a die 6000 times, we expect to get each value around 1000
times. But when we roll two dice and sum the result, the distribution
is going to be quite different. A histogram illustrates those
distributions.

A grouped histogram can be generated by providing the parameter by (which
can be a column name, or a list of column names):
