You are reading documentation for the unreleased version of Matplotlib. Try searching for the released version of this page instead?
Applications are open for the 2018 John Hunter Matplotlib Summer Fellowship. Apply now!
Version 2.2.2.post1722+g3b337c9d6
Fork me on GitHub

Table Of Contents

Related Topics


For more in-depth information about the colormaps available in matplotlib as well as a description of their properties, see the colormaps tutorial.

Event handling

Matplotlib supports event handling with a GUI neutral event model, so you can connect to Matplotlib events without knowledge of what user interface Matplotlib will ultimately be plugged in to. This has two advantages: the code you write will be more portable, and Matplotlib events are aware of things like data coordinate space and which axes the event occurs in so you don't have to mess with low level transformation details to go from canvas space to data space. Object picking examples are also included.

Our Favorite Recipes

Here is a collection of short tutorials, examples and code snippets that illustrate some of the useful idioms and tricks to make snazzier figures and overcome some matplotlib warts.


These examples cover how different scales are handled in Matplotlib.

Embedding Matplotlib in graphical user interfaces

You can embed Matplotlib directly into a user interface application by following the examples here. Currently matplotlib supports wxpython, pygtk, tkinter and pyqt4/5.

When embedding Matplotlib in a GUI, you must use the Matplotlib API directly rather than the pylab/pyplot proceedural interface, so take a look at the examples/api directory for some example code working with the API.