SuperAPI AI 工具集

omicverse-single-cell-via-trajectory

通用与其它

查看项目

更新于 10-16 02:38

技能介绍

用途:对已完成预处理并带细胞类型标注的 AnnData 运行 VIA(Stassen 2021),进行轨迹拓扑构建、拟时序推断、自动终末状态检测,以及沿谱系的基因趋势可视化。相较经典方法,VIA 的特点是无需预先指定终点即可自动预测终末状态。

两种模式:普通 VIA(t_via)仅用基因距离,必须提供 root 细胞;速度引导 VIA(t_via_velo)传入 velocity_matrix=adata.layers['velocity']、gene_matrix=adata.X.todense()、velo_weight=0.5,用 RNA 速度引导随机游走转移概率,root_user=None 时自动推断根。pyVIA 是 OmicVerse 的封装,可直传 AnnData,并改进了配色。

主要能力:构造后调用 v0.run() 完成拟合;绘图方法包括 plot_piechart_graph(簇转移饼图)、plot_trajectory_gams(GAM 谱系曲线)、plot_stream(方向流图)、plot_lineage_probability、plot_gene_trend、plot_gene_trend_heatmap、plot_clustergraph;get_pseudotime 可取每细胞拟时序,get_piechart_dict 返回每簇谱系概率。

用法要点:输入需 obs 含细胞类型标签、obsm['X_pca'] 与二维嵌入(tsne/umap)。普通模式示例:v0 = ov.single.pyVIA(adata=adata, adata_key='X_pca', adata_ncomps=80, basis='tsne', clusters='label', knn=30, random_seed=4, root_user=[4823]),随后 v0.run()。速度引导模式需先用 scvelo 计算 adata.layers['velocity'] 和 varm['PCs']。root_user 为整数索引,不是字符串细胞名。

参数:adata_ncomps 常用 80,大队列 100–200,小队列 30–50;knn 30(普通)或 20(速度引导);velo_weight 0 等价普通模式、0.5 为教程默认、1 为纯速度,论文建议 0.3–0.7;pseudotime_threshold_TS 30(普通)或 50(速度引导),越低检测到的终末状态越多。random_seed 应显式设置,因 PARC 聚类与随机游走都有随机性。

适用场景:单细胞谱系轨迹与终末状态推断,尤其适合剪接连接覆盖良好的队列使用速度引导模式。限制:不要用于 spliced/unspliced 分离稀疏的浅测序 10x 数据;其他轨迹方法、RNA 速度计算本身、CellRank 命运图、多组学 StaVIA 均不属本技能范围。验证建议:检查终末状态数量是否合理、拟时序无 NaN、饼图箭头由祖细胞向外;速度引导结果应与 scvelo 流图方向一致。公开资料未提供收费、价格与平台授权信息。