matplotlib
diff --git a/‎doc/api/next_api_changes/deprecations/XXXXX-AL.rst
Lines changed: 9 additions & 0 deletions b/‎doc/api/next_api_changes/deprecations/XXXXX-AL.rst
Lines changed: 9 additions & 0 deletions
diff --git a/‎lib/matplotlib/axes/_base.py
Lines changed: 1 addition & 4 deletions b/‎lib/matplotlib/axes/_base.py
Lines changed: 1 addition & 4 deletions
diff --git a/‎lib/matplotlib/colorbar.py
Lines changed: 5 additions & 5 deletions b/‎lib/matplotlib/colorbar.py
Lines changed: 5 additions & 5 deletions
@@ -0,0 +1,9 @@
+``ContourSet.collections``
+~~~~~~~~~~~~~~~~~~~~~~~~~~
+... is deprecated.  `.ContourSet` is now implemented as a single `.Collection` of paths,
+each path corresponding to a contour level, possibly including multiple unconnected
+components.
+
+During the deprecation period, accessing ``ContourSet.collections`` will revert the
+current ContourSet instance to the old object layout, with a separate `.PathCollection`
+per contour level.
@@ -2179,10 +2179,7 @@ def _sci(self, im):
         _api.check_isinstance(
             (mpl.contour.ContourSet, mcoll.Collection, mimage.AxesImage),
             im=im)
-        if isinstance(im, mpl.contour.ContourSet):
-            if im.collections[0] not in self._children:
-                raise ValueError("ContourSet must be in current Axes")
-        elif im not in self._children:
+        if im not in self._children:
             raise ValueError("Argument must be an image, collection, or "
                              "ContourSet in this Axes")
         self._current_image = im
 
@@ -767,15 +767,15 @@ def add_lines(self, *args, **kwargs):
              lambda self, levels, colors, linewidths, erase=True: locals()],
             self, *args, **kwargs)
         if "CS" in params:
-            self, CS, erase = params.values()
-            if not isinstance(CS, contour.ContourSet) or CS.filled:
+            self, cs, erase = params.values()
+            if not isinstance(cs, contour.ContourSet) or cs.filled:
                 raise ValueError("If a single artist is passed to add_lines, "
                                  "it must be a ContourSet of lines")
             # TODO: Make colorbar lines auto-follow changes in contour lines.
             return self.add_lines(
-                CS.levels,
-                CS.to_rgba(CS.cvalues, CS.alpha),
-                [coll.get_linewidths()[0] for coll in CS.collections],
+                cs.levels,
+                cs.to_rgba(cs.cvalues, cs.alpha),
+                cs.get_linewidths(),
                 erase=erase)
         else:
             self, levels, colors, linewidths, erase = params.values()