matplotlib

Управление бэкендами

matplotlib.use(backend, warn=<deprecated parameter>, force=True) [source]

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

Параметры:

backendstr Бэкенд, на который требуется переключиться. Это может быть одно из стандартных имён бэкендов, нечувствительных к регистру: интерактивные бэкенды: GTK3Agg, GTK3Cairo, MacOSX, nbAgg, Qt4Agg, Qt4Cairo, Qt5Agg, Qt5Cairo, TkAgg, TkCairo, WebAgg, WX, WXAgg, WXCairo неинтерактивные бэкенды: agg, cairo, pdf, pgf, ps, svg, template или строка вида: module://my.module.name. warnbool, optional, default: False Если True и не force, вывести предупреждение, если при переключении произошла ошибка ImportError. Этот параметр устарел. forcebool, optional, default: True Если True (по умолчанию), вызовите ImportError, если бэкенд не может быть настроен (либо из-за неудачного импорта, либо из-за того, что уже запущен несовместимый интерактивный фреймворк графического интерфейса); если False, проигнорировать ошибку.

См. также

Бэкенды

matplotlib.get_backend

matplotlib.get_backend() [source]

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

См. также

matplotlib.use

matplotlib.interactive(b) [source]

Установить, нужно ли перерисовывать после каждой команды построения графика (например, pyplot.xlabel).

matplotlib.is_interactive() [source]

Возвращает, нужно ли перерисовывать после каждой команды построения графика.

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

matplotlib.rcParams

Экземпляр RcParams для управления значениями параметров по умолчанию Matplotlib.

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

Объект словаря с валидацией.

Функции валидации определены и связаны с параметрами rc в matplotlib.rcsetup.

См. также

Файл matplotlibrc

find_all(self, pattern) [source]

Возвращает подмножество словаря RcParams, ключи которого соответствуют, используя re.search(), заданному pattern.

Примечание

Изменения в возвращаемом словаре не распространяются на родительский словарь RcParams.

matplotlib.rc_context(rc=None, fname=None) [source]

Возвращает контекстный менеджер для управления настройками rc.

Это позволяет сделать следующее:

with mpl.rc_context(fname='screen.rc'):
    plt.plot(x, a)  # uses 'screen.rc'
    with mpl.rc_context(fname='print.rc'):
        plt.plot(x, b)  # uses 'print.rc'
    plt.plot(x, c)  # uses 'screen.rc'

Словарь также можно передать в контекстный менеджер:

with mpl.rc_context(rc={'text.usetex': True}, fname='screen.rc'):
    plt.plot(x, a)

Словарь 'rc' имеет приоритет над настройками, загруженными из 'fname'. Передача только словаря также допустима. Например, распространённое использование:

with mpl.rc_context(rc={'interactive': False}):
    fig, ax = plt.subplots()
    ax.plot(range(3), range(3))
    fig.savefig('A.png', format='png')
    plt.close(fig)

matplotlib.rc(group, **kwargs) [source]

Установить текущие параметры rc. group — группировка для rc, например, для lines.linewidth группа — lines, для axes.facecolor, группа — axes, и так далее. Группа также может быть списком или кортежем имён групп, например, (xtick, ytick). kwargs — словарь пар имя/значение атрибутов, например:

rc('lines', linewidth=2, color='r')

устанавливает текущие параметры rc и эквивалентно:

rcParams['lines.linewidth'] = 2
rcParams['lines.color'] = 'r'

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

Псевдоним	Свойство
'lw'	'linewidth'
'ls'	'linestyle'
'c'	'color'
'fc'	'facecolor'
'ec'	'edgecolor'
'mew'	'markeredgewidth'
'aa'	'antialiased'

Таким образом, вы можете сократить приведенную выше команду rc как:

rc('lines', lw=2, c='r')

Обратите внимание, что вы можете использовать возможность python's kwargs для хранения словарей параметров по умолчанию. Например, вы можете настроить параметры шрифта rc следующим образом:

font = {'family' : 'monospace',
        'weight' : 'bold',
        'size'   : 'larger'}
rc('font', **font)  # pass in the font dict as kwargs

Это позволяет легко переключаться между несколькими конфигурациями. Используйте matplotlib.style.use('default') или rcdefaults(), чтобы восстановить параметры rc по умолчанию после изменений.

Примечания

Аналогичная функциональность доступна при использовании обычного интерфейса словаря, т.е. rcParams.update({"lines.linewidth": 2, ...}) (но rcParams.update не поддерживает сокращения или группировку).

matplotlib.rcdefaults() [source]

Восстановить параметры rc из внутреннего стиля по умолчанию Matplotlib.

Параметры rc, исключенные из стиля (определённые в matplotlib.style.core.STYLE_BLACKLIST), не обновляются.

См. также

rc_file_defaults

Восстановить параметры rc из файла rc, первоначально загруженного Matplotlib.

matplotlib.style.use

Использовать определённый файл стиля. Вызовите style.use('default') для восстановления стиля по умолчанию.

matplotlib.rc_file_defaults() [source]

Восстановить параметры rc из исходного файла rc, загруженного Matplotlib.

Параметры rc, исключенные из стиля (определённые в matplotlib.style.core.STYLE_BLACKLIST), не обновляются.

matplotlib.rc_file(fname, *, use_default_template=True) [source]

Обновить параметры rc из файла.

Параметры rc, исключенные из стиля (определённые в matplotlib.style.core.STYLE_BLACKLIST), не обновляются.

Параметры:	fnamestr Имя файла, обрабатываемого для параметров Matplotlib. use_default_templatebool Если True, инициализировать параметрами по умолчанию перед обновлением их значениями из данного файла. Если False, текущая конфигурация сохраняется, и обновляются только параметры, указанные в файле.

matplotlib.rc_params(fail_on_error=False) [source]

Создать экземпляр RcParams из файла параметров rc по умолчанию Matplotlib.

matplotlib.rc_params_from_file(fname, fail_on_error=False, use_default_template=True) [source]

Создать RcParams из файла fname.

Параметры:

fnamestr or path-like Имя файла, обрабатываемого для параметров Matplotlib. fail_on_errorbool Если True, генерировать ошибку, когда парсер не может преобразовать параметр. use_default_templatebool Если True, инициализировать значениями по умолчанию перед обновлением параметрами из заданного файла. Если False, класс конфигурации содержит только параметры, указанные в файле. (Полезно для обновления словарей.)

matplotlib.matplotlib_fname() [source]

Получить расположение файла конфигурации.

Расположение файла определяется в следующем порядке:

• $PWD/matplotlibrc
• $MATPLOTLIBRC если это не каталог
• $MATPLOTLIBRC/matplotlibrc
• $MPLCONFIGDIR/matplotlibrc

• В Linux:

  • $XDG_CONFIG_HOME/matplotlib/matplotlibrc (если $XDG_CONFIG_HOME определено)
  • или $HOME/.config/matplotlib/matplotlibrc (если $XDG_CONFIG_HOME не определено)

• На других платформах — $HOME/.matplotlib/matplotlibrc если $HOME определено
• В конце ищется в $MATPLOTLIBDATA/matplotlibrc, который всегда должен существовать.

matplotlib.get_data_path(*, _from_rc=None) [source]

Возвращает путь к данным Matplotlib.

Ведение журнала

matplotlib.set_loglevel(level) [source]

Устанавливает уровень обработчика корневого логгера Matplotlib, создавая обработчик, если он еще не существует.

Обычно для получения дополнительной отладочной информации следует вызвать set_loglevel("info") или set_loglevel("debug").

Параметры:	level{"notset", "debug", "info", "warning", "error", "critical"} Уровень журнала обработчика.

Примечания

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