matplotlib.style
Стили — это предопределённые наборы rcParams, задающие визуальный вид графика.
В разделе Настройка Matplotlib с помощью таблиц стилей и rcParams описаны механизм и применение стилей.
В Справочнике по таблицам стилей представлен обзор встроенных стилей.
- matplotlib.style.context(style, after_reset=False)[исходный код]
-
Менеджер контекста для временного применения настроек стиля.
- Параметры:
-
- stylestr, dict, Path or list
-
Спецификация стиля. Допустимые варианты:
- str
-
- Одно из имён стилей в
style.available(встроенный стиль или стиль, установленный в каталоге пользовательской библиотеки). - Имя с точками в формате "package.style_name"; в этом случае "package" должно быть именем импортируемого пакета 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()[исходный код]
-
Перезагрузить библиотеку стилей.
- matplotlib.style.use(style)[исходный код]
-
Использовать настройки стиля Matplotlib из спецификации стиля.
Имя стиля 'default' зарезервировано для возврата к настройкам стиля по умолчанию.
Примечание
Настройки стиля записываются в
rcParams. Не заданные в стиле элементыrcParamsсохраняются.- Параметры:
-
- stylestr, dict, Path or list
-
Спецификация стиля. Допустимые варианты:
- str
-
- Одно из имён стилей в
style.available(встроенный стиль или стиль, установленный в каталоге пользовательской библиотеки). - Имя с точками в формате "package.style_name"; в этом случае "package" должно быть именем импортируемого пакета 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
-
Словарь, сопоставляющий имена стилей с
rcParams, определяющими эти стили.Предназначен только для чтения. Для обновления используйте
reload_library.
- matplotlib.style.available
-
Список имён доступных стилей.
Предназначен только для чтения. Для обновления используйте
reload_library.
© 2012–2026 Matplotlib Development Team. All rights reserved.
Licensed under the Matplotlib License Agreement.
https://matplotlib.org/stable/api/style_api.html