matplotlib.widgets

Компоненты графического интерфейса, независимые от среды

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

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

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

Компонент, связанный с одним графиком Axes.

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

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

Атрибуты:

ax : Axes: Родительский график для компонента
canvas : FigureCanvasBase subclass: Родительский холст фигуры для компонента.
active : bool: Если False, компонент не реагирует на события.

connect_event(self, event, callback) [source]

Подключение обратного вызова к событию.

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

disconnect_events(self) [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` Цвет кнопки, когда курсор находится над ней

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(self, cid) [source]: Удаление функции обратного вызова с идентификатором соединения cid.

on_clicked(self, func) [source]

Подключение функции обратного вызова func к событиям нажатия на кнопку.

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

END_OF_DOCUMENT_MARKER

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

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

Набор флажков, независимый от GUI.

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

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

ax: Экземпляр matplotlib.axes.Axes, в котором расположены кнопки.
labels: Список экземпляров matplotlib.text.Text.
lines: Список кортежей (line1, line2) для знаков «х» в флажках. Эти линии существуют для каждой кнопки, но имеют 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(self, cid) [source]: Удалить наблюдателя с идентификатором подключения cid

get_status(self) [source]: Возвращает кортеж состояний (True/False) всех флажков.

on_clicked(self, func) [source]

Подключить функцию обратного вызова func к событиям нажатия на кнопку.

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

set_active(self, index) [source]

Прямое (де)активация флажка по индексу.

index - индекс в исходном списке меток,: с помощью которого был создан этот объект. Вызовет ValueError, если index недействителен.

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

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

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

Перекрестный курсор, который охватывает оси и перемещается с курсором мыши.

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

Параметры:

Параметры:	`ax : matplotlib.axes.Axes` Экземпляр `Axes` для прикрепления курсора. `horizOn : bool, optional, default: True` Отображать ли горизонтальную линию. `vertOn : bool, optional, default: True` Отображать ли вертикальную линию. `useblit : bool, optional, default: False` Использовать ли blitting для более быстрого отображения, если поддерживается бэкендом.
Другие параметры:	**lineprops Свойства `Line2D`, которые управляют внешним видом линий. См. также `axhline`.

ax : matplotlib.axes.Axes: Экземпляр Axes для прикрепления курсора.
horizOn : bool, optional, default: True: Отображать ли горизонтальную линию.
vertOn : bool, optional, default: True: Отображать ли вертикальную линию.
useblit : bool, optional, default: False: Использовать ли blitting для более быстрого отображения, если поддерживается бэкендом.

Другие параметры:

**lineprops: Свойства Line2D, которые управляют внешним видом линий. См. также axhline.

Примеры

См. Cursor.

clear(self, event) [source]: Внутренний обработчик событий для очистки курсора.

onmove(self, 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.mpl_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(self, extents) [source]

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

Основы: matplotlib.widgets.AxesWidget

Кривая выделения произвольной формы.

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

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

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

onmove(self, event) [source]

onrelease(self, 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 = правая кнопка мыши

ax : Axes

Родительские оси виджета.

onselect : function

При отпускании лассо вызывается функция onselect, которой передаются вершины выбранного пути.

button : List[Int], optional

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

Обратите внимание, обычно:

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

onpress(self, event) [source]

onrelease(self, event) [source]

class matplotlib.widgets.LockDraw [source]

Основы: object

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

available(self, o) [source]: Возвращает, доступно ли рисование для o.

isowner(self, o) [source]: Возвращает, владеет ли o этой блокировкой.

locked(self) [source]: Возвращает, заблокирована ли блокировка в данный момент владельцем.

release(self, 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(self, event) [source]: очистить курсор

connect(self) [source]: подключить события

disconnect(self) [source]: отключить события

onmove(self, event) [source]

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

Bases: 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 пикселей.

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(self, event) [source]: Обработчик и валидатор событий перемещения курсора

verts

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

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

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

Bases: matplotlib.widgets.AxesWidget

Радиокнопка, независимая от GUI.

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

Подключитесь к RadioButtons, используя метод on_clicked().

Атрибуты:	ax Экземпляр `Axes`. activecolor Цвет выбранной кнопки. labels Список экземпляров `Text`, содержащих метки кнопок. circles Список экземпляров `Circle`, определяющих кнопки. `value_selected : str` Текст метки выбранной кнопки.

Добавление радиокнопок на Axes.

Параметры:	`ax : Axes` Оси, к которым добавляются кнопки. `labels : list of str` Метки кнопок. `active : int` Индекс начальной выбранной кнопки. `activecolor : color` Цвет выбранной кнопки.

disconnect(self, cid) [source]: Удаление наблюдателя с идентификатором соединения cid.

on_clicked(self, func) [source]

Подключение функции обратного вызова func к событиям нажатия на кнопку.

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

set_active(self, index) [source]

Выбрать кнопку с номером index.

Обратные вызовы будут вызваны, если 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]

Bases: 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.mpl_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 игнорируются (аналогично для minspany).

Прямоугольник рисуется с помощью 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 и minspany будут интерпретированы в тех же координатах, что и оси 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(self, extents) [source]

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

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

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

END_OF_DOCUMENT_MARKER

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, orientation='horizontal', **kwargs) [source]

Bases: 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`. `orientation : str, 'horizontal' or 'vertical', default: 'horizontal'` Ориентация ползунка.

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.
orientation : str, 'horizontal' or 'vertical', default: 'horizontal': Ориентация ползунка.

Примечания

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

disconnect(self, cid) [source]

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

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

on_changed(self, func) [source]

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

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

reset(self) [source]: Сбросить ползунок до начального значения

set_val(self, 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]

Bases: matplotlib.widgets._SelectorWidget

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

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

Для отключения 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 = правая кнопка мыши

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()

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

buttonDown

ignore(self, event) [source]: Возвращает True, если событие event должно быть проигнорировано

new_axes(self, ax) [source]: Устанавливает SpanSelector для работы с новой осью

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

Базы: matplotlib.widgets.Widget

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

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

funcbottom(self, val) [source]

funchspace(self, val) [source]

funcleft(self, val) [source]

funcright(self, val) [source]

functop(self, val) [source]

funcwspace(self, val) [source]

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

Базы: matplotlib.widgets.AxesWidget

Поле ввода текста, независимое от графического интерфейса.

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

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

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` Расстояние между подписью и правой стороной поля ввода.

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

begin_typing(self, x) [source]

disconnect(self, cid) [source]: Удалить наблюдателя с идентификатором соединения cid.

on_submit(self, func) [source]

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

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

on_text_change(self, func) [source]

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

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

position_cursor(self, x) [source]

set_val(self, val) [source]

stop_typing(self) [source]

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

Базы: object

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

Параметры:

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

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

closest(self, x, y) [source]: Возвращает индекс и пиксельное расстояние до ближайшего индекса.

set_animated(self, val) [source]

set_data(self, pts, y=None) [source]: Установка x и y позиций маркеров.

set_visible(self, val) [source]

x

y

class matplotlib.widgets.Widget [source]

Bases: object

Абстрактный базовый класс для виджетов, независимых от графического интерфейса

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

drawon = True

eventson = True

get_active(self) [source]: Получить, является ли виджет активным.

ignore(self, event) [source]

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

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

set_active(self, active) [source]: Установить, является ли виджет активным.