Commit da1551f
committed
DOC: Clarify interface terminology
as proposed in https://github
.com/matplotlib/issues/21817#issuecomment-983705359
and matplotlib#26388
and already used in 26402.
Closes matplotlib#21817.1 parent 69f9ebf commit da1551f
1 file changed
Lines changed: 12 additions & 7 deletions
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
@@ -155,14 +155,19 @@ reliability and consistency in documentation. They are not interchangeable. | |||
| 155 | 155 | | | | rotational | | | |
| 156 | 156 | | | | motion." | | | |
| 157 | 157 | +------------------+--------------------------+--------------+--------------+ | |
| 158 | - | Explicit, | Explicit approach of | - Explicit | - object | | ||
| 159 | - | Object Oriented | programming in | - explicit | oriented | | ||
| 160 | - | Programming (OOP)| Matplotlib. | - OOP | - OO-style | | ||
| 158 | + | Axes interface | Usage pattern in which | - Axes | - explicit | | ||
| 159 | + | | one calls methods on | interface | interface | | ||
| 160 | + | | Axes and Figure (and | - call | - object | | ||
| 161 | + | | sometimes other Artist) | methods on | oriented | | ||
| 162 | + | | objects to configure the | the Axes / | - OO-style | | ||
| 163 | + | | plot. | Figure | - OOP | | ||
| 164 | + | | | object | | | ||
| 161 | 165 | +------------------+--------------------------+--------------+--------------+ | |
| 162 | - | Implicit, | Implicit approach of | - Implicit | - MATLAB like| | ||
| 163 | - | ``pyplot`` | programming in Matplotlib| - implicit | - Pyplot | | ||
| 164 | - | | with ``pyplot`` module. | - ``pyplot`` | - pyplot | | ||
| 165 | - | | | | interface | | ||
| 166 | + | pyplot interface | Usage pattern in which | - ``pyplot`` | - implicit | | ||
| 167 | + | | one only calls `.pyplot` | interface | interface | | ||
| 168 | + | | functions to configure | - call | - MATLAB like| | ||
| 169 | + | | the plot. | ``pyplot`` | - Pyplot | | ||
| 170 | + | | | functions | | | ||
| 166 | 171 | +------------------+--------------------------+--------------+--------------+ | |
| 167 | 172 | ||
| 168 | 173 | .. |Figure| replace:: :class:`~matplotlib.figure.Figure` | |
0 commit comments