matplotlib

matplotlib.use(backend, warn=False, force=True) [source]

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

Параметры:

backend : str Бэкэнд для переключения. Это может быть одно из стандартных имён бэкэндов, не чувствительных к регистру: интерактивные бэкэнды: 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. warn : bool, optional, default: False Если True и не force, выводить предупреждение о том, что вызов не повлияет, если он вызван после импорта pyplot и настройки бэкэнда. force : bool, optional, default: True Если True, попытаться переключиться на бэкэнд. ImportError возникает, если выбран интерактивный бэкэнд, но другой интерактивный бэкэнд уже запущен.

См. также

Бэкэнды

matplotlib.get_backend

matplotlib.get_backend() [source]

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

См. также

matplotlib.use

matplotlib.rcParams

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

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

Возвращает менеджер контекста для управления настройками 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) [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')

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

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, *, use_default_template=True) [source]

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

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

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

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), не обновляются.

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

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

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

copy(self) [source]

find_all(self, pattern) [source]

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

Примечание

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

msg_backend_obsolete

msg_depr

msg_depr_ignore

msg_depr_set

msg_obsolete

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

matplotlib.rc_params(fail_on_error=False) [source]

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

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

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

Параметры:

fname : str Имя файла, анализируемого для настроек matplotlib. fail_on_error : bool Если True, выводит ошибку, когда анализатор не может преобразовать параметр. use_default_template : bool Если 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.interactive(b) [source]

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

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

matplotlib.is_interactive() [source]

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

matplotlib.set_loglevel(level) [source]

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

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

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

Примечания

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