
Azimuth把查询单细胞数据映射到已有组织参考,适合在参考覆盖范围内做细胞类型注释和跨数据集投影。它不等于无监督聚类,也不能保证参考中没有的稀有或新型细胞会被正确识别。准备本地运行前,先确认组织参考适合研究样本,再固定R、Seurat、Azimuth版本和参考文件来源。
选择并核验本地参考
先查看Azimuth/SeuratData提供的参考组织、物种、注释层级和版本。参考目录至少应有官方要求的ref.Rds与idx.annoy,两者必须来自同一个参考包,不要跨目录拼接。记录下载页面、发布日期和文件校验值,并将目录设为只读,防止误覆盖。若要离线运行,提前在联网环境下载完整文件并转移校验。
| 对象 | 运行前检查 | 不能据此推断 |
|---|---|---|
| 参考目录 | 两个必需文件齐全、大小非零、来源一致 | 文件存在不代表组织一定匹配 |
| 查询数据 | 细胞ID唯一、物种和RNA assay确认 | 对象可读不代表是原始counts |
| 软件环境 | R、Seurat、SeuratObject、Azimuth版本锁定 | 另一版本输出完全相同 |
| 映射结果 | 分数、细胞群、已知标记联合检查 | 高分自动证明生物学正确 |
先用一个查询对象试跑
示例query.rds是已通过基础QC的Seurat RNA对象,reference为本地参考文件夹。H5/H5AD也可作为查询路径传入,但需确认格式和assay可被当前RunAzimuth版本读取。先将一小批代表性数据用于环境连通性和输出检查;抽样结果只验证流程,不用于最终生物学结论。
library(Seurat)
library(Azimuth)
reference <- normalizePath("/project/azimuth/pbmc_reference")
required <- file.path(reference, c("ref.Rds", "idx.annoy"))
stopifnot(all(file.exists(required)), all(file.info(required)$size > 0))
query <- readRDS("query.rds")
stopifnot(inherits(query, "Seurat"), "RNA" %in% Assays(query))
stopifnot(!anyDuplicated(colnames(query)), ncol(query) > 0)
print(cells = ncol(query))
set.seed(2026)
mapped <- RunAzimuth(query=query, reference=reference,
query.modality="RNA", verbose=TRUE)
pred_cols <- grep("^predicted\.", colnames(mapped[[]]), value=TRUE)
stopifnot(length(pred_cols) > 0)
saveRDS(mapped, "query-azimuth-mapped.rds")
writeLines(capture.output(sessionInfo()), "azimuth-session.txt")
如果当前Azimuth版本的RNA工作流要求特定assay/layer,按该版本帮助页确认,不要把ATAC bridge参数套入RNA映射。保存返回对象前检查预测列、注释层级和运行日志;若程序提示基因未匹配,先核对基因名体系、物种和assay,而不是立刻重装或扩容。
复核注释而非只看是否成功
汇总各预测类别的细胞数和预测分数分布,关注低分群、极少数群、未映射基因和不同样本间的异常差异。抽查与组织相关的标记基因和已知细胞类型;若数据不属于参考覆盖组织,或出现参考中没有的状态,应保留“未确定/低置信”解释并回到聚类和marker分析。Azimuth输出是参考映射结果,不应把自动标签直接当成最终结论。官方教程还指出映射过程中的归一化结果不会作为原对象的归一化数据返回;需要可视化表达时,应按自己的下游分析规范单独执行并记录归一化。
分别测参考加载和查询规模
使用/usr/bin/time -v Rscript run_azimuth.R记录读取查询、参考加载、映射和保存的总耗时及最大RSS。每轮注明参考文件校验值、查询细胞数、软件版本、工作盘空间和退出状态。先跑代表性查询,再用同一参考逐步增加细胞数;多进程并行加载参考可能重复占内存,测试前先确认单任务峰值。若参考与输入正确而峰值持续超过现有额度,才按目标细胞数、并发和保存需求评估资源;参考不匹配或基因ID问题不能靠更大服务器解决。
下载练习材料
先核对包内SHA256清单,再在独立目录复现。
需要额外算力时
适用前提:参考适配性已确认,缺少兼容环境或查询所需资源。如需额外资源,可评估服务器租赁及按需环境部署。咨询时说明软件版本、任务规模和使用期限,配置与支持范围另行确认。
咨询本任务的服务器配置
留下手机号,我们会结合本文任务与您沟通服务器配置和报价。 也可联系云生信企业微信客服,说明本文任务。咨询本任务的服务器配置
参考与版本核对
按文中适用环境运行,所用版本与参数以实际安装环境和对应官方文档为准。
