matplotlib.backend_tools

Абстрактные базовые классы определяют примитивы для инструментов. Эти инструменты используются matplotlib.backend_managers.ToolManager

ToolBase

Простой бессостоятельный инструмент

ToolToggleBase

Инструмент, имеющий два состояния, только один инструмент Toggle может быть активным в любой момент времени для одного и того же matplotlib.backend_managers.ToolManager

class matplotlib.backend_tools.AxisScaleBase(*args, **kwargs) [source]

Bases: matplotlib.backend_tools.ToolToggleBase

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

disable(self, event) [source]

Отключить инструмент переключения

trigger вызовет этот метод, когда toggled равно True.

Это может произойти в разных ситуациях

• Нажатие на кнопку инструмента в панели инструментов
• Вызов matplotlib.backend_managers.ToolManager.trigger_tool
• Другой инструмент, производный от ToolToggleBase (из того же ToolManager)

enable(self, event) [source]

Включить инструмент переключения

trigger вызывает этот метод, когда toggled равно False

trigger(self, sender, event, data=None) [source]

Вызывает enable или disable в зависимости от значения toggled

class matplotlib.backend_tools.ConfigureSubplotsBase(toolmanager, name) [source]

Bases: matplotlib.backend_tools.ToolBase

Базовый инструмент для настройки подграфиков

description = 'Configure subplots'

image = 'subplots'

class matplotlib.backend_tools.Cursors [source]

Bases: object

Простой пространство имён для ссылок на курсоры

HAND = 0

MOVE = 3

POINTER = 1

SELECT_REGION = 2

WAIT = 4

class matplotlib.backend_tools.RubberbandBase(toolmanager, name) [source]

Bases: matplotlib.backend_tools.ToolBase

Отрисовка и удаление резиновой рамки

draw_rubberband(self, *data) [source]

Отрисовка резиновой рамки

Этот метод должен быть реализован для каждого бэкенда

remove_rubberband(self) [source]

Удаление резиновой рамки

Этот метод должен быть реализован для каждого бэкенда

trigger(self, sender, event, data) [source]

Вызов draw_rubberband или remove_rubberband в зависимости от данных

class matplotlib.backend_tools.SaveFigureBase(toolmanager, name) [source]

Bases: matplotlib.backend_tools.ToolBase

Базовый инструмент для сохранения рисунка

default_keymap = ['s', 'ctrl+s']

description = 'Save the figure'

image = 'filesave'

class matplotlib.backend_tools.SetCursorBase(*args, **kwargs) [source]

Bases: matplotlib.backend_tools.ToolBase

Изменение текущего курсора во время работы с осями

Этот инструмент отслеживает все инструменты, производные от ToolToggleBase, и вызывает set_cursor при срабатывании инструмента

set_cursor(self, cursor) [source]

Установить курсор

Этот метод должен быть реализован для каждого бэкенда

set_figure(self, figure) [source]

Присвоить инструменту фигуру

Parameters:	figure : Figure

class matplotlib.backend_tools.ToolBack(toolmanager, name) [source]

Bases: matplotlib.backend_tools.ViewsPositionsBase

Перейти на предыдущий уровень в стеке ограничений отображения

default_keymap = ['left', 'c', 'backspace', 'MouseButton.BACK']

description = 'Back to previous view'

image = 'back'

class matplotlib.backend_tools.ToolBase(toolmanager, name) [source]

Bases: object

Базовый класс инструмента

Базовый инструмент, реализующий только метод trigger или вообще не реализующий его. Инструмент инициализируется matplotlib.backend_managers.ToolManager

Атрибуты:	toolmanager : matplotlib.backend_managers.ToolManager Менеджер инструментов, контролирующий этот инструмент figure : FigureCanvas Экземпляр Figure, на который влияет этот инструмент name : string Идентификатор инструмента

canvas

default_keymap = None

Схема управления клавишами для этого инструмента

Строка: Список разделённых запятыми клавиш, которые будут использоваться для вызова этого инструмента при возникновении события нажатия клавиши на self.figure.canvas

description = None

Описание инструмента

Строка: Если инструмент включён в панель инструментов, этот текст используется в качестве всплывающей подсказки

destroy(self) [source]

Уничтожить инструмент

Этот метод вызывается при удалении инструмента с помощью matplotlib.backend_managers.ToolManager.remove_tool

figure

image = None

Имя файла изображения

Строка: Имя файла изображения, используемого в панели инструментов. Если None, то name используется в качестве метки на кнопке панели инструментов

name

Идентификатор инструмента

set_figure(self, figure) [source]

Присвоить инструменту фигуру

Параметры:	figure : Figure

toolmanager

trigger(self, sender, event, data=None) [source]

Вызывается при использовании этого инструмента

Этот метод вызывается matplotlib.backend_managers.ToolManager.trigger_tool

Параметры:	event : Event Событие Canvas, вызвавшее этот инструмент sender : object Объект, запросивший запуск инструмента data : object Дополнительные данные

matplotlib.backend_tools.ToolCopyToClipboard

псевдоним для matplotlib.backend_tools.ToolCopyToClipboardBase

class matplotlib.backend_tools.ToolCopyToClipboardBase(toolmanager, name) [source]

Bases: matplotlib.backend_tools.ToolBase

Инструмент для копирования фигуры в буфер обмена

default_keymap = ['ctrl+c', 'cmd+c']

description = 'Copy the canvas figure to clipboard'

trigger(self, *args, **kwargs) [source]

Вызывается при использовании этого инструмента

Этот метод вызывается matplotlib.backend_managers.ToolManager.trigger_tool

Параметры:	event : Event Событие Canvas, вызвавшее этот инструмент sender : object Объект, запросивший запуск инструмента data : object Дополнительные данные

class matplotlib.backend_tools.ToolCursorPosition(*args, **kwargs) [source]

Bases: matplotlib.backend_tools.ToolBase

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

Этот инструмент работает в фоновом режиме, сообщая о позиции курсора

send_message(self, event) [source]

Вызов matplotlib.backend_managers.ToolManager.message_event

set_figure(self, figure) [source]

Присвоить инструменту фигуру

Параметры:	figure : Figure

class matplotlib.backend_tools.ToolEnableAllNavigation(toolmanager, name) [source]

Bases: matplotlib.backend_tools.ToolBase

Инструмент для активации всех осей для взаимодействия с toolmanager

default_keymap = ['a']

description = 'Enable all axes toolmanager'

trigger(self, sender, event, data=None) [source]

Вызывается при использовании этого инструмента

Этот метод вызывается matplotlib.backend_managers.ToolManager.trigger_tool

Параметры:	event : Event Событие Canvas, вызвавшее этот инструмент sender : object Объект, запросивший запуск инструмента data : object Дополнительные данные

class matplotlib.backend_tools.ToolEnableNavigation(toolmanager, name) [source]

Основы: matplotlib.backend_tools.ToolBase

Инструмент для активации определённой оси для взаимодействия с менеджером инструментов

default_keymap = (1, 2, 3, 4, 5, 6, 7, 8, 9)

description = 'Enable one axes toolmanager'

trigger(self, sender, event, data=None) [source]

Вызывается при использовании этого инструмента

Этот метод вызывается matplotlib.backend_managers.ToolManager.trigger_tool

Параметры:	event : Event Событие холста, которое вызвало этот инструмент sender : object Объект, который запросил запуск инструмента data : object Дополнительные данные

class matplotlib.backend_tools.ToolForward(toolmanager, name) [source]

Основы: matplotlib.backend_tools.ViewsPositionsBase

Переход вперёд в стеке пределов отображения

default_keymap = ['right', 'v', 'MouseButton.FORWARD']

description = 'Forward to next view'

image = 'forward'

class matplotlib.backend_tools.ToolFullScreen(*args, **kwargs) [source]

Основы: matplotlib.backend_tools.ToolToggleBase

Инструмент для переключения полноэкранного режима

default_keymap = ['f', 'ctrl+f']

description = 'Toggle fullscreen mode'

disable(self, event) [source]

Отключение инструмента переключения

trigger вызовите этот метод, когда toggled равно True.

Это может произойти в разных обстоятельствах

• Нажатие на кнопку инструмента в панели инструментов
• Вызов matplotlib.backend_managers.ToolManager.trigger_tool
• Запускается другой инструмент, производный от ToolToggleBase (из того же ToolManager)

enable(self, event) [source]

Включение инструмента переключения

trigger вызывает этот метод, когда toggled равно False

class matplotlib.backend_tools.ToolGrid(toolmanager, name) [source]

Основы: matplotlib.backend_tools._ToolGridBase

Инструмент для переключения основных сеток фигуры

default_keymap = ['g']

description = 'Toggle major grids'

class matplotlib.backend_tools.ToolHelpBase(toolmanager, name) [source]

Основы: matplotlib.backend_tools.ToolBase

default_keymap = ['f1']

description = 'Print tool list, shortcuts and description'

static format_shortcut(key_sequence) [source]

Преобразует строку ярлыка из обозначения, используемого в конфигурации rc, в стандартное обозначение для отображения ярлыков, например, 'ctrl+a' -> 'Ctrl+A'.

image = 'help.png'

class matplotlib.backend_tools.ToolHome(toolmanager, name) [source]

Основы: matplotlib.backend_tools.ViewsPositionsBase

Восстановление исходных пределов отображения

default_keymap = ['h', 'r', 'home']

description = 'Reset original view'

image = 'home'

class matplotlib.backend_tools.ToolMinorGrid(toolmanager, name) [source]

Основы: matplotlib.backend_tools._ToolGridBase

Инструмент для переключения основных и дополнительных сеток фигуры

default_keymap = ['G']

description = 'Toggle major and minor grids'

class matplotlib.backend_tools.ToolPan(*args) [source]

Основы: matplotlib.backend_tools.ZoomPanBase

Панорамирование осей левой кнопкой мыши, масштабирование правой

cursor = 3

default_keymap = ['p']

description = 'Pan axes with left mouse, zoom with right'

image = 'move'

radio_group = 'default'

class matplotlib.backend_tools.ToolQuit(toolmanager, name) [source]

Основы: matplotlib.backend_tools.ToolBase

Инструмент для вызова метода уничтожения менеджера фигуры

default_keymap = ['ctrl+w', 'cmd+w', 'q']

description = 'Quit the figure'

trigger(self, sender, event, data=None) [source]

Вызывается при использовании этого инструмента

Этот метод вызывается matplotlib.backend_managers.ToolManager.trigger_tool

Параметры:	event : Event Событие холста, которое вызвало этот инструмент sender : object Объект, который запросил запуск инструмента data : object Дополнительные данные

class matplotlib.backend_tools.ToolQuitAll(toolmanager, name) [source]

Основы: matplotlib.backend_tools.ToolBase

Инструмент для вызова метода уничтожения менеджера фигур

default_keymap = ['W', 'cmd+W', 'Q']

description = 'Quit all figures'

trigger(self, sender, event, data=None) [source]

Вызывается при использовании этого инструмента

Этот метод вызывается методом matplotlib.backend_managers.ToolManager.trigger_tool

Параметры:	event : Event Событие холста, которое вызвало вызов этого инструмента sender : object Объект, который запросил запуск инструмента data : object Дополнительные данные

class matplotlib.backend_tools.ToolToggleBase(*args, **kwargs) [source]

Основы: matplotlib.backend_tools.ToolBase

Инструмент переключения

Каждый раз при его запуске он переключается между включением и выключением

Параметры:	``*args`` Аргумент переменной длины, используемый инструментом ``**kwargs`` toggled, если присутствует и True, устанавливает начальное состояние инструмента. Произвольные ключевые аргументы для потребления инструментом.

cursor = None

Курсор, используемый, когда инструмент активен

default_toggled = False

Значение состояния переключения по умолчанию

disable(self, event=None) [source]

Отключить инструмент переключения

trigger вызывает этот метод, когда toggled равно True.

Это может произойти в разных обстоятельствах

• Нажатие на кнопку инструмента на панели инструментов
• Вызов matplotlib.backend_managers.ToolManager.trigger_tool
• Другой инструмент, производный от ToolToggleBase (из той же ToolManager)

enable(self, event=None) [source]

Включить инструмент переключения

trigger вызывает этот метод, когда toggled равно False

radio_group = None

Атрибут для группирования инструментов типа 'radio' (взаимоисключающие)

Строка, которая идентифицирует группу, или None, если она не принадлежит к группе

set_figure(self, figure) [source]

Назначение фигуры инструменту

Параметры:	figure : Figure

toggled

Состояние переключаемого инструмента

trigger(self, sender, event, data=None) [source]

Вызывает enable или disable в зависимости от значения toggled

class matplotlib.backend_tools.ToolViewsPositions(*args, **kwargs) [source]

Bases: matplotlib.backend_tools.ToolBase

Вспомогательный инструмент для обработки изменений представлений и позиций

Работает в фоновом режиме и должен использоваться всеми инструментами, которым требуется доступ к истории представлений и позиций фигуры, например:

• ToolZoom
• ToolPan
• ToolHome
• ToolBack
• ToolForward

add_figure(self, figure) [source]

Добавить текущую фигуру в стек представлений и позиций

back(self) [source]

Назад на один шаг в стеке представлений и позиций

clear(self, figure) [source]

Сбросить стек осей

forward(self) [source]

Вперед на один шаг в стеке представлений и позиций

home(self) [source]

Вернуться к первому представлению и позиции из стека

push_current(self, figure=None) [source]

Положить текущие пределы представления и позицию в соответствующие стеки

refresh_locators(self) [source]

Перерисовать холсты, обновить локаторы

update_home_views(self, figure=None) [source]

Убедиться, что self.home_views имеет запись для всех осей, присутствующих в фигуре

update_view(self) [source]

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

class matplotlib.backend_tools.ToolXScale(*args, **kwargs) [source]

Bases: matplotlib.backend_tools.AxisScaleBase

Инструмент для переключения между линейными и логарифмическими масштабами по оси X

default_keymap = ['k', 'L']

description = 'Toggle scale X axis'

set_scale(self, ax, scale) [source]

class matplotlib.backend_tools.ToolYScale(*args, **kwargs) [source]

Bases: matplotlib.backend_tools.AxisScaleBase

Инструмент для переключения между линейными и логарифмическими масштабами по оси Y

default_keymap = ['l']

description = 'Toggle scale Y axis'

set_scale(self, ax, scale) [source]

class matplotlib.backend_tools.ToolZoom(*args) [source]

Bases: matplotlib.backend_tools.ZoomPanBase

Масштабирование к прямоугольнику

cursor = 2

default_keymap = ['o']

description = 'Zoom to rectangle'

image = 'zoom_to_rect'

radio_group = 'default'

class matplotlib.backend_tools.ViewsPositionsBase(toolmanager, name) [source]

Bases: matplotlib.backend_tools.ToolBase

Базовый класс для ToolHome, ToolBack и ToolForward

trigger(self, sender, event, data=None) [source]

Вызывается при использовании данного инструмента

Этот метод вызывается matplotlib.backend_managers.ToolManager.trigger_tool

Параметры:	event : Event Событие холста, вызвавшее запуск этого инструмента sender : object Объект, запросивший запуск инструмента data : object Дополнительные данные

class matplotlib.backend_tools.ZoomPanBase(*args) [source]

Базовый класс для ToolZoom и ToolPan

Базовый класс для matplotlib.backend_tools.ToolToggleBase

disable(self, event) [source]

Освобождение холста и отключение событий нажатия/отпускания

enable(self, event) [source]

Подключение событий нажатия/отпускания и блокировка холста

scroll_zoom(self, event) [source]

trigger(self, sender, event, data=None) [source]

Вызов enable или disable в зависимости от значения toggled

matplotlib.backend_tools.add_tools_to_container(container, tools=[['navigation', ['home', 'back', 'forward']], ['zoompan', ['pan', 'zoom', 'subplots']], ['io', ['save', 'help']]]) [source]

Добавление нескольких инструментов в контейнер.

Параметры:	container : Container Объект, которому будут добавлены инструменты tools : list, optional Список в формате [[группа1, [инструмент1, инструмент2 ...]], [группа2, [...]]]. Инструменты, такие как инструмент1 и инструмент2, будут отображаться в группе1. Подробности см. в add_tool.

matplotlib.backend_tools.add_tools_to_manager(toolmanager, tools={'home': <class 'matplotlib.backend_tools.ToolHome'>, 'back': <class 'matplotlib.backend_tools.ToolBack'>, 'forward': <class 'matplotlib.backend_tools.ToolForward'>, 'zoom': <class 'matplotlib.backend_tools.ToolZoom'>, 'pan': <class 'matplotlib.backend_tools.ToolPan'>, 'subplots': 'ToolConfigureSubplots', 'save': 'ToolSaveFigure', 'grid': <class 'matplotlib.backend_tools.ToolGrid'>, 'grid_minor': <class 'matplotlib.backend_tools.ToolMinorGrid'>, 'fullscreen': <class 'matplotlib.backend_tools.ToolFullScreen'>, 'quit': <class 'matplotlib.backend_tools.ToolQuit'>, 'quit_all': <class 'matplotlib.backend_tools.ToolQuitAll'>, 'allnav': <class 'matplotlib.backend_tools.ToolEnableAllNavigation'>, 'nav': <class 'matplotlib.backend_tools.ToolEnableNavigation'>, 'xscale': <class 'matplotlib.backend_tools.ToolXScale'>, 'yscale': <class 'matplotlib.backend_tools.ToolYScale'>, 'position': <class 'matplotlib.backend_tools.ToolCursorPosition'>, 'viewpos': <class 'matplotlib.backend_tools.ToolViewsPositions'>, 'cursor': 'ToolSetCursor', 'rubberband': 'ToolRubberband', 'help': 'ToolHelp', 'copy': 'ToolCopyToClipboard'}) [source]

Добавление нескольких инструментов в ToolManager

Параметры:	toolmanager : ToolManager Объект, которому будут добавлены инструменты tools : {str: class_like}, optional Инструменты для добавления в словаре {имя: инструмент}. Дополнительную информацию см. в add_tool.

matplotlib.backend_tools.default_toolbar_tools = [['navigation', ['home', 'back', 'forward']], ['zoompan', ['pan', 'zoom', 'subplots']], ['io', ['save', 'help']]]

Инструменты по умолчанию в панели инструментов

matplotlib.backend_tools.default_tools = {'allnav': <class 'matplotlib.backend_tools.ToolEnableAllNavigation'>, 'back': <class 'matplotlib.backend_tools.ToolBack'>, 'copy': 'ToolCopyToClipboard', 'cursor': 'ToolSetCursor', 'forward': <class 'matplotlib.backend_tools.ToolForward'>, 'fullscreen': <class 'matplotlib.backend_tools.ToolFullScreen'>, 'grid': <class 'matplotlib.backend_tools.ToolGrid'>, 'grid_minor': <class 'matplotlib.backend_tools.ToolMinorGrid'>, 'help': 'ToolHelp', 'home': <class 'matplotlib.backend_tools.ToolHome'>, 'nav': <class 'matplotlib.backend_tools.ToolEnableNavigation'>, 'pan': <class 'matplotlib.backend_tools.ToolPan'>, 'position': <class 'matplotlib.backend_tools.ToolCursorPosition'>, 'quit': <class 'matplotlib.backend_tools.ToolQuit'>, 'quit_all': <class 'matplotlib.backend_tools.ToolQuitAll'>, 'rubberband': 'ToolRubberband', 'save': 'ToolSaveFigure', 'subplots': 'ToolConfigureSubplots', 'viewpos': <class 'matplotlib.backend_tools.ToolViewsPositions'>, 'xscale': <class 'matplotlib.backend_tools.ToolXScale'>, 'yscale': <class 'matplotlib.backend_tools.ToolYScale'>, 'zoom': <class 'matplotlib.backend_tools.ToolZoom'>}

Инструменты по умолчанию