statsmodels.graphics.dotplots.dot_plot¶

statsmodels.graphics.dotplots.dot_plot(points, intervals=None, lines=None, sections=None, styles=None, marker_props=None, line_props=None, split_names=None, section_order=None, line_order=None, stacked=False, styles_order=None, striped=False, horizontal=True, show_names='both', fmt_left_name=None, fmt_right_name=None, show_section_titles=None, ax=None)[source]¶

点图（也称为森林图和斑点图）。

生成一个类似于Cleveland的“Visualizing Data”书中的点图（[1]）。这些也被称为“森林图”。

Parameters:¶

pointsarray_like

要绘制为标记的定量值。

intervalsarray_like

要在点周围绘制的区间。intervals 的元素可以是标量或长度为2的序列。标量表示对称区间的半宽度。长度为2的序列包含非对称区间的左右半宽度（分别为）。如果为 None，则不绘制区间。

linesarray_like

一个分组变量，指示哪些点/区间绘制在同一条线上。如果为None，则每个点/区间显示在其自己的线上。

sectionsarray_like

一个分组变量，指示哪些线条被分组到部分中。如果为None，则所有内容都绘制在单个部分中。

stylesarray_like

定义标记和区间绘图风格的组标签。

marker_propsdict

一个映射样式代码（styles中的值）到定义键/值对的字典，这些键/值对将作为关键字参数传递给plot，在绘制标记时使用。有用的关键字参数是“color”、“marker”和“ms”（标记大小）。

line_propsdict

一个字典，将样式代码（styles中的值）映射到定义键/值对的字典，这些键/值对将作为关键字参数传递给plot，在绘制区间线时使用。有用的关键字参数包括“color”、“linestyle”、“solid_capstyle”和“linewidth”。

split_namesstr

如果不是 None，这将用于将 lines 的值分割成分别绘制在左右边距中的子字符串。如果是 None，lines 的值将绘制在左边距中。

section_orderarray_like

图中各部分标签按其在点图中出现的顺序排列。

line_orderarray_like

线条标签按它们在点图中出现的顺序排列。

stackedbool

如果为真，当多个点或区间绘制在同一条线上时，它们会相互偏移。

styles_orderarray_like

如果 stacked=True，这是在给定线上点样式从上到下（如果 horizontal 为 True）或从左到右（如果 horizontal 为 False）绘制的顺序。如果为 None（默认），顺序是词典序。

stripedbool

如果为真，则每隔一行都会被包含在一个阴影框中。

horizontalbool

如果为真（默认），线条将水平绘制，否则将垂直绘制。

show_namesstr

确定标签（名称）是否显示在左侧和/或右侧边距（如果horizontal为True，则为顶部/底部边距）。如果both，标签将绘制在两个边距中，如果为‘left’，标签将绘制在左侧或顶部边距中。如果right，标签将绘制在右侧或底部边距中。

fmt_left_namecallable

左/上边距名称在绘制到图表上之前通过此函数传递。

fmt_right_namecallable

右/下边距名称在绘制到图表之前通过此函数传递。

show_section_titlesbool or None

如果为None，则仅当存在多个部分时才会绘制部分标题。如果为False/True，则分别永远不会/始终绘制部分标题。

axmatplotlib.axes

绘制点图的坐标轴。如果为 None，则创建一个新的坐标轴。

Returns:¶

figFigure

由 ax.figure 给出的图形或一个新的实例。

注释

点, 区间, 线, 段, 样式 在存在时必须具有相同的长度。

参考文献

[1]

克利夫兰, 威廉 S. (1993). “数据可视化”. 霍巴特出版社.

[2]

Jacoby, William G. (2006) “点图：用于标记定量值的图形显示。” 政治方法学家 14(1): 6-14。

示例

这是一个简单的点图，每行一个点：

>>> dot_plot(points=point_values)

这个点图在线上有标签（如果label_values中的元素重复，相应的点会出现在同一条线上）：

>>> dot_plot(points=point_values, lines=label_values)