widgets
matplotlib.widgets
GUI-нейтральные виджеты
Виджеты, разработанные для работы с любыми графическими интерфейсами (GUI). Все эти виджеты требуют предварительного определения экземпляра matplotlib.axes.Axes и передачи его в качестве первого аргумента. matplotlib не пытается слишком умно подстраивать макет – вам нужно самостоятельно определить ширину и высоту области Axes, чтобы вместить ваш виджет.
-
class matplotlib.widgets.AxesWidget(ax) -
Наследуется от
matplotlib.widgets.WidgetВиджет, подключенный к одной области
Axes.Чтобы гарантировать, что виджет остается отзывчивым и не удаляется сборщиком мусора, пользователь должен сохранить ссылку на объект.
Это необходимо, потому что регистр обратных вызовов сохраняет только слабые ссылки на функции, которые являются методами виджета. Если ссылок на объект виджета нет, он может быть удален сборщиком мусора, что отсоединит обратные вызовы.
Атрибуты:
-
ax : Axes - Область, являющаяся родителем виджета
-
canvas : FigureCanvasBase subclass - Объект холста родительской фигуры для виджета.
-
active : bool - Если False, виджет не реагирует на события.
-
connect_event(event, callback) -
Подключение обратного вызова к событию.
Следует использовать вместо
figure.canvas.mpl_connect, так как эта функция хранит идентификаторы обратных вызовов для последующей очистки.
-
disconnect_events() -
Отключение всех событий, созданных этим виджетом.
-
-
class matplotlib.widgets.Button(ax, label, image=None, color='0.85', hovercolor='0.95') -
Наследуется от
matplotlib.widgets.AxesWidgetGUI-нейтральная кнопка.
Для сохранения отзывчивости кнопки необходимо сохранить ссылку на неё.
Доступны следующие атрибуты:
- ax
- Область
matplotlib.axes.Axes, в которую отображается кнопка. - label
- Экземпляр
matplotlib.text.Text. - color
- Цвет кнопки при отсутствии наведения.
- hovercolor
- Цвет кнопки при наведении.
Для подключения к кнопке используйте метод
on_clicked()Параметры: ax : matplotlib.axes.Axes
Объект
matplotlib.axes.Axes, в который будет помещена кнопка.label : str
Текст кнопки. Принимает строку.
image : массив, mpl изображение, изображение Pillow
Изображение, которое нужно разместить в кнопке, если оно не равно None. Может быть любым допустимым аргументом для imshow (массив NumPy, экземпляр изображения matplotlib или изображение Pillow).
color : цвет
Цвет кнопки при отсутствии активации
hovercolor : цвет
Цвет кнопки при наведении курсора
-
disconnect(cid) -
удаление наблюдателя с идентификатором соединения cid
-
on_clicked(func) -
При нажатии кнопки вызывайте func с событием.
Возвращается идентификатор соединения. Он может быть использован для отключения кнопки от обратного вызова.
-
class matplotlib.widgets.CheckButtons(ax, labels, actives) -
Наследуется от
matplotlib.widgets.AxesWidgetGUI-нейтральный набор флажков.
Для сохранения отзывчивости флажков необходимо сохранить ссылку на этот объект.
Доступны следующие атрибуты:
- ax
- Экземпляр
matplotlib.axes.Axes, в котором находятся кнопки. - labels
- Список экземпляров
matplotlib.text.Text - lines
- Список кортежей (line1, line2) для символов x в флажках. Эти линии существуют для каждого поля, но имеют
set_visible(False)когда его поле не отмечено. - rectangles
- Список экземпляров
matplotlib.patches.Rectangle
Подключитесь к CheckButtons с помощью метода
on_clicked()Добавление флажков в экземпляр
matplotlib.axes.Axesax- labels
- Список меток длиной buttons в виде строк
- actives
-
- Список булевых значений длиной buttons, указывающих,
- активна ли кнопка
-
disconnect(cid) -
удаление наблюдателя с идентификатором соединения cid
-
get_status() -
возвращает кортеж статусов (True/False) всех флажков
-
on_clicked(func) -
При нажатии кнопки вызывайте func с меткой кнопки
Возвращается идентификатор соединения, который может быть использован для отключения
-
set_active(index) -
Прямое (де)активация флажка по индексу.
- index – индекс в исходном списке меток,
- с которым был создан этот объект. Возбуждает ValueError, если index некорректен.
Обратные вызовы будут вызваны, если
eventsonравно True.
-
class matplotlib.widgets.Cursor(ax, horizOn=True, vertOn=True, useblit=False, **lineprops) -
Наследуется от
matplotlib.widgets.AxesWidgetГоризонтальная и вертикальная линия, охватывающая область и перемещающаяся вместе с указателем. Вы можете отключить горизонтальную или вертикальную линию соответственно с помощью следующих атрибутов:
- horizOn
- Управляет видимостью горизонтальной линии
- vertOn
- Управляет видимостью горизонтальной линии
а также видимость курсора с помощью атрибута visible.
Для сохранения отзывчивости курсора необходимо сохранить ссылку на него.
Добавление курсора в ax. Если
useblit=True, используйте функции сглаживания, зависящие от бэкенда, для более быстрых обновлений (только GTKAgg на данный момент). lineprops — словарь свойств линии.-
clear(event) -
очистка курсора
-
onmove(event) -
при движении мыши отрисовать курсор, если он виден
-
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) -
Наследуется от
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'.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)
-
class matplotlib.widgets.Lasso(ax, xy, callback=None, useblit=True) -
Базы:
matplotlib.widgets.AxesWidgetКривая выделения произвольной формы.
Выбранный путь может быть использован совместно с
contains_point()для выбора точек данных на изображении.В отличие от
LassoSelector, это должно быть инициализировано с начальной точкиxy, и событияLassoуничтожаются при отпускании.Параметры:
-
ax : Axes - Родительские оси для виджета.
-
xy : array - Координаты начала лассо.
-
callback : function - При отпускании лассо вызывается функция
callback, которой передаются вершины выбранного пути.
-
onmove(event)
-
onrelease(event)
-
-
class matplotlib.widgets.LassoSelector(ax, onselect=None, useblit=True, lineprops=None, button=None) -
Базы:
matplotlib.widgets._SelectorWidgetКривая выделения произвольной формы.
Чтобы селектор оставался отзывчивым, необходимо сохранить на него ссылку.
Выбранный путь может быть использован совместно с
contains_point()для выбора точек данных на изображении.В отличие от
Lasso,LassoSelectorнаписан с интерфейсом, похожим наRectangleSelectorиSpanSelector, и будет продолжать взаимодействовать с осями до разъединения.Параметры:
-
ax : Axes - Родительские оси для виджета.
-
onselect : function - При отпускании лассо вызывается функция
onselect, которой передаются вершины выбранного пути.
Пример использования:
ax = subplot(111) ax.plot(x,y) def onselect(verts): print(verts) lasso = LassoSelector(ax, onselect) *button* is a list of integers indicating which mouse buttons should be used for rectangle selection. You can also specify a single integer if only a single button is desired. Default is *None*, which does not limit which button can be used. Note, typically: 1 = left mouse button 2 = center mouse button (scroll wheel) 3 = right mouse button-
onpress(event)
-
onrelease(event)
-
-
class matplotlib.widgets.LockDraw -
Базы:
objectНекоторые виджеты, такие как курсор, рисуют на холсте, и это нежелательно во всех случаях, например, когда панель инструментов находится в режиме масштабирования по прямоугольнику, и рисуется прямоугольник. Модульный «замок» позволяет кому-то захватить замок и предотвратить рисование других виджетов. Используйте
matplotlib.widgets.lock(someobj)для предотвращения рисования других виджетов во время взаимодействия с холстом.-
available(o) -
рисование доступно для o
-
isowner(o) -
Возвращает True, если o владеет этим замком
-
locked() -
Возвращает True, если замок в настоящее время удерживается владельцем
-
release(o) -
освободить замок
-
-
class matplotlib.widgets.MultiCursor(canvas, axes, useblit=True, horizOn=False, vertOn=True, **lineprops) -
Базы:
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) -
очистить курсор
-
connect() -
подключить события
-
disconnect() -
отключить события
-
onmove(event)
-
-
class matplotlib.widgets.PolygonSelector(ax, onselect, useblit=False, lineprops=None, markerprops=None, vertex_select_radius=15) -
Базы:
matplotlib.widgets._SelectorWidgetВыбор области многоугольника на осях.
Размещайте вершины при каждом щелчке мыши и делайте выбор, завершая многоугольник (щелчок на первой вершине). Удерживайте клавишу ctrl и щелкайте и перетаскивайте вершину, чтобы переместить ее (клавиша ctrl не нужна, если многоугольник уже завершен). Удерживайте клавишу shift и щелкайте и перетаскивайте в любом месте осей, чтобы переместить все вершины. Нажмите клавишу esc, чтобы начать новый многоугольник.
Чтобы селектор оставался отзывчивым, необходимо сохранить на него ссылку.
Параметры: ax :
AxesРодительские оси для виджета.
onselect : функция
Когда многоугольник завершен или изменен после завершения, вызывается функция
onselect, которой передается список вершин как(xdata, ydata)кортежи.useblit : bool, необязательно
lineprops : dict, необязательно
Линия для сторон многоугольника рисуется с заданными свойствами
lineprops. По умолчаниюdict(color='k', linestyle='-', linewidth=2, alpha=0.5).markerprops : dict, необязательно
Маркеры для вершин многоугольника рисуются с заданными свойствами
markerprops. По умолчаниюdict(marker='o', markersize=7, mec='k', mfc='k', alpha=0.5).vertex_select_radius : float, необязательно
Вершина выделяется (чтобы завершить многоугольник или переместить вершину), если щелчок мышью находится в пределах
vertex_select_radiusпикселей от вершины. Радиус по умолчанию составляет 15 пикселей.См. также
-
onmove(event) -
Обработчик и валидатор события перемещения курсора
-
verts -
Получить вершины многоугольника.
Возвращает: список
Список вершин многоугольника как
(xdata, ydata)кортежи.
-
-
class matplotlib.widgets.RadioButtons(ax, labels, active=0, activecolor='blue') -
Базы:
matplotlib.widgets.AxesWidgetНейтральная кнопка радио для пользовательского интерфейса.
Следующие атрибуты доступны:
- ax
- Экземпляр
matplotlib.axes.Axes, в котором находятся кнопки - activecolor
- Цвет кнопки при нажатии
- labels
- Список экземпляров
matplotlib.text.Text - circles
- Список экземпляров
matplotlib.patches.Circle - value_selected
- Строка, перечисляющая текущее выбранное значение
Подключитесь к RadioButtons с помощью метода
on_clicked()Добавьте кнопки радио к экземпляру
matplotlib.axes.Axesax- labels
- Список меток длиной len(buttons) в виде строк
- active
- Индекс в метках для активной кнопки
- activecolor
- Цвет кнопки при нажатии
-
disconnect(cid) -
удалить наблюдателя с идентификатором соединения cid
-
on_clicked(func) -
При нажатии кнопки вызовите func с меткой кнопки
Возвращается идентификатор соединения, который можно использовать для отключения
-
set_active(index) -
Срабатывание, для того, чтобы сделать активной определенную кнопку радио.
- 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) -
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'.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)
-
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, **kwargs) -
Bases:
matplotlib.widgets.AxesWidgetПолзунок, представляющий диапазон с плавающей точкой.
Создайте ползунок от
valminдоvalmaxна осяхax. Для сохранения отзывчивости ползунка необходимо сохранить ссылку на него.Вызовите
on_changed()для подключения к событию ползункаПараметры: ax : Axes
Оси, в которые помещается ползунок.
label : str
Подпись ползунка.
valmin : float
Минимальное значение ползунка.
valmax : float
Максимальное значение ползунка.
valinit : float, необязательно, по умолчанию: 0.5
Начальное положение ползунка.
valfmt : str, необязательно, по умолчанию: “%1.2f”
Используется для форматирования значения ползунка, строка формата fprint.
closedmin : bool, необязательно, по умолчанию: True
Указывает, является ли интервал ползунка замкнутым слева.
closedmax : bool, необязательно, по умолчанию: True
Указывает, является ли интервал ползунка замкнутым справа.
slidermin : Slider, необязательно, по умолчанию: None
Не допускает, чтобы текущий ползунок имел значение меньше значения ползунка
slidermin.slidermax : Slider, необязательно, по умолчанию: None
Не допускает, чтобы текущий ползунок имел значение больше значения ползунка
slidermax.dragging : bool, необязательно, по умолчанию: True
Если True, ползунок можно перетаскивать мышью.
Примечания
Дополнительные kwargs передаются в
self.poly, который являетсяRectangle, рисующим элемент управления ползунком. См. документациюRectangleдля допустимых имен свойств (например,facecolor,edgecolor,alpha).-
disconnect(cid) -
удаляет наблюдателя с идентификатором соединения cid
-
on_changed(func) -
При изменении значения ползунка вызовите func с новым положением ползунка
Возвращается идентификатор соединения, который может использоваться для отключения
-
reset() -
при необходимости сбросить ползунок до начального значения
-
set_val(val)
-
-
class matplotlib.widgets.SpanSelector(ax, onselect, direction, minspan=None, useblit=False, rectprops=None, onmove_callback=None, span_stays=False, button=None) -
Bases:
matplotlib.widgets._SelectorWidgetВизуально выбирает диапазон min/max на одной оси и вызывает функцию со значениями.
Для обеспечения отзывчивости селектора сохраняйте ссылку на него.
Для отключения SpanSelector установите
span_selector.active=False. Чтобы включить его снова, установитеspan_selector.active=True.Параметры: ax :
matplotlib.axes.Axesобъектonselect : func(min, max), min/max — числа с плавающей точкой
direction : “horizontal” или “vertical”
Ось, вдоль которой рисовать SpanSelector
minspan : float, по умолчанию None
Если выбор меньше minspan, не вызывайте onselect
useblit : bool, по умолчанию False
Если True, используйте функции блиттинга, зависящие от бэкенда, для более быстрого обновления холста. В настоящее время доступно только для GTKAgg.
rectprops : dict, по умолчанию None
Словарь свойств
matplotlib.patches.Patchonmove_callback : func(min, max), min/max — числа с плавающей точкой, по умолчанию None
Вызывается при перемещении мыши во время выбора отрезка
span_stays : bool, по умолчанию False
Если True, отрезок остается видимым после отпускания мыши
button : int или список целых чисел
- Определяет, какие кнопки мыши активируют SpanSelector
-
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()См. также: Span Selector
-
ignore(event) -
возвращает True, если event следует игнорировать
-
new_axes(ax) -
Устанавливает SpanSelector для работы с новыми осями
-
class matplotlib.widgets.SubplotTool(targetfig, toolfig) -
Bases:
matplotlib.widgets.WidgetИнструмент для настройки параметров subplot для
matplotlib.figure.Figure.- targetfig
- Экземпляр фигуры для настройки.
- toolfig
- Экземпляр фигуры, в которую нужно встроить инструмент subplot. Если None, будет создана фигура по умолчанию. Если вы используете это из GUI
-
funcbottom(val)
-
funchspace(val)
-
funcleft(val)
-
funcright(val)
-
functop(val)
-
funcwspace(val)
-
class matplotlib.widgets.TextBox(ax, label, initial='', color='.95', hovercolor='1', label_pad=0.01) -
Основы:
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 : цвет
Цвет поля.
hovercolor : цвет
Цвет поля при наведении курсора.
label_pad : float
расстояние между меткой и правой стороной поля ввода.
-
begin_typing(x)
-
disconnect(cid) -
удаляет наблюдателя с идентификатором соединения cid
-
on_submit(func) -
При нажатии Enter или выходе из поля ввода, вызовите эту функцию func с событием.
Возвращается идентификатор соединения, который можно использовать для отключения.
-
on_text_change(func) -
При изменении текста вызовите эту функцию func с событием.
Возвращается идентификатор соединения, который можно использовать для отключения.
-
position_cursor(x)
-
set_val(val)
-
stop_typing()
-
class matplotlib.widgets.ToolHandles(ax, x, y, marker='o', marker_props=None, useblit=True) -
Основы:
objectУправляющие маркеры для инструментов холста.
Параметры: ax :
matplotlib.axes.AxesОси Matplotlib, где отображаются управляющие маркеры.
x, y : 1D массивы
Координаты управляющих маркеров.
marker : str
Форма маркера, используемого для отображения маркера. См.
matplotlib.pyplot.plot.marker_props : dict
Дополнительные свойства маркера. См.
matplotlib.lines.Line2D.-
closest(x, y) -
Возвращает индекс и пиксельное расстояние до ближайшего индекса.
-
set_animated(val)
-
set_data(pts, y=None) -
Устанавливает x и y координаты маркеров.
-
set_visible(val)
-
x
-
y
-
-
class matplotlib.widgets.Widget -
Основы:
objectАбстрактный базовый класс для графических элементов, не зависящих от графической среды.
-
active -
Является ли элемент активным?
-
drawon = True
-
eventson = True
-
get_active() -
Получить, активен ли элемент.
-
ignore(event) -
Возвращает True, если событие должно быть проигнорировано.
Этот метод (или его версия) должен вызываться в начале любого обработчика событий.
-
set_active(active) -
Установить, активен ли элемент.
-
© 2012–2017 Matplotlib Development Team. All rights reserved.
Licensed under the Matplotlib License Agreement.
http://matplotlib.org/2.1.0/api/widgets_api.html