matplotlib
diff --git a/Collapse file
‎doc/api/next_api_changes/deprecations/15604-AL.rst‎
Copy file name to clipboard
+5Lines changed: 5 additions & 0 deletions
Display the source diff
Display the rich diff b/Collapse file
‎doc/api/next_api_changes/deprecations/15604-AL.rst‎
Copy file name to clipboard
+5Lines changed: 5 additions & 0 deletions
Display the source diff
Display the rich diff
diff --git a/Collapse file
‎lib/matplotlib/axes/_axes.py‎
Copy file name to clipboardExpand all lines: lib/matplotlib/axes/_axes.py
+11-3Lines changed: 11 additions & 3 deletions b/Collapse file
‎lib/matplotlib/axes/_axes.py‎
Copy file name to clipboardExpand all lines: lib/matplotlib/axes/_axes.py
+11-3Lines changed: 11 additions & 3 deletions
@@ -0,0 +1,5 @@
+Auto-removal of grids by `~.Axes.pcolor` and `~.Axes.pcolormesh`
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+`~.Axes.pcolor` and `~.Axes.pcolormesh` currently remove any visible axes major
+grid.  This behavior is deprecated; please explicitly call ``ax.grid(False)``
+to remove the grid.
@@ -5670,6 +5670,15 @@ def _interp_grid(X):
         C = cbook.safe_masked_invalid(C)
         return X, Y, C, shading
 
+    def _pcolor_grid_deprecation_helper(self):
+        if any(axis._major_tick_kw["gridOn"]
+               for axis in self._get_axis_list()):
+            _api.warn_deprecated(
+                "3.5", message="Auto-removal of grids by pcolor() and "
+                "pcolormesh() is deprecated since %(since)s and will be "
+                "removed %(removal)s; please call grid(False) first.")
+        self.grid(False)
+
     @_preprocess_data()
     @docstring.dedent_interpd
     def pcolor(self, *args, shading=None, alpha=None, norm=None, cmap=None,
@@ -5885,7 +5894,7 @@ def pcolor(self, *args, shading=None, alpha=None, norm=None, cmap=None,
         collection.set_cmap(cmap)
         collection.set_norm(norm)
         collection._scale_norm(norm, vmin, vmax)
-        self.grid(False)
+        self._pcolor_grid_deprecation_helper()
 
         x = X.compressed()
         y = Y.compressed()
@@ -6122,8 +6131,7 @@ def pcolormesh(self, *args, alpha=None, norm=None, cmap=None, vmin=None,
         collection.set_cmap(cmap)
         collection.set_norm(norm)
         collection._scale_norm(norm, vmin, vmax)
-
-        self.grid(False)
+        self._pcolor_grid_deprecation_helper()
 
         # Transform from native to data coordinates?
         t = collection._transform