matplotlib.backends.backend_qtagg, matplotlib.backends.backend_qtcairo

ПРИМЕЧАНИЕ Эти Подсистемы не документируются здесь (автоматически), чтобы избежать добавления зависимости при построении документации.

Связывания Qt

В настоящее время поддерживаются 2 активно используемые версии Qt, Qt5 и Qt6, и две поддерживаемые Python-связывания на каждую версию — PyQt5 и PySide2 для Qt5 и PyQt6 и PySide6 для Qt6 [1]. Подсистемы qtagg и qtcairo Matplotlib (matplotlib.backends.backend_qtagg и matplotlib.backend.backend_qtcairo) поддерживают все эти связывания, с общими частями, выделенными в модуле matplotlib.backends.backend_qt.

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

Если подпакет связывания QtCore уже импортирован, это связывание выбирается (порядок проверки PyQt6, PySide6, PyQt5, PySide2).
Если переменная окружения QT_API установлена в одно из значений "PyQt6", "PySide6", "PyQt5", "PySide2" (регистр не учитывается), это связывание выбирается. (См. также документацию по Переменным среды.)
В противном случае выбирается первая доступная подсистема в порядке PyQt6, PySide6, PyQt5, PySide2.

В прошлом Matplotlib имел отдельные подсистемы для каждой версии Qt (например, qt4agg/matplotlib.backends.backend_qt4agg и qt5agg/matplotlib.backends.backend_qt5agg). Эта схема была отменена с добавлением поддержки Qt6. Для обратной совместимости qt5agg/backend_qt5agg и qt5cairo/backend_qt5cairo остаются доступными; выбор одной из этих подсистем принудительно использует связывание Qt5. Их использование не рекомендуется, и следует предпочесть backend_qtagg или backend_qtcairo вместо этого. Однако эти модули не будут устаревшими до тех пор, пока мы не откажемся от поддержки Qt5.

Хотя PyQt и Qt for Python (также известный как PySide) тесно отражают подлежащий C++ API, который они оборачивают, они не являются взаимозаменяемыми [2]. Чтобы учесть это, Matplotlib имеет внутренний API-слой совместимости в matplotlib.backends.qt_compat, который охватывает наши потребности. Несмотря на то, что это общедоступный модуль, мы не считаем его стабильным API для конечных пользователей, и он может измениться без предупреждения [3].