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]