matplotlib.rcsetup#

rcsetup 模块包含用于使用 Matplotlib 的 rc 设置进行自定义的验证代码。

每个 rc 设置都分配有一个用于验证对该设置的任何尝试性更改的函数。验证函数在 rcsetup 模块中定义,并用于构建 rcParams 全局对象,该对象存储设置并在整个 Matplotlib 中引用。

rc 设置的默认值在默认的 matplotlibrc 文件中设置。此处列出的参数集的任何添加或删除也应传播到 Matplotlib 根源代码目录中的 lib/matplotlib/mpl-data/matplotlibrc 文件。

class matplotlib.rcsetup.ValidateInStrings(key, valid, ignorecase=False, *, _deprecated_since=None)[source]#

基类: object

valid 是一个合法字符串列表。

matplotlib.rcsetup.cycler(*args, **kwargs)[source]#

创建一个 Cycler 对象,与 cycler.cycler() 类似,但包含输入验证。

调用签名

cycler(cycler)
cycler(label=values, label2=values2, ...)
cycler(label, values)

形式 1 复制给定的 Cycler 对象。

形式 2 创建一个 Cycler,它同时循环遍历一个或多个属性。如果给定多个属性,则它们的值列表必须具有相同的长度。

形式 3 为单个属性创建一个 Cycler。此形式是为了与原始 cycler 兼容而存在的。不鼓励使用此形式,而倾向于使用 kwarg 形式,即 cycler(label=values)

参数:
cyclerCycler

Cycler 的复制构造函数。

labelstr

属性键。必须是有效的 Artist 属性。例如,'color' 或 'linestyle'。允许使用别名,例如 'c' 表示 'color' 和 'lw' 表示 'linewidth'。

valuesiterable

属性值的有限长度可迭代对象。这些值经过验证,如果无效将引发 ValueError。

返回:
Cycler

用于给定属性的新 Cycler

示例

为单个属性创建 cycler

>>> c = cycler(color=['red', 'green', 'blue'])

为同时循环遍历多个属性创建 cycler(例如,红色圆圈、绿色加号、蓝色十字)

>>> c = cycler(color=['red', 'green', 'blue'],
...            marker=['o', '+', 'x'])
matplotlib.rcsetup.validate_any(s)[source]#
matplotlib.rcsetup.validate_anylist(s)[source]#
matplotlib.rcsetup.validate_aspect(s)[source]#
matplotlib.rcsetup.validate_axisbelow(s)[source]#
matplotlib.rcsetup.validate_backend(s)[source]#
matplotlib.rcsetup.validate_bbox(s)[source]#
matplotlib.rcsetup.validate_bool(b)[source]#

将 b 转换为 bool 或引发错误。

matplotlib.rcsetup.validate_color(s)[source]#

返回一个有效的颜色参数。

matplotlib.rcsetup.validate_color_for_prop_cycle(s)[source]#
matplotlib.rcsetup.validate_color_or_auto(s)[source]#
matplotlib.rcsetup.validate_color_or_inherit(s)[source]#

返回一个有效的颜色参数。

matplotlib.rcsetup.validate_colorlist(s)[source]#

返回颜色规范列表

matplotlib.rcsetup.validate_cycler(s)[source]#

从字符串表示或对象本身返回 Cycler 对象。

matplotlib.rcsetup.validate_dashlist(s)[source]#

返回浮点数列表

matplotlib.rcsetup.validate_dpi(s)[source]#

确认 s 是字符串 'figure' 或将 s 转换为浮点数,否则引发错误。

matplotlib.rcsetup.validate_fillstylelist(s)[source]#
matplotlib.rcsetup.validate_float(s)[source]#
matplotlib.rcsetup.validate_float_or_None(s)[source]#
matplotlib.rcsetup.validate_floatlist(s)[source]#

返回浮点数列表

matplotlib.rcsetup.validate_font_properties(s)[source]#
matplotlib.rcsetup.validate_fontsize(s)[source]#
matplotlib.rcsetup.validate_fontsize_None(s)[source]#
matplotlib.rcsetup.validate_fontsizelist(s)[source]#
matplotlib.rcsetup.validate_fontstretch(s)[source]#
matplotlib.rcsetup.validate_fonttype(s)[source]#

确认这是我们知道如何转换的 Postscript 或 PDF 字体类型。

matplotlib.rcsetup.validate_fontweight(s)[source]#
matplotlib.rcsetup.validate_hatch(s)[source]#

验证孵化图案。孵化图案字符串可以包含以下任意字符序列:\ / | - + * . x o O

matplotlib.rcsetup.validate_hatchlist(s)[source]#

验证孵化图案。孵化图案字符串可以包含以下任意字符序列:\ / | - + * . x o O

matplotlib.rcsetup.validate_hist_bins(s)[source]#
matplotlib.rcsetup.validate_int(s)[source]#
matplotlib.rcsetup.validate_int_or_None(s)[source]#
matplotlib.rcsetup.validate_markevery(s)[source]#

验证 Line2D 对象的 markevery 属性。

参数:
sNone, int, (int, int), slice, float, (float, float), 或 list[int]
返回:
None, int, (int, int), slice, float, (float, float), 或 list[int]
matplotlib.rcsetup.validate_markeverylist(s)[source]#

验证 Line2D 对象的 markevery 属性。

参数:
sNone, int, (int, int), slice, float, (float, float), 或 list[int]
返回:
None, int, (int, int), slice, float, (float, float), 或 list[int]
matplotlib.rcsetup.validate_ps_distiller(s)[source]#
matplotlib.rcsetup.validate_sketch(s)[source]#
matplotlib.rcsetup.validate_string(s)[source]#
matplotlib.rcsetup.validate_string_or_None(s)[source]#
matplotlib.rcsetup.validate_stringlist(s)[source]#

返回字符串列表

matplotlib.rcsetup.validate_whiskers(s)[source]#