You are reading an old version of the documentation (v3.1.1). For the latest version see
Version 3.1.2
Fork me on GitHub

Table of Contents


Inheritance diagram of matplotlib.axes._axes.Axes, matplotlib.axes._base._AxesBase, matplotlib.axis.Axis, matplotlib.axis.Tick, matplotlib.axis.XAxis, matplotlib.axis.XTick, matplotlib.axis.YAxis, matplotlib.axis.YTick, matplotlib.collections.AsteriskPolygonCollection, matplotlib.collections.BrokenBarHCollection, matplotlib.collections.CircleCollection, matplotlib.collections.Collection, matplotlib.collections.EllipseCollection, matplotlib.collections.EventCollection, matplotlib.collections.LineCollection, matplotlib.collections.PatchCollection, matplotlib.collections.PathCollection, matplotlib.collections.PolyCollection, matplotlib.collections.QuadMesh, matplotlib.collections.RegularPolyCollection, matplotlib.collections.StarPolygonCollection, matplotlib.collections.TriMesh, matplotlib.collections._CollectionWithSizes, matplotlib.contour.ClabelText, matplotlib.figure.Figure, matplotlib.image.AxesImage, matplotlib.image.BboxImage, matplotlib.image.FigureImage, matplotlib.image.NonUniformImage, matplotlib.image.PcolorImage, matplotlib.image._ImageBase, matplotlib.legend.Legend, matplotlib.lines.Line2D, matplotlib.offsetbox.AnchoredOffsetbox, matplotlib.offsetbox.AnchoredText, matplotlib.offsetbox.AnnotationBbox, matplotlib.offsetbox.AuxTransformBox, matplotlib.offsetbox.DrawingArea, matplotlib.offsetbox.HPacker, matplotlib.offsetbox.OffsetBox, matplotlib.offsetbox.OffsetImage, matplotlib.offsetbox.PackerBase, matplotlib.offsetbox.PaddedBox, matplotlib.offsetbox.TextArea, matplotlib.offsetbox.VPacker, matplotlib.patches.Arc, matplotlib.patches.Arrow, matplotlib.patches.Circle, matplotlib.patches.CirclePolygon, matplotlib.patches.ConnectionPatch, matplotlib.patches.Ellipse, matplotlib.patches.FancyArrow, matplotlib.patches.FancyArrowPatch, matplotlib.patches.FancyBboxPatch, matplotlib.patches.Patch, matplotlib.patches.PathPatch, matplotlib.patches.Polygon, matplotlib.patches.Rectangle, matplotlib.patches.RegularPolygon, matplotlib.patches.Shadow, matplotlib.patches.Wedge, matplotlib.patches.YAArrow, matplotlib.projections.geo.AitoffAxes, matplotlib.projections.geo.GeoAxes, matplotlib.projections.geo.HammerAxes, matplotlib.projections.geo.LambertAxes, matplotlib.projections.geo.MollweideAxes, matplotlib.projections.polar.PolarAxes, matplotlib.quiver.Barbs, matplotlib.quiver.Quiver, matplotlib.quiver.QuiverKey, matplotlib.spines.Spine, matplotlib.table.Cell, matplotlib.table.CustomCell, matplotlib.table.Table, matplotlib.text.Annotation, matplotlib.text.Text, matplotlib.text.TextWithDash

Artist class

class matplotlib.artist.Artist[source]

Abstract base class for objects that render into a FigureCanvas.

Typically, all visible elements in a figure are subclasses of Artist.


Artist.add_callback Add a callback function that will be called whenever one of the Artist's properties changes.
Artist.remove_callback Remove a callback based on its observer id.
Artist.pchanged Call all of the registered callbacks.
Artist.get_cursor_data Return the cursor data for a given event.
Artist.format_cursor_data Return a string representation of data.
Artist.contains Test whether the artist contains the mouse event.
Artist.set_contains Define a custom contains test for the artist.
Artist.get_contains Return the custom contains function of the artist if set, or None.
Artist.pick Process a pick event.
Artist.pickable Return whether the artist is pickable.
Artist.set_picker Define the picking behavior of the artist.
Artist.get_picker Return the picking behavior of the artist.


Artist.set_clip_on Set whether the artist uses clipping.
Artist.get_clip_on Return whether the artist uses clipping.
Artist.set_clip_box Set the artist's clip Bbox.
Artist.get_clip_box Return the clipbox.
Artist.set_clip_path Set the artist's clip path, which may be:
Artist.get_clip_path Return the clip path.

Bulk Properties

Artist.update Update this artist's properties from the dictionary props.
Artist.update_from Copy properties from other to self. Return a dictionary of all the properties of the artist.
Artist.set A property batch setter.


Artist.draw Draw the Artist using the given renderer.
Artist.set_animated Set the artist's animation state.
Artist.get_animated Return the animated state.
Artist.set_alpha Set the alpha value used for blending - not supported on all backends.
Artist.get_alpha Return the alpha value used for blending - not supported on all backends
Artist.set_snap Set the snapping behavior.
Artist.get_snap Returns the snap setting.
Artist.set_visible Set the artist's visibility.
Artist.get_visible Return the visibility.
Artist.set_zorder Set the zorder for the artist.
Artist.get_zorder Return the artist's zorder.
Artist.set_agg_filter Set the agg filter.
Artist.set_sketch_params Sets the sketch parameters.
Artist.get_sketch_params Returns the sketch parameters for the artist.
Artist.set_rasterized Force rasterized (bitmap) drawing in vector backend output.
Artist.get_rasterized Return whether the artist is to be rasterized.
Artist.set_path_effects Set the path effects.
Artist.get_agg_filter Return filter function to be used for agg filter.
Artist.get_window_extent Get the axes bounding box in display space.
Artist.get_transformed_clip_path_and_affine Return the clip path with the non-affine part of its transformation applied, and the remaining affine part of its transformation.

Figure and Axes

Artist.remove Remove the artist from the figure if possible.
Artist.axes The Axes instance the artist resides in, or None.
Artist.set_figure Set the Figure instance the artist belongs to.
Artist.get_figure Return the Figure instance the artist belongs to.


Artist.get_children Return a list of the child Artists of this Artist.
Artist.findobj Find artist objects.


Artist.set_transform Set the artist transform.
Artist.get_transform Return the Transform instance used by this artist.
Artist.is_transform_set Return whether the Artist has an explicitly set transform.


Artist.convert_xunits Convert x using the unit type of the xaxis.
Artist.convert_yunits Convert y using the unit type of the yaxis.
Artist.have_units Return True if units are set on the x or y axes.


Artist.set_gid Set the (group) id for the artist.
Artist.get_gid Return the group id.
Artist.set_label Set a label that will be displayed in the legend.
Artist.get_label Return the label used for this artist in the legend.
Artist.set_url Set the url for the artist.
Artist.get_url Return the url.


Artist.sticky_edges x and y sticky edge lists for autoscaling.
Artist.set_in_layout Set if artist is to be included in layout calculations, E.g.
Artist.get_in_layout Return boolean flag, True if artist is included in layout calculations.
Artist.stale Whether the artist is 'stale' and needs to be re-drawn for the output to match the internal state of the artist.


allow_rasterization Decorator for Artist.draw method.
get Return the value of object's property.
getp Return the value of object's property.
setp Set a property on an artist object.
kwdoc Inspect an Artist class (using ArtistInspector) and return information about its settable properties and their current values.
ArtistInspector A helper class to inspect an Artist and return information about its settable properties and their current values.