ENH: Fix support for matplotlib's constrained_layout (#25261)

doc/source/whatsnew/v1.3.0.rst

@@ -330,7 +330,7 @@ Plotting
 ^^^^^^^^
 
 - Bug in :func:`scatter_matrix` raising when 2d ``ax`` argument passed (:issue:`16253`)
--
+- Support matplotlib's ``constrained_layout=True`` (:issue:`25261`)
 -
 
 Groupby/resample/rolling

pandas/plotting/_matplotlib/boxplot.py

@@ -227,7 +227,8 @@ def _grouped_plot_by_column(
 
     byline = by[0] if len(by) == 1 else by
     fig.suptitle(f"Boxplot grouped by {byline}")
-    fig.subplots_adjust(bottom=0.15, top=0.9, left=0.1, right=0.9, wspace=0.2)
+    if not hasattr(fig, "get_constrained_layout") or not fig.get_constrained_layout():
+        fig.subplots_adjust(bottom=0.15, top=0.9, left=0.1, right=0.9, wspace=0.2)
 
     return result
 
@@ -434,7 +435,11 @@ def boxplot_frame_groupby(
             )
             ax.set_title(pprint_thing(key))
             ret.loc[key] = d
-        fig.subplots_adjust(bottom=0.15, top=0.9, left=0.1, right=0.9, wspace=0.2)
+        if (
+            not hasattr(fig, "get_constrained_layout")
+            or not fig.get_constrained_layout()
+        ):
+            fig.subplots_adjust(bottom=0.15, top=0.9, left=0.1, right=0.9, wspace=0.2)
     else:
         keys, frames = zip(*grouped)
         if grouped.axis == 0:

pandas/plotting/_matplotlib/hist.py

@@ -294,9 +294,10 @@ def plot_group(group, ax):
         axes, xlabelsize=xlabelsize, xrot=xrot, ylabelsize=ylabelsize, yrot=yrot
     )
 
-    fig.subplots_adjust(
-        bottom=0.15, top=0.9, left=0.1, right=0.9, hspace=0.5, wspace=0.3
-    )
+    if not hasattr(fig, "get_constrained_layout") or not fig.get_constrained_layout():
+        fig.subplots_adjust(
+            bottom=0.15, top=0.9, left=0.1, right=0.9, hspace=0.5, wspace=0.3
+        )
     return axes
 
 
@@ -454,6 +455,7 @@ def hist_frame(
     set_ticks_props(
         axes, xlabelsize=xlabelsize, xrot=xrot, ylabelsize=ylabelsize, yrot=yrot
     )
-    fig.subplots_adjust(wspace=0.3, hspace=0.3)
+    if not hasattr(fig, "get_constrained_layout") or not fig.get_constrained_layout():
+        fig.subplots_adjust(wspace=0.3, hspace=0.3)
 
     return axes

pandas/plotting/_matplotlib/misc.py

@@ -39,7 +39,8 @@ def scatter_matrix(
     fig, axes = create_subplots(naxes=naxes, figsize=figsize, ax=ax, squeeze=False)
 
     # no gaps between subplots
-    fig.subplots_adjust(wspace=0, hspace=0)
+    if not hasattr(fig, "get_constrained_layout") or not fig.get_constrained_layout():
+        fig.subplots_adjust(wspace=0, hspace=0)
 
     mask = notna(df)
 
@@ -329,7 +330,8 @@ def bootstrap_plot(
     for axis in axes:
         plt.setp(axis.get_xticklabels(), fontsize=8)
         plt.setp(axis.get_yticklabels(), fontsize=8)
-    plt.tight_layout()
+    if not hasattr(fig, "get_constrained_layout") or not fig.get_constrained_layout():
+        plt.tight_layout()
     return fig
 
 

pandas/plotting/_matplotlib/tools.py

@@ -29,7 +29,8 @@ def format_date_labels(ax: "Axes", rot):
         label.set_ha("right")
         label.set_rotation(rot)
     fig = ax.get_figure()
-    fig.subplots_adjust(bottom=0.2)
+    if not hasattr(fig, "get_constrained_layout") or not fig.get_constrained_layout():
+        fig.subplots_adjust(bottom=0.2)
 
 
 def table(