bigframes.pandas.api.typing.PlotAccessor.hist#

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

Draw one histogram of the DataFrames 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 DataFrames 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