Scanpy中Dotplot函数显示树状图的问题解析

问题背景

在单细胞RNA测序数据分析中，Scanpy是一个广泛使用的Python工具包。其中sc.pl.dotplot函数常用于可视化不同细胞群之间的标记基因表达模式。该函数的一个重要功能是能够显示基于层次聚类的树状图(dendrogram)，帮助用户直观理解细胞群之间的相似性关系。

问题现象

用户在使用sc.pl.dotplot函数时遇到了树状图无法显示的问题。根据用户提供的截图，虽然基因表达的热点图正常显示，但左侧的树状图缺失，这影响了用户对细胞群层次关系的观察。

原因分析

经过技术验证，我们发现这个问题可能有以下几种原因：

1. 数据预处理不完整：在使用sc.pl.dotplot前，需要先通过sc.tl.dendrogram计算层次聚类关系。如果这一步执行不完整或参数设置不当，会导致树状图无法显示。

2. 参数传递问题：dendrogram参数需要正确指定存储在AnnData对象中的树状图键名。如果键名不匹配，函数将无法找到预计算的树状图数据。

3. 版本兼容性问题：不同版本的Scanpy可能在树状图显示逻辑上存在差异。

解决方案

正确使用流程

1. 计算层次聚类：

sc.tl.dendrogram(adata, groupby='leiden', key_added='dendrogram_leiden')

2. 绘制点图：

sc.pl.dotplot(adata, marker_genes, groupby="leiden", 
             standard_scale="var", 
             dendrogram='dendrogram_leiden')

注意事项

• 确保groupby参数在两步操作中保持一致
• key_added参数指定的键名需要与dendrogram参数一致
• 如果使用自定义的聚类结果，需要确保聚类信息已正确存储在AnnData对象中

相关函数对比

值得注意的是，Scanpy提供了两种点图绘制方式：

1. 函数式调用：sc.pl.dotplot - 这是推荐的使用方式，支持树状图显示
2. 面向对象方式：sc.pl.DotPlot - 目前版本(1.10.2)不支持直接通过参数传递显示树状图

技术建议

对于需要更复杂自定义的用户，可以考虑以下进阶方案：

1. 手动添加树状图：先使用sc.pl.dendrogram单独绘制树状图，然后与点图组合
2. 调整布局参数：通过figsize等参数调整图形大小，确保有足够空间显示树状图
3. 版本升级：考虑升级到最新版本，获取更稳定的树状图显示功能

总结

Scanpy的点图功能是单细胞数据分析中重要的可视化工具，正确显示树状图对于理解细胞群关系至关重要。通过遵循正确的使用流程和参数设置，用户可以充分利用这一功能来展示和分析单细胞数据中的基因表达模式。