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.AxesWidgetGUI-нейтральная кнопка.
Для сохранения отзывчивости кнопки необходимо сохранить ссылку на неё. Вызовите
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.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.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] -
При движении мыши отрисовка курсора, если он виден
-
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] -
освободить блокировку
-
-
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.Axesax- 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