Spec-Zone.ru › Matplotlib 2.2

widgets

matplotlib.widgets

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

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

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

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

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

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

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

Атрибуты:

ax : Axes
Родительская область Axes для виджета
canvas : FigureCanvasBase subclass
Родительская область Figure Canvas для виджета.
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

GUI-нейтральная кнопка.

Для сохранения отзывчивости кнопки необходимо сохранить ссылку на неё. Вызовите 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) [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

labels
Список меток длиной len(кнопки) в виде строк
actives
Список булевых значений длиной len(кнопки), указывающих,
активна ли кнопка
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

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

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

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

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

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

clear(event) [source]

Очистка курсора

onmove(event) [source]

При движении мыши отрисовка курсора, если он виден

END_OF_DOCUMENT_MARKER
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]

Bases: matplotlib.widgets.RectangleSelector

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

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

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

from matplotlib.widgets import  EllipseSelector
from pylab import *

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 = arange(100)/(99.0)
y = sin(x)
fig = figure
ax = subplot(111)
ax.plot(x,y)

toggle_selector.ES = EllipseSelector(ax, onselect, drawtype='line')
connect('key_press_event', toggle_selector)
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]

Bases: 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]

Bases: 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]

Bases: object

Некоторые виджеты, такие как курсор, рисуют на холсте, и это нежелательно во всех ситуациях, например, когда панель инструментов находится в режиме масштабирования по прямоугольнику, и рисуется прямоугольник. Модульная "блокировка" позволяет кому-то захватить блокировку и предотвратить рисование другими виджетами. Используйте matplotlib.widgets.lock(someobj) для предотвращения рисования других виджетов во время взаимодействия с холстом.

available(o) [source]

рисование доступно для o

isowner(o) [source]

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

locked() [source]

Возвращает True, если блокировка в настоящее время удерживается владельцем

release(o) [source]

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

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

Базы: matplotlib.widgets.Widget

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

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

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

from matplotlib.widgets import MultiCursor
from pylab import figure, show, np

t = np.arange(0.0, 2.0, 0.01)
s1 = np.sin(2*np.pi*t)
s2 = np.sin(4*np.pi*t)
fig = figure()
ax1 = fig.add_subplot(211)
ax1.plot(t, s1)

ax2 = fig.add_subplot(212, sharex=ax1)
ax2.plot(t, s2)

multi = MultiCursor(fig.canvas, (ax1, ax2), color='r', lw=1,
                    horizOn=False, vertOn=True)
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(кнопок) меток в виде строк
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]

Bases: matplotlib.widgets._SelectorWidget

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

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

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

from matplotlib.widgets import  RectangleSelector
from pylab import *

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 = arange(100)/(99.0)
y = sin(x)
fig = figure
ax = subplot(111)
ax.plot(x,y)

toggle_selector.RS = RectangleSelector(ax, onselect, drawtype='line')
connect('key_press_event', toggle_selector)
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' можно комбинировать.

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]

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.

Примечания

Дополнительные ключевые слова передаются в self.poly, что является 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]

Bases: 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]

Bases: 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]

Bases: 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

Расстояние между меткой и правой стороной текстового поля.

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

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

active

Является ли элемент управления активным?

drawon = True
eventson = True
get_active() [source]

Получить, является ли элемент управления активным.

ignore(event) [source]

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

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

set_active(active) [source]

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

© 2012–2018 Matplotlib Development Team. All rights reserved.
Licensed under the Matplotlib License Agreement.
https://matplotlib.org/2.2.3/api/widgets_api.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API