Seurat V5中SCT转换后FindNeighbors默认使用RNA层的问题解析

问题背景

在单细胞数据分析流程中，Seurat是一个广泛使用的工具包。近期有用户在从Seurat V3升级到V5版本后，发现使用SCTransform进行数据转换后，FindNeighbors函数未能如预期那样使用SCT转换后的数据，而是继续使用原始的RNA数据层，导致最终UMAP可视化结果与之前版本不一致。

技术细节分析

在Seurat V5中，数据结构发生了重要变化：

1. 数据存储方式改变：V5版本取消了传统的"assay"概念，转而使用"layers"来存储不同处理阶段的数据。这种架构变化影响了部分函数的参数传递方式。

2. SCTransform处理流程：SCTransform在V5中仍然会对数据进行归一化和方差稳定转换，但转换后的数据不再存储在单独的"SCT"assay中，而是作为数据层存在。

3. FindNeighbors行为变化：在V5中，FindNeighbors默认会使用当前活跃的数据层进行计算。如果用户没有显式指定使用转换后的数据层，函数可能会回退到原始RNA数据。

解决方案

针对这一问题，有以下几种解决方案：

1. 显式指定数据层： 在调用FindNeighbors时，明确指定要使用的数据层参数。虽然V5中不再使用"assay.use"参数，但可以通过其他方式指定数据来源。

2. 检查数据层状态： 在进行关键分析步骤前，使用DefaultAssay()函数确认当前活跃的数据层是否为期望使用的转换后数据。

3. 版本回退方案： 如果项目对结果一致性要求极高，可以考虑暂时回退到Seurat V3版本，待完全熟悉V5的工作流程后再进行迁移。

最佳实践建议

1. 升级注意事项：

   • 从V3升级到V5时，应仔细阅读版本变更说明
   • 对关键分析步骤进行结果验证
   • 逐步迁移分析流程，而非一次性全部转换

2. 工作流程调整：

   • 在V5中建立新的标准化分析流程
   • 充分利用layers系统的优势，如同时保留原始和转换数据
   • 对每个分析步骤明确指定数据来源

3. 结果验证：

   • 使用names(object@graphs)验证生成的图结构
   • 比较关键步骤的输出与预期是否一致
   • 对UMAP等可视化结果进行人工检查

总结

Seurat V5在数据架构上的重大改进带来了更强大的功能，但也需要用户调整原有的工作习惯。对于依赖SCTransform和FindNeighbors的分析流程，理解V5中数据层的运作机制至关重要。通过明确指定数据来源和验证中间结果，可以确保分析流程的正确性和结果的可重复性。