matplotlib.style
Стили — это предопределенные наборы rcParams, которые определяют визуальный вид графика.
Настройка Matplotlib с помощью стилей и rcParams описывает механизм и использование стилей.
Справочник по стилям предоставляет обзор встроенных стилей.
- matplotlib.style.context(style, after_reset=False)[source]
-
Менеджер контекста для временного использования настроек стиля.
- Параметры:
-
- stylestr, dict, Path или список
-
Спецификация стиля. Допустимые варианты:
- str
-
- Одно из имён стилей в
style.available(встроенный стиль или стиль, установленный в пути библиотеки пользователя). - Точечное имя вида "пакет.имя_стиля"; в этом случае "пакет" должен быть импортируемым именем Python-пакета, например, в
/path/to/package/__init__.py; загружаемый файл стиля —/path/to/package/style_name.mplstyle. (Аналогично поддерживаются файлы стилей в подпакетах.) - Путь или URL к файлу стиля, который загружается с помощью
rc_params_from_file.
- Одно из имён стилей в
- dict
-
Сопоставление пар ключ/значение для
matplotlib.rcParams. - Path
-
Путь к файлу стиля, который загружается с помощью
rc_params_from_file. - list
-
Список спецификаторов стиля (str, Path или dict), которые применяются от первого к последнему в списке.
- after_resetbool
-
Если True, применяет стиль после сброса настроек до значений по умолчанию; в противном случае применяет стиль поверх текущих настроек.
- matplotlib.style.reload_library()[source]
-
Перезагрузить библиотеку стилей.
- matplotlib.style.use(style)[source]
-
Использовать настройки стиля Matplotlib из спецификации стиля.
Имя стиля 'default' зарезервировано для возврата к настройкам стиля по умолчанию.
Примечание
Это обновляет
rcParamsнастройками из стиля.rcParams, которые не определены в стиле, сохраняются.- Параметры:
-
- stylestr, dict, Path или список
-
Спецификация стиля. Допустимые варианты:
- str
-
- Одно из имён стилей в
style.available(встроенный стиль или стиль, установленный в пути библиотеки пользователя). - Точечное имя вида "пакет.имя_стиля"; в этом случае "пакет" должен быть импортируемым именем Python-пакета, например, в
/path/to/package/__init__.py; загружаемый файл стиля —/path/to/package/style_name.mplstyle. (Аналогично поддерживаются файлы стилей в подпакетах.) - Путь или URL к файлу стиля, который загружается с помощью
rc_params_from_file.
- Одно из имён стилей в
- dict
-
Сопоставление пар ключ/значение для
matplotlib.rcParams. - Path
-
Путь к файлу стиля, который загружается с помощью
rc_params_from_file. - list
-
Список спецификаторов стиля (str, Path или dict), которые применяются от первого к последнему в списке.
Примечания
Следующие
rcParamsне относятся к стилю и будут проигнорированы, если найдены в спецификации стиля:- backend
- backend_fallback
- date.epoch
- docstring.hardcopy
- figure.max_open_warning
- figure.raise_window
- interactive
- savefig.directory
- timezone
- tk.window_focus
- toolbar
- webagg.address
- webagg.open_in_browser
- webagg.port
- webagg.port_retries
- matplotlib.style.library[source]
-
Словарь, сопоставляющий имя стиля с
rcParams, определяющим этот стиль.Это предназначено для чтения только. Используйте
reload_libraryдля обновления.
- matplotlib.style.available
-
Список имён доступных стилей.
Это предназначено для чтения только. Используйте
reload_libraryдля обновления.
© 2012–2023 Matplotlib Development Team. All rights reserved.
Licensed under the Matplotlib License Agreement.
https://matplotlib.org/3.7.5/api/style_api.html