`matplotlib`¶

后端管理¶

matplotlib.use(backend, *, force=True)[源代码]¶

选择用于呈现和GUI集成的后端。

参数:

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 .

forcebool，默认值：True

如果为True（默认值），则引发 ImportError 如果后端无法设置（可能是因为它无法导入，或者是因为不兼容的GUI交互框架已经在运行）；如果为False，则忽略失败。

参见

后端
matplotlib.get_backend

matplotlib.get_backend()[源代码]¶

返回当前后端的名称。

参见

matplotlib.use

matplotlib.interactive(b)[源代码]¶: 设置是否在每次打印命令后重画（例如。 pyplot.xlabel ）

matplotlib.is_interactive()[源代码]¶: 返回每个打印命令后是否重画。

默认值和样式¶

matplotlib.rcParams¶: 的实例 RcParams 用于处理默认Matplotlib值。

class matplotlib.RcParams(*args, **kwargs)[源代码]¶

包含验证的dictionary对象。

验证函数在中定义并与rc参数关联 matplotlib.rcsetup .

参见

这个 matplotlibrc 文件

find_all(pattern)[源代码]¶: 返回此rcparms字典的子集，其键匹配，使用 re.search() 给定的 pattern .

注解

对返回字典的更改是 not 传播到父RCPARMS字典。

matplotlib.rc_context(rc=None, fname=None)[源代码]¶

返回用于临时更改rcParams的上下文管理器。

参数:	rc双关语要临时设置的rcParams。 fnamestr或path-like 具有Matplotlib rc设置的文件。如果两者都有文件名和 rc 已给定，设置来自 rc 优先考虑。

参见

这个 matplotlibrc 文件

实例

通过dict传递显式值：

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

从文件加载设置：

with mpl.rc_context(fname='print.rc'):
    plt.plot(x, y)  # uses 'print.rc'

matplotlib.rc(group, **kwargs)[源代码]¶

设置电流 rcParams . 组是RC的分组，例如 lines.linewidth 该组是 lines ，为了 axes.facecolor ，该组是 axes 等等。组也可以是组名的列表或元组，例如（ XICK ， 伊蒂克 ） 关键字参数 是字典属性名/值对，例如：

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

设置当前值 rcParams 相当于：

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

以下别名可用于保存交互式用户的键入：

别名	财产
“LW”	“线宽”
“LS”	“直线式”
“C”	“颜色”
“FC”	“脸色”
“EC”	“EdgCeor”
“喵”	'标记边缘宽度'
“AA”	“反锯齿”

因此，您可以将上述调用缩写为：

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

注意，您可以使用python的kwargs字典工具来存储默认参数的字典。例如，您可以自定义字体rc，如下所示：

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

这使您能够轻松地在多个配置之间切换。使用 matplotlib.style.use('default') 或 rcdefaults() 恢复默认值 rcParams 更改后。

笔记

使用普通dict接口也可以使用类似的功能，即。 rcParams.update({{"lines.linewidth": 2, ...}}) （但是 rcParams.update 不支持缩写或分组）。

matplotlib.rcdefaults()[源代码]¶

恢复 rcParams 来自Matplotlib的内部默认样式。

样式被列入黑名单 rcParams （定义在 matplotlib.style.core.STYLE_BLACKLIST ）未更新。

参见

matplotlib.rc_file_defaults: 恢复 rcParams 从最初由Matplotlib加载的rc文件。
matplotlib.style.use: 使用特定的样式文件。呼叫 style.use('default') 恢复默认样式。

matplotlib.rc_file_defaults()[源代码]¶

恢复 rcParams 从Matplotlib加载的原始rc文件。

样式被列入黑名单 rcParams （定义在 matplotlib.style.core.STYLE_BLACKLIST ）未更新。

matplotlib.rc_file(fname, *, use_default_template=True)[源代码]¶

更新 rcParams 从文件。

样式被列入黑名单 rcParams （定义在 matplotlib.style.core.STYLE_BLACKLIST ）未更新。

参数:	fnamestr或path-like 具有Matplotlib rc设置的文件。 use_default_template布尔如果为True，则在使用给定文件中的参数更新之前使用默认参数初始化。如果为False，则当前配置将继续，并且仅更新文件中指定的参数。

matplotlib.rc_params(fail_on_error=False)[源代码]¶: 构建一个 RcParams 来自默认Matplotlib rc文件的实例。

matplotlib.rc_params_from_file(fname, fail_on_error=False, use_default_template=True)[源代码]¶

构建一个 RcParams 从文件 文件名 .

参数:	fnamestr或path-like 具有Matplotlib rc设置的文件。 fail_on_error布尔如果为true，则在分析器无法转换参数时引发错误。 use_default_template布尔如果为true，则在使用给定文件中的参数进行更新之前使用默认参数进行初始化。如果为false，则配置类只包含文件中指定的参数。（用于更新听写。）

matplotlib.get_configdir()[源代码]¶

返回配置目录的字符串路径。

目录选择如下：

如果提供了MPLCONFIGDIR环境变量，请选择该变量。
在Linux上，遵循XDG规范并首先查看 $XDG_CONFIG_HOME ，如果定义，或 $HOME/.config . 在其他平台上，选择 $HOME/.matplotlib .
如果所选目录存在且可写，请将其用作配置目录。
否则，创建一个临时目录，并将其用作配置目录。

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.get_data_path(*, _from_rc=None)[源代码]¶: 返回Matplotlib数据的路径。

登录中¶

matplotlib.set_loglevel(level)[源代码]¶

设置Matplotlib的根记录器和根记录器处理程序级别，如果该处理程序尚不存在，则创建该处理程序。

一般来说，应该打电话 set_loglevel("info") 或 set_loglevel("debug") 以获取其他调试信息。

参数:	level{“notset”，“debug”，“info”，“warning”，“error”，“critical”} 处理程序的日志级别。

笔记

第一次调用此函数时，会将一个附加的处理程序附加到Matplotlib的根处理程序上；每次都会重用此处理程序，并且此函数只会操作记录器和处理程序的级别。

其他¶

matplotlib.get_cachedir()[源代码]¶

返回缓存目录的字符串路径。

查找目录的过程与u getu configu dir相同，只是使用 $XDG_CACHE_HOME/$HOME/.cache 相反。

matplotlib¶

后端管理¶

默认值和样式¶

登录中¶

其他¶

`matplotlib`¶