Movatterモバイル変換

[0]ホーム
URL:

Skip to content

Navigation Menu

Sign in
Appearance settings

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

 Sign up
Appearance settings

Commit9134a5c

Browse files
committed
Add InsetIndicator artist
1 parent86f04cb commit9134a5c

File tree

12 files changed

+461
-78
lines changed

12 files changed

+461
-78
lines changed

‎doc/api/index.rst

Lines 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

Lines 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:
Lines 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.
Lines 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

Lines changed: 36 additions & 68 deletions
Original file line numberDiff line numberDiff line change
@@ -16,6 +16,7 @@
1616
importmatplotlib.contourasmcontour
1717
importmatplotlib.dates# noqa: F401, Register date unit converter as side effect.
1818
importmatplotlib.imageasmimage
19+
importmatplotlib.insetasminset
1920
importmatplotlib.legendasmlegend
2021
importmatplotlib.linesasmlines
2122
importmatplotlib.markersasmmarkers
@@ -418,7 +419,7 @@ def inset_axes(self, bounds, *, transform=None, zorder=5, **kwargs):
418419
returninset_ax
419420

420421
@_docstring.dedent_interpd
421-
defindicate_inset(self,bounds,inset_ax=None,*,transform=None,
422+
defindicate_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.
@@ -468,15 +470,19 @@ def indicate_inset(self, bounds, inset_ax=None, *, transform=None,
468470
469471
Returns
470472
-------
471-
rectangle_patch : `.patches.Rectangle`
472-
The indicator frame.
473+
inset_indicator : `.inset.InsetIndicator` artist containing
473474
474-
connector_lines : 4-tuple of `.patches.ConnectionPatch`
475-
The four connector lines connecting to (lower_left, upper_left,
476-
lower_right upper_right) corners of *inset_ax*. Two lines are
477-
set with visibility to *False*, but the user can set the
478-
visibility to True if the automatic choice is not deemed correct.
475+
inset_indicator.rectangle : `.Rectangle`
476+
The indicator frame.
479477
478+
inset_indicator.connectors : 4-tuple of `.patches.ConnectionPatch`
479+
The four connector lines connecting to (lower_left, upper_left,
480+
lower_right upper_right) corners of *inset_ax*. Two lines are
481+
set with visibility to *False*, but the user can set the
482+
visibility to True if the automatic choice is not deemed correct.
483+
484+
.. versionchanged:: 3.10
485+
Previously the rectangle and connectors tuple were returned.
480486
"""
481487
# to make the Axes connectors work, we need to apply the aspect to
482488
# the parent Axes.
@@ -486,51 +492,13 @@ def indicate_inset(self, bounds, inset_ax=None, *, transform=None,
486492
transform=self.transData
487493
kwargs.setdefault('label','_indicate_inset')
488494

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

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

569-
xlim=inset_ax.get_xlim()
570-
ylim=inset_ax.get_ylim()
571-
rect= (xlim[0],ylim[0],xlim[1]-xlim[0],ylim[1]-ylim[0])
572-
returnself.indicate_inset(rect,inset_ax,**kwargs)
540+
returnself.indicate_inset(None,inset_ax,**kwargs)
573541

574542
@_docstring.dedent_interpd
575543
defsecondary_xaxis(self,location,functions=None,*,transform=None,**kwargs):

‎lib/matplotlib/axes/_axes.pyi

Lines changed: 4 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -15,6 +15,7 @@ from matplotlib.colors import Colormap, Normalize
1515
frommatplotlib.containerimportBarContainer,ErrorbarContainer,StemContainer
1616
frommatplotlib.contourimportContourSet,QuadContourSet
1717
frommatplotlib.imageimportAxesImage,PcolorImage
18+
frommatplotlib.insetimportInsetIndicator
1819
frommatplotlib.legendimportLegend
1920
frommatplotlib.legend_handlerimportHandlerBase
2021
frommatplotlib.linesimportLine2D,AxLine
@@ -74,7 +75,7 @@ class Axes(_AxesBase):
7475
)->Axes: ...
7576
defindicate_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-
defindicate_inset_zoom(self,inset_ax:Axes,**kwargs)->Rectangle: ...
87+
)->InsetIndicator: ...
88+
defindicate_inset_zoom(self,inset_ax:Axes,**kwargs)->InsetIndicator: ...
8889
defsecondary_xaxis(
8990
self,
9091
location:Literal["top","bottom"]|float,

0 commit comments

Comments
 (0)
[8]ページ先頭
©2009-2025 Movatter.jp