Skip to content

Navigation Menu

Sign in

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly
Appearance settings

Commit cbe1aa1

Browse filesBrowse files
rcomerrcomer
committed
Add InsetIndicator artist
1 parent 109ab93 commit cbe1aa1
Copy full SHA for cbe1aa1

File tree

12 files changed

+461
-78
lines changed
Filter options

12 files changed

+461
-78
lines changed

‎doc/api/index.rst

Copy file name to clipboardExpand all lines: doc/api/index.rst
+1Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -106,6 +106,7 @@ Alphabetical list of modules:
106106
gridspec_api.rst
107107
hatch_api.rst
108108
image_api.rst
109+
inset_api.rst
109110
layout_engine_api.rst
110111
legend_api.rst
111112
legend_handler_api.rst

‎doc/api/inset_api.rst

Copy file name to clipboard
+8Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,8 @@
1+
********************
2+
``matplotlib.inset``
3+
********************
4+
5+
.. automodule:: matplotlib.inset
6+
:members:
7+
:undoc-members:
8+
:show-inheritance:

‎doc/api/next_api_changes/behavior/27996-REC.rst

Copy file name to clipboard
+8Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,8 @@
1+
``InsetIndicator`` artist
2+
~~~~~~~~~~~~~~~~~~~~~~~~~
3+
4+
`~.Axes.indicate_inset` and `~.Axes.indicate_inset_zoom` now return an instance
5+
of `~matplotlib.inset.InsetIndicator`. Use the
6+
`~matplotlib.inset.InsetIndicator.rectangle` and
7+
`~matplotlib.inset.InsetIndicator.connectors` properties of this artist to
8+
access the objects that were previously returned directly.

‎doc/users/next_whats_new/inset_indicator.rst

Copy file name to clipboard
+18Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,18 @@
1+
``InsetIndicator`` artist
2+
~~~~~~~~~~~~~~~~~~~~~~~~~
3+
4+
`~.Axes.indicate_inset` and `~.Axes.indicate_inset_zoom` now return an instance
5+
of `~matplotlib.inset.InsetIndicator` which contains the rectangle and
6+
connector patches. These patches now update automatically so that
7+
8+
.. code-block:: python
9+
10+
ax.indicate_inset_zoom(ax_inset)
11+
ax_inset.set_xlim(new_lim)
12+
13+
gives the same result as
14+
15+
.. code-block:: python
16+
17+
ax_inset.set_xlim(new_lim)
18+
ax.indicate_inset_zoom(ax_inset)

‎lib/matplotlib/axes/_axes.py

Copy file name to clipboardExpand all lines: lib/matplotlib/axes/_axes.py
+36-68Lines changed: 36 additions & 68 deletions
Original file line numberDiff line numberDiff line change
@@ -16,6 +16,7 @@
1616
import matplotlib.contour as mcontour
1717
import matplotlib.dates # noqa: F401, Register date unit converter as side effect.
1818
import matplotlib.image as mimage
19+
import matplotlib.inset as minset
1920
import matplotlib.legend as mlegend
2021
import matplotlib.lines as mlines
2122
import matplotlib.markers as mmarkers
@@ -418,7 +419,7 @@ def inset_axes(self, bounds, *, transform=None, zorder=5, **kwargs):
418419
return inset_ax
419420

420421
@_docstring.dedent_interpd
421-
def indicate_inset(self, bounds, inset_ax=None, *, transform=None,
422+
def indicate_inset(self, bounds=None, inset_ax=None, *, transform=None,
422423
facecolor='none', edgecolor='0.5', alpha=0.5,
423424
zorder=4.99, **kwargs):
424425
"""
@@ -432,11 +433,12 @@ def indicate_inset(self, bounds, inset_ax=None, *, transform=None,
432433
433434
Parameters
434435
----------
435-
bounds : [x0, y0, width, height]
436+
bounds : [x0, y0, width, height], optional
436437
Lower-left corner of rectangle to be marked, and its width
437-
and height.
438+
and height. If not set, the bounds will be calculated from the
439+
data limits of inset_ax, which must be supplied.
438440
439-
inset_ax : `.Axes`
441+
inset_ax : `.Axes`, optional
440442
An optional inset Axes to draw connecting lines to. Two lines are
441443
drawn connecting the indicator box to the inset Axes on corners
442444
chosen so as to not overlap with the indicator box.
@@ -466,15 +468,19 @@ def indicate_inset(self, bounds, inset_ax=None, *, transform=None,
466468
467469
Returns
468470
-------
469-
rectangle_patch : `.patches.Rectangle`
470-
The indicator frame.
471+
inset_indicator : `.inset.InsetIndicator` artist containing
471472
472-
connector_lines : 4-tuple of `.patches.ConnectionPatch`
473-
The four connector lines connecting to (lower_left, upper_left,
474-
lower_right upper_right) corners of *inset_ax*. Two lines are
475-
set with visibility to *False*, but the user can set the
476-
visibility to True if the automatic choice is not deemed correct.
473+
inset_indicator.rectangle : `.Rectangle`
474+
The indicator frame.
477475
476+
inset_indicator.connectors : 4-tuple of `.patches.ConnectionPatch`
477+
The four connector lines connecting to (lower_left, upper_left,
478+
lower_right upper_right) corners of *inset_ax*. Two lines are
479+
set with visibility to *False*, but the user can set the
480+
visibility to True if the automatic choice is not deemed correct.
481+
482+
.. versionchanged:: 3.10
483+
Previously the rectangle and connectors tuple were returned.
478484
"""
479485
# to make the Axes connectors work, we need to apply the aspect to
480486
# the parent Axes.
@@ -484,51 +490,13 @@ def indicate_inset(self, bounds, inset_ax=None, *, transform=None,
484490
transform = self.transData
485491
kwargs.setdefault('label', '_indicate_inset')
486492

487-
x, y, width, height = bounds
488-
rectangle_patch = mpatches.Rectangle(
489-
(x, y), width, height,
493+
indicator_patch = minset.InsetIndicator(
494+
bounds, inset_ax=inset_ax,
490495
facecolor=facecolor, edgecolor=edgecolor, alpha=alpha,
491496
zorder=zorder, transform=transform, **kwargs)
492-
self.add_patch(rectangle_patch)
493-
494-
connects = []
495-
496-
if inset_ax is not None:
497-
# connect the inset_axes to the rectangle
498-
for xy_inset_ax in [(0, 0), (0, 1), (1, 0), (1, 1)]:
499-
# inset_ax positions are in axes coordinates
500-
# The 0, 1 values define the four edges if the inset_ax
501-
# lower_left, upper_left, lower_right upper_right.
502-
ex, ey = xy_inset_ax
503-
if self.xaxis.get_inverted():
504-
ex = 1 - ex
505-
if self.yaxis.get_inverted():
506-
ey = 1 - ey
507-
xy_data = x + ex * width, y + ey * height
508-
p = mpatches.ConnectionPatch(
509-
xyA=xy_inset_ax, coordsA=inset_ax.transAxes,
510-
xyB=xy_data, coordsB=self.transData,
511-
arrowstyle="-", zorder=zorder,
512-
edgecolor=edgecolor, alpha=alpha)
513-
connects.append(p)
514-
self.add_patch(p)
515-
516-
# decide which two of the lines to keep visible....
517-
pos = inset_ax.get_position()
518-
bboxins = pos.transformed(self.figure.transSubfigure)
519-
rectbbox = mtransforms.Bbox.from_bounds(
520-
*bounds
521-
).transformed(transform)
522-
x0 = rectbbox.x0 < bboxins.x0
523-
x1 = rectbbox.x1 < bboxins.x1
524-
y0 = rectbbox.y0 < bboxins.y0
525-
y1 = rectbbox.y1 < bboxins.y1
526-
connects[0].set_visible(x0 ^ y0)
527-
connects[1].set_visible(x0 == y1)
528-
connects[2].set_visible(x1 == y0)
529-
connects[3].set_visible(x1 ^ y1)
530-
531-
return rectangle_patch, tuple(connects) if connects else None
497+
self.add_artist(indicator_patch)
498+
499+
return indicator_patch
532500

533501
def indicate_inset_zoom(self, inset_ax, **kwargs):
534502
"""
@@ -552,22 +520,22 @@ def indicate_inset_zoom(self, inset_ax, **kwargs):
552520
553521
Returns
554522
-------
555-
rectangle_patch : `.patches.Rectangle`
556-
Rectangle artist.
557-
558-
connector_lines : 4-tuple of `.patches.ConnectionPatch`
559-
Each of four connector lines coming from the rectangle drawn on
560-
this axis, in the order lower left, upper left, lower right,
561-
upper right.
562-
Two are set with visibility to *False*, but the user can
563-
set the visibility to *True* if the automatic choice is not deemed
564-
correct.
523+
inset_indicator : `.inset.InsetIndicator` artist containing
524+
525+
inset_indicator.rectangle : `.Rectangle`
526+
The indicator frame.
527+
528+
inset_indicator.connectors : 4-tuple of `.patches.ConnectionPatch`
529+
The four connector lines connecting to (lower_left, upper_left,
530+
lower_right upper_right) corners of *inset_ax*. Two lines are
531+
set with visibility to *False*, but the user can set the
532+
visibility to True if the automatic choice is not deemed correct.
533+
534+
.. versionchanged:: 3.10
535+
Previously the rectangle and connectors tuple were returned.
565536
"""
566537

567-
xlim = inset_ax.get_xlim()
568-
ylim = inset_ax.get_ylim()
569-
rect = (xlim[0], ylim[0], xlim[1] - xlim[0], ylim[1] - ylim[0])
570-
return self.indicate_inset(rect, inset_ax, **kwargs)
538+
return self.indicate_inset(None, inset_ax, **kwargs)
571539

572540
@_docstring.dedent_interpd
573541
def secondary_xaxis(self, location, functions=None, *, transform=None, **kwargs):

‎lib/matplotlib/axes/_axes.pyi

Copy file name to clipboardExpand all lines: lib/matplotlib/axes/_axes.pyi
+4-3Lines changed: 4 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -15,6 +15,7 @@ from matplotlib.colors import Colormap, Normalize
1515
from matplotlib.container import BarContainer, ErrorbarContainer, StemContainer
1616
from matplotlib.contour import ContourSet, QuadContourSet
1717
from matplotlib.image import AxesImage, PcolorImage
18+
from matplotlib.inset import InsetIndicator
1819
from matplotlib.legend import Legend
1920
from matplotlib.legend_handler import HandlerBase
2021
from matplotlib.lines import Line2D, AxLine
@@ -74,7 +75,7 @@ class Axes(_AxesBase):
7475
) -> Axes: ...
7576
def indicate_inset(
7677
self,
77-
bounds: tuple[float, float, float, float],
78+
bounds: tuple[float, float, float, float] | None = ...,
7879
inset_ax: Axes | None = ...,
7980
*,
8081
transform: Transform | None = ...,
@@ -83,8 +84,8 @@ class Axes(_AxesBase):
8384
alpha: float = ...,
8485
zorder: float = ...,
8586
**kwargs
86-
) -> Rectangle: ...
87-
def indicate_inset_zoom(self, inset_ax: Axes, **kwargs) -> Rectangle: ...
87+
) -> InsetIndicator: ...
88+
def indicate_inset_zoom(self, inset_ax: Axes, **kwargs) -> InsetIndicator: ...
8889
def secondary_xaxis(
8990
self,
9091
location: Literal["top", "bottom"] | float,

0 commit comments

Comments
0 (0)
Morty Proxy This is a proxified and sanitized view of the page, visit original site.