如何为Holoviz多索引柱状图添加数值标签？

问题原因 #

报错源于柱状图x轴与标签x轴维度不匹配：多索引分组后生成的柱状图，x轴是(yr, origin)形式的复合因子（字符串元组），但你创建hv.Labels时只指定了origin作为x维度，导致Labels的x轴维度（单一字符串）和柱状图的x轴维度（复合元组）无法对齐，触发FactorRange验证错误。

修正方案 #

需要将多索引DataFrame重置为普通列，确保Labels的x轴维度与柱状图完全一致，同时调整hv.Labels的参数匹配复合轴：

import pandas as pd
import hvplot.pandas # noqa
from bokeh.sampledata.autompg import autompg_clean as autompg
import holoviews as hv

# 多索引分组并重置为普通列
autompg_multi_index = autompg.query("yr<=80").groupby(['yr', 'origin']).mean(numeric_only=True).reset_index()
# 将yr转为字符串，确保复合因子类型统一
autompg_multi_index['yr'] = autompg_multi_index['yr'].astype(str)

# 绘制多索引柱状图，hvplot会自动将yr+origin处理为复合x轴
plot = autompg_multi_index.hvplot.bar(x=['yr', 'origin'], y="mpg", width=1000, rot=90)

# 创建标签：kdims对应复合x轴(yr, origin) + y轴(mpg)，vdims指定要显示的数值
multi_labels = hv.Labels(
    data=autompg_multi_index,
    kdims=['yr', 'origin', 'mpg'],
    vdims='mpg'
)

# 叠加展示
hvplot.show(plot * multi_labels)

关键修改点 #

• 重置多索引：用reset_index()将yr和origin从索引转为普通列，方便hvplot和holoviews识别复合维度
• 统一类型：将yr转为字符串，避免因数值类型导致复合因子的类型不匹配
• 对齐维度：hv.Labels的kdims必须包含复合x轴的所有字段（yr和origin），再加上y轴字段mpg，这样标签才能准确定位到每个柱子的顶部
• 显式指定x轴：绘制柱状图时显式声明x=['yr', 'origin']，确保hvplot生成正确的复合x轴

内容的提问来源于stack exchange，提问作者Abhi