plot modified by BHM-Bob G

BHM-Bob G — Sun, 28 Apr 2024 12:51:24 -0000

Brief

Now, plot sub-module mainly work for drawing a positional grouped and stacked plot, such as bar plot. Thus, this sub-module contains pandas.dataFrame utils for plot and some simple plot based on plt.

API文档

generated by ChatGPT

模块 mbapy.stats.plot

该模块提供了一些绘图函数，用于生成柱状图、QQ图和Tukey's test结果的可视化。

函数 `rgb2hex(r, g, b)`

将RGB颜色值转换为十六进制颜色代码。

参数

r (int): 红色分量，取值范围为0-255。
g (int): 绿色分量，取值范围为0-255。
b (int): 蓝色分量，取值范围为0-255。

返回值

hex (str): 十六进制颜色代码。

函数 `hex2rgb(hex)`

将十六进制颜色代码转换为RGB颜色值。

参数

hex (str): 十六进制颜色代码。

返回值

rgb (list[int]): 包含红色、绿色和蓝色分量的列表。

函数 `rgbs2hexs(rgbs)`

将RGB颜色值列表转换为十六进制颜色代码列表。

参数

rgbs (list[tuple[float]]): 包含RGB颜色值的元组列表。每个元组必须包含三个介于0和1之间的浮点数，分别表示红色、绿色和蓝色分量。

返回值

hexs (list[str]): 十六进制颜色代码列表。

函数 `get_palette(n=10, mode=None, return_n=True)`

获取一组颜色序列。

参数

n (int): 需要的颜色数量。
mode (str): 颜色的类型。
hls (默认值): 使用 sns.color_palette('hls', n) 生成颜色序列。
green：使用5种绿色生成颜色序列。
pair：使用 plt.get_cmap('tab20') 生成颜色序列。
None：当 n<=9 时使用 plt.get_cmap('Set1')，当 n<=12 时使用 plt.get_cmap('Set3')。
return_n (bool): 是否返回指定数量的颜色序列。

返回值

palette (list[str]): 包含颜色代码的列表。

类 `AxisLable`

表示一个坐标轴标签。

属性

name (str): 标签名称。
hold_space (int): 保留的空间大小。

方法

add_space(space=1): 增加保留的空间大小。

函数 `pro_hue_pos(factors, df, width, bar_space)`

计算多个分类变量的 x 轴标签和每个柱子的位置。

参数

factors (list[str]): DataFrame 中要分组的列名列表。
df (pd.DataFrame): 输入的 DataFrame。
width (float): 每个柱子的宽度。
bar_space (float): 柱子之间的间距。

返回值

xlabels (list[AxisLable]): 每个坐标轴的标签列表。
pos (list[float]): 每个柱子的位置列表。

函数 `plot_bar(factors, tags, df, **kwargs)`

绘制带有不同颜色的堆叠柱状图。

参数

factors (list[str]): 用于分组的列名列表。
tags (list[str]): 用于堆叠的列名列表。
df (pd.DataFrame): 输入的 DataFrame。
**kwargs (dict): 其他关键字参数。
width (float): 每个柱子的宽度，默认值为0.4。
bar_space (float): 柱子之间的间距，默认值为0.2。
xrotations (list[int]): 每个坐标轴的旋转角度列表，默认值为每个坐标轴都不旋转。
colors (list[str]): 颜色列表，默认值为 plt.rcParams['axes.prop_cycle'].by_key()['color']。
hatchs (list[str]): 柱子的填充样式列表，默认值为 ['-', '+', 'x', '\\', '*', 'o', 'O', '.']。
labels (None or list[str]): 标签列表，默认值为 None。
font_size (None or list[int]): 字体大小列表，默认值为 None。
offset (list[int]): 每个坐标轴的偏移量列表，默认值为每个坐标轴的字体大小加上8的倍数。
edgecolor (str): 柱子边缘的颜色，默认值为 'white'。

返回值

pos (np.array): 每个柱子的位置数组。
ax1 (Axes): 当前的 Axes 实例。

装饰器 `plot_positional_hue(factors, tags, df, **kwargs)`

用于包装绘图函数，支持传递额外的参数。

参数

factors (list[str]): 用于分组的列名列表。
tags (list[str]): 用于堆叠的列名列表。
df (pd.DataFrame): 输入的 DataFrame。
**kwargs (dict): 其他关键字参数。

返回值

core_wrapper (function): 包装后的函数。

函数 `qqplot(tags, df, figsize=(12, 6), nrows=1, ncols=1, **kwargs)`

生成每个标签的QQ图。

参数

tags (list[str]): 要绘制QQ图的标签列表。
df (pd.DataFrame): 包含要绘制的数据的 DataFrame。
figsize (tuple(int, int)): 图形的大小，默认值为 (12, 6)。
nrows (int): 图形网格的行数，默认值为 1。
ncols (int): 图形网格的列数，默认值为 1。
**kwargs (dict): 其他关键字参数。

返回值

None

函数 `save_show(path, dpi=300, bbox_inches='tight')`

保存并显示当前的图形。

参数

path (str): 要保存图形的文件路径。
dpi (int): 保存图形的分辨率，默认值为 300。
bbox_inches (str or Bbox): 要保存的图形区域，默认值为 'tight'。

返回值

None

函数 `plot_turkey(means, std_errs, tukey_results)`

绘制显示不同组均值和标准误差的柱状图。

参数

means (list[float]): 每个组的均值列表。
std_errs (list[float]): 每个组的标准误差列表。
tukey_results (Tukey's test结果): Tukey's test结果对象。

返回值

ax (Axes): 当前的 Axes 实例。

类 `AxisLable`

表示一个坐标轴标签。

属性

name (str): 标签名称。
hold_space (int): 保留的空间大小。

方法

add_space(space=1): 增加保留的空间大小。

函数 `pro_hue_pos(factors, df, width, bar_space)`

计算多个分类变量的 x 轴标签和每个柱子的位置。

参数

factors (list[str]): DataFrame 中要分组的列名列表。
df (pd.DataFrame): 输入的 DataFrame。
width (float): 每个柱子的宽度。
bar_space (float): 柱子之间的间距。

返回值

xlabels (list[AxisLable]): 每个坐标轴的标签列表。
pos (list[float]): 每个柱子的位置列表。

函数 `plot_bar(factors, tags, df, **kwargs)`

绘制带有不同颜色的堆叠柱状图。

参数

factors (list[str]): 用于分组的列名列表。
tags (list[str]): 用于堆叠的列名列表。
df (pd.DataFrame): 输入的 DataFrame。
**kwargs (dict): 其他关键字参数。

返回值

pos (np.array): 每个柱子的位置数组。
ax1 (Axes): 当前的 Axes 实例。

装饰器 `plot_positional_hue(factors, tags, df, **kwargs)`

用于包装绘图函数，支持传递额外的参数。

参数

factors (list[str]): 用于分组的列名列表。
tags (list[str]): 用于堆叠的列名列表。
df (pd.DataFrame): 输入的 DataFrame。
**kwargs (dict): 其他关键字参数。

返回值

core_wrapper (function): 包装后的函数。

函数 `qqplot(tags, df, figsize=(12, 6), nrows=1, ncols=1, **kwargs)`

生成每个标签的QQ图。

参数

tags (list[str]): 要绘制QQ图的标签列表。
df (pd.DataFrame): 包含要绘制的数据的 DataFrame。
figsize (tuple(int, int)): 图形的大小，默认值为 (12, 6)。
nrows (int): 图形网格的行数，默认值为 1。
ncols (int): 图形网格的列数，默认值为 1。
**kwargs (dict): 其他关键字参数。

返回值

None

函数 `save_show(path, dpi=300, bbox_inches='tight')`

保存并显示当前的图形。

参数

path (str): 要保存图形的文件路径。
dpi (int): 保存图形的分辨率，默认值为 300。
bbox_inches (str or Bbox): 要保存的图形区域，默认值为 'tight'。

返回值

None

函数 `plot_turkey(means, std_errs, tukey_results)`

绘制显示不同组均值和标准误差的柱状图。

参数

means (list[float]): 每个组的均值列表。
std_errs (list[float]): 每个组的标准误差列表。
tukey_results (Tukey's test结果): Tukey's test结果对象。

返回值

ax (Axes): 当前的 Axes 实例。

Recent changes to plot

plot modified by BHM-Bob G

Brief

API文档

模块 mbapy.stats.plot

函数 rgb2hex(r, g, b)

参数

返回值

函数 hex2rgb(hex)

参数

返回值

函数 rgbs2hexs(rgbs)

参数

返回值

函数 get_palette(n=10, mode=None, return_n=True)

参数

返回值

类 AxisLable

属性

方法

函数 pro_hue_pos(factors, df, width, bar_space)

参数

返回值

函数 plot_bar(factors, tags, df, **kwargs)

参数

返回值

装饰器 plot_positional_hue(factors, tags, df, **kwargs)

参数

返回值

函数 qqplot(tags, df, figsize=(12, 6), nrows=1, ncols=1, **kwargs)

参数

返回值

函数 save_show(path, dpi=300, bbox_inches='tight')

参数

返回值

函数 plot_turkey(means, std_errs, tukey_results)

参数

返回值

类 AxisLable

属性

方法

函数 pro_hue_pos(factors, df, width, bar_space)

参数

返回值

函数 plot_bar(factors, tags, df, **kwargs)

参数

返回值

装饰器 plot_positional_hue(factors, tags, df, **kwargs)

参数

返回值

函数 qqplot(tags, df, figsize=(12, 6), nrows=1, ncols=1, **kwargs)

参数

返回值

函数 save_show(path, dpi=300, bbox_inches='tight')

参数

返回值

函数 plot_turkey(means, std_errs, tukey_results)

参数

返回值

函数 `rgb2hex(r, g, b)`

函数 `hex2rgb(hex)`

函数 `rgbs2hexs(rgbs)`

函数 `get_palette(n=10, mode=None, return_n=True)`

类 `AxisLable`

函数 `pro_hue_pos(factors, df, width, bar_space)`

函数 `plot_bar(factors, tags, df, **kwargs)`

装饰器 `plot_positional_hue(factors, tags, df, **kwargs)`

函数 `qqplot(tags, df, figsize=(12, 6), nrows=1, ncols=1, **kwargs)`

函数 `save_show(path, dpi=300, bbox_inches='tight')`

函数 `plot_turkey(means, std_errs, tukey_results)`

类 `AxisLable`

函数 `pro_hue_pos(factors, df, width, bar_space)`

函数 `plot_bar(factors, tags, df, **kwargs)`

装饰器 `plot_positional_hue(factors, tags, df, **kwargs)`

函数 `qqplot(tags, df, figsize=(12, 6), nrows=1, ncols=1, **kwargs)`

函数 `save_show(path, dpi=300, bbox_inches='tight')`

函数 `plot_turkey(means, std_errs, tukey_results)`