SuperAPI AI 工具集

omicverse-single-cell-batch-integration

通用与其它

查看项目

更新于 10-16 02:38

技能介绍

用途:将 OmicVerse 笔记本中预处理之后的批次整合流程封装为可复用技能。前提是质控、标准化、高变基因选择和基础 PCA 已在上游完成,输入为带批次列(adata.obs)的预处理 AnnData;本技能不做通用预处理。

主要能力:通过 ov.single.batch_correction(adata, batch_key, use_rep='scaled|original|X_pca', methods='harmony', n_pcs=50, **kwargs) 选择整合后端。harmony 写入 X_pca_harmony 与 X_harmony;combat 在副本上运行后重新缩放并重算 PCA,写入 X_combat;scanorama 按分类批次拆分并拼接整合坐标,写入 X_scanorama;scVI 需 adata.layers['counts'] 原始计数,训练模型并写入 X_scVI,返回模型对象而非 adata;CellANOVA 需 control_dict,计算 denoised 并在该层上做 PCA,写入 X_cellanova;Concord 构建 concord.Concord 对象并 fit_transform(output_key='X_concord'),返回 Concord 对象。可选 ov.pp.mde(...) 做低维可视化,需已有嵌入键;scib_metrics.benchmark.Benchmarker(...) 可用批次与标签标注对一个或多个嵌入键做基准评测。

使用方式:显式指定 methods,先校验后端特定前置条件,再调用 batch_correction,随后检查写入 adata.obsm 的嵌入键;scVI 与 Concord 需保留返回对象。基准评测需至少一个未整合参考嵌入与一个或多个整合嵌入。可视化仅在整合嵌入存在后进行。

适用场景:需要校正隐空间或比较不同后端时用整合阶段;评测属于下游评估,非独立上游任务。harmony 为 CPU 默认路径;combat 用于表达层校正;scanorama 用于配对流形拼接(需额外依赖);scVI 需 scvi-tools 与原始计数;CellANOVA 需合理对照池;Concord 需已安装 Concord。

限制:不得隐式省略 methods;不得假设所有后端都返回 adata;scVI 与 Concord 明显比 harmony、combat 更重;不得评测未写入 adata.obsm 的嵌入;不在此重跑预处理。验证:整合后检查对应嵌入键,评测前确认批次列与标签列存在,评测后确认结果表非空并含所需键。若仅运行代表性冒烟路径,应说明实际执行的后端与评测子集。