SuperAPI AI 工具集

omicverse-single-cell-differential-expression

通用与其它

查看项目

更新于 10-16 02:38

技能介绍

用途:把 OmicVerse 笔记本式的单细胞差异表达(DEG)分析封装为可复用的可触发技能,专注于在选定细胞类型内做条件对条件的比较。差异丰度与组成分析属于另一项独立任务,不在本技能范围内。

主要能力:通过 ov.single.DEG(adata, condition, ctrl_group, test_group, method='wilcoxon', use_raw=None) 初始化包装器,method 分支支持 wilcoxon、t-test 和 memento-de。use_raw=None 会自动检测 adata.raw,若存在则将其 X 复制到新对象用于 DEG。DEG.run(celltype_key, celltype_group=None, max_cells=100000, **kwargs) 按细胞类型取子集并分派到所选后端。get_results() 返回 DEG 表,并补充 baseMean、pct_ctrl、pct_test 和 pct_diff。

使用方式:先检查 AnnData 的 condition 列、细胞类型列以及原始计数是否在 adata.raw 或 adata.layers["counts"] 中;在运行前显式选择后端;用 celltype_key 与 celltype_group 取所需细胞类型,仅在全细胞类型汇总时才设 celltype_group=None;运行 run(...) 并设置 max_cells 策略,使用 memento 时传入方法相关参数(如 capture_rate、num_cpus、num_boot);用 get_results() 收集结果并核对统计列与表达比例列。最小示例:ov.single.DEG(adata, condition="condition", ctrl_group="Control", test_group="Salmonella", method="wilcoxon"),再 deg.run(celltype_key="cell_label", celltype_group=["TA"], max_cells=100000),最后 res = deg.get_results()。

适用场景:需要在一个或多个选定细胞类型内进行条件间 DEG 比较,且希望复用固定执行流程与校验步骤。

限制:wilcoxon 与 t-test 仅在活动矩阵仍呈整数值时做归一化与对数转换;memento-de 期望类计数输入,若 X 非整数则先查 adata.layers["counts"],否则尝试从对数归一化值恢复计数。不要默认示例细胞类型或基因是通用默认值;不要隐式保留 method;未确认原始计数、计数层或成功计数恢复时不得声称 memento-de 运行在原始计数上。应检查子集后对照与实验标签是否仍存在,并说明 max_cells 是否导致降采样。小提琴图属于可选的后续报告,不属于复用执行契约。