You are reading documentation for the unreleased version of Matplotlib. Try searching for the released version of this page instead?
Version 3.0.2.post1755+geb5acc4f7
matplotlib
Fork me on GitHub

matplotlib.pyplot.findobj

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

Find artist objects.

Recursively find all Artist instances contained in the artist.

Parameters:
match

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.

Returns:
artists : list of Artist