`matplotlib.rcsetup`#

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

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

rc 设置的默认值在默认的 matplotlibrc 文件中设置。此处列出的参数集的任何增加或删除都应同步到 Matplotlib 根源目录中的 lib/matplotlib/mpl-data/matplotlibrc 文件。新的 rcparams 还需要添加到 lib/matplotlib/typing.py 中的 RcKeyType 枚举中。

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 兼容。建议优先使用关键字参数形式，即 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 转换为 float，否则引发异常。

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_intlist(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]#

matplotlib.rcsetup#

`matplotlib.rcsetup`#