Scanpy项目中的Leiden算法后端变更预告

背景介绍

Scanpy是一个用于单细胞RNA测序数据分析的Python库，它提供了丰富的工具来处理和分析单细胞数据。在单细胞数据分析中，细胞聚类是一个关键步骤，而Leiden算法是Scanpy中常用的聚类方法之一。

当前状态

在Scanpy的当前版本中，Leiden算法的实现默认使用leidenalg作为后端。然而，开发团队已经决定在未来版本中将默认后端切换为igraph。这一变更将影响所有使用默认参数调用sc.tl.leiden()的用户。

变更原因

这种后端变更主要基于以下几个考虑因素：

1. 性能优化：igraph实现通常比leidenalg更快
2. 依赖简化：减少项目的外部依赖
3. 维护便利：统一使用igraph生态系统

变更细节

开发团队已经在代码中添加了FutureWarning警告，提醒用户这一即将到来的变更。当前的警告信息如下：

FutureWarning: Use of leidenalg is discouraged and will be deprecated in the future. Please use `flavor="igraph"` `n_iterations=2` to achieve similar results. `directed` must also be `False` to work with `igraph`'s implementation.

警告信息优化

开发团队计划对警告信息进行以下改进：

1. 堆栈级别调整：确保警告显示正确的代码行
2. 信息内容优化：使警告信息更加清晰明确
3. 警告频率控制：确保只显示一次警告，避免重复提醒

改进后的警告信息将更清晰地说明：

• 未来版本中默认后端将变更为igraph
• 如何通过参数设置提前适应这一变更
• 需要注意的参数限制（如directed必须为False）
• 结果可能会有轻微差异的说明

迁移建议

为了平稳过渡，建议用户：

1. 现在就开始测试使用flavor="igraph"参数
2. 注意设置n_iterations=2以获得类似结果
3. 确保directed=False以兼容igraph实现
4. 测试分析流程，确认结果差异是否可接受

技术影响

这一变更将带来以下技术影响：

1. 结果差异：虽然算法相同，但不同实现可能产生微小差异
2. 性能变化：igraph实现通常更快，但具体效果取决于数据规模
3. 参数要求：某些参数组合将不再支持

总结

Scanpy团队正在有计划地将Leiden算法的默认后端从leidenalg迁移到igraph。这一变更将提高性能并简化依赖，但需要用户注意参数调整和结果验证。通过提前发布的警告信息和逐步迁移策略，团队希望最小化对现有分析流程的影响。