Skip to main content
`Ctrl`+`K`

# pandas.api.typing.DataFrameGroupBy.boxplot

DataFrameGroupBy.boxplot(subplots=True, column=None, fontsize=None, rot=0, grid=True, ax=None, figsize=None, layout=None, sharex=False, sharey=True, backend=None, **kwargs)

  Make box plots from DataFrameGroupBy data.

  Creates one or more box-and-whisker plots based on data that has been grouped using `DataFrame.groupby()`. Each group can be rendered as a separate subplot or combined into a single figure.

  Parameters:
    grouped DataFrameGroupBy

      The grouped DataFrame object over which to create the box plots.

    subplots bool

      - `False` - no subplots will be used

      - `True` - create a subplot for each group.

    column column name or list of names, or vector

      Can be any valid input to groupby.

    fontsize float or str

      Font size for the labels.

    rot float

      Rotation angle of labels (in degrees) on the x-axis.

    grid bool

      Whether to show grid lines on the plot.

    ax Matplotlib axis object, default None

      The axes on which to draw the plots. If None, uses the current axes.

    figsize tuple of (float, float)

      The figure size in inches (width, height).

    layout tuple (optional)

      The layout of the plot: (rows, columns).

    sharex bool, default False

      Whether x-axes will be shared among subplots.

    sharey bool, default True

      Whether y-axes will be shared among subplots.

    backend str, default None

      Backend to use instead of the backend specified in the option `plotting.backend`. For instance, ‘matplotlib’. Alternatively, to specify the `plotting.backend` for the whole session, set `pd.options.plotting.backend`.

    **kwargs

      All other plotting keyword arguments to be passed to matplotlib’s boxplot function.

  Returns:
    dict or DataFrame.boxplot return value

      If `subplots=True`, returns a dictionary of group keys to the boxplot return values. If `subplots=False`, returns the boxplot return value of a single DataFrame.

  See also

  `DataFrame.boxplot`

    Create a box plot from a DataFrame.

  `Series.plot`

    Plot a Series.

  Examples

  You can create boxplots for grouped data and show them as separate subplots:

      >>> import itertools
      >>> tuples = [t for t in itertools.product(range(1000), range(4))]
      >>> index = pd.MultiIndex.from_tuples(tuples, names=["lvl0", "lvl1"])
      >>> data = np.random.randn(len(index), 4)
      >>> df = pd.DataFrame(data, columns=list("ABCD"), index=index)
      >>> grouped = df.groupby(level="lvl1")
      >>> grouped.boxplot(rot=45, fontsize=12, figsize=(8, 10))

  The `subplots=False` option shows the boxplots in a single figure.

      >>> grouped.boxplot(subplots=False, rot=45, fontsize=12)