matplotlib.backend_bases

Абстрактные базовые классы определяют примитивы, которые должны реализовывать рендеры и графические контексты, чтобы служить бэкендом Matplotlib.

RendererBase: Абстрактный базовый класс для обработки операций рисования/рендеринга.
FigureCanvasBase: Уровень абстракции, который отделяет Figure от специфичных для бэкенда деталей, таких как область рисования пользовательского интерфейса.
GraphicsContextBase: Абстрактный базовый класс, предоставляющий цвета, стили линий и т. д.
Event: Базовый класс для всей обработки событий Matplotlib. Производные классы, такие как KeyEvent и MouseEvent, хранят метаданные, такие как нажатые клавиши и кнопки, координаты x и y в пикселях и координатах Axes.
ShowBase: Базовый класс для класса Show каждого интерактивного бэкенда; вызов «show» затем устанавливается в Show.__call__.
ToolContainerBase: Базовый класс для класса Панель инструментов каждого интерактивного бэкенда.

classmatplotlib.backend_bases.CloseEvent(name, canvas, guiEvent=None)[source]

Базы: Event

Событие, срабатывающее при закрытии фигуры.

classmatplotlib.backend_bases.DrawEvent(name, canvas, renderer)[source]

Базы: Event

Событие, срабатывающее при выполнении операции рисования на холсте.

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

Предупреждение

Вызов canvas.draw и canvas.blit в этих обработчиках может быть небезопасным для всех бэкендов и может привести к бесконечной рекурсии.

У DrawEvent есть ряд специальных атрибутов помимо тех, которые определены родительским классом Event.

Атрибуты:

rendererRendererBase: Рендер для события рисования.

classmatplotlib.backend_bases.Event(name, canvas, guiEvent=None)[source]

Базы: object

Событие Matplotlib.

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

Атрибуты:

namestr: Имя события.
canvasFigureCanvasBase: Экземпляр бэкенд-специфичного холста, генерирующий событие.
guiEvent: Событие графического интерфейса, которое вызвало событие Matplotlib.

classmatplotlib.backend_bases.FigureCanvasBase(figure=None)[source]

END_OF_DOCUMENT_MARKER

Базы: object

Поверхность холста, на которую отрисовывается фигура.

Атрибуты:

figurematplotlib.figure.Figure: Экземпляр фигуры высокого уровня.

blit(bbox=None)[source]: Отрисовка холста в области bbox (по умолчанию весь холст).

propertybutton_pick_id

button_press_event(x, y, button, dblclick=False, guiEvent=None)[source]

[Устарело] Обработка событий нажатия клавиш мыши.

Классы, производные от бэкенда, должны вызывать эту функцию при любом нажатии кнопки мыши. (x, y) — координаты холста (0, 0) — в нижнем левом углу. Кнопка и клавиша определяются в MouseEvent.

Этот метод вызовет все функции, связанные с 'button_press_event', с экземпляром MouseEvent.

Примечания

Устарело начиная с версии 3.6: Используйте callbacks.process('button_press_event', MouseEvent(...)) вместо этого.

button_release_event(x, y, button, guiEvent=None)[source]

[Устарело] Обработка событий отпускания кнопок мыши.

Производные классы бэкенда должны вызывать эту функцию при отпускании любой кнопки мыши.

Этот метод вызовет все функции, связанные с 'button_release_event', с экземпляром MouseEvent.

Параметры:

xfloat: Координаты холста, где 0=слева.
yfloat: Координаты холста, где 0=снизу.
guiEvent: Природное событие пользовательского интерфейса, породившее событие Matplotlib.

Примечания

Устарело начиная с версии 3.6: Используйте callbacks.process('button_release_event', MouseEvent(...)) вместо этого.

propertycallbacks

close_event(guiEvent=None)[source]: [Устарело] Передает CloseEvent всем функциям, связанным с close_event.

Примечания

Устарело начиная с версии 3.6: Используйте callbacks.process('close_event', CloseEvent(...)) вместо этого.

propertydevice_pixel_ratio

Соотношение физических и логических пикселей, используемых для холста на экране.

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

draw(*args, **kwargs)[source]

Отрисовка Figure.

Этот метод должен пройти по дереву элементов, даже если вывод не создается, потому что это запускает отложенную работу, к которой пользователи могут получить доступ перед сохранением вывода на диск. Например, вычисление пределов, автоматических пределов и значений делений.

draw_event(renderer)[source]: [Устарело] Передает DrawEvent всем функциям, связанным с draw_event.

Примечания

Устарело начиная с версии 3.6: Используйте callbacks.process('draw_event', DrawEvent(...)) вместо этого.

draw_idle(*args, **kwargs)[source]

Запрос перерисовки виджета после возвращения управления циклу событий GUI.

Даже если несколько вызовов draw_idle происходят до возвращения управления циклу событий GUI, фигура будет отрисована только один раз.

Примечания

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

enter_notify_event(guiEvent=None, xy=None)[source]

[Устарело] Обработка событий ввода курсора мыши в область холста.

Производные классы бэкенда должны вызывать эту функцию при входе в холст.

Параметры:

guiEvent: Природное событие пользовательского интерфейса, породившее событие Matplotlib.
xy(float, float): Координаты указателя при входе в область холста.

Примечания

Устарело начиная с версии 3.6: Используйте callbacks.process('enter_notify_event', LocationEvent(...)) вместо этого.

events=['resize_event', 'draw_event', 'key_press_event', 'key_release_event', 'button_press_event', 'button_release_event', 'scroll_event', 'motion_notify_event', 'pick_event', 'figure_enter_event', 'figure_leave_event', 'axes_enter_event', 'axes_leave_event', 'close_event']

filetypes={'eps': 'Encapsulated Postscript', 'jpeg': 'Joint Photographic Experts Group', 'jpg': 'Joint Photographic Experts Group', 'pdf': 'Portable Document Format', 'pgf': 'PGF code for LaTeX', 'png': 'Portable Network Graphics', 'ps': 'Postscript', 'raw': 'Raw RGBA bitmap', 'rgba': 'Raw RGBA bitmap', 'svg': 'Scalable Vector Graphics', 'svgz': 'Scalable Vector Graphics', 'tif': 'Tagged Image File Format', 'tiff': 'Tagged Image File Format', 'webp': 'WebP Image Format'}

fixed_dpi=None

flush_events()[source]

Выполнить обработку событий графического интерфейса для фигуры.

Интерактивные бэкэнды должны реализовать этот метод.

get_default_filename()[source]: Возвращает строку, включающую расширение, подходящую для использования в качестве имени файла по умолчанию.

classmethodget_default_filetype()[source]

Возвращает формат файла сохранения по умолчанию, как указано в rcParams["savefig.format"] (по умолчанию: 'png').

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

classmethodget_supported_filetypes()[source]: Возвращает словарь форматов файлов сохранения, поддерживаемых этим бэкэндом.

classmethodget_supported_filetypes_grouped()[source]: Возвращает словарь форматов файлов сохранения, поддерживаемых этим бэкэндом, где ключи — имя типа файла, например, 'Joint Photographic Experts Group', а значения — список расширений файлов, используемых для этого типа файла, например, ['jpg', 'jpeg'].

get_width_height(*, physical=False)[source]

Возвращает ширину и высоту фигуры в целых точках или пикселях.

При использовании фигуры на экранах с высокой плотностью пикселей (и если бэкэнд её поддерживает), усечение до целых чисел происходит после масштабирования с учётом коэффициента плотности пикселей.

Параметры:

physicalbool, по умолчанию: False: Возвращать ли истинные физические пиксели или логические пиксели. Физические пиксели могут использоваться бэкендами, которые поддерживают HiDPI, но всё ещё настраивают холст, используя его фактический размер.

Возвращает:

width, heightint: Размер фигуры в точках или пикселях, в зависимости от бэкэнда.

grab_mouse(ax)[source]

Установить дочерний элемент Axes, который захватывает события мыши.

Обычно вызывается самими виджетами. Вызов этого метода, если мышь уже захвачена другим объектом Axes, является ошибкой.

inaxes(xy)[source]

Возвращает самый верхний видимый Axes, содержащий точку xy.

Параметры:

xy(float, float): (x, y) координаты пикселей от левого нижнего угла холста.

Возвращает:

Axes или None: Самый верхний видимый объект Axes, содержащий точку, или None, если в данной точке нет объекта Axes.

is_saving()[source]: Возвращает, выполняется ли сохранение в файл, или же происходит рендеринг для буфера на экране.

key_press_event(key, guiEvent=None)[source]: [Устарело] Передаёт KeyEvent во все функции, подключенные к key_press_event.

Примечания

Устарело начиная с версии 3.6: Используйте callbacks.process('key_press_event', KeyEvent(...)) вместо этого.

key_release_event(key, guiEvent=None)[source]: [Устарело] Передаёт KeyEvent во все функции, подключенные к key_release_event.

Примечания

Устарело начиная с версии 3.6: Используйте callbacks.process('key_release_event', KeyEvent(...)) вместо этого.

leave_notify_event(guiEvent=None)[source]

[Устарело] Обработка вызова для выхода курсора мыши с холста.

Производные классы бэкэндов должны вызывать эту функцию при выходе с холста.

Параметры:

guiEvent: Внутреннее событие пользовательского интерфейса, которое сгенерировало событие Matplotlib.

Примечания

Устарело начиная с версии 3.6: Используйте callbacks.process('leave_notify_event', LocationEvent(...)) вместо этого.

manager_class[source]: псевдоним для FigureManagerBase

motion_notify_event(x, y, guiEvent=None)[source]

[Устаревший] Обработка событий перемещения мыши.

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

Этот метод вызовет все функции, подключенные к событию 'motion_notify_event', с экземпляром MouseEvent.

Параметры:

xfloat: Координаты на холсте, где 0=слева.
yfloat: Координаты на холсте, где 0=внизу.
guiEvent: Исходное событие пользовательского интерфейса, сгенерировавшее событие Matplotlib.

Примечания

Устарело начиная с версии 3.6: Используйте callbacks.process('motion_notify_event', MouseEvent(...)) вместо этого.

mpl_connect(s, func)[source]

Связывает функцию func с событием s.

Параметры:

sstr

Один из следующих идентификаторов событий:

'button_press_event'
'button_release_event'
'draw_event'
'key_press_event'
'key_release_event'
'motion_notify_event'
'pick_event'
'resize_event'
'scroll_event'
'figure_enter_event',
'figure_leave_event',
'axes_enter_event',
'axes_leave_event'
'close_event'.

funccallable

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

def func(event: Event) -> Any

Для событий положения (нажатия и отпускания клавиш мыши), если курсор находится над осями, атрибут inaxes события будет установлен на Axes, над которым находится курсор, и дополнительно атрибуты xdata и ydata будут установлены на координаты мыши в координатах данных. См. KeyEvent и MouseEvent для получения дополнительной информации.

Возвращает:

cid: Идентификатор подключения, который можно использовать с FigureCanvasBase.mpl_disconnect.

Примеры

def on_press(event):
    print('you pressed', event.button, event.xdata, event.ydata)

cid = canvas.mpl_connect('button_press_event', on_press)

mpl_disconnect(cid)[source]

Отключает обратный вызов с идентификатором cid.

Примеры

cid = canvas.mpl_connect('button_press_event', on_press)
# ... later
canvas.mpl_disconnect(cid)

classmethodnew_manager(figure, num)[source]

Создаёт новый диспетчер фигур для figure, используя этот класс холста.

Примечания

Этот метод не следует переопределять в подклассах. Если требуется кастомизация создания диспетчера, переопределите FigureManager.create_with_canvas.

new_timer(interval=None, callbacks=None)[source]

Создаёт новый бэкенд-специфичный подкласс Timer.

Это полезно для получения периодических событий через собственный цикл событий бэкенда. Реализовано только для бэкэндов с GUI.

Параметры:

intervalint

Интервал таймера в миллисекундах.

callbackslist[tuple[callable, tuple, dict]]

Последовательность (func, args, kwargs), где func(*args, **kwargs) будет выполняться таймером каждые interval.

Обратные вызовы, которые возвращают False или 0 будут удалены из таймера.

Примеры

>>> timer = fig.canvas.new_timer(callbacks=[(f1, (1,), {'a': 3})])

pick(mouseevent)[source]: [Устаревший]

Примечания

Устарело начиная с версии 3.6: Используйте canvas.figure.pick вместо этого.

pick_event(mouseevent, artist, **kwargs)[source]

[Устаревший] Обработка событий выбора.

Этот метод будет вызываться выбранными элементами и запускать обратные вызовы PickEvent, зарегистрированными слушателями.

Обратите внимание, что элементы по умолчанию не являются выбираемыми (см. Artist.set_picker).

Примечания

Устарело начиная с версии 3.6: Используйте callbacks.process('pick_event', PickEvent(...)) вместо этого.

print_figure(filename, dpi=None, facecolor=None, edgecolor=None, orientation='portrait', format=None, *, bbox_inches=None, pad_inches=None, bbox_extra_artists=None, backend=None, **kwargs)[source]

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

Параметры:

filenameстрока или объект пути или файл: Файл, в который сохраняется рисунок.
dpiвещественное число, по умолчанию: rcParams["savefig.dpi"] (по умолчанию: 'figure'): Точки на дюйм для сохранения рисунка.
facecolorцвет или 'auto', по умолчанию: rcParams["savefig.facecolor"] (по умолчанию: 'auto'): Цвет заливки области рисунка. Если 'auto', используется текущий цвет заливки области рисунка.
edgecolorцвет или 'auto', по умолчанию: rcParams["savefig.edgecolor"] (по умолчанию: 'auto'): Цвет обводки области рисунка. Если 'auto', используется текущий цвет обводки области рисунка.
orientation{'горизонтально', 'вертикально'}, по умолчанию: 'вертикально': Применяется только к печати PostScript.
formatстрока, необязательно: Принудительно задать определённый формат файла. Если не указан, формат определяется по расширению имени файла, а если это не удаётся, из rcParams["savefig.format"] (по умолчанию: 'png').
bbox_inches'плотно' или Bbox, по умолчанию: rcParams["savefig.bbox"] (по умолчанию: None): Прямоугольник в дюймах: сохраняется только указанная часть рисунка. Если 'плотно', попытаться определить плотное прямоугольник рисунка.
pad_inchesвещественное число, по умолчанию: rcParams["savefig.pad_inches"] (по умолчанию: 0.1): Количество отступов вокруг рисунка, когда bbox_inches равно 'плотно'.
bbox_extra_artistsсписок Artist, необязательно: Список дополнительных элементов, которые будут учитываться при расчёте плотного прямоугольника.
backendстрока, необязательно: Использовать графический интерфейс без использования графического интерфейса по умолчанию для отрисовки файла, например, для отрисовки файла png с графическим интерфейсом "cairo" вместо стандартного "agg", или файла pdf с графическим интерфейсом "pgf" вместо стандартного "pdf". Обратите внимание, что стандартного графического интерфейса обычно достаточно. См. Встроенные графические интерфейсы для списка допустимых графических интерфейсов для каждого формата файлов. Настраиваемые графические интерфейсы могут быть указаны как "module://...".

release_mouse(ax)[source]

Освободить захват мыши, удерживаемый элементом Axes ax.

Обычно вызывается виджетами. Вызов этого метода допустим, даже если ax не держит в настоящее время захват мыши.

required_interactive_framework=None

resize(w, h)[source]

НЕ ИСПОЛЬЗУЕТСЯ: Установить размер холста в пикселях.

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

resize_event()[source]: [Устарело] Передать ResizeEvent всем функциям, подключенным к resize_event.

Примечания

Устарело начиная с версии 3.6: Используйте callbacks.process('resize_event', ResizeEvent(...)) вместо этого.

scroll_event(x, y, step, guiEvent=None)[source]

[Устарело] Обработка событий прокрутки.

Производные классы графических интерфейсов должны вызывать эту функцию при любом событии прокрутки колёсика мыши. (x, y) — координаты холста ((0, 0) — нижний левый угол). button и key определены в MouseEvent.

Этот метод вызовет все функции, подключенные к «scroll_event», с экземпляром MouseEvent.

Примечания

Устарело начиная с версии 3.6: Используйте callbacks.process('scroll_event', MouseEvent(...)) вместо этого.

propertyscroll_pick_id

set_cursor(cursor)[source]

Установить текущий курсор.

Это может не иметь эффекта, если графический интерфейс ничего не отображает.

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

Параметры:

cursorCursors: Курсор, который будет отображаться над холстом. Примечание: некоторые графические интерфейсы могут изменить курсор для всего окна.

start_event_loop(timeout=0)[source]

Запустить блокирующий цикл событий.

Такой цикл событий используется интерактивными функциями, такими как ginput и waitforbuttonpress, для ожидания событий.

Цикл событий блокируется до тех пор, пока функция обратного вызова не вызовет stop_event_loop или не будет достигнут timeout.

Если timeout равен 0 или отрицательно, таймаут не используется.

Переопределять этот метод необходимо только для интерактивных бэкэндов, и он полагается на правильную реализацию flush_events.

Интерактивные бэкэнды должны реализовать этот метод более нативным способом.

stop_event_loop()[source]

Остановить текущий блокирующий цикл событий.

Интерактивные бэкэнды должны переопределить этот метод, чтобы он соответствовал start_event_loop.

supports_blit=False

switch_backends(FigureCanvasClass)[source]

Инициализировать экземпляр FigureCanvasClass

Используется для переключения бэкэндов, например, для инициализации FigureCanvasPS из FigureCanvasGTK. Обратите внимание, что глубокое копирование не выполняется, поэтому любые изменения в одном из экземпляров (например, установка размера фигуры или свойств линии) будут отражены в другом.

classmatplotlib.backend_bases.FigureManagerBase(canvas, num)[source]

Bases: object

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

Менеджер фигуры используется pyplot для взаимодействия с окном независимо от бэкэнда. Это адаптер для реальной (GUI) среды, представляющей визуальную фигуру на экране.

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

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

Операции с окном

show
destroy
full_screen_toggle
resize
get_window_title
set_window_title

Обработка нажатий клавиш и кнопок мыши

Менеджер фигуры настраивает обработку нажатий клавиш и кнопок мыши по умолчанию, подключив key_press_handler к системе событий matplotlib. Это обеспечивает одинаковые сокращения и действия мыши во всех бэкендах.

Другие операции

Подклассы будут иметь дополнительные атрибуты и функции для доступа к дополнительным возможностям. Это, конечно, зависит от бэкэнда. Например, большинство GUI-бэкэндов имеют атрибуты window и toolbar, которые обеспечивают доступ к нативным GUI-виджетам соответствующей среды.

Атрибуты:

canvasFigureCanvasBase

Экземпляр канвы, специфичный для бэкэнда.

numint или str

Номер фигуры.

key_press_handler_idint

Идентификатор обработчика нажатия клавиш по умолчанию, при использовании toolmanager. Чтобы отключить обработку нажатий клавиш по умолчанию, используйте:

figure.canvas.mpl_disconnect(
    figure.canvas.manager.key_press_handler_id)

button_press_handler_idint

Идентификатор обработчика нажатия кнопки мыши по умолчанию, при использовании toolmanager. Чтобы отключить обработку нажатий кнопок мыши по умолчанию, используйте:

figure.canvas.mpl_disconnect(
    figure.canvas.manager.button_press_handler_id)

classmethodcreate_with_canvas(canvas_class, figure, num)[source]

Создает менеджер для заданной figure с использованием определённого canvas_class.

Бэкэнды должны переопределять этот метод, если у них есть особые потребности в настройке канвы или менеджера.

destroy()[source]

full_screen_toggle()[source]

get_window_title()[source]: Возвращает текст заголовка окна, содержащего фигуру, или None, если окно отсутствует (например, в бэкенде PS).

resize(w, h)[source]: Для GUI-бэкэндов, изменение размера окна (в физических пикселях).

set_window_title(title)[source]

Устанавливает текст заголовка окна, содержащего фигуру.

Это не имеет эффекта для бэкэндов без GUI (например, PS).

show()[source]: Для GUI-бэкэндов, отображение окна фигуры и перерисовка. Для бэкэндов без GUI генерирует исключение, за исключением беглого режима (например, в Linux без установленного DISPLAY); это исключение преобразуется в предупреждение в Figure.show.

classmatplotlib.backend_bases.GraphicsContextBase[source]

END_OF_DOCUMENT_MARKER

Основание: object

Абстрактный базовый класс, предоставляющий цвет, стили линий и т. д.

copy_properties(gc)[source]: Копирование свойств из gc в self.

get_alpha()[source]: Возвращает значение альфа-канала, используемое для смешивания. Не поддерживается во всех бэкендах.

get_antialiased()[source]: Возвращает, следует ли выполнять антиалиасинговое рендеринг.

get_capstyle()[source]: Возвращает стиль окончания CapStyle.

get_clip_path()[source]: Возвращает обрезной путь в виде (path, transform), где path — объект Path, а transform — аффинное преобразование, применяемое к пути перед обрезкой.

get_clip_rectangle()[source]: Возвращает прямоугольник обрезки как объект Bbox.

get_dashes()[source]

Возвращает стиль штриховки как пару (смещение, список штрихов).

Подробности см. в set_dashes.

Значение по умолчанию — (None, None).

get_forced_alpha()[source]: Возвращает, следует ли использовать значение, возвращаемое get_alpha(), для переопределения других значений альфа-канала.

get_gid()[source]: Возвращает идентификатор объекта, если он задан, иначе None.

get_hatch()[source]: Получить текущий стиль штриховки.

get_hatch_color()[source]: Получить цвет штриховки.

get_hatch_linewidth()[source]: Получить ширину линии штриховки.

get_hatch_path(density=6.0)[source]: Возвращает Path для текущей штриховки.

get_joinstyle()[source]: Возвращает стиль соединения JoinStyle.

get_linewidth()[source]: Возвращает ширину линии в пунктах.

get_rgb()[source]: Возвращает кортеж из трех или четырех чисел с плавающей точкой от 0 до 1.

get_sketch_params()[source]

Возвращает параметры наброска для элемента.

Возвращает:

кортеж или None

Кортеж из 3 элементов:

scale: Амплитуда колебаний перпендикулярно исходной линии.
length: Длина колебаний вдоль линии.
randomness: Коэффициент масштабирования, сжимающий или расширяющий длину.

Может возвращать None, если параметры наброска не были установлены.

get_snap()[source]

Возвращает установку привязки, которая может быть:

True: вершины привязываются к ближайшему центру пикселя
False: вершины остаются как есть
None: (авто) Если путь содержит только прямолинейные сегменты, округляются до ближайшего центра пикселя

get_url()[source]: Возвращает URL, если он задан, иначе None.

END_OF_DOCUMENT_MARKER

restore()[source]: Восстановить контекст графики из стека — необходимо только для тех бэкэндов, которые сохраняют контексты графики в стеке.

set_alpha(alpha)[source]

Установить значение альфа-канала, используемое для смешения — не поддерживается во всех бэкендах.

Если alpha=None (по умолчанию), компоненты альфа цвета переднего плана и заливки будут использоваться для установки их прозрачности (если применимо); в противном случае, alpha переопределит их.

set_antialiased(b)[source]: Установить, нужно ли рисовать объекты с сглаживанием.

set_capstyle(cs)[source]

Установить способ рисования концов линий.

Параметры:

csCapStyle или {'butt', 'projecting', 'round'}

set_clip_path(path)[source]: Установить путь обрезки на TransformedPath или None.

set_clip_rectangle(rectangle)[source]: Установить прямоугольник обрезки на Bbox или None.

set_dashes(dash_offset, dash_list)[source]

Установить стиль штриховки для контекста графики.

Параметры:

dash_offsetfloat: Смещение, в точках, по образцу штриховки, с которого следует начать. Обычно устанавливается в 0.
dash_listarray-like или None: Последовательность включения/выключения в точках. None означает сплошную линию. Все значения должны быть неотрицательными (\(\ge 0\)).

Примечания

См. стр. 666 справки PostScript Language Reference для получения дополнительной информации.

set_foreground(fg, isRGBA=False)[source]

Установить цвет переднего плана.

Параметры:

fgцвет
isRGBAbool: Если известно, что fg является (r, g, b, a) кортежем, isRGBA можно установить в True для повышения производительности.

set_gid(id)[source]: Установить идентификатор.

set_hatch(hatch)[source]: Установить стиль штриховки (для заливки).

set_hatch_color(hatch_color)[source]: Установить цвет штриховки.

set_joinstyle(js)[source]

Установить способ рисования соединений между отрезками линий.

Параметры:

jsJoinStyle или {'miter', 'round', 'bevel'}

set_linewidth(w)[source]: Установить толщину линии в точках.

set_sketch_params(scale=None, length=None, randomness=None)[source]

Установить параметры наброска.

Параметры:

scalefloat, необязательно: Амплитуда колебаний перпендикулярно исходной линии, в пикселях. Если scale None или не задано, фильтр наброска не будет применен.
lengthfloat, по умолчанию: 128: Длина колебаний вдоль линии, в пикселях.
randomnessfloat, по умолчанию: 16: Коэффициент масштабирования, на который уменьшается или увеличивается длина.

set_snap(snap)[source]

Установить значение настройки сетки, которое может быть:

True: привязывать вершины к ближайшему центру пикселя
False: оставить вершины как есть
None: (авто) Если путь содержит только прямолинейные сегменты линий, округлять до ближайшего центра пикселя

set_url(url)[source]: Установить URL для ссылок в совместимых бэкендах.

classmatplotlib.backend_bases.KeyEvent(name, canvas, key, x=0, y=0, guiEvent=None)[source]

Bases: LocationEvent

Событие нажатия клавиши (нажатие, отпускание клавиши).

В событии KeyEvent есть ряд специальных атрибутов помимо тех, которые определены в родительских классах Event и LocationEvent.

Примечания

Модификаторы клавиш будут предварять нажатую клавишу и будут в порядке "ctrl", "alt", "super". Исключением из этого правила является случай, когда нажатая клавиша сама является модификатором, поэтому "ctrl+alt" и "alt+control" могут быть допустимыми значениями клавиши.

Примеры

def on_key(event):
    print('you pressed', event.key, event.xdata, event.ydata)

cid = fig.canvas.mpl_connect('key_press_event', on_key)

Атрибуты:

keyNone или str: Нажатая(ые) клавиша(ы). Может быть None, одиночный символ Unicode в верхнем регистре ("g", "G", "#", и т. д.), специальная клавиша ("control", "shift", "f1", "up", и т. д.) или их комбинация (например, "ctrl+alt+g", "ctrl+alt+G").

classmatplotlib.backend_bases.LocationEvent(name, canvas, x, y, guiEvent=None)[source]

Bases: Event

Событие, имеющее экранное положение.

В событии LocationEvent есть ряд специальных атрибутов помимо тех, которые определены в родительском классе Event.

Атрибуты:

x, yint или None: Положение события в пикселях от нижнего левого угла холста.
inaxesAxes или None: Объект Axes, над которым находится курсор, если таковой имеется.
xdata, ydatafloat или None: Координаты данных курсора внутри inaxes, или None, если курсор не находится над объектом Axes.

lastevent=None

classmatplotlib.backend_bases.MouseButton(value)[source]

Bases: IntEnum

Перечисление.

BACK=8[source]

FORWARD=9[source]

LEFT=1[source]

MIDDLE=2[source]

RIGHT=3[source]

classmatplotlib.backend_bases.MouseEvent(name, canvas, x, y, button=None, key=None, step=0, dblclick=False, guiEvent=None)[source]

Bases: LocationEvent

Событие мыши ('button_press_event', 'button_release_event', 'scroll_event', 'motion_notify_event').

У объекта MouseEvent есть ряд специальных атрибутов помимо тех, что определены родительскими классами Event и LocationEvent.

Примеры

def on_press(event):
    print('you pressed', event.button, event.xdata, event.ydata)

cid = fig.canvas.mpl_connect('button_press_event', on_press)

Атрибуты:

buttonNone или MouseButton или {'up', 'down'}

Нажатая кнопка. 'up' и 'down' используются для событий прокрутки.

Обратите внимание, что LEFT и RIGHT фактически относятся к "первичной" и "вторичной" кнопкам, то есть, если пользователь инвертирует свои левую и правую кнопки ("леворукое расположение"), то кнопка LEFT будет той, которая физически находится справа.

Если этот атрибут не задан, name – "scroll_event", а step – не ноль, то он будет установлен в "up" или "down" в зависимости от знака step.

keyNone или str

Нажатая клавиша, когда произошло событие мыши, например, 'shift'. См. KeyEvent.

Предупреждение

Эта клавиша в настоящее время получена из последнего события 'key_press_event' или 'key_release_event', произошедшего на холсте. Таким образом, если последнее изменение состояния клавиатуры произошло, когда холст не имел фокуса, этот атрибут будет неверным.

stepfloat

Количество шагов прокрутки (положительное для 'up', отрицательное для 'down'). Это относится только к 'scroll_event' и по умолчанию равно 0 в противном случае.

dblclickbool

Является ли событие двойным щелчком. Это относится только к 'button_press_event' и равно False в противном случае. В частности, оно не используется в 'button_release_event'.

classmatplotlib.backend_bases.NavigationToolbar2(canvas)[source]

Базы: object

Базовый класс для курсора навигации, версия 2.

Модули должны реализовать холст, который обрабатывает соединения для 'button_press_event' и 'button_release_event'. Смотрите FigureCanvasBase.mpl_connect() для получения дополнительной информации.

Они также должны определить

save_figure(): сохранить текущую фигуру
draw_rubberband() (необязательно): рисовать прямоугольник "резинка" для масштабирования по области
set_message() (необязательно): отобразить сообщение
set_history_buttons() (необязательно): можно изменить кнопки истории "назад" / "вперед", чтобы указать состояние "отключено" / "включено".

и переопределить __init__ для настройки панели инструментов — не забывая вызвать инициализацию базового класса. Как правило, __init__ необходимо настроить кнопки панели инструментов, связанные с методами home, back, forward, pan, zoom и save_figure, а также использовать стандартные значки в подкаталоге "images" пути к данным.

Вот и все, остальное сделаем позже!

back(*args)[source]

Перемещение назад по стеку пределов просмотра.

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

configure_subplots(*args)[source]

drag_pan(event)[source]: Обратный вызов для перетаскивания в режиме панорамирования/масштабирования.

drag_zoom(event)[source]: Обратный вызов для перетаскивания в режиме масштабирования.

draw_rubberband(event, x0, y0, x1, y1)[source]

Рисование прямоугольной резинки для обозначения границ масштабирования.

Обратите внимание, что не гарантируется, что x0 <= x1 и y0 <= y1.

forward(*args)[source]

Перемещение вперед по стеку пределов просмотра.

home(*args)[source]

Восстановление исходного вида.

mouse_move(event)[source]

pan(*args)[source]

Переключение инструмента панорамирования/масштабирования.

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

press_pan(event)[source]: Обратный вызов при нажатии кнопки мыши в режиме панорамирования/масштабирования.

press_zoom(event)[source]: Обратный вызов при нажатии кнопки мыши в режиме масштабирования по области.

push_current()[source]: Добавить текущие пределы просмотра и положение в стек.

release_pan(event)[source]: Обратный вызов при отпускании кнопки мыши в режиме панорамирования/масштабирования.

release_zoom(event)[source]: Обратный вызов при отпускании кнопки мыши в режиме масштабирования по области.

remove_rubberband()[source]: Удалить резинку.

END_OF_DOCUMENT_MARKER

save_figure(*args)[source]: Сохранить текущую фигуру.

set_cursor(cursor)[source]

[Устарело] Установить текущий курсор на одно из значений перечисления Cursors.

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

Примечания

Устарело начиная с версии 3.5: Используйте FigureCanvasBase.set_cursor вместо него.

set_history_buttons()[source]: Включить или отключить кнопки «Назад»/«Вперед».

set_message(s)[source]: Отобразить сообщение на панели инструментов или в строке состояния.

toolitems=(('Домой', 'Сбросить исходный вид', 'home', 'home'), ('Назад', 'Возврат к предыдущему виду', 'back', 'back'), ('Вперед', 'Переход к следующему виду', 'forward', 'forward'), (None, None, None, None), ('Перемещение', 'Левая кнопка перемещает, правая кнопка увеличивает/уменьшает\nx/y фиксируют ось, CTRL фиксирует аспект', 'move', 'pan'), ('Масштабирование', 'Масштабирование по прямоугольнику\nx/y фиксируют ось', 'zoom_to_rect', 'zoom'), ('Подграфики', 'Настройка подграфиков', 'subplots', 'configure_subplots'), (None, None, None, None), ('Сохранить', 'Сохранить фигуру', 'filesave', 'save_figure'))

update()[source]: Сбросить стек осей.

zoom(*args)[source]

exceptionmatplotlib.backend_bases.NonGuiException[source]

Bases: Exception

Возникает при попытке отобразить фигуру в бэкенде без графического интерфейса.

classmatplotlib.backend_bases.PickEvent(name, canvas, mouseevent, artist, guiEvent=None, **kwargs)[source]

Bases: Event

Событие выделения.

Это событие срабатывает, когда пользователь выбирает положение на холсте достаточно близко к элементу, который был сделан выделяемым с помощью Artist.set_picker.

Событие PickEvent имеет ряд специальных атрибутов помимо тех, которые определены родительским классом Event.

Примеры

Привяжите функцию on_pick() к событиям выделения, которая выводит координаты выбранной точки данных:

ax.plot(np.rand(100), 'o', picker=5)  # 5 points tolerance

def on_pick(event):
    line = event.artist
    xdata, ydata = line.get_data()
    ind = event.ind
    print('on pick line:', np.array([xdata[ind], ydata[ind]]).T)

cid = fig.canvas.mpl_connect('pick_event', on_pick)

Атрибуты:

mouseeventMouseEvent: Событие мыши, которое сгенерировало выделение.
artistmatplotlib.artist.Artist: Выделенный элемент. Обратите внимание, что элементы по умолчанию не выделяются (см. Artist.set_picker).
other: Дополнительные атрибуты могут присутствовать в зависимости от типа выбранного объекта; например, выделение Line2D может определять разные дополнительные атрибуты, чем выделение PatchCollection.

классmatplotlib.backend_bases.RendererBase[source]

Базовый абстрактный класс для обработки операций рисования/рендеринга.

Следующие методы должны быть реализованы в бэкенде для полной функциональности (хотя просто реализация draw_path даст высокопроизводительный бэкенд):

draw_path
draw_image
draw_gouraud_triangle

Следующие методы должны быть реализованы в бэкенде по соображениям оптимизации:

draw_text
draw_markers
draw_path_collection
draw_quad_mesh

close_group(s)[source]

Закрыть элемент группировки с меткой s.

Используется только рендерером SVG.

draw_gouraud_triangle(gc, points, colors, transform)[source]

Отрисовка треугольника с заливкой Гуро.

Параметры:

gcGraphicsContextBase: Контекст графики.
points(3, 2) массив-подобный: Массив точек (x, y) для треугольника.
colors(3, 4) массив-подобный: Цвета RGBA для каждой точки треугольника.
transformmatplotlib.transforms.Transform: Аффинное преобразование, применяемое к точкам.

draw_gouraud_triangles(gc, triangles_array, colors_array, transform)[source]

Отрисовка набора треугольников с заливкой Гуро.

Параметры:

points(N, 3, 2) массив-подобный: Массив из N точек (x, y) для треугольников.
colors(N, 3, 4) массив-подобный: Массив из N значений RGBA для каждой точки треугольников.
transformmatplotlib.transforms.Transform: Аффинное преобразование, применяемое к точкам.

draw_image(gc, x, y, im, transform=None)[source]

Отрисовка изображения RGBA.

Параметры:

gcGraphicsContextBase: Контекст графики с информацией о обрезке.
xскаляр: Расстояние в физических единицах (т.е. точки или пиксели) от левой стороны холста.
yскаляр: Расстояние в физических единицах (т.е. точки или пиксели) от нижней стороны холста.
im(N, M, 4) массив-подобный np.uint8: Массив пикселей RGBA.
transformmatplotlib.transforms.Affine2DBase: Если и только если конкретный бэкенд написан так, что option_scale_image возвращает True, аффинное преобразование (т.е., Affine2DBase) может быть передано в draw_image. Вектор смещения преобразования задается в физических единицах (т.е. точках или пикселях). Обратите внимание, что преобразование не переопределяет x и y и должно быть применено перед перемещением результата на x и y (это можно сделать, добавив x и y к вектору смещения, определенному transform).

draw_markers(gc, marker_path, marker_trans, path, trans, rgbFace=None)[source]

Отрисовка маркера в каждой из вершин path (исключая точки управления).

Базовая (резервная) реализация выполняет несколько вызовов draw_path. Бэкенды могут переопределить этот метод для отрисовки маркера только один раз и многократного его использования.

Параметры:

gcGraphicsContextBase: Контекст графики.
marker_transmatplotlib.transforms.Transform: Аффинное преобразование, применяемое к маркеру.
transmatplotlib.transforms.Transform: Аффинное преобразование, применяемое к пути.

draw_path(gc, path, transform, rgbFace=None)[source]: Отобразить экземпляр Path с помощью заданного аффинного преобразования.

draw_path_collection(gc, master_transform, paths, all_transforms, offsets, offset_trans, facecolors, edgecolors, linewidths, linestyles, antialiaseds, urls, offset_position)[source]

Отобразить коллекцию paths.

Каждый путь сначала преобразуется с помощью соответствующей записи в all_transforms (список матриц (3, 3)), а затем с помощью master_transform. Затем они переводятся с помощью соответствующей записи в offsets, которая была предварительно преобразована с помощью offset_trans.

facecolors, edgecolors, linewidths, linestyles и antialiased — списки, устанавливающие соответствующие свойства.

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

Базовая (резервная) реализация выполняет несколько вызовов draw_path. Возможно, бэкэнды захотят переопределить это, чтобы отобразить каждый набор данных пути только один раз, а затем обратиться к этому пути несколько раз с различными смещениями, цветами, стилями и т. д. Для помощи (и стандартизации) реализации в разных бэкэндах предоставлены методы генераторов _iter_collection_raw_paths и _iter_collection. Настоятельно рекомендуется использовать эти генераторы, чтобы изменения в поведении draw_path_collection можно было внести глобально.

draw_quad_mesh(gc, master_transform, meshWidth, meshHeight, coordinates, offsets, offsetTrans, facecolors, antialiased, edgecolors)[source]

Отобразить сетку quadmesh.

Базовая (резервная) реализация преобразует сетку quadmesh в пути, а затем вызывает draw_path_collection.

draw_tex(gc, x, y, s, prop, angle, *, mtext=None)[source]

draw_text(gc, x, y, s, prop, angle, ismath=False, mtext=None)[source]

Отобразить экземпляр текста.

Параметры:

gcGraphicsContextBase: Контекст графики.
xfloat: Положение x текста в координатах отображения.
yfloat: Положение y базовой линии текста в координатах отображения.
sstr: Строка текста.
propmatplotlib.font_manager.FontProperties: Свойства шрифта.
anglefloat: Угол поворота в градусах против часовой стрелки.
mtextmatplotlib.text.Text: Исходный объект текста для отображения.

Примечания

Примечание для разработчиков бэкэндов:

При попытке определить, правильно ли вы получили область границ (что позволяет корректно работать с выкладкой/выравниванием текста), полезно изменить строку в тексте.py:

if 0: bbox_artist(self, renderer)

на if 1, и тогда реальная область границ будет нарисована вместе с вашим текстом.

flipy()[source]

Возвращает, увеличиваются ли значения y сверху вниз.

Обратите внимание, что это влияет только на отображение текста.

get_canvas_width_height()[source]: Возвращает ширину и высоту холста в координатах отображения.

get_image_magnification()[source]: Возвращает коэффициент увеличения изображений, передаваемых в draw_image. Позволяет бэкэнду иметь изображения с другим разрешением, отличным от других объектов.

get_texmanager()[source]: Возвращает экземпляр TexManager.

get_text_width_height_descent(s, prop, ismath)[source]: Получить ширину, высоту и спуск (смещение снизу до базовой линии) строки s с FontProperties prop в координатах отображения.

new_gc()[source]: Возвращает экземпляр GraphicsContextBase.

open_group(s, gid=None)[source]

Открывает элемент группирования с меткой s и gid (если задан) в качестве идентификатора.

Используется только рендерером SVG.

option_image_nocomposite()[source]

Возвращает значение, указывающее, нужно ли пропускать композицию изображений Matplotlib.

Векторные бэкэнды обычно должны возвращать not rcParams["image.composite_image"]; растровые бэкэнды обычно возвращают False (позволяя C-уровневому растризатору позаботиться о композиции изображений).

option_scale_image()[source]: Возвращает значение, указывающее, поддерживаются ли произвольные аффинные преобразования в draw_image (True для большинства векторных бэкэндов).

points_to_pixels(points)[source]

Преобразует точки в единицы отображения.

Вам необходимо переопределить эту функцию (если ваш бэкэнд не имеет dpi, например, postscript или svg). Некоторые системы изображения предполагают некоторое значение для пикселей на дюйм:

points to pixels = points * pixels_per_inch/72 * dpi/72

Параметры:

pointsfloat или array-like: float или numpy массив float

Возвращает:

Точки, преобразованные в пиксели

start_filter()[source]

Переключается на временный рендерер для эффектов фильтрации изображений.

В настоящее время поддерживается только рендерером agg.

start_rasterizing()[source]

Переключается на растровый рендерер.

Используется MixedModeRenderer.

stop_filter(filter_func)[source]

Возвращается к исходному рендереру. Содержимое временного рендерера обрабатывается с помощью filter_func и отображается на исходном рендерере в виде изображения.

В настоящее время поддерживается только рендерером agg.

stop_rasterizing()[source]

Возвращается к векторному рендереру и отображает содержимое растрового рендерера в виде изображения на векторном рендерере.

Используется MixedModeRenderer.

classmatplotlib.backend_bases.ResizeEvent(name, canvas)[source]

Bases: Event

Событие, срабатывающее при изменении размера холста.

ResizeEvent имеет ряд специальных атрибутов в дополнение к тем, которые определены в родительском классе Event.

Атрибуты:

widthint: Ширина холста в пикселях.
heightint: Высота холста в пикселях.

classmatplotlib.backend_bases.ShowBase[source]

Bases: _Backend

Простой базовый класс для генерации функции show() в бэкэндах.

Подкласс должен переопределить метод mainloop().

classmatplotlib.backend_bases.TimerBase(interval=None, callbacks=None)[source]

Bases: object

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

Подклассы должны переопределить следующие методы:

_timer_start: Специфичный для бэкенда код для запуска таймера.
_timer_stop: Специфичный для бэкенда код для остановки таймера.

Подклассы могут дополнительно переопределить следующие методы:

_timer_set_single_shot: Код для установки таймера в режим однократного срабатывания, если это поддерживается объектом таймера. Если нет, класс Timer сам будет хранить флаг, и метод _on_timer должен быть переопределён для поддержки такого поведения.
_timer_set_interval: Код для установки интервала таймера, если для объекта таймера существует такой метод.
_on_timer: Внутренняя функция, которую должен вызывать любой объект таймера, которая будет обрабатывать задачу выполнения всех установленных обратных вызовов.

Параметры:

intervalint, по умолчанию: 1000мс: Время между таймерными событиями в миллисекундах. Будет сохранено как timer.interval.
callbackslist[tuple[callable, tuple, dict]]: Список кортежей (func, args, kwargs), которые будут вызваны при таймерных событиях. Этот список доступен как timer.callbacks и может быть изменён напрямую, или можно использовать функции add_callback и remove_callback.

add_callback(func, *args, **kwargs)[source]

Регистрирует func для вызова таймером при срабатывании события. Любые дополнительные аргументы будут переданы в func.

Эта функция возвращает func, что позволяет использовать её как декоратор.

propertyinterval: Время между таймерными событиями в миллисекундах.

remove_callback(func, *args, **kwargs)[source]

Удаляет func из списка обратных вызовов.

args и kwargs являются необязательными и используются для различения копий одной и той же функции, зарегистрированной для вызова с различными аргументами. Это поведение устарело. В будущем *args, **kwargs больше не будет рассматриваться; чтобы сохранить возможность удаления определённого обратного вызова самостоятельно, передайте его в add_callback в виде объекта functools.partial.

propertysingle_shot: Определяет, должен ли таймер остановиться после одного срабатывания.

start(interval=None)[source]

Запускает объект таймера.

Параметры:

intervalint, необязательно: Интервал таймера в миллисекундах; переопределяет ранее установленный интервал, если указан.

stop()[source]: Останавливает таймер.

classmatplotlib.backend_bases.ToolContainerBase(toolmanager)[source]

Bases: object

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

Атрибуты:

toolmanagerToolManager: Инструменты, с которыми данному ToolContainer необходимо взаимодействовать.

add_tool(tool, group, position=-1)[source]

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

Параметры:

tooltool_like: Инструмент для добавления, см. ToolManager.get_tool.
groupstr: Имя группы, к которой добавить этот инструмент.
positionint, по умолчанию: -1: Позиция внутри группы для размещения этого инструмента.

add_toolitem(name, group, position, image, description, toggle)[source]

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

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

Обработчик события нажатия кнопки должен быть точно self.trigger_tool(name).

Параметры:

namestr

Имя инструмента для добавления, оно используется в качестве идентификатора инструмента и в качестве метки по умолчанию для кнопок.

groupstr

Имя группы, к которой принадлежит этот инструмент.

positionint

Позиция инструмента в группе; если -1, то добавляется в конец.

imagestr

Имя файла изображения для кнопки или None.

descriptionstr

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

togglebool

True : Кнопка является переключателем (изменяет состояние нажатия/снятия между последовательными нажатиями).
False : Кнопка является обычной кнопкой (возвращается в состояние снятия после отпуска).

remove_toolitem(name)[source]

Удаление элемента инструмента из ToolContainer.

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

Вызывается при ToolManager отправляет tool_removed_event.

Параметры:

namestr: Имя инструмента для удаления.

set_message(s)[source]

Отображение сообщения на панели инструментов.

Параметры:

sstr: Текст сообщения.

toggle_toolitem(name, toggled)[source]

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

Параметры:

namestr: Идентификатор инструмента для переключения.
toggledbool: Установить этот инструмент в состояние включения или выключения.

trigger_tool(name)[source]

Вызов инструмента.

Параметры:

namestr: Имя (идентификатор) инструмента, вызываемого из контейнера.

matplotlib.backend_bases.button_press_handler(event, canvas=None, toolbar=None)[source]

Стандартные действия Matplotlib для дополнительных кнопок мыши.

Параметры такие же, как для key_press_handler, за исключением того, что event является MouseEvent.

matplotlib.backend_bases.get_registered_canvas_class(format)[source]: Возвращает зарегистрированный по умолчанию холст для данного формата файла. Обрабатывает отложенный импорт требуемого бэкэнда.

matplotlib.backend_bases.key_press_handler(event, canvas=None, toolbar=None)[source]

Реализуйте стандартные привязки клавиш Matplotlib для холста и панели инструментов, описанные в Клавиши для навигации.

Параметры:

eventKeyEvent: Событие нажатия/отпускания клавиши.
canvasFigureCanvasBase, по умолчанию: event.canvas: Экземпляр холста, специфичный для бэкенда. Этот параметр сохранён для обратной совместимости, но, если он задан, он всегда должен быть равен event.canvas.
toolbarNavigationToolbar2, по умолчанию: event.canvas.toolbar: Панель навигации курсора. Этот параметр сохранён для обратной совместимости, но, если он задан, он всегда должен быть равен event.canvas.toolbar.

matplotlib.backend_bases.register_backend(format, backend, description=None)[source]

Регистрирует бэкенд для сохранения в заданном формате файла.

Параметры:

formatstr: Расширение файла
backendстрока модуля или класс холста: Бэкенд для обработки вывода файла
descriptionstr, по умолчанию: "": Описание типа файла.