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.post1768+g23420a4c1
Fork me on GitHub

Related Topics

Pythonic MatplotlibΒΆ

Some people prefer to write more pythonic, object-oriented code rather than use the pyplot interface to matplotlib. This example shows you how.

Unless you are an application developer, I recommend using part of the pyplot interface, particularly the figure, close, subplot, axes, and show commands. These hide a lot of complexity from you that you don't need to see in normal figure creation, like instantiating DPI instances, managing the bounding boxes of the figure elements, creating and realizing GUI windows and embedding figures in them.

If you are an application developer and want to embed matplotlib in your application, follow the lead of examples/, examples/ or examples/ In this case you will want to control the creation of all your figures, embedding them in application windows, etc.

If you are a web application developer, you may want to use the example in, which shows how to use the backend agg figure canvas directly, with none of the globals (current figure, current axes) that are present in the pyplot interface. Note that there is no reason why the pyplot interface won't work for web application developers, however.

If you see an example in the examples dir written in pyplot interface, and you want to emulate that using the true python method calls, there is an easy mapping. Many of those examples use 'set' to control figure properties. Here's how to map those commands onto instance methods

The syntax of set is:

plt.setp(object or sequence, somestring, attribute)

if called with an object, set calls:


if called with a sequence, set does:

for object in sequence:

So for your example, if a is your axes object, you can do:

import matplotlib.pyplot as plt
import numpy as np

t = np.arange(0.0, 1.0, 0.01)

fig, (ax1, ax2) = plt.subplots(2)

ax1.plot(t, np.sin(2*np.pi * t))
ax1.set_ylim((-2, 2))
ax1.set_ylabel('1 Hz')
ax1.set_title('A sine wave or two')


ax2.plot(t, np.sin(2 * 2*np.pi * t))
ax2.set_ylim((-2, 2))
l = ax2.set_xlabel('Hi mom')

Keywords: matplotlib code example, codex, python plot, pyplot Gallery generated by Sphinx-Gallery