You are reading documentation for the unreleased version of Matplotlib. Try searching for the released version of this page instead?
Version 3.1.1.post1893+gd8123e656
Fork me on GitHub


matplotlib.pyplot.findobj(o=None, match=None, include_self=True)[source]

Find artist objects.

Recursively find all Artist instances contained in the artist.


A filter criterion for the matches. This can be

  • None: Return all objects contained in artist.
  • A function with signature def match(artist: Artist) -> bool. The result will only contain artists for which the function returns True.
  • A class instance: e.g., Line2D. The result will only contain artists of this class or its subclasses (isinstance check).
include_self : bool

Include self in the list to be checked for a match.

artists : list of Artist