matplotlib.widgets

GUI 중립 위젯

모든 GUI 백엔드에서 작동하도록 설계된 위젯입니다. 이러한 모든 위젯은 matplotlib.axes.Axes 인스턴스를 사전 정의하고 첫 번째 매개변수로 전달해야 합니다. Matplotlib는 레이아웃과 관련하여 너무 똑똑해지려고 하지 않습니다. 위젯을 수용하기 위해 축의 너비와 높이를 파악해야 합니다.

클래스 matplotlib.widgets. AxesWidget ( ax )

베이스:Widget

하나의 Axes.

위젯이 가비지 수집되지 않고 응답성을 유지하도록 보장하려면 객체에 대한 참조가 사용자에 의해 유지되어야 합니다.

이는 콜백 레지스트리가 위젯의 멤버 함수인 함수에 대한 약한 참조만 유지하기 때문에 필요합니다. 위젯 개체에 대한 참조가 없으면 가비지 수집되어 콜백 연결이 끊어질 수 있습니다.

속성 :

도끼Axes

위젯의 상위 Axes입니다.

캔버스FigureCanvasBase

위젯의 상위 그림 캔버스입니다.

active부울

위젯이 활성화되어 있습니까?

connect_event ( 이벤트 , 콜백 )

콜백 함수를 이벤트와 연결합니다.

figure.canvas.mpl_connect이 함수는 나중에 정리할 수 있도록 콜백 ID를 저장하므로 대신 사용해야 합니다.

disconnect_events ( )

이 위젯에서 생성한 모든 이벤트를 연결 해제합니다.

클래스 matplotlib.widgets. 버튼 ( ax , label , image = None , color = '0.85' , hovercolor = '0.95' )

베이스:AxesWidget

GUI 중립 버튼.

버튼이 계속 반응하려면 버튼에 대한 참조를 유지해야 합니다. on_clicked버튼에 연결하기 위해 전화 하십시오.

속성 :

도끼

버튼 이 matplotlib.axes.Axes렌더링됩니다.

상표

matplotlib.text.Text인스턴스 .

색깔

호버링하지 않을 때의 버튼 색상입니다.

호버 컬러

호버링 시 버튼의 색상.

매개변수 :

도끼Axes

버튼 이 Axes배치될 인스턴스입니다.

레이블 문자열

버튼 텍스트.

이미지 배열 유사 또는 PIL 이미지

None 이 아닌 경우 버튼에 배치할 이미지 입니다. 매개변수는 에 직접 전달됩니다 imshow.

색상 색상

활성화되지 않은 버튼의 색상입니다.

호버 컬러 색상

마우스가 버튼 위에 있을 때 버튼의 색상입니다.

연결 끊기 ( cid )

연결 ID가 cid 인 콜백 함수를 제거하십시오 .

on_clicked ( func )

콜백 함수 func 를 버튼 클릭 이벤트에 연결합니다.

콜백 연결을 끊는 데 사용할 수 있는 연결 ID를 반환합니다.

클래스 matplotlib.widgets. CheckButtons ( ax , labels , actives = None )

베이스:AxesWidget

GUI 중립적인 체크 버튼 세트.

확인 단추가 계속 응답하려면 이 개체에 대한 참조를 유지해야 합니다.

메서드 를 사용하여 CheckButtons에 연결합니다 on_clicked.

속성 :

도끼Axes

위젯의 상위 Axes입니다.

라벨 목록Text

직사각형 목록Rectangle

( , ) 쌍 의 라인 목록Line2DLine2D

확인란의 x에 대한 줄 목록입니다. 이 라인은 각 상자에 대해 존재하지만 set_visible(False)해당 상자가 선택되지 않은 경우가 있습니다.

matplotlib.axes.Axes인스턴스 ax 에 확인 버튼을 추가합니다 .

매개변수 :

도끼Axes

위젯의 상위 Axes입니다.

str의 레이블 목록

확인 버튼의 레이블입니다.

bool의 활성 목록, 선택 사항

버튼의 초기 확인 상태. 목록은 labels 와 길이가 같아야 합니다 . 지정하지 않으면 모든 버튼이 선택 해제됩니다.

연결 끊기 ( cid )

연결 ID가 cid 인 관찰자를 제거합니다 .

get_status ( )

모든 확인 버튼의 상태(True/False) 튜플을 반환합니다.

on_clicked ( func )

콜백 함수 func 를 버튼 클릭 이벤트에 연결합니다.

콜백 연결을 끊는 데 사용할 수 있는 연결 ID를 반환합니다.

set_active ( 인덱스 )

색인으로 체크 버튼을 토글(활성화 또는 비활성화)합니다.

eventson가 True 인 경우 콜백이 트리거됩니다 .

매개변수 :

인덱스 정수

전환할 확인 버튼의 인덱스입니다.

레이즈 :

값 오류

인덱스 가 유효하지 않은 경우 .

클래스 matplotlib.widgets. 커서 ( ax , horizOn = True , vertOn = True , useblit = False , ** lineprops )

베이스:AxesWidget

Axes에 걸쳐 있고 마우스 커서와 함께 이동하는 십자형 커서입니다.

커서가 계속 응답하려면 커서에 대한 참조를 유지해야 합니다.

매개변수 :

도끼matplotlib.axes.Axes

Axes커서를 연결할 입니다 .

horizOn 부울, 기본값: True

수평선을 그릴지 여부입니다.

vertOn 부울, 기본값: True

세로선을 그릴지 여부입니다.

useblit 부울, 기본값: 거짓

백엔드에서 지원하는 경우 빠른 그리기를 위해 블리팅을 사용하십시오. 자세한 내용은 블리팅을 사용하여 더 빠른 렌더링 튜토리얼 을 참조하세요.

기타 매개변수 :

**lineprops

Line2D선의 모양을 제어하는 ​​속성입니다. 또한 참조하십시오 axhline.

예

커서 를 참조하십시오 .

지우기 ( 이벤트 )

커서를 지우는 내부 이벤트 핸들러.

onmove ( 이벤트 )

마우스가 움직일 때 커서를 그리는 내부 이벤트 처리기.

클래스 matplotlib.widgets. EllipseSelector ( ax , onselect , drawtype=<사용되지 않는 매개변수> , minspanx=0 , minspany=0 , useblit=False , lineprops=<사용되지 않는 매개변수> , props=None , spancoords='data' , button=None , grab_range=10 , handle_props=없음 , interactive=False , state_modifier_keys=없음 , drag_from_anywhere=False , ignore_event_outside=False ,use_data_coordinates=False )

베이스:RectangleSelector

축의 타원형 영역을 선택합니다.

커서가 계속 응답하려면 커서에 대한 참조를 유지해야 합니다.

선택 외부의 동일한 좌표에서 트리거된 눌렀다 떼는 이벤트는 다음 경우를 제외하고 선택기를 지웁니다 ignore_event_outside=True.

매개변수 :

도끼Axes

위젯의 상위 축입니다.

선택 함수

릴리스 이벤트 및 선택이 생성, 변경 또는 제거된 후에 호출되는 콜백 함수입니다. 서명이 있어야 합니다.

def onselect(eclick: MouseEvent, erelease: MouseEvent)

여기서 eclick 및 ereleaseMouseEvent 는 선택을 시작하고 완료하는 마우스 클릭 및 릴리스 입니다.

minspanx float, 기본값: 0

x-span이 minspanx 보다 작거나 같은 선택 은 제거되거나(이미 존재하는 경우) 취소됩니다.

minspany float, 기본값: 0

y 범위가 minspanx 보다 작거나 같은 선택 은 제거되거나(이미 존재하는 경우) 취소됩니다.

useblit 부울, 기본값: 거짓

더 빠른 그리기를 위해 블리팅을 사용할지 여부(백엔드에서 지원하는 경우). 자세한 내용은 블리팅을 사용하여 더 빠른 렌더링 튜토리얼 을 참조하세요.

소품 사전, 선택 사항

타원이 그려지는 속성입니다. matplotlib.patches.Patch유효한 속성은 를 참조하십시오 . 기본:

dict(facecolor='red', edgecolor='black', alpha=0.2, fill=True)

spancoords {"데이터", "픽셀"}, 기본값: "데이터"

데이터 또는 픽셀 좌표에서 minspanx 및 minspany 를 해석할지 여부 입니다.

버튼 MouseButton, 목록 MouseButton, 기본값: 모든 버튼

사각형 선택을 트리거하는 버튼.

grab_range float, 기본값: 10

대화형 도구 핸들을 활성화할 수 있는 거리(픽셀)입니다.

handle_props 사전, 선택사항

대화형 핸들(마커 아티스트)이 그려지는 속성입니다. matplotlib.lines.Line2D유효한 속성 은 마커 인수를 참조하십시오 . 기본값 은 props 의 속성 과 동일한 mpl.rcParams기본값을 제외하고 에 정의됩니다 .markeredgecoloredgecolor

대화식 부울, 기본값: False

위젯이 그려진 후 위젯과의 상호 작용을 허용하는 핸들 집합을 그릴지 여부입니다.

state_modifier_keys 사전, 선택사항

위젯의 동작에 영향을 미치는 키보드 수정자. 값은 다음과 같은 기본값을 수정합니다.

• "이동": 기존 모양을 이동합니다. 기본값: 수정자 없음.

• "clear": 현재 모양을 지웁니다. 기본값은 "escape"입니다.

• "square": 모양을 사각형으로 만듭니다. 기본값은 "shift"입니다.

• "center": 중심 주위의 모양을 변경합니다. 기본값은 "ctrl"입니다.

• "rotate": -45°와 45° 사이에서 중심을 중심으로 도형을 회전합니다. 기본값은 "r"입니다.

"정사각형"과 "중심"을 결합할 수 있습니다. use_data_coordinates사각형 모양은 선택기를 만들 때 지정된 인수 에 따라 결정되는 데이터 또는 디스플레이 좌표에서 정의할 수 있습니다 .

drag_from_anywhere 부울, 기본값: 거짓

이면 True위젯은 범위 내의 아무 곳이나 클릭하여 이동할 수 있습니다.

ignore_event_outside 부울, 기본값: False

인 경우 True범위 선택기 외부에서 트리거된 이벤트는 무시됩니다.

use_data_coordinates 부울, 기본값: False

이면 True선택기의 "정사각형" 모양이 디스플레이 좌표 대신 데이터 좌표에 정의됩니다.

예

직사각형 및 타원 선택기

속성 draw_shape

클래스 matplotlib.widgets. 올가미 ( ax , xy , 콜백 = 없음 , useblit = True )

베이스:AxesWidget

임의의 모양의 선택 곡선.

contains_point선택한 경로 는 이미지에서 데이터 포인트를 선택하기 위해 와 함께 사용할 수 있습니다 .

와 달리 LassoSelector시작점 xy 로 초기화해야 Lasso하며 해제 시 이벤트가 소멸됩니다.

매개변수 :

도끼Axes

위젯의 상위 Axes입니다.

xy (플로트, 플로트)

올가미 시작 좌표입니다.

useblit 부울, 기본값: 참

더 빠른 그리기를 위해 블리팅을 사용할지 여부(백엔드에서 지원하는 경우). 자세한 내용은 블리팅을 사용하여 더 빠른 렌더링 튜토리얼 을 참조하세요.

콜백 콜러블

올가미가 해제될 때마다 콜백 함수가 호출되어 선택한 경로의 정점을 전달합니다.

onmove ( 이벤트 )

onrelease ( 이벤트 )

클래스 matplotlib.widgets. LassoSelector ( ax , onselect = None , useblit = True , props = None , button = None )

베이스:_SelectorWidget

임의의 모양의 선택 곡선.

선택기가 계속 응답하려면 이에 대한 참조를 유지해야 합니다.

contains_point 선택한 경로 는 이미지에서 데이터 포인트를 선택하기 위해 와 함께 사용할 수 있습니다 .

와 달리 는 및 와 유사한 인터페이스로 작성되며 Lasso연결 이 끊어질 때까지 Axes와 계속 상호 작용합니다.LassoSelectorRectangleSelectorSpanSelector

사용 예:

ax = plt.subplot()
ax.plot(x, y)

def onselect(verts):
    print(verts)
lasso = LassoSelector(ax, onselect)

매개변수 :

도끼Axes

위젯의 상위 Axes입니다.

선택 함수

올가미가 해제될 때마다 onselect 함수가 호출되어 선택한 경로의 정점을 전달합니다.

useblit 부울, 기본값: 참

더 빠른 그리기를 위해 블리팅을 사용할지 여부(백엔드에서 지원하는 경우). 자세한 내용은 블리팅을 사용하여 더 빠른 렌더링 튜토리얼 을 참조하세요.

소품 사전, 선택 사항

선이 그려지는 matplotlib.lines.Line2D 속성은 유효한 속성을 참조하십시오. 기본값은 에 정의되어 mpl.rcParams있습니다.

버튼 MouseButton또는 목록 MouseButton, 선택 사항

사각형 선택에 사용되는 마우스 버튼입니다. 기본값은 None모든 버튼에 해당하는 입니다.

onpress ( 이벤트 )

[ 더 이상 사용되지 않음 ]

메모

버전 3.5부터 사용되지 않음: 대신 press를 사용하십시오.

onrelease ( 이벤트 )

[ 더 이상 사용되지 않음 ]

메모

버전 3.5부터 사용되지 않음: 대신 릴리스를 사용하십시오.

클래스 matplotlib.widgets. 락드로우

베이스:object

커서와 같은 일부 위젯은 캔버스에 그립니다. 이는 도구 모음이 확대/축소 모드에 있고 사각형을 그리는 경우와 같은 모든 상황에서 바람직하지 않습니다. 이를 방지하기 위해 위젯은 캔버스 canvas.widgetlock(widget)에 그리기 전에 캔버스의 잠금을 획득할 수 있습니다. 이렇게 하면 다른 위젯이 동시에 그렇게 하는 것을 방지할 수 있습니다(또한 먼저 잠금을 획득하려고 시도하는 경우).

사용 가능 ( o )

o 가 드로잉을 사용할 수 있는지 여부를 반환합니다 .

isowner ( o )

o 가 이 잠금을 소유 하는지 여부를 반환합니다 .

잠김 ( )

소유자가 현재 잠금을 보유하고 있는지 여부를 반환합니다.

릴리스 ( o )

o 에서 잠금을 해제합니다 .

클래스 matplotlib.widgets. MultiCursor ( 캔버스 , 축 , * , useblit = True , horizOn = False , vertOn = True , ** lineprops )

베이스:Widget

여러 축 간에 공유되는 세로(기본값) 및/또는 가로선 커서를 제공합니다.

커서가 계속 응답하려면 커서에 대한 참조를 유지해야 합니다.

매개변수 :

캔버스 개체

이 매개변수는 완전히 사용되지 않으며 이전 버전과의 호환성을 위해서만 유지됩니다.

축 목록matplotlib.axes.Axes

Axes커서를 연결할 입니다 .

useblit 부울, 기본값: 참

백엔드에서 지원하는 경우 빠른 그리기를 위해 블리팅을 사용하십시오. 자세한 내용은 블리팅을 사용하여 더 빠른 렌더링 튜토리얼 을 참조하세요.

horizOn 부울, 기본값: False

수평선을 그릴지 여부입니다.

vertOn 부울, 기본값: True

세로선을 그릴지 여부입니다.

기타 매개변수 :

**lineprops

Line2D선의 모양을 제어하는 ​​속성입니다. 또한 참조하십시오 axhline.

예

다중 커서 를 참조 하십시오 .

배경 ( )

[ 더 이상 사용되지 않음 ]

메모

버전 3.6부터 사용되지 않음:

속성 캔버스

지우기 ( 이벤트 )

커서를 지웁니다.

연결 ( )

이벤트를 연결합니다.

연결 끊기 ( )

이벤트 연결을 끊습니다.

onmove ( 이벤트 )

클래스 matplotlib.widgets. PolygonSelector ( ax , onselect , useblit = False , props = None , handle_props = None , grab_range = 10 , * , draw_bounding_box = False , box_handle_props = None , box_props = None )

베이스:_SelectorWidget

축의 폴리곤 영역을 선택합니다.

마우스를 클릭할 때마다 정점을 배치하고 다각형을 완성하여 선택합니다(첫 번째 정점 클릭). 그려진 개별 정점은 마우스 왼쪽 버튼으로 클릭하고 드래그하여 이동하거나 마우스 오른쪽 버튼을 클릭하여 제거할 수 있습니다.

또한 다음 수정자 키를 사용할 수 있습니다.

• 다각형 이 완성되기 전에 ctrl 을 누른 상태에서 정점을 클릭하고 드래그하여 위치를 변경합니다.

• Shift 키를 누른 상태에서 축의 아무 곳이나 클릭하고 드래그하여 모든 정점을 이동합니다.

• esc 키를 눌러 새 다각형을 시작합니다.

선택기가 계속 응답하려면 이에 대한 참조를 유지해야 합니다.

매개변수 :

도끼Axes

위젯의 상위 Axes입니다.

선택 함수

폴리곤이 완료되거나 완료 후 수정되면 onselect 함수가 호출되어 정점 목록을 튜플로 전달합니다.(xdata, ydata)

useblit 부울, 기본값: 거짓

더 빠른 그리기를 위해 블리팅을 사용할지 여부(백엔드에서 지원하는 경우). 자세한 내용은 블리팅을 사용하여 더 빠른 렌더링 튜토리얼 을 참조하세요.

소품 사전, 선택 사항

선이 그려지는 matplotlib.lines.Line2D 속성은 유효한 속성을 참조하십시오. 기본:

dict(color='k', linestyle='-', linewidth=2, alpha=0.5)

handle_props 사전, 선택사항

다각형의 정점에 그려진 마커의 아티스트 속성입니다. matplotlib.lines.Line2D유효한 속성 은 마커 인수를 참조하십시오 . 기본값 은 props 의 속성 과 동일한 mpl.rcParams기본값을 제외하고 에 정의됩니다 .markeredgecolorcolor

grab_range float, 기본값: 10

마우스 클릭이 정점의 grab_range 픽셀 내에 있으면 정점이 선택됩니다(다각형을 완성하거나 정점을 이동하기 위해) .

draw_bounding_box 부울, 선택 사항

인 경우 True완료되면 다각형 선택기 주위에 경계 상자가 그려집니다. 이 상자를 사용하여 선택기를 이동하고 크기를 조정할 수 있습니다.

box_handle_props 사전, 선택 사항

상자 핸들에 대해 설정할 속성입니다. 자세한 내용은 handle_props 인수에 RectangleSelector대한 설명서를 참조하십시오.

box_props 사전, 선택 사항

상자에 대해 설정할 속성입니다. 자세한 내용은 props 인수에 RectangleSelector대한 설명서를 참조하십시오.

메모

포인트를 제거한 후 포인트가 하나만 남아 있으면 선택기가 불완전한 상태로 돌아가고 기존 포인트에서 새 다각형 그리기를 시작할 수 있습니다.

예

다각형 선택기 다각형 선택기를 사용하여 컬렉션에서 인덱스 선택

대지 경계선

onmove ( 이벤트 )

커서 이동 이벤트 처리기 및 유효성 검사기.

속성 vertex_select_radius

속성 vert

쌍 의 목록인 다각형 정점 .(x, y)

클래스 matplotlib.widgets. RadioButtons ( ax , labels , 활성 = 0 , 활성 색상 = '파란색' )

베이스:AxesWidget

GUI 중립 라디오 버튼.

버튼이 계속 반응하려면 이 개체에 대한 참조를 유지해야 합니다.

메서드 를 사용하여 RadioButton에 연결합니다 on_clicked.

속성 :

도끼Axes

위젯의 상위 Axes입니다.

활성 색상

선택한 버튼의 색상입니다.

라벨 목록Text

버튼 레이블.

서클 목록Circle

버튼.

value_selected 문자열

현재 선택된 버튼의 라벨 텍스트.

에 라디오 버튼을 추가합니다 Axes.

매개변수 :

도끼Axes

버튼을 추가할 Axes입니다.

str의 레이블 목록

버튼 레이블.

활성 정수

처음 선택된 버튼의 인덱스.

활성 색상

선택한 버튼의 색상입니다.

연결 끊기 ( cid )

연결 ID가 cid 인 관찰자를 제거합니다 .

on_clicked ( func )

콜백 함수 func 를 버튼 클릭 이벤트에 연결합니다.

콜백 연결을 끊는 데 사용할 수 있는 연결 ID를 반환합니다.

set_active ( 인덱스 )

숫자 색인 이 있는 버튼을 선택합니다 .

eventson가 True 인 경우 콜백이 트리거됩니다 .

클래스 matplotlib.widgets. RangeSlider ( ax , label , valmin , valmax , valinit = None , valfmt = None , closedmin = True , closedmax = True , dragging = True , valstep = None , orientation = 'horizontal' , track_color = 'lightgrey' , handle_style = None , **kwargs )

베이스:SliderBase

부동 소수점 값 범위를 나타내는 슬라이더입니다. val 속성을 통해 범위의 최소값과 최대 값 을 (min, max)의 튜플로 정의합니다.

Axes ax 의 [ valmin , valmax ] 내에 포함된 범위를 정의하는 슬라이더를 만듭니다 . 슬라이더가 계속 반응하려면 그에 대한 참조를 유지해야 합니다. 슬라이더 이벤트에 연결하기 위해 호출 합니다.on_changed()

속성 :

float의 val 튜플

슬라이더 값.

매개변수 :

도끼 _

슬라이더를 넣을 축입니다.

레이블 문자열

슬라이더 라벨.

발민 플로트

슬라이더의 최소값입니다.

발맥스 플로트

슬라이더의 최대값입니다.

float 또는 None의 valinit 튜플, 기본값: 없음

슬라이더의 초기 위치입니다. 없음인 경우 초기 위치는 범위의 25번째 및 75번째 백분위수에 있습니다.

valfmt 문자열 , 기본값: 없음

슬라이더 값의 형식을 지정하는 데 사용되는 % 형식 문자열입니다. None이면 a ScalarFormatter가 대신 사용됩니다.

closedmin 부울, 기본값: 참

슬라이더 간격이 하단에서 닫혀 있는지 여부입니다.

closedmax 부울, 기본값: True

슬라이더 간격이 상단에서 닫히는지 여부입니다.

드래그 부울, 기본값: True

참이면 슬라이더를 마우스로 끌 수 있습니다.

발스텝 플로트, 기본값: 없음

주어진 경우 슬라이더는 valstep 의 배수로 스냅됩니다 .

방향 {'수평', '수직'}, 기본값: '수평'

슬라이더의 방향입니다.

track_color 색상, 기본값: 'lightgrey'

배경 트랙의 색상입니다. track 속성 을 통해 추가 스타일 지정을 위해 트랙에 액세스할 수 있습니다 .

handle_style 사전

슬라이더 핸들의 속성입니다. 기본값은

열쇠	값	기본	설명
얼굴색	색깔	'하얀'	슬라이더 핸들의 페이스 컬러.
엣지컬러	색깔	'.75'	슬라이더 핸들의 가장자리 색상입니다.
크기	정수	10	슬라이더 핸들의 크기(포인트)입니다.

다른 값은 marker{foo}로 변환되어 Line2D생성자에게 전달됩니다. 예 를 들어 .handle_style = {'style'='x'}markerstyle = 'x'

메모

슬라이더 노브를 그리는 self.poly에 추가 kwargs가 전달됩니다 . 유효한 속성 이름( , , 등) 은 설명서를 Polygon참조하십시오 .Polygonfacecoloredgecoloralpha

on_changed ( func )

func 를 콜백 함수로 슬라이더 값의 변경에 연결 합니다.

매개변수 :

함수 호출 가능

슬라이더가 변경될 때 호출하는 함수입니다. 이 함수는 모양이 (2,)인 numpy 배열을 인수로 받아들여야 합니다.

반환 :

정수

연결 ID( func 를 연결 해제하는 데 사용할 수 있음 ).

set_max ( 최대 )

슬라이더의 낮은 값을 max 로 설정합니다 .

매개변수 :

최대 플로트

set_min ( 분 )

슬라이더의 낮은 값을 min 으로 설정합니다 .

매개변수 :

최소 플로트

set_val ( val )

슬라이더 값을 val 로 설정 합니다.

매개변수 :

val 튜플 또는 배열과 유사한 float

클래스 matplotlib.widgets. RectangleSelector ( ax , onselect , drawtype=<사용되지 않는 매개변수> , minspanx=0 , minspany=0 , useblit=False , lineprops=<사용되지 않는 매개변수> , props=None , spancoords='data' , button=None , grab_range=10 , handle_props=없음 , interactive=False , state_modifier_keys=없음 , drag_from_anywhere=False , ignore_event_outside=False ,use_data_coordinates=False )

베이스:_SelectorWidget

축의 직사각형 영역을 선택합니다.

커서가 계속 응답하려면 커서에 대한 참조를 유지해야 합니다.

선택 외부의 동일한 좌표에서 트리거된 눌렀다 떼는 이벤트는 다음 경우를 제외하고 선택기를 지웁니다 ignore_event_outside=True.

매개변수 :

도끼Axes

위젯의 상위 축입니다.

선택 함수

릴리스 이벤트 및 선택이 생성, 변경 또는 제거된 후에 호출되는 콜백 함수입니다. 서명이 있어야 합니다.

def onselect(eclick: MouseEvent, erelease: MouseEvent)

여기서 eclick 및 ereleaseMouseEvent 는 선택을 시작하고 완료하는 마우스 클릭 및 릴리스 입니다.

minspanx float, 기본값: 0

x-span이 minspanx 보다 작거나 같은 선택 은 제거되거나(이미 존재하는 경우) 취소됩니다.

minspany float, 기본값: 0

y 범위가 minspanx 보다 작거나 같은 선택 은 제거되거나(이미 존재하는 경우) 취소됩니다.

useblit 부울, 기본값: 거짓

더 빠른 그리기를 위해 블리팅을 사용할지 여부(백엔드에서 지원하는 경우). 자세한 내용은 블리팅을 사용하여 더 빠른 렌더링 튜토리얼 을 참조하세요.

소품 사전, 선택 사항

사각형을 그리는 속성입니다. matplotlib.patches.Patch유효한 속성은 를 참조하십시오 . 기본:

dict(facecolor='red', edgecolor='black', alpha=0.2, fill=True)

spancoords {"데이터", "픽셀"}, 기본값: "데이터"

데이터 또는 픽셀 좌표에서 minspanx 및 minspany 를 해석할지 여부 입니다.

버튼 MouseButton, 목록 MouseButton, 기본값: 모든 버튼

사각형 선택을 트리거하는 버튼.

grab_range float, 기본값: 10

대화형 도구 핸들을 활성화할 수 있는 거리(픽셀)입니다.

handle_props 사전, 선택사항

대화형 핸들(마커 아티스트)이 그려지는 속성입니다. matplotlib.lines.Line2D유효한 속성 은 마커 인수를 참조하십시오 . 기본값 은 props 의 속성 과 동일한 mpl.rcParams기본값을 제외하고 에 정의됩니다 .markeredgecoloredgecolor

대화식 부울, 기본값: False

위젯이 그려진 후 위젯과의 상호 작용을 허용하는 핸들 집합을 그릴지 여부입니다.

state_modifier_keys 사전, 선택사항

위젯의 동작에 영향을 미치는 키보드 수정자. 값은 다음과 같은 기본값을 수정합니다.

• "이동": 기존 모양을 이동합니다. 기본값: 수정자 없음.

• "clear": 현재 모양을 지웁니다. 기본값은 "escape"입니다.

• "square": 모양을 사각형으로 만듭니다. 기본값은 "shift"입니다.

• "center": 중심 주위의 모양을 변경합니다. 기본값은 "ctrl"입니다.

• "rotate": -45°와 45° 사이에서 중심을 중심으로 도형을 회전합니다. 기본값은 "r"입니다.

"정사각형"과 "중심"을 결합할 수 있습니다. use_data_coordinates사각형 모양은 선택기를 만들 때 지정된 인수 에 따라 결정되는 데이터 또는 디스플레이 좌표에서 정의할 수 있습니다 .

drag_from_anywhere 부울, 기본값: 거짓

이면 True위젯은 범위 내의 아무 곳이나 클릭하여 이동할 수 있습니다.

ignore_event_outside 부울, 기본값: False

인 경우 True범위 선택기 외부에서 트리거된 이벤트는 무시됩니다.

use_data_coordinates 부울, 기본값: False

이면 True선택기의 "정사각형" 모양이 디스플레이 좌표 대신 데이터 좌표에 정의됩니다.

예

>>> import matplotlib.pyplot as plt
>>> import matplotlib.widgets as mwidgets
>>> fig, ax = plt.subplots()
>>> ax.plot([1, 2, 3], [10, 50, 100])
>>> def onselect(eclick, erelease):
...     print(eclick.xdata, eclick.ydata)
...     print(erelease.xdata, erelease.ydata)
>>> props = dict(facecolor='blue', alpha=0.5)
>>> rect = mwidgets.RectangleSelector(ax, onselect, interactive=True,
                                      props=props)
>>> fig.show()

>>> selector.add_state('square')

참조: 사각형 및 타원 선택기

속성 active_handle

재산 센터

데이터 좌표에서 사각형의 중심.

부동산 코너

데이터 좌표에서 사각형의 모서리는 왼쪽 아래부터 시계 방향으로 이동합니다.

속성 draw_shape

속성 그리기 유형

속성 edge_centers

시계 반대 방향으로 이동하면서 왼쪽부터 데이터 좌표에 있는 사각형 가장자리의 중간점입니다.

속성 범위

회전 전 경계 상자에 의해 정의된 데이터 좌표로 (xmin, xmax, ymin, ymax)를 반환합니다.

속성 기하학

왼쪽 위 모서리에서 시작하고 끝나는 사각형의 네 모서리에 대한 x( ) 및 y( ) 데이터 좌표를 포함하는 모양 (2, 5)의 배열을 반환합니다 .RectangleSelector.geometry[1, :]RectangleSelector.geometry[0, :]

속성 인터랙티브

속성 maxdist

속성 회전

[-45°, 45°] 간격으로 회전합니다. 구현을 단순하게 유지하기 위해 회전 범위가 제한됩니다.

속성 to_draw

클래스 matplotlib.widgets. 슬라이더 ( ax , label , valmin , valmax , valinit = 0.5 , valfmt = None , closedmin = True , closedmax = True , slidermin = None , slidermax = None , 드래그 = True , valstep = None , orientation = 'horizontal' , * ,initcolor = 'r' , track_color = 'lightgrey' , handle_style = None , ** kwargs )

베이스:SliderBase

부동 소수점 범위를 나타내는 슬라이더입니다.

Axes ax 에서 valmin 에서 valmax 까지 슬라이더를 만듭니다 . 슬라이더가 계속 반응하려면 그에 대한 참조를 유지해야 합니다. 슬라이더 이벤트에 연결하기 위해 호출 합니다.on_changed()

속성 :

발 플로트

슬라이더 값.

매개변수 :

도끼 _

슬라이더를 넣을 축입니다.

레이블 문자열

슬라이더 라벨.

발민 플로트

슬라이더의 최소값입니다.

발맥스 플로트

슬라이더의 최대값입니다.

발리닛 플로트, 기본값: 0.5

슬라이더 초기 위치입니다.

valfmt 문자열 , 기본값: 없음

슬라이더 값의 형식을 지정하는 데 사용되는 % 형식 문자열입니다. None이면 a ScalarFormatter가 대신 사용됩니다.

closedmin 부울, 기본값: 참

슬라이더 간격이 하단에서 닫혀 있는지 여부입니다.

closedmax 부울, 기본값: True

슬라이더 간격이 상단에서 닫히는지 여부입니다.

slidermin 슬라이더, 기본값: 없음

현재 슬라이더가 Slider slidermin 값보다 작은 값을 갖지 않도록 하십시오 .

slidermax 슬라이더, 기본값: 없음

현재 슬라이더가 Slider slidermax 값보다 큰 값을 갖지 않도록 하십시오 .

드래그 부울, 기본값: True

참이면 슬라이더를 마우스로 끌 수 있습니다.

valstep 부동 소수점 또는 유사 배열, 기본값: 없음

플로트인 경우 슬라이더는 valstep 의 배수로 스냅됩니다 . 배열인 경우 슬라이더는 배열의 값에 맞춰집니다.

방향 {'수평', '수직'}, 기본값: '수평'

슬라이더의 방향입니다.

초기 색상, 기본값: 'r'

valinit 위치 에 있는 선의 색상입니다 . 줄 없음 으로 설정합니다 'none' .

track_color 색상, 기본값: 'lightgrey'

배경 트랙의 색상입니다. track 속성 을 통해 추가 스타일 지정을 위해 트랙에 액세스할 수 있습니다 .

handle_style 사전

슬라이더 핸들의 속성입니다. 기본값은

열쇠	값	기본	설명
얼굴색	색깔	'하얀'	슬라이더 핸들의 페이스 컬러.
엣지컬러	색깔	'.75'	슬라이더 핸들의 가장자리 색상입니다.
크기	정수	10	슬라이더 핸들의 크기(포인트)입니다.

다른 값은 marker{foo}로 변환되어 Line2D생성자에게 전달됩니다. 예 를 들어 .handle_style = {'style'='x'}markerstyle = 'x'

메모

슬라이더 노브를 그리는 self.poly에 추가 kwargs가 전달됩니다 . 유효한 속성 이름( , , 등) 은 설명서를 Polygon참조하십시오 .Polygonfacecoloredgecoloralpha

on_changed ( func )

func 를 콜백 함수로 슬라이더 값의 변경에 연결 합니다.

매개변수 :

함수 호출 가능

슬라이더가 변경될 때 호출하는 함수입니다. 함수는 단일 부동 소수점을 인수로 받아들여야 합니다.

반환 :

정수

연결 ID( func 를 연결 해제하는 데 사용할 수 있음 ).

set_val ( val )

슬라이더 값을 val 로 설정 합니다.

매개변수 :

발 플로트

클래스 matplotlib.widgets. SliderBase ( ax , orientation , closedmin , closedmax , valmin , valmax , valfmt , dragging , valstep )

베이스:AxesWidget

Slider 위젯을 구성하기 위한 기본 클래스입니다. 직접 사용하기 위한 것이 아닙니다.

슬라이더가 계속 반응하려면 그에 대한 참조를 유지해야 합니다.

연결 끊기 ( cid )

연결 ID가 cid 인 관찰자를 제거합니다 .

매개변수 :

cid 정수

제거할 관찰자의 연결 ID입니다.

재설정 ( )

슬라이더를 초기 값으로 재설정합니다.

클래스 matplotlib.widgets. SpanSelector ( ax , onselect , direction , minspan = 0 , useblit = False , props = None , onmove_callback = None , interactive = False , button = None , handle_props = None , grab_range = 10 , state_modifier_keys = None , drag_from_anywhere =False , ignore_event_outside = False , snap_values ​​= None )

베이스:_SelectorWidget

단일 축에서 최소/최대 범위를 시각적으로 선택하고 해당 값으로 함수를 호출합니다.

선택자가 계속 응답하도록 보장하려면 이에 대한 참조를 유지하십시오.

SpanSelector를 끄 span_selector.active려면 False로 설정하십시오. 다시 켜려면 True로 설정하십시오.

선택 외부의 동일한 좌표에서 트리거된 눌렀다 떼는 이벤트는 다음 경우를 제외하고 선택기를 지웁니다 ignore_event_outside=True.

매개변수 :

도끼matplotlib.axes.Axes

onselect 호출 가능

릴리스 이벤트 및 선택이 생성, 변경 또는 제거된 후에 호출되는 콜백 함수입니다. 서명이 있어야 합니다.

def on_select(min: float, max: float) -> Any

방향 {"수평", "수직"}

범위 선택기를 그릴 방향입니다.

minspan float, 기본값: 0

선택이 minspan 보다 작거나 같으면 선택이 제거되거나(이미 존재하는 경우) 취소됩니다.

useblit 부울, 기본값: 거짓

True인 경우 더 빠른 캔버스 업데이트를 위해 백엔드 종속 블리팅 기능을 사용합니다. 자세한 내용은 블리팅을 사용하여 더 빠른 렌더링 튜토리얼 을 참조하세요.

소품 사전, 선택 사항

matplotlib.patches.Patch속성 사전 . 기본:

dict(facecolor='red', alpha=0.5)

onmove_callback func(최소, 최대), 최소/최대는 부동 소수점, 기본값: 없음

범위가 선택되는 동안 마우스 이동 시 호출됩니다.

span_stays 부울, 기본값: 거짓

True인 경우 마우스를 놓은 후에도 범위가 계속 표시됩니다. 더 이상 사용되지 않습니다 . 대신 대화형 을 사용하세요.

대화식 부울, 기본값: False

위젯이 그려진 후 위젯과의 상호 작용을 허용하는 핸들 집합을 그릴지 여부입니다.

버튼 MouseButton또는 목록 MouseButton, 기본값: 모든 버튼

범위 선택기를 활성화하는 마우스 버튼입니다.

handle_props 사전, 기본값: 없음

범위 가장자리에 있는 핸들 선의 속성입니다. Interactive 가 True인 경우에만 사용됩니다 . matplotlib.lines.Line2D유효한 속성은 를 참조하십시오 .

grab_range float, 기본값: 10

대화형 도구 핸들을 활성화할 수 있는 거리(픽셀)입니다.

state_modifier_keys 사전, 선택사항

위젯의 동작에 영향을 미치는 키보드 수정자. 값은 다음과 같은 기본값을 수정합니다.

• "clear": 현재 모양을 지웁니다. 기본값은 "escape"입니다.

drag_from_anywhere 부울, 기본값: 거짓

이면 True위젯은 범위 내의 아무 곳이나 클릭하여 이동할 수 있습니다.

ignore_event_outside 부울, 기본값: False

인 경우 True범위 선택기 외부에서 트리거된 이벤트는 무시됩니다.

snap_values ​​1D 배열 유사, 선택 사항

선택기 가장자리를 주어진 값에 맞춥니다.

예

>>> import matplotlib.pyplot as plt
>>> import matplotlib.widgets as mwidgets
>>> fig, ax = plt.subplots()
>>> ax.plot([1, 2, 3], [10, 50, 100])
>>> def onselect(vmin, vmax):
...     print(vmin, vmax)
>>> span = mwidgets.SpanSelector(ax, onselect, 'horizontal',
...                              props=dict(facecolor='blue', alpha=0.5))
>>> fig.show()

참조: 스팬 선택기

속성 active_handle

connect_default_events ( )

주요 캔버스 이벤트를 메서드에 연결합니다.

속성 방향

범위 선택기의 방향: '수직' 또는 '수평'.

속성 범위

범위 선택기의 범위를 반환합니다.

new_axes ( ax )

새 Axes에서 작동하도록 SpanSelector를 설정합니다.

속성 pressv

속성 이전

속성 rect

속성 rectprops

속성 span_stays

클래스 matplotlib.widgets. SubplotTool ( targetfig , toolfig )

베이스:Widget

의 서브플롯 매개변수를 조정하는 도구 matplotlib.figure.Figure입니다.

매개변수 :

타겟피그Figure

조정할 Figure 인스턴스입니다.

툴피그Figure

서브플롯 도구를 삽입할 그림 인스턴스입니다.

클래스 matplotlib.widgets. TextBox ( ax , label , initial = '' , color = '.95' , hovercolor = '1' , label_pad = 0.01 , textalignment = 'left' )

베이스:AxesWidget

GUI 중립 텍스트 입력 상자.

텍스트 상자가 계속 응답하려면 텍스트 상자에 대한 참조를 유지해야 합니다.

on_text_change텍스트가 변경될 때마다 업데이트되도록 호출 합니다.

on_submit사용자가 텍스트 입력 필드를 입력하거나 떠날 때마다 업데이트되도록 호출 합니다.

속성 :

도끼Axes

위젯의 상위 Axes입니다.

상표Text

색상 색상

가리키지 않을 때의 텍스트 상자 색상입니다.

호버 컬러 색상

가리키면 텍스트 상자의 색상입니다.

매개변수 :

도끼Axes

버튼 이 Axes배치될 인스턴스입니다.

레이블 문자열

이 텍스트 상자의 레이블입니다.

초기 문자열

텍스트 상자의 초기 값입니다.

색상 색상

상자의 색상입니다.

호버 컬러 색상

마우스가 위에 있을 때 상자의 색상입니다.

label_pad 플로트

레이블과 텍스트 상자의 오른쪽 사이의 거리입니다.

텍스트 정렬 {'왼쪽', '가운데', '오른쪽'}

텍스트의 가로 위치입니다.

속성 DIST_FROM_LEFT

begin_typing ( x )

연결 끊기 ( cid )

연결 ID가 cid 인 관찰자를 제거합니다 .

on_submit ( func )

사용자가 엔터를 치거나 제출 상자를 떠날 때 이벤트와 함께 이 기능 을 호출합니다.

연결을 끊는 데 사용할 수 있는 연결 ID가 반환됩니다.

on_text_change ( func )

텍스트가 변경되면 이벤트와 함께 이 함수 를 호출합니다.

연결을 끊는 데 사용할 수 있는 연결 ID가 반환됩니다.

position_cursor ( x )

set_val ( val )

stop_typing ( )

속성 텍스트

클래스 matplotlib.widgets. ToolHandles ( ax , x , y , marker = 'o' , marker_props = None , useblit = True )

베이스:object

캔버스 도구의 핸들을 제어합니다.

매개변수 :

도끼matplotlib.axes.Axes

도구 핸들이 표시되는 Matplotlib 축.

x, y 1D 배열

제어 핸들의 좌표.

마커 문자열, 기본값: 'o'

핸들을 표시하는 데 사용되는 마커의 모양입니다. 참조하십시오 matplotlib.pyplot.plot.

marker_props 사전, 선택사항

추가 마커 속성. 참조하십시오 matplotlib.lines.Line2D.

useblit 부울, 기본값: 참

더 빠른 그리기를 위해 블리팅을 사용할지 여부(백엔드에서 지원하는 경우). 자세한 내용은 블리팅을 사용하여 더 빠른 렌더링 튜토리얼 을 참조하세요.

부동산 아티스트

가장 가까운 ( x , y )

인덱스와 픽셀 거리를 가장 가까운 인덱스로 반환합니다.

set_animated ( val )

set_data ( pts , y = 없음 )

핸들의 x 및 y 위치를 설정합니다.

set_visible ( val )

재산 x

재산 y

클래스 matplotlib.widgets. ToolLineHandles ( ax , position , direction , line_props = None , useblit = True )

베이스:object

캔버스 도구의 핸들을 제어합니다.

매개변수 :

도끼matplotlib.axes.Axes

도구 핸들이 표시되는 Matplotlib 축.

위치 1D 배열

데이터 좌표에서 핸들의 위치.

방향 {"수평", "수직"}

핸들의 방향, '수직' 또는 '수평'

line_props 사전, 선택 사항

추가 라인 속성. 참조하십시오 matplotlib.lines.Line2D.

useblit 부울, 기본값: 참

더 빠른 그리기를 위해 블리팅을 사용할지 여부(백엔드에서 지원하는 경우). 자세한 내용은 블리팅을 사용하여 더 빠른 렌더링 튜토리얼 을 참조하세요.

부동산 아티스트

가장 가까운 ( x , y )

가장 가까운 핸들까지의 인덱스 및 픽셀 거리를 반환합니다.

매개변수 :

x, y 플로트

가장 가까운 핸들을 결정하기 위해 거리를 계산할 x, y 위치

반환 :

색인, 핸들의 거리 색인 및 거리

위치 x, y

속성 방향

핸들의 방향: '수직' 또는 '수평'.

속성 위치

데이터 좌표에서 핸들의 위치입니다.

제거 ( )

그림에서 아티스트 핸들을 제거합니다.

set_animated ( 값 )

핸들 아티스트의 애니메이션 상태를 설정합니다.

set_data ( 위치 )

선이 가로인지 세로인지에 따라 핸들의 x 또는 y 위치를 설정합니다.

매개변수 :

길이가 2인 위치 튜플

데이터 좌표에서 핸들 위치 설정

set_visible ( 값 )

핸들 아티스트의 가시성 상태를 설정합니다.

클래스 matplotlib.widgets. 위젯

베이스:object

GUI 중립 위젯의 추상 기본 클래스입니다.

속성 활성

위젯이 활성화되어 있습니까?

drawon = 참

이벤트슨 = 참

get_active ( )

위젯이 활성 상태인지 확인합니다.

무시 ( 이벤트 )

이벤트 를 무시 할지 여부를 반환합니다 .

이 메서드는 이벤트 콜백이 시작될 때 호출해야 합니다.

set_active ( 활성 )

위젯 활성 여부를 설정합니다.