Модуль matplotlib верхнего уровня

matplotlib.use(arg, warn=True, force=False)

Установите графический интерфейс matplotlib на один из известных.

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

Примечание

Эта функция должна вызываться до первого импорта pyplot; или, если вы не используете pyplot, она должна быть вызвана до импорта matplotlib.backends. Если warn равно True, выводится предупреждение, если вы пытаетесь вызвать это после загрузки pylab или pyplot. В некоторых случаях, например, при использовании pyplot.switch_backend(), мы выполняем перезагрузку, необходимую для работы переключения интерфейса (в некоторых случаях, например, с интерфейсами, работающими только с изображениями), поэтому можно установить warn=False, чтобы подавить предупреждения.

Чтобы узнать, какой интерфейс установлен в настоящее время, см. matplotlib.get_backend().

matplotlib.get_backend()

Возвращает имя текущего интерфейса.

matplotlib.rcParams

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

matplotlib.rc(group, **kwargs)

Установить текущие параметры rc. Группа — это группа для 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')

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

font = {'family' : 'monospace',
        'weight' : 'bold',
        'size'   : 'larger'}

rc('font', **font)  # pass in the font dict as kwargs

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

matplotlib.matplotlib_fname()

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

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

• $PWD/matplotlibrc
• $MATPLOTLIBRC/matplotlibrc
• $MPLCONFIGDIR/matplotlibrc

• В Linux:

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

• На других платформах:

  • $HOME/.matplotlib/matplotlibrc если $HOME определено.
• Наконец, ищет системную копию в $MATPLOTLIBDATA/matplotlibrc.

class matplotlib.RcParams(*args, **kwargs)

Объект словаря, включающий проверку

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

matplotlib.rc_params(fail_on_error=False)

Возвращает экземпляр matplotlib.RcParams из файла параметров по умолчанию matplotlib.

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

Возвращает matplotlib.RcParams из содержимого заданного файла.

Параметры:

fname : str Имя файла, проанализированного для параметров matplotlib. fail_on_error : bool Если True, генерирует ошибку, когда анализатор не может преобразовать параметр. use_default_template : bool Если True, инициализирует значениями параметров по умолчанию перед обновлением их значениями из указанного файла. Если False, класс конфигурации содержит только параметры, указанные в файле. (Полезно для обновления словарей.)

class matplotlib.rc_context(rc=None, fname=None)

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

Это позволяет выполнить:

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

Графики ‘a’ против ‘x’ и ‘c’ против ‘x’ будут иметь параметры из ‘screen.rc’, а график ‘b’ против ‘x’ — из ‘print.rc’.

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

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

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