widgets

matplotlib.widgets

GUI-нейтральные виджеты

Виджеты, предназначенные для работы с любыми графическими интерфейсами (GUI). Все эти виджеты требуют предварительного определения экземпляра matplotlib.axes.Axes и передачи его в качестве первого аргумента. matplotlib не пытается слишком умно подходить к макетированию — вам придётся самостоятельно определить желаемую ширину и высоту объекта Axes, чтобы разместить в нём ваш виджет.

class matplotlib.widgets.AxesWidget(ax) [source]

Базовый класс: matplotlib.widgets.Widget

Виджет, связанный с одним Axes.

Для гарантии, что виджет остаётся отзывчивым и не удаляется сборщиком мусора, пользователь должен сохранить ссылку на объект.

Это необходимо, потому что регистр обратных вызовов сохраняет только слабые ссылки на функции, которые являются методами виджета. Если нет ссылок на объект виджета, он может быть удалён сборщиком мусора, что отсоединит обратные вызовы.

Атрибуты:

ax : Axes

Ось родительского виджета

canvas : FigureCanvasBase subclass

Родительский холст фигуры виджета.

active : bool

Если False, виджет не реагирует на события.

connect_event(event, callback) [source]

Связывает обратный вызов с событием.

Следует использовать вместо figure.canvas.mpl_connect, так как эта функция сохраняет идентификаторы обратных вызовов для последующей очистки.

disconnect_events() [source]

Отсоединить все события, созданные этим виджетом.

class matplotlib.widgets.Button(ax, label, image=None, color='0.85', hovercolor='0.95') [source]

Базовый класс: matplotlib.widgets.AxesWidget

Нейтральная кнопка графического интерфейса.

Для сохранения отзывчивости кнопки необходимо сохранить ссылку на неё. Вызовите on_clicked() для подключения к кнопке.

Атрибуты:	ax : matplotlib.axes.Axes, на котором отображается кнопка. label : Экземпляр matplotlib.text.Text. color : Цвет кнопки, когда она не наведена курсором. hovercolor : Цвет кнопки, когда на неё наведён курсор.

Параметры:

ax : matplotlib.axes.Axes Экземпляр matplotlib.axes.Axes, в который будет помещена кнопка. label : str Текст кнопки. Принимает строку. image : array, mpl image, Pillow Image Изображение для размещения в кнопке, если не None. Может быть любым допустимым аргументом для imshow (массив NumPy, экземпляр matplotlib Image или Pillow Image). color : color Цвет кнопки в неактивном состоянии hovercolor : color Цвет кнопки при наведении курсора

disconnect(cid) [source]

Удалить наблюдателя с идентификатором подключения cid

on_clicked(func) [source]

При нажатии на кнопку вызывать функцию func с событием.

Возвращает идентификатор подключения. Он может быть использован для отключения кнопки от обратного вызова.

class matplotlib.widgets.CheckButtons(ax, labels, actives=None) [source]

Базовый класс: matplotlib.widgets.AxesWidget

Набор флажков GUI-нейтрального типа.

Для сохранения отзывчивости флажков необходимо сохранить ссылку на этот объект.

Доступны следующие атрибуты:

ax

Экземпляр matplotlib.axes.Axes, в котором расположены кнопки.

labels

Список экземпляров matplotlib.text.Text

lines

Список кортежей (line1, line2) для значков «x» в чекбоксах. Эти линии существуют для каждого поля, но имеют set_visible(False) значение, когда его поле не отмечено.

rectangles

Список экземпляров matplotlib.patches.Rectangle

Подключиться к CheckButtons можно с помощью метода on_clicked().

Добавить флажки на matplotlib.axes.Axes экземпляр ax

Параметры:	ax : Axes Родительская ось для виджета. labels : List[str] Метки флажков. actives : List[bool], optional Начальное состояние флагов. Список должен иметь такую же длину, как labels. Если не указано, все флажки будут сняты.

disconnect(cid) [source]

Удалить наблюдателя с идентификатором подключения cid

get_status() [source]

Возвращает кортеж состояния (True/False) всех флажков.

on_clicked(func) [source]

При нажатии на кнопку вызывать функцию func с меткой кнопки.

Возвращает идентификатор подключения, который можно использовать для отключения.

set_active(index) [source]

Непосредственно (де)активировать флажок по индексу.

index — индекс в исходном списке меток, с которым был создан этот объект. ValueError будет поднят, если index некорректен.

Обратные вызовы будут вызваны, если eventson равно True.

class matplotlib.widgets.Cursor(ax, horizOn=True, vertOn=True, useblit=False, **lineprops) [source]

Базы: matplotlib.widgets.AxesWidget

Горизонтальная и вертикальная линия, охватывающая ось и перемещающаяся вместе с указателем. Вы можете отключить линию hline или vline соответственно с помощью следующих атрибутов:

horizOn

Управляет видимость горизонтальной линии

vertOn

Управляет видимость горизонтальной линии

и видимость самого курсора с помощью атрибута visible.

Для того, чтобы курсор оставался отзывчивым, вы должны сохранить ссылку на него.

Добавьте курсор в ax. Если useblit=True, используйте функции кеширования (blitting), зависящие от бэкенда, для более быстрых обновлений. lineprops — это словарь свойств линии.

clear(event) [source]

очистить курсор

onmove(event) [source]

при движении мыши отобразить курсор, если он виден

class matplotlib.widgets.EllipseSelector(ax, onselect, drawtype='box', minspanx=None, minspany=None, useblit=False, lineprops=None, rectprops=None, spancoords='data', button=None, maxdist=10, marker_props=None, interactive=False, state_modifier_keys=None) [source]

Базы: matplotlib.widgets.RectangleSelector

Выбор эллиптической области на оси.

Для того, чтобы курсор оставался отзывчивым, вы должны сохранить ссылку на него.

Пример использования:

import numpy as np
import matplotlib.pyplot as plt
from matplotlib.widgets import EllipseSelector

def onselect(eclick, erelease):
    "eclick and erelease are matplotlib events at press and release."
    print('startposition: (%f, %f)' % (eclick.xdata, eclick.ydata))
    print('endposition  : (%f, %f)' % (erelease.xdata, erelease.ydata))
    print('used button  : ', eclick.button)

def toggle_selector(event):
    print(' Key pressed.')
    if event.key in ['Q', 'q'] and toggle_selector.ES.active:
        print('EllipseSelector deactivated.')
        toggle_selector.RS.set_active(False)
    if event.key in ['A', 'a'] and not toggle_selector.ES.active:
        print('EllipseSelector activated.')
        toggle_selector.ES.set_active(True)

x = np.arange(100.) / 99
y = np.sin(x)
fig, ax = plt.subplots()
ax.plot(x, y)

toggle_selector.ES = EllipseSelector(ax, onselect, drawtype='line')
fig.canvas.connect('key_press_event', toggle_selector)
plt.show()

Создайте селектор в ax. Когда выбор сделан, очистите интервал и вызовите onselect со значением:

onselect(pos_1, pos_2)

и очистите нарисованный прямоугольник/линию. pos_1 и pos_2 — массивы длиной 2, содержащие x- и y-координаты.

Если minspanx не None, то события, меньшие minspanx по оси x, игнорируются (аналогично для y).

Прямоугольник рисуется с помощью rectprops; по умолчанию:

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

Линия рисуется с помощью lineprops; по умолчанию:

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

Используйте drawtype, если вы хотите, чтобы мышь рисовала линию, прямоугольник или ничего между щелчком и фактическим положением, установив

drawtype = 'line', drawtype='box' или drawtype = 'none'. Рисование линии приведет к линии от вершины A к вершине C в прямоугольнике ABCD.

spancoords может быть 'data' или 'pixels'. Если 'data', minspanx и minspanx будут интерпретироваться в тех же координатах, что и оси x и y. Если 'pixels', они указаны в пикселях.

button — список целых чисел, указывающих, какие кнопки мыши следует использовать для выбора прямоугольника. Вы также можете указать одно целое число, если требуется только одна кнопка. По умолчанию None, что не ограничивает использование кнопок.

Примечание:

1 = левая кнопка мыши 2 = центральная кнопка мыши (колесо прокрутки) 3 = правая кнопка мыши

interactive нарисует набор элементов управления и позволит взаимодействовать с виджетом после его отображения.

state_modifier_keys — это модификаторы клавиатуры, которые влияют на поведение виджета.

Значения по умолчанию: dict(move=' ', clear='escape', square='shift', center='ctrl')

Модификаторы клавиатуры, которые: 'move': Переместить существующую фигуру. 'clear': Очистить текущую фигуру. 'square': Сделать фигуру квадратной. 'center': Сделать начальную точку центром фигуры. 'square' и 'center' могут быть объединены.

draw_shape(extents) [source]

class matplotlib.widgets.Lasso(ax, xy, callback=None, useblit=True) [source]

Базы: matplotlib.widgets.AxesWidget

Линия выбора произвольной формы.

Выбранный путь может быть использован совместно с contains_point() для выбора точек данных из изображения.

В отличие от LassoSelector, этот виджет должен быть инициализирован с начальной точкой xy, и события Lasso удаляются при отпускании.

Параметры:	ax : Axes Родительская ось виджета. xy : array Координаты начала лассо. callback : callable При отпускании лассо вызывается функция callback, получающая на вход вершины выбранного пути.

onmove(event) [source]

onrelease(event) [source]

class matplotlib.widgets.LassoSelector(ax, onselect=None, useblit=True, lineprops=None, button=None) [source]

Базы: matplotlib.widgets._SelectorWidget

Линия выбора произвольной формы.

Выбранный путь может быть использован совместно с contains_point для выбора точек данных из изображения.

В отличие от Lasso, LassoSelector имеет интерфейс, похожий на RectangleSelector и SpanSelector, и будет взаимодействовать с осью до разъединения.

Пример использования:

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

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

Параметры:

ax : Axes Родительская ось виджета. onselect : function При отпускании лассо вызывается функция onselect, получающая на вход вершины выбранного пути. button : List[Int], optional Список целых чисел, указывающих, какие кнопки мыши следует использовать для выбора прямоугольника. Также можно указать одно целое число, если требуется только одна кнопка. По умолчанию None, что не ограничивает выбор кнопок. Обычно: 1 = левая кнопка мыши 2 = центральная кнопка мыши (колесо прокрутки) 3 = правая кнопка мыши

onpress(event) [source]

onrelease(event) [source]

class matplotlib.widgets.LockDraw [source]

Базовое класс: object

Некоторые виджеты, такие как курсор, рисуют на холсте, и это нежелательно во всех случаях, например, когда панель инструментов находится в режиме масштабирования по прямоугольнику и рисуется прямоугольник. Чтобы избежать этого, виджет может захватить блокировку холста с помощью canvas.widgetlock(widget) перед рисованием на холсте; это предотвратит рисование другими виджетами в то же время (если они также попытаются сначала захватить блокировку).

available(o) [source]

Возвращает, доступно ли рисование для o.

isowner(o) [source]

Возвращает, владеет ли o этой блокировкой.

locked() [source]

Возвращает, удерживает ли блокировку владелец.

release(o) [source]

Освободить блокировку от o.

class matplotlib.widgets.MultiCursor(canvas, axes, useblit=True, horizOn=False, vertOn=True, **lineprops) [source]

Базовое класс: matplotlib.widgets.Widget

Обеспечивает вертикальный (по умолчанию) и/или горизонтальный курсор линии, общий для нескольких осей.

Чтобы курсор оставался отзывчивым, необходимо сохранить ссылку на него.

Пример использования:

from matplotlib.widgets import MultiCursor
import matplotlib.pyplot as plt
import numpy as np

fig, (ax1, ax2) = plt.subplots(nrows=2, sharex=True)
t = np.arange(0.0, 2.0, 0.01)
ax1.plot(t, np.sin(2*np.pi*t))
ax2.plot(t, np.sin(4*np.pi*t))

multi = MultiCursor(fig.canvas, (ax1, ax2), color='r', lw=1,
                    horizOn=False, vertOn=True)
plt.show()

clear(event) [source]

очистить курсор

connect() [source]

подключить события

disconnect() [source]

отключить события

onmove(event) [source]

class matplotlib.widgets.PolygonSelector(ax, onselect, useblit=False, lineprops=None, markerprops=None, vertex_select_radius=15) [source]

Базовое класс: matplotlib.widgets._SelectorWidget

Выбрать область многоугольника на оси.

Установите вершины с помощью каждого щелчка мыши и выполните выбор, завершив многоугольник (щелкнув по первой вершине). Удерживайте клавишу ctrl и щелкните и перетащите вершину, чтобы переместить ее (клавиша ctrl не требуется, если многоугольник уже завершен). Удерживайте клавишу shift и щелкните и перетащите в любом месте на оси, чтобы переместить все вершины. Нажмите клавишу esc, чтобы начать новый многоугольник.

Чтобы селектор оставался отзывчивым, необходимо сохранить на него ссылку.

Параметры:

ax : Axes Родительская ось для виджета. onselect : function Когда многоугольник завершается или изменяется после завершения, вызывается функция onselect, и передаётся список вершин в виде (xdata, ydata) кортежей. useblit : bool, optional lineprops : dict, optional Линия для сторон многоугольника рисуется с помощью свойств, заданных lineprops. По умолчанию - dict(color='k', linestyle='-', linewidth=2, alpha=0.5). markerprops : dict, optional Маркеры для вершин многоугольника рисуются с помощью свойств, заданных markerprops. По умолчанию - dict(marker='o', markersize=7, mec='k', mfc='k', alpha=0.5). vertex_select_radius : float, optional Вершина выбирается (для завершения многоугольника или перемещения вершины), если щелчок мышью находится в пределах vertex_select_radius пикселей от вершины. Радиус по умолчанию составляет 15 пикселей.

Примеры

Демонстрация селектора многоугольника

onmove(event) [source]

Обработчик событий перемещения курсора и валидатор

verts

Получить вершины многоугольника.

Возвращает:	список Список вершин многоугольника в виде (xdata, ydata) кортежей.

class matplotlib.widgets.RadioButtons(ax, labels, active=0, activecolor='blue') [source]

Базовое класс: matplotlib.widgets.AxesWidget

Радиокнопка, нейтральная для графического интерфейса.

Для того, чтобы кнопки оставались отзывчивыми, необходимо сохранить ссылку на этот объект.

Следующие атрибуты доступны:

ax

Экземпляр matplotlib.axes.Axes, в котором находятся кнопки

activecolor

Цвет кнопки при нажатии

labels

Список экземпляров matplotlib.text.Text

circles

Список экземпляров matplotlib.patches.Circle

value_selected

Строка со значением текущей выбранной кнопки

Подключитесь к RadioButtons с помощью метода on_clicked()

Добавьте радиокнопки в экземпляр matplotlib.axes.Axes ax

labels

Список меток (строки) длиной len(buttons)

active

Индекс в списке меток для активной кнопки

activecolor

Цвет кнопки при нажатии

disconnect(cid) [source]

Удалить наблюдателя с идентификатором подключения cid

on_clicked(func) [source]

При нажатии кнопки вызовите func с меткой кнопки.

Возвращается идентификатор подключения, который может быть использован для отключения.

set_active(index) [source]

Выберите активную радиокнопку.

index — индекс в исходном списке меток, с которым был создан этот объект. Вызовет ValueError, если индекс недопустим.

Обработчики будут вызваны, если eventson равно True.

class matplotlib.widgets.RectangleSelector(ax, onselect, drawtype='box', minspanx=None, minspany=None, useblit=False, lineprops=None, rectprops=None, spancoords='data', button=None, maxdist=10, marker_props=None, interactive=False, state_modifier_keys=None) [source]

Базы: matplotlib.widgets._SelectorWidget

Выбор прямоугольной области осей.

Для сохранения отзывчивости курсора необходимо сохранить ссылку на него.

Пример использования:

import numpy as np
import matplotlib.pyplot as plt
from matplotlib.widgets import RectangleSelector

def onselect(eclick, erelease):
    "eclick and erelease are matplotlib events at press and release."
    print('startposition: (%f, %f)' % (eclick.xdata, eclick.ydata))
    print('endposition  : (%f, %f)' % (erelease.xdata, erelease.ydata))
    print('used button  : ', eclick.button)

def toggle_selector(event):
    print('Key pressed.')
    if event.key in ['Q', 'q'] and toggle_selector.RS.active:
        print('RectangleSelector deactivated.')
        toggle_selector.RS.set_active(False)
    if event.key in ['A', 'a'] and not toggle_selector.RS.active:
        print('RectangleSelector activated.')
        toggle_selector.RS.set_active(True)

x = np.arange(100.) / 99
y = np.sin(x)
fig, ax = plt.subplots()
ax.plot(x, y)

toggle_selector.RS = RectangleSelector(ax, onselect, drawtype='line')
fig.canvas.connect('key_press_event', toggle_selector)
plt.show()

Создайте селектор в ax. При выборе области, очистите область и вызовите onselect с:

onselect(pos_1, pos_2)

и очистите нарисованную рамку/линию. pos_1 и pos_2 — массивы длиной 2, содержащие координаты x и y.

Если minspanx не None, события, меньшие minspanx по x, игнорируются (то же относится и к y).

Прямоугольник рисуется с помощью rectprops; значения по умолчанию:

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

Линия рисуется с помощью lineprops; значения по умолчанию:

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

Используйте drawtype, если вы хотите, чтобы мышь рисовала линию, прямоугольник или ничего между кликом и фактическим положением, установив

drawtype = 'line', drawtype='box' или drawtype = 'none'. Рисование линии приведет к линии от вершины А к вершине С в прямоугольнике ABCD.

spancoords — одно из 'data' или 'pixels'. Если 'data', minspanx и minspanx будут интерпретироваться в тех же координатах, что и оси x и y. Если 'pixels', они указаны в пикселях.

button — список целых чисел, указывающих, какие кнопки мыши должны использоваться для выбора прямоугольника. Вы также можете указать одно целое число, если требуется только одна кнопка. Значение по умолчанию — None, что не ограничивает используемую кнопку.

Примечание:

1 = левая кнопка мыши 2 = центральная кнопка мыши (колесо прокрутки) 3 = правая кнопка мыши

interactive нарисует набор элементов управления и позволит взаимодействовать с виджетом после его отрисовки.

state_modifier_keys — модификаторы клавиш, которые влияют на поведение виджета.

Значения по умолчанию: dict(move=' ', clear='escape', square='shift', center='ctrl')

Модификаторы клавиш: 'move': Перемещение существующей фигуры. 'clear': Очистка текущей фигуры. 'square': Делает фигуру квадратной. 'center': Делает начальную точку центром фигуры. 'square' и 'center' могут быть объединены.

center

Центр прямоугольника

corners

Углы прямоугольника, начиная с нижнего левого, по часовой стрелке.

draw_shape(extents) [source]

edge_centers

Середины сторон прямоугольника, начиная слева, по часовой стрелке.

extents

Возвращает (xmin, xmax, ymin, ymax).

geometry

Возвращает numpy.ndarray формы (2,5), содержащий x (RectangleSelector.geometry[1,:]) и y (RectangleSelector.geometry[0,:]) координаты четырёх углов прямоугольника, начиная и заканчивая в верхнем левом углу.

class matplotlib.widgets.Slider(ax, label, valmin, valmax, valinit=0.5, valfmt='%1.2f', closedmin=True, closedmax=True, slidermin=None, slidermax=None, dragging=True, valstep=None, **kwargs) [source]

Базы: matplotlib.widgets.AxesWidget

Ползунок, представляющий диапазон с плавающей точкой.

Создайте ползунок от valmin до valmax на осях ax. Для сохранения отзывчивости ползунка необходимо сохранить ссылку на него. Вызовите on_changed() для подключения к событию ползунка.

Атрибуты:	val : float Значение ползунка.

Параметры:

ax : Axes Оси для размещения ползунка. label : str Подпись ползунка. valmin : float Минимальное значение ползунка. valmax : float Максимальное значение ползунка. valinit : float, optional, default: 0.5 Начальное положение ползунка. valfmt : str, optional, default: "%1.2f" Используется для форматирования значения ползунка, строка формата fprint. closedmin : bool, optional, default: True Указывает, является ли интервал ползунка закрытым снизу. closedmax : bool, optional, default: True Указывает, является ли интервал ползунка закрытым сверху. slidermin : Slider, optional, default: None Не допускает, чтобы текущее значение ползунка было меньше значения ползунка slidermin. slidermax : Slider, optional, default: None Не допускает, чтобы текущее значение ползунка было больше значения ползунка slidermax. dragging : bool, optional, default: True Если True, ползунок можно перетаскивать мышью. valstep : float, optional, default: None Если задано, ползунок будет привязываться к кратным значениям valstep.

Примечания

Дополнительные параметры передаются self.poly which is the Rectangle, рисующему ползунок. См. документацию Rectangle для допустимых имён свойств (например, facecolor, edgecolor, alpha).

disconnect(cid) [source]

Удаляет наблюдателя с идентификатором соединения cid

Параметры:	cid : int Идентификатор соединения наблюдателя, который необходимо удалить

on_changed(func) [source]

При изменении значения ползунка, вызовите func со значением нового ползунка

Параметры:	func : callable Функция, которая вызывается при изменении ползунка. Функция должна принимать одно значение с плавающей точкой в качестве аргумента.
Возвращает:	cid : int Идентификатор соединения (который можно использовать для отключения func)

reset() [source]

Сбросить ползунок до начального значения

set_val(val) [source]

Установить значение ползунка в val

Параметры:	val : float

class matplotlib.widgets.SpanSelector(ax, onselect, direction, minspan=None, useblit=False, rectprops=None, onmove_callback=None, span_stays=False, button=None) [source]

Базовое класс: matplotlib.widgets._SelectorWidget

Визуально выбирает диапазон мин/макс на одной оси и вызывает функцию с этими значениями.

Для обеспечения отзывчивости селектора сохраняйте ссылку на него.

Для отключения SpanSelector, установите span_selector.active=False. Чтобы включить его снова, установите span_selector.active=True.

Параметры:

ax : matplotlib.axes.Axes object onselect : func(min, max), min/max are floats direction : "horizontal" or "vertical" Ось, по которой будет отображаться селектор. minspan : float, default is None Если выбор меньше, чем minspan, не вызывать onselect useblit : bool, default is False Если True, использовать функции блиттинга, зависящие от бэкенда, для более быстрых обновлений канваса. rectprops : dict, default is None Словарь свойств matplotlib.patches.Patch onmove_callback : func(min, max), min/max are floats, default is None Вызывается при перемещении мыши, пока выбирается отрезок. span_stays : bool, default is False Если True, отрезок остается видимым после отпускания кнопки мыши. button : int or list of ints Определяет, какие кнопки мыши активируют селектор отрезка 1 = левая кнопка мыши 2 = центральная кнопка мыши (колесо прокрутки) 3 = правая кнопка мыши

Примеры

>>> 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)
>>> rectprops = dict(facecolor='blue', alpha=0.5)
>>> span = mwidgets.SpanSelector(ax, onselect, 'horizontal',
...                              rectprops=rectprops)
>>> fig.show()

См. также: Селектор отрезка

ignore(event) [source]

возвращает True, если event нужно игнорировать

new_axes(ax) [source]

Установить SpanSelector для работы с новой осью

class matplotlib.widgets.SubplotTool(targetfig, toolfig) [source]

Базовое класс: matplotlib.widgets.Widget

Инструмент для изменения параметров поддиаграммы matplotlib.figure.Figure.

targetfig

Экземпляр фигуры для изменения.

toolfig

Экземпляр фигуры для вставки инструмента поддиаграммы. Если None, будет создана фигура по умолчанию. Если вы используете это из графического интерфейса

funcbottom(val) [source]

funchspace(val) [source]

funcleft(val) [source]

funcright(val) [source]

functop(val) [source]

funcwspace(val) [source]

class matplotlib.widgets.TextBox(ax, label, initial='', color='.95', hovercolor='1', label_pad=0.01) [source]

Базовое класс: matplotlib.widgets.AxesWidget

Поле ввода текста, нейтральное к GUI.

Для обеспечения отзывчивости текстового поля, необходимо сохранять ссылку на него.

Доступны следующие атрибуты:

ax

Ось matplotlib.axes.Axes, в которую будет отрисовано поле.

label

Экземпляр matplotlib.text.Text.

color

Цвет текстового поля, когда курсор не наведен.

hovercolor

Цвет текстового поля, когда курсор наведен.

Вызовите on_text_change(), чтобы обновлять поле при изменении текста.

Вызовите on_submit(), чтобы обновлять поле, когда пользователь нажимает Enter или покидает поле ввода.

Параметры:	ax : matplotlib.axes.Axes Экземпляр matplotlib.axes.Axes в который будет помещено поле. label : str Подпись для этого поля ввода. Принимает строку. initial : str Начальное значение в поле ввода. color : color Цвет поля. hovercolor : color Цвет поля, когда курсор наведен. label_pad : float Расстояние между подписью и правой стороной поля ввода.

begin_typing(x) [source]

disconnect(cid) [source]

Удалить наблюдателя с идентификатором соединения cid.

on_submit(func) [source]

При нажатии Enter или выходе из поля ввода, вызовите эту func с событием.

Возвращается идентификатор соединения, который может быть использован для отключения.

on_text_change(func) [source]

При изменении текста, вызовите эту func с событием.

Возвращается идентификатор соединения, который может быть использован для отключения.

position_cursor(x) [source]

set_val(val) [source]

stop_typing() [source]

class matplotlib.widgets.ToolHandles(ax, x, y, marker='o', marker_props=None, useblit=True) [source]

Bases: object

Управляющие элементы для инструментов холста.

Параметры:	ax : matplotlib.axes.Axes Оси Matplotlib, где отображаются управляющие элементы инструментов. x, y : 1D arrays Координаты управляющих элементов. marker : str Форма маркера, используемого для отображения управляющего элемента. См. matplotlib.pyplot.plot. marker_props : dict Дополнительные свойства маркера. См. matplotlib.lines.Line2D.

closest(x, y) [source]

Возвращает индекс и пиксельное расстояние до ближайшего индекса.

set_animated(val) [source]

set_data(pts, y=None) [source]

Устанавливает x и y координаты элементов управления

set_visible(val) [source]

x

y

class matplotlib.widgets.Widget [source]

Bases: object

Абстрактный базовый класс для GUI-нейтральных виджетов

active

Является ли виджет активным?

drawon = True

eventson = True

get_active() [source]

Получить, активен ли виджет.

ignore(event) [source]

Возвращает True, если событие должно быть проигнорировано.

Этот метод (или его версия) должен вызываться в начале любого обратного вызова события.

set_active(active) [source]

Установить, активен ли виджет.