Модуль 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_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». Передача только словаря также допустима. Например, распространенное использование:

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)

Установить текущие параметры 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

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

matplotlib.rc_file(fname)

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

matplotlib.rcdefaults()

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

См. также

rc_file_defaults

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

matplotlib.style.use

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

matplotlib.rc_file_defaults()

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

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

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

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

find_all(pattern)

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

Примечание

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

msg_depr = '%s is deprecated and replaced with %s; please use the latter.'

msg_depr_ignore = '%s is deprecated and ignored. Use %s'

msg_depr_set = '%s is deprecated. Please remove it from your matplotlibrc and/or style files.'

msg_obsolete = '%s is obsolete. Please remove it from your matplotlibrc and/or style files.'

validate = {'backend': <function validate_backend>, 'backend_fallback': <function validate_bool>, 'backend.qt4': <matplotlib.rcsetup.ValidateInStrings object>, 'backend.qt5': <matplotlib.rcsetup.ValidateInStrings object>, 'webagg.port': <function validate_int>, 'webagg.open_in_browser': <function validate_bool>, 'webagg.port_retries': <function validate_int>, 'nbagg.transparent': <function validate_bool>, 'toolbar': <function validate_toolbar>, 'datapath': <function validate_path_exists>, 'interactive': <function validate_bool>, 'timezone': <class 'str'>, 'verbose.level': <matplotlib.rcsetup.ValidateInStrings object>, 'verbose.fileo': <class 'str'>, 'lines.linewidth': <function validate_float>, 'lines.linestyle': <function _validate_linestyle>, 'lines.color': <function validate_color>, 'lines.marker': <class 'str'>, 'lines.markeredgewidth': <function validate_float>, 'lines.markersize': <function validate_float>, 'lines.antialiased': <function validate_bool>, 'lines.dash_joinstyle': <matplotlib.rcsetup.ValidateInStrings object>, 'lines.solid_joinstyle': <matplotlib.rcsetup.ValidateInStrings object>, 'lines.dash_capstyle': <matplotlib.rcsetup.ValidateInStrings object>, 'lines.solid_capstyle': <matplotlib.rcsetup.ValidateInStrings object>, 'lines.dashed_pattern': <matplotlib.rcsetup.validate_nseq_float object>, 'lines.dashdot_pattern': <matplotlib.rcsetup.validate_nseq_float object>, 'lines.dotted_pattern': <matplotlib.rcsetup.validate_nseq_float object>, 'lines.scale_dashes': <function validate_bool>, 'markers.fillstyle': <matplotlib.rcsetup.ValidateInStrings object>, 'patch.linewidth': <function validate_float>, 'patch.edgecolor': <function validate_color>, 'patch.force_edgecolor': <function validate_bool>, 'patch.facecolor': <function validate_color>, 'patch.antialiased': <function validate_bool>, 'hatch.color': <function validate_color>, 'hatch.linewidth': <function validate_float>, 'hist.bins': <function validate_hist_bins>, 'boxplot.notch': <function validate_bool>, 'boxplot.vertical': <function validate_bool>, 'boxplot.whiskers': <function validate_whiskers>, 'boxplot.bootstrap': <function validate_int_or_None>, 'boxplot.patchartist': <function validate_bool>, 'boxplot.showmeans': <function validate_bool>, 'boxplot.showcaps': <function validate_bool>, 'boxplot.showbox': <function validate_bool>, 'boxplot.showfliers': <function validate_bool>, 'boxplot.meanline': <function validate_bool>, 'boxplot.flierprops.color': <function validate_color>, 'boxplot.flierprops.marker': <class 'str'>, 'boxplot.flierprops.markerfacecolor': <function validate_color_or_auto>, 'boxplot.flierprops.markeredgecolor': <function validate_color>, 'boxplot.flierprops.markersize': <function validate_float>, 'boxplot.flierprops.linestyle': <function _validate_linestyle>, 'boxplot.flierprops.linewidth': <function validate_float>, 'boxplot.boxprops.color': <function validate_color>, 'boxplot.boxprops.linewidth': <function validate_float>, 'boxplot.boxprops.linestyle': <function _validate_linestyle>, 'boxplot.whiskerprops.color': <function validate_color>, 'boxplot.whiskerprops.linewidth': <function validate_float>, 'boxplot.whiskerprops.linestyle': <function _validate_linestyle>, 'boxplot.capprops.color': <function validate_color>, 'boxplot.capprops.linewidth': <function validate_float>, 'boxplot.capprops.linestyle': <function _validate_linestyle>, 'boxplot.medianprops.color': <function validate_color>, 'boxplot.medianprops.linewidth': <function validate_float>, 'boxplot.medianprops.linestyle': <function _validate_linestyle>, 'boxplot.meanprops.color': <function validate_color>, 'boxplot.meanprops.marker': <class 'str'>, 'boxplot.meanprops.markerfacecolor': <function validate_color>, 'boxplot.meanprops.markeredgecolor': <function validate_color>, 'boxplot.meanprops.markersize': <function validate_float>, 'boxplot.meanprops.linestyle': <function _validate_linestyle>, 'boxplot.meanprops.linewidth': <function validate_float>, 'font.family': <function _listify_validator.<locals>.f>, 'font.style': <class 'str'>, 'font.variant': <class 'str'>, 'font.stretch': <class 'str'>, 'font.weight': <class 'str'>, 'font.size': <function validate_float>, 'font.serif': <function _listify_validator.<locals>.f>, 'font.sans-serif': <function _listify_validator.<locals>.f>, 'font.cursive': <function _listify_validator.<locals>.f>, 'font.fantasy': <function _listify_validator.<locals>.f>, 'font.monospace': <function _listify_validator.<locals>.f>, 'text.color': <function validate_color>, 'text.usetex': <function validate_bool>, 'text.latex.unicode': <function validate_bool>, 'text.latex.preamble': <function _listify_validator.<locals>.f>, 'text.latex.preview': <function validate_bool>, 'text.hinting': <function validate_hinting>, 'text.hinting_factor': <function validate_int>, 'text.antialiased': <function validate_bool>, 'mathtext.cal': <function validate_font_properties>, 'mathtext.rm': <function validate_font_properties>, 'mathtext.tt': <function validate_font_properties>, 'mathtext.it': <function validate_font_properties>, 'mathtext.bf': <function validate_font_properties>, 'mathtext.sf': <function validate_font_properties>, 'mathtext.fontset': <matplotlib.rcsetup.ValidateInStrings object>, 'mathtext.default': <matplotlib.rcsetup.ValidateInStrings object>, 'mathtext.fallback_to_cm': <function validate_bool>, 'image.aspect': <function validate_aspect>, 'image.interpolation': <class 'str'>, 'image.cmap': <class 'str'>, 'image.lut': <function validate_int>, 'image.origin': <class 'str'>, 'image.resample': <function validate_bool>, 'image.composite_image': <function validate_bool>, 'contour.negative_linestyle': <function _validate_linestyle>, 'contour.corner_mask': <function validate_corner_mask>, 'errorbar.capsize': <function validate_float>, 'axes.axisbelow': <function validate_axisbelow>, 'axes.hold': <function deprecate_axes_hold>, 'axes.facecolor': <function validate_color>, 'axes.edgecolor': <function validate_color>, 'axes.linewidth': <function validate_float>, 'axes.spines.left': <function validate_bool>, 'axes.spines.right': <function validate_bool>, 'axes.spines.bottom': <function validate_bool>, 'axes.spines.top': <function validate_bool>, 'axes.titlesize': <function validate_fontsize>, 'axes.titleweight': <class 'str'>, 'axes.titlepad': <function validate_float>, 'axes.grid': <function validate_bool>, 'axes.grid.which': <matplotlib.rcsetup.ValidateInStrings object>, 'axes.grid.axis': <matplotlib.rcsetup.ValidateInStrings object>, 'axes.labelsize': <function validate_fontsize>, 'axes.labelpad': <function validate_float>, 'axes.labelweight': <class 'str'>, 'axes.labelcolor': <function validate_color>, 'axes.formatter.limits': <matplotlib.rcsetup.validate_nseq_int object>, 'axes.formatter.use_locale': <function validate_bool>, 'axes.formatter.use_mathtext': <function validate_bool>, 'axes.formatter.min_exponent': <function validate_int>, 'axes.formatter.useoffset': <function validate_bool>, 'axes.formatter.offset_threshold': <function validate_int>, 'axes.unicode_minus': <function validate_bool>, 'axes.prop_cycle': <function validate_cycler>, 'axes.autolimit_mode': <matplotlib.rcsetup.ValidateInStrings object>, 'axes.xmargin': <matplotlib.rcsetup.ValidateInterval object>, 'axes.ymargin': <matplotlib.rcsetup.ValidateInterval object>, 'polaraxes.grid': <function validate_bool>, 'axes3d.grid': <function validate_bool>, 'scatter.marker': <class 'str'>, 'date.autoformatter.year': <class 'str'>, 'date.autoformatter.month': <class 'str'>, 'date.autoformatter.day': <class 'str'>, 'date.autoformatter.hour': <class 'str'>, 'date.autoformatter.minute': <class 'str'>, 'date.autoformatter.second': <class 'str'>, 'date.autoformatter.microsecond': <class 'str'>, 'legend.fancybox': <function validate_bool>, 'legend.loc': <matplotlib.rcsetup.ValidateInStrings object>, 'legend.numpoints': <function validate_int>, 'legend.scatterpoints': <function validate_int>, 'legend.fontsize': <function validate_fontsize>, 'legend.markerscale': <function validate_float>, 'legend.shadow': <function validate_bool>, 'legend.frameon': <function validate_bool>, 'legend.framealpha': <function validate_float_or_None>, 'legend.borderpad': <function validate_float>, 'legend.labelspacing': <function validate_float>, 'legend.handlelength': <function validate_float>, 'legend.handleheight': <function validate_float>, 'legend.handletextpad': <function validate_float>, 'legend.borderaxespad': <function validate_float>, 'legend.columnspacing': <function validate_float>, 'legend.facecolor': <function validate_color_or_inherit>, 'legend.edgecolor': <function validate_color_or_inherit>, 'xtick.top': <function validate_bool>, 'xtick.bottom': <function validate_bool>, 'xtick.major.size': <function validate_float>, 'xtick.minor.size': <function validate_float>, 'xtick.major.width': <function validate_float>, 'xtick.minor.width': <function validate_float>, 'xtick.major.pad': <function validate_float>, 'xtick.minor.pad': <function validate_float>, 'xtick.color': <function validate_color>, 'xtick.minor.visible': <function validate_bool>, 'xtick.minor.top': <function validate_bool>, 'xtick.minor.bottom': <function validate_bool>, 'xtick.major.top': <function validate_bool>, 'xtick.major.bottom': <function validate_bool>, 'xtick.labelsize': <function validate_fontsize>, 'xtick.direction': <class 'str'>, 'xtick.alignment': <matplotlib.rcsetup.ValidateInStrings object>, 'ytick.left': <function validate_bool>, 'ytick.right': <function validate_bool>, 'ytick.major.size': <function validate_float>, 'ytick.minor.size': <function validate_float>, 'ytick.major.width': <function validate_float>, 'ytick.minor.width': <function validate_float>, 'ytick.major.pad': <function validate_float>, 'ytick.minor.pad': <function validate_float>, 'ytick.color': <function validate_color>, 'ytick.minor.visible': <function validate_bool>, 'ytick.minor.left': <function validate_bool>, 'ytick.minor.right': <function validate_bool>, 'ytick.major.left': <function validate_bool>, 'ytick.major.right': <function validate_bool>, 'ytick.labelsize': <function validate_fontsize>, 'ytick.direction': <class 'str'>, 'ytick.alignment': <matplotlib.rcsetup.ValidateInStrings object>, 'grid.color': <function validate_color>, 'grid.linestyle': <function _validate_linestyle>, 'grid.linewidth': <function validate_float>, 'grid.alpha': <function validate_float>, 'figure.titlesize': <function validate_fontsize>, 'figure.titleweight': <class 'str'>, 'figure.figsize': <matplotlib.rcsetup.validate_nseq_float object>, 'figure.dpi': <function validate_float>, 'figure.facecolor': <function validate_color>, 'figure.edgecolor': <function validate_color>, 'figure.frameon': <function validate_bool>, 'figure.autolayout': <function validate_bool>, 'figure.max_open_warning': <function validate_int>, 'figure.subplot.left': <matplotlib.rcsetup.ValidateInterval object>, 'figure.subplot.right': <matplotlib.rcsetup.ValidateInterval object>, 'figure.subplot.bottom': <matplotlib.rcsetup.ValidateInterval object>, 'figure.subplot.top': <matplotlib.rcsetup.ValidateInterval object>, 'figure.subplot.wspace': <matplotlib.rcsetup.ValidateInterval object>, 'figure.subplot.hspace': <matplotlib.rcsetup.ValidateInterval object>, 'savefig.dpi': <function validate_dpi>, 'savefig.facecolor': <function validate_color>, 'savefig.edgecolor': <function validate_color>, 'savefig.frameon': <function validate_bool>, 'savefig.orientation': <matplotlib.rcsetup.ValidateInStrings object>, 'savefig.jpeg_quality': <function validate_int>, 'savefig.format': <function update_savefig_format>, 'savefig.bbox': <function validate_bbox>, 'savefig.pad_inches': <function validate_float>, 'savefig.directory': <class 'str'>, 'savefig.transparent': <function validate_bool>, 'tk.window_focus': <function validate_bool>, 'ps.papersize': <matplotlib.rcsetup.ValidateInStrings object>, 'ps.useafm': <function validate_bool>, 'ps.usedistiller': <function validate_ps_distiller>, 'ps.distiller.res': <function validate_int>, 'ps.fonttype': <function validate_fonttype>, 'pdf.compression': <function validate_int>, 'pdf.inheritcolor': <function validate_bool>, 'pdf.use14corefonts': <function validate_bool>, 'pdf.fonttype': <function validate_fonttype>, 'pgf.debug': <function validate_bool>, 'pgf.texsystem': <matplotlib.rcsetup.ValidateInStrings object>, 'pgf.rcfonts': <function validate_bool>, 'pgf.preamble': <function _listify_validator.<locals>.f>, 'svg.image_inline': <function validate_bool>, 'svg.fonttype': <matplotlib.rcsetup.ValidateInStrings object>, 'svg.hashsalt': <function validate_string_or_None>, 'docstring.hardcopy': <function validate_bool>, 'plugins.directory': <class 'str'>, 'path.simplify': <function validate_bool>, 'path.simplify_threshold': <matplotlib.rcsetup.ValidateInterval object>, 'path.snap': <function validate_bool>, 'path.sketch': <function validate_sketch>, 'path.effects': <function validate_any>, 'agg.path.chunksize': <function validate_int>, 'keymap.fullscreen': <function _listify_validator.<locals>.f>, 'keymap.home': <function _listify_validator.<locals>.f>, 'keymap.back': <function _listify_validator.<locals>.f>, 'keymap.forward': <function _listify_validator.<locals>.f>, 'keymap.pan': <function _listify_validator.<locals>.f>, 'keymap.zoom': <function _listify_validator.<locals>.f>, 'keymap.save': <function _listify_validator.<locals>.f>, 'keymap.quit': <function _listify_validator.<locals>.f>, 'keymap.quit_all': <function _listify_validator.<locals>.f>, 'keymap.grid': <function _listify_validator.<locals>.f>, 'keymap.grid_minor': <function _listify_validator.<locals>.f>, 'keymap.yscale': <function _listify_validator.<locals>.f>, 'keymap.xscale': <function _listify_validator.<locals>.f>, 'keymap.all_axes': <function _listify_validator.<locals>.f>, 'examples.directory': <class 'str'>, 'animation.html': <matplotlib.rcsetup.ValidateInStrings object>, 'animation.embed_limit': <function validate_float>, 'animation.writer': <matplotlib.rcsetup.ValidateInStrings object>, 'animation.codec': <class 'str'>, 'animation.bitrate': <function validate_int>, 'animation.frame_format': <matplotlib.rcsetup.ValidateInStrings object>, 'animation.html_args': <function _listify_validator.<locals>.f>, 'animation.ffmpeg_path': <function validate_animation_writer_path>, 'animation.ffmpeg_args': <function _listify_validator.<locals>.f>, 'animation.avconv_path': <function validate_animation_writer_path>, 'animation.avconv_args': <function _listify_validator.<locals>.f>, 'animation.mencoder_path': <function validate_animation_writer_path>, 'animation.mencoder_args': <function _listify_validator.<locals>.f>, 'animation.convert_path': <function validate_animation_writer_path>, 'animation.convert_args': <function _listify_validator.<locals>.f>, '_internal.classic_mode': <function validate_bool>}

matplotlib.rc_params(fail_on_error=False)

Возвращает экземпляр matplotlib.RcParams из файла параметров rc 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, класс конфигурации содержит только параметры, указанные в файле. (Полезно для обновления словарей.)

matplotlib.matplotlib_fname()

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

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

• $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.interactive(b)

Установить интерактивный режим в булево значение b.

Если b равно True, то отрисовка происходит после каждой команды построения графика, например, после xlabel

matplotlib.is_interactive()

Возвращает true, если режим построения интерактивный