HOWTO · Plotly
Plotly 条形图
使用 Plotly Express 的 `px.bar` API 在 Python 中创建交互式条形图。
本页内容
Plotly Express 可在 Python 中创建交互式条形图。使用 px.bar 将类别标签和数值映射到图表,再根据数据调整条形方向、颜色、标签和轨迹。运行示例前,请先在 Python 环境中安装 Plotly。
使用 Plotly Express 创建基本条形图
将类别名称传给 x,将对应的数值传给 y。Plotly Express 会为每一行数据或每一对对应值创建一个条形。在交互式环境中调用 fig.show() 可显示图表;可运行示例则会打印简短摘要,因此在无法通过浏览器显示图表的环境中也能运行。
运行此示例:
本节中的代码以及显示的标签或输出仍为英文。
import plotly.express as px
labels = ["One", "Two", "Three"]
values = [10, 50, 100]
fig = px.bar(x=labels, y=values, height=400, width=500)
print(f"Categories: {len(labels)}; values: {values}")
Categories: 3; values: [10, 50, 100]
图表尺寸以像素为单位。此图表包含三个类别,条形高度分别为 10、50 和 100。渲染结果应显示这些标签及其对应数值;下方图片是随附的基本图表素材。
渲染结果:三个类别标签及其对应的条形高度。
如果使用数据框,请传入列名,例如 px.bar(data_frame, x="category", y="value")。这样可以明确指定映射关系,并让 Plotly 将每一行作为一个观测值。
选择条形方向并配置坐标轴
默认情况下,px.bar 会绘制竖直条形:x 值表示类别,y 值决定条形高度。设置 orientation="h" 可绘制水平条形。绘制水平条形时,将数值映射到 x,将类别标签映射到 y;Plotly 会根据方向设置决定条形朝向,因此无需不加判断地交换列。
例如,可以用 px.bar(x=values, y=labels, orientation="h") 创建水平图表。使用 fig.update_layout(title="Sales by category") 设置图表标题。在默认的竖直图表中,数值位于 y 轴;适合使用对数数值轴时,可调用 fig.update_yaxes(title_text="Sales", type="log")。如果水平图表的数值位于 x 轴,则用 fig.update_xaxes(...) 配置该轴。对数轴无法显示非正数,因此只有在数据和比较目的都适用时才使用。height 和 width 控制整个图表的尺寸,而非单个条形的尺寸。要显示图表,请在已配置 Plotly 渲染器的环境中调用 fig.show()。
自定义条形颜色
如果希望每个类别使用不同颜色,可将分类字段传给 color。color_discrete_map 可为类别值指定颜色;映射中未列出的类别会使用 Plotly 的颜色序列,而不是随机颜色。例如,传入 color=labels 和 color_discrete_map={"One": "green", "Two": "cyan", "Three": "yellow"},即可为这三个标签分别指定颜色。
对于数值字段,可将其用作 color,通过连续颜色比例表示数值大小。例如,px.bar(x=labels, y=values, color=values, color_continuous_scale=px.colors.sequential.Rainbow) 会根据数值分配颜色。连续颜色比例表示有序数值范围;离散映射则表示具名类别。可参阅 Plotly 内置颜色比例,了解可用的颜色比例和序列。
添加标签并设置条形样式
将序列传给 text,即可在条形上显示数值或其他标签。可用 textposition 调整标签位置,例如设为 "outside" 或 "inside";具体位置可能受可用空间影响。创建图表后,可使用 fig.update_traces 设置条形轨迹的选项。例如,创建图表时传入 text=["First", "Second", "Third"],然后调用 fig.update_traces(textposition="outside", textfont_size=16, marker=dict(line=dict(color="green", width=3))),即可添加标签和绿色描边。
fig.update_traces 支持文本位置、标记线、透明度和误差线等轨迹属性。在 px.bar 中,error_x 和 error_y 分别表示对应数据轴上的不确定性,而 base 用于设置每个条形的起始位置。只有当这些设置能准确表达数据时才使用它们。完整的轨迹属性请参阅 Plotly 条形图参考。