使用Bokeh可视化图时遇StaticLayoutProvider验证失败问题求助

报错原因 #

Bokeh的StaticLayoutProvider对图布局字典的键类型有明确约束：必须是字符串或整数，但你的全量数据集节点ID是浮点数（如55331.0），不符合验证规则，因此触发ValueError。

NetworkX本身不限制节点ID的类型，所以用Matplotlib结合NetworkX绘制时不会有问题，但Bokeh的可视化组件对输入类型做了严格校验。

解决方法 #

根据你的节点ID实际情况选择以下方案：

方案1：将浮点数节点ID转换为整数（适用于浮点数均为整数形式） #

在构建NetworkX图之前，先把DataFrame中的节点列转换为整数类型：

import pandas as pd
import networkx as nx
from bokeh.plotting import figure, show
from bokeh.models import from_networkx

# 加载全量数据集
df = pd.read_csv("your_full_dataset.csv")

# 转换节点ID为整数
df['Node 1'] = df['Node 1'].astype(int)
df['Node 2'] = df['Node 2'].astype(int)

# 构建图
G = nx.from_pandas_edgelist(df, 'Node 1', 'Node 2', edge_attr=['len', 'Stick ID'])

# 生成布局并可视化
layout = nx.spring_layout(G)
graph_renderer = from_networkx(G, layout)
# 后续可视化代码...

方案2：将浮点数节点ID转换为字符串（适用于非整数浮点数节点ID） #

如果节点ID存在非整数的浮点数（如55331.5），可以转换为字符串类型：

# 转换节点ID为字符串
df['Node 1'] = df['Node 1'].astype(str)
df['Node 2'] = df['Node 2'].astype(str)

# 后续构建图和可视化步骤同上

方案3：已生成NetworkX图后修改节点类型 #

如果已经构建了NetworkX图，可以通过relabel_nodes修改节点ID类型：

# 转换为整数
G = nx.relabel_nodes(G, {node: int(node) for node in G.nodes()})
# 或者转换为字符串
# G = nx.relabel_nodes(G, {node: str(node) for node in G.nodes()})

# 重新生成布局
layout = nx.spring_layout(G)
graph_renderer = from_networkx(G, layout)

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