Method add_collection

lib/matplotlib/axes/_base.py:2378–2431

Add a `.Collection` to the Axes; return the collection. Parameters ---------- collection : `.Collection` The collection to add. autolim : bool Whether to update data and view limits. If *False*, the collection does not ta

(self, collection, autolim=True)

        return ax

    def add_collection(self, collection, autolim=True):
        """
        Add a `.Collection` to the Axes; return the collection.

        Parameters
        ----------
        collection : `.Collection`
            The collection to add.
        autolim : bool
            Whether to update data and view limits.

            If *False*, the collection does not take part in any limit
            operations.

            .. versionchanged:: 3.11

               Since 3.11 ``autolim=True`` matches the standard behavior
               of other ``add_[artist]`` methods: Axes data and view limits
               are both updated in the method, and the collection will
               be considered in future data limit updates through
               `.relim`.

               Prior to matplotlib 3.11 this was only a one-time update
               of the data limits. Updating view limits required an
               explicit call to `~.Axes.autoscale_view`, and collections
               did not take part in `.relim`.

            As an implementation detail, the value "_datalim_only" is
            supported to smooth the internal transition from pre-3.11
            behavior. This is not a public interface and will be removed
            again in the future.
        """
        _api.check_isinstance(mcoll.Collection, collection=collection)
        if not collection.get_label():
            collection.set_label(f'_child{len(self._children)}')
        self._children.append(collection)
        collection._remove_method = self._children.remove
        self._set_artist_props(collection)

        if collection.get_clip_path() is None:
            collection.set_clip_path(self.patch)

        if autolim:
            if autolim != "_datalim_only":
                collection._set_in_autoscale(True)
            # Make sure viewLim is not stale (mostly to match
            # pre-lazy-autoscale behavior, which is not really better).
            self._unstale_viewLim()
            self._update_collection_limits(collection)
            if autolim != "_datalim_only":
                self._request_autoscale_view()

        self.stale = True
        return collection

    def add_image(self, image):
        """