1
1
``plt.subplot `` re-selection without keyword arguments
2
2
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
3
3
4
- The purpose of `pyplot.subplot ` is to facilitate creating and
4
+ The purpose of `. pyplot.subplot ` is to facilitate creating and
5
5
re-selecting Axes in a Figure when working in the implicit pyplot API.
6
6
When used to create Axes it is possible to select the projection
7
7
(e.g. polar, 3D, or various cartographic projections) as well as to pass
8
8
additional keyword arguments through to the Axes-subclass that is created.
9
9
10
- The first time `pyplot.subplot ` is called for a given position in the
10
+ The first time `. pyplot.subplot ` is called for a given position in the
11
11
Axes grid it is clear that the correct behavior is to create and
12
12
return an Axes at the given position with the passed arguments
13
13
(defaulting to a rectilinear Axes). However, on subsequent calls to
14
- `pyplot.subplot ` the correct behavior is more subtle. If an Axes exists
14
+ `. pyplot.subplot ` the correct behavior is more subtle. If an Axes exists
15
15
at the requested location and has equivalent parameters the existing Axes
16
16
should be returned, but if the parameters are different the old Axes is removed
17
17
from the Figure and a new Axes is created and returned.
@@ -24,7 +24,7 @@ if the projections were different. Thus ::
24
24
ax1 is plt.subplots(1, 1, 1)
25
25
26
26
We are embracing this long standing behavior and in the case when no keyword
27
- arguments are passed to `pyplot.subplot ` and there is an existing Axes
27
+ arguments are passed to `. pyplot.subplot ` and there is an existing Axes
28
28
at the grid position, the existing Axes is returned without consideration
29
29
of the keywords used to create the Axes.
30
30
@@ -37,7 +37,7 @@ would return the existing Axes. Now this will replace the existing Axes
37
37
with a new rectilinear Axes. To get the previous behavior, do not pass
38
38
*projection *.
39
39
40
- Previously Axes3D could not be re-selected with `pyplot.subplot ` due
40
+ Previously Axes3D could not be re-selected with `. pyplot.subplot ` due
41
41
to an unrelated bug. While Axes3D are now consistent with all other projections
42
42
there is a change in behavior for ::
43
43
0 commit comments