bigframes.pandas.Series.hist#

Series.hist(by: Sequence[str] | None = None, bins: int = 10, **kwargs)[source]#

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. This is useful when the DataFrame’s Series are in a similar scale.

Examples:

>>> import bigframes.pandas as bpd
>>> df = bpd.DataFrame(np.random.randint(1, 7, 6000), columns=['one'])
>>> df['two'] = np.random.randint(1, 7, 6000) + np.random.randint(1, 7, 6000)
>>> ax = df.plot.hist(bins=12, alpha=0.5)
Parameters:
  • by (str or sequence, optional) – Column in the DataFrame to group by. It is not supported yet.

  • bins (int, default 10) – Number of histogram bins to be used.

  • **kwargs – Additional keyword arguments are documented in DataFrame.plot().

Returns:

matplotlib.AxesSubplot: A histogram plot.

Return type:

class