Deprecate count_contains

scottshambaugh · scottshambaugh · commit 2d0127ad7533 · 2026-06-02T11:06:45.000-06:00
diff --git a/doc/api/next_api_changes/deprecations/31803-SS.rst b/doc/api/next_api_changes/deprecations/31803-SS.rst
@@ -0,0 +1,5 @@
+``BboxBase.count_contains`` is deprecated
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+`.BboxBase.count_contains` is deprecated with no replacement. To count how many
+points fall inside a bounding box, test the coordinates directly.
diff --git a/lib/matplotlib/transforms.py b/lib/matplotlib/transforms.py
@@ -581,6 +581,7 @@ def splity(self, *args):
         return [Bbox([[x0, y0 + yf0 * h], [x1, y0 + yf1 * h]])
                 for yf0, yf1 in itertools.pairwise(yf)]
 
+    @_api.deprecated("3.12")
     def count_contains(self, vertices):
         """
         Count the number of vertices contained in the `Bbox`.
