Skip to content

Commit c192740

Browse files
authored
Merge pull request matplotlib#31423 from timhoffm/doc-lifecycle-interface
DOC: Remove pyplot vs. OO interface discussion from lifecycle example
2 parents ee63e75 + a020675 commit c192740

1 file changed

Lines changed: 0 additions & 29 deletions

File tree

galleries/tutorials/lifecycle.py

Lines changed: 0 additions & 29 deletions
Original file line numberDiff line numberDiff line change
@@ -19,35 +19,6 @@
1919
<https://pbpython.com/effective-matplotlib.html>`_
2020
by Chris Moffitt. It was transformed into this tutorial by Chris Holdgraf.
2121
22-
A note on the explicit vs. implicit interfaces
23-
==============================================
24-
25-
Matplotlib has two interfaces. For an explanation of the trade-offs between the
26-
explicit and implicit interfaces see :ref:`api_interfaces`.
27-
28-
In the explicit object-oriented (OO) interface we directly utilize instances of
29-
:class:`axes.Axes` to build up the visualization in an instance of
30-
:class:`figure.Figure`. In the implicit interface, inspired by and modeled on
31-
MATLAB, we use a global state-based interface which is encapsulated in the
32-
:mod:`.pyplot` module to plot to the "current Axes". See the :ref:`pyplot
33-
tutorials <pyplot_tutorial>` for a more in-depth look at the
34-
pyplot interface.
35-
36-
Most of the terms are straightforward but the main thing to remember
37-
is that:
38-
39-
* The `.Figure` is the final image, and may contain one or more `~.axes.Axes`.
40-
* The `~.axes.Axes` represents an individual plot (not to be confused with
41-
`~.axis.Axis`, which refers to the x-, y-, or z-axis of a plot).
42-
43-
We call methods that do the plotting directly from the Axes, which gives
44-
us much more flexibility and power in customizing our plot.
45-
46-
.. note::
47-
48-
In general, use the explicit interface over the implicit pyplot interface
49-
for plotting.
50-
5122
Our data
5223
========
5324

0 commit comments

Comments
 (0)