学术资源 / 固定快照
OmicVerse 2.3.2 重构了组学绘图模块
OmicVerse(GitHub 仓库 omicverse/omicverse)是面向转录组和多组学分析的开源 Python 库,采用 GNU GPL 第 3 版许可,把 bulk RNA-seq、单细胞和空间转录组的常用方法接入同一套以 AnnData 为核心的接口。2026 年 9 月 23 日发布的 2.3.2 版重构了多面板绘图,并修复了空间、单细胞和 bulk 分析中的多处问题。  OmicVerse 单细胞分析模块概览与示例结果,涵盖细胞注释、细胞通讯、轨迹推断和通路评分(2024 年论文版本)。图源:Zeng Z 等,Nature Communications 15:5983(2024)图 5,CC BY 4.0。 ### 项目定位与数据接口 项目 README 把 OmicVerse v2 描述为统一的 Python 项目,覆盖 bulk RNA-seq、单细胞、空间转录组、下游可视化、基于模型的分析和 AI 辅助工作流。它以 pandas、AnnData、NumPy 和 MuData 为数据底座,封装了 Scanpy、PyDESeq2、CellPhoneDB、Harmony、STAGATE、cell2location 等大量已发表工具,研究者可以用同一种数据对象串起质控、降维聚类、细胞注释、差异分析、细胞通讯和作图。项目的方法论文于 2024 年 7 月 16 日发表在 Nature Communications(第 15 卷,文章号 5983),除介绍整体框架外,还提出 BulkTrajBlend 算法:用 β-VAE 从 bulk RNA-seq 中解卷积出单细胞谱,再用图神经网络识别重叠的细胞群落,补回单细胞测序因技术限制而“遗漏”的细胞类型。 PyPI 上 2.3.2 的元数据要求 Python 3.9 及以上,并把 anndata 限定在 0.10 及以上、0.14 以下。README 建议先装好 PyTorch,再用 `pip install -U omicverse` 或 `conda install omicverse -c conda-forge` 安装;COMMOT、FlowSig、流式细胞、合成生物学等功能需按可选依赖组另行安装。v2 还提供 ov.Agent 自然语言分析接口和 MCP 服务端(`python -m omicverse.mcp`),可以把已注册的分析函数交给支持 MCP 的 AI 客户端调用。本文于 2026 年 10 月 21 日核对上述官方资料,属于资料核验,未安装实测。 ### 2.3.2 版本更新内容 GitHub Releases 显示,v2.3.2 于 2026 年 9 月 23 日(UTC)发布,距 2.3.1 共 96 次提交,截至核对日仍是最新正式版本。改动最大的是绘图模块 ov.pl:新增 panelflow 版面引擎,先测量再摆放,多面板图按面板而不只是按画布确定尺寸;所有单坐标轴绘图函数都接受 ax= 参数,可以直接画进指定面板;新增通用桑基图和冲积图、基于 Marsilea 的可嵌入聚类热图、按计数绘制的细胞通讯热图和细胞比例趋势图。标签避让、刻度重叠、火山图图例等细节也有修正,plot_set 增加了中日韩字体回退。 空间组学模块 ov.space 修正了 STAligner 的批次识别与对齐,以及 Visium 的坐标、文库和图像变换,并要求 cell2location 和 RCTD 使用原始计数输入;SpaceFlow、STAGATE 的训练与输入,COMMOT、FlowSig 的输入校验也有调整。单细胞方面新增 Bonsai 细胞状态树的计算与绘图,支持 CellPhoneDB Method 3 并处理重复基因,修正扰动分析后端的输出与报错、RNA 速度下游分析的对齐,同时移除了 CytoTRACE2 和 scGPT 占位接口。bulk 与兼容性方面,pyDEG 增加输入校验并支持 GDC 临床字段,兼容 anndata 0.11 至 0.13 和新旧两代 zarr,还补入了 UCE 与 SAMap 的 MIT 许可。
- 收录日期
- 2026-10-21
- 类别
- 生命与医学
- 状态
- 资料核验,未安装实测(核验日期 2026-10-21)
为何收录
对在 Python 里做转录组分析的研究者,OmicVerse 的主要用处是减少工具之间的格式转换:bulk、单细胞和空间数据都以 AnnData 等通用结构传递,换一种方法通常只需换一个函数,不必为每个工具单独整理输入。2.3.2 的绘图改动面向论文配图,面板尺寸可控,单张图能放进指定坐标轴,多面板图可以在代码里拼好再导出,减少手工排版。空间组学用户则多了一道输入检查:对原始计数的强制要求,可以在源头避免把标准化后的数据送进 cell2location 或 RCTD 这类基于计数建模的方法。
适用场景与验收建议
方法论文用两组案例展示了典型流程。bulk 部分以阿尔茨海默病数据为例,依次用 pyDEG 做差异表达、pyGSEA 做基因集富集、pyWGCNA 构建共表达网络;单细胞部分以结直肠癌数据为例,串起 pySCSA 自动注释、AUCell 通路评分、SEACells 元细胞、pyVIA 轨迹推断和 CellPhoneDB 细胞通讯,论文报告自动注释与人工注释对比的 F1 分数为 0.856。这些数字是作者在论文数据上得到的结果,不能直接外推到其他数据集。

OmicVerse 的 bulk RNA-seq 分析流程:差异表达、基因集富集、蛋白互作与共表达网络,以阿尔茨海默病数据为例(2024 年论文版本)。图源:Zeng Z 等,Nature Communications 15:5983(2024)图 4,CC BY 4.0。
它更适合已经用 Python 处理组学数据、希望在一个环境里覆盖多类分析的研究生和课题组;已有成熟 R 或 Seurat 流程、只做单一分析的团队,迁移收益要看具体任务。可以先做一次小规模验收:在独立虚拟环境中固定 2.3.2 版本,跑通官方文档里的一个单细胞教程,再拿一份已经用 Scanpy 或 Seurat 分析过的数据,比较聚类、标记基因和差异基因是否一致。这是建议步骤,本文没有执行。
局限、许可与注意事项
OmicVerse 的许多功能是对第三方方法的封装或重新实现,结果受原方法的假设、参数和依赖版本影响。统一接口降低了调用门槛,却不会替研究者判断某种方法是否适合自己的数据类型。发表时应同时引用 OmicVerse 和实际使用的原始方法,并记录 OmicVerse 与关键依赖的版本。
项目迭代很快。Releases 页面显示,2026 年 6 月至 9 月先后发布了 2.2.1、2.2.2、2.2.3、2.2.4、2.3.0 和 2.3.2,其间有过不兼容改动:2.2.2 起 inferCNV 必须指定测序平台或显式阈值,2.3.2 移除了 CytoTRACE2。长期项目应在环境文件里锁定版本,升级前重跑关键步骤。依赖也较重:需要先装 PyTorch,部分功能依赖 GPU 或额外安装项,anndata 还有版本上限,与已有环境共存时容易冲突,最好单独建环境。
仓库代码采用 GNU GPL 第 3 版,在研究中运行程序不受限制;分发修改版或包含 OmicVerse 的软件时,须按 GPL-3.0 提供对应源代码并附许可证文本。它集成的第三方方法和基础模型(如 Geneformer、scFoundation、UCE)各有许可证和权重使用条款,再分发前要逐项核对。ov.Agent 需要接入外部大模型服务,并在本地执行生成的代码,使用时应先审查代码,不把输出直接当作分析结论。
项目入口:GitHub 仓库 omicverse/omicverse、v2.3.2 发布页、官方文档。
参考文献
-
omicverse/omicverse(GitHub 仓库)
-
omicverse 2.3.2 发布页(GitHub Releases)
-
omicverse Releases 列表
-
omicverse v2.3.2 LICENSE(GNU GPL v3)
-
omicverse 2.3.2(PyPI)
-
OmicVerse 官方文档
-
Zeng Z, Ma Y, Hu L, et al. OmicVerse: a framework for bridging and deepening insights across bulk and single-cell sequencing. Nature Communications, 2024, 15: 5983
-
OmicVerse README(master 分支)
-
OmicVerse: a framework for bridging and deepening insights across bulk and single-cell sequencing
-
信息由 Scholay 学术一站式平台 整理并发表,如有侵权请反馈下架。
-
信息同步发表于恩特学术,智能时代的学者社区
在交互式日历中查看这条记录 ↗