云生信学生物信息学

SCENIC+安装与试跑:环境锁定、输入配置和结果验收

作者:发布于 2026-11-21更新于 2026-11-15约 6 分钟阅读
SCENIC+先锁版本再跑小样本

SCENIC+先锁版本再跑小样本:记录提交SHA与Python版本;核对RNA、ATAC、peak和数据库;看dry-run任务与路径计划;小样本验收后再估算资源
本文操作与检查路径示意。

SCENIC+把单细胞RNA表达与染色质可及性整合起来,推断候选增强子驱动的调控网络。它需要多个输入对象、motif数据库和工作流步骤;“能import”不代表数据已配对或网络可信。本文演示Linux环境下如何锁定版本、初始化Snakemake、检查配置并先用小任务试跑。示例固定到项目提交 840dab85de3044846234c157e327b6ea0290abfb,其元数据标注版本1.0a2、Python不高于3.11.8。若使用其他提交,应重新核对依赖与配置模板,不要把本文的版本号直接套用到最新版。

准备输入清单再安装

准备cisTopic对象、RNA AnnData、region sets、cisTarget ranking/score数据库和物种对应的motif-TF注释。核对条码配对;非配对数据需明确metacell方案,数据库、参考基因组和peak坐标须匹配。

材料 核对内容 出错时优先检查
cisTopic对象 细胞、peak坐标和参考版本 对象能否读取、细胞数是否符合预期
RNA AnnData 细胞ID、基因ID及raw表达层 条码转换和表达矩阵来源
region sets 目录层级、BED坐标和文件非空 染色体命名、峰集与数据库覆盖
cisTarget资源 ranking库、score库和motif注释 物种、版本、文件完整性与可读权限

固定提交并验证命令入口

在Linux新目录创建独立环境,不要在已有分析环境里反复升级NumPy等底层依赖。这个提交的项目元数据要求Python不高于3.11.8;安装后先检查依赖、版本和命令帮助,再创建工作流模板。

set -euo pipefail
mkdir -p scenicplus-test
cd scenicplus-test
conda create -y -n scenicplus-1a2 python=3.11.8
conda activate scenicplus-1a2

git clone https://github.com/aertslab/scenicplus.git source
git -C source checkout 840dab85de3044846234c157e327b6ea0290abfb
git -C source rev-parse HEAD > source-commit.txt
python -m pip install ./source
python -m pip check
scenicplus --help
scenicplus init_snakemake --out_dir run-001
conda list --explicit > conda-explicit.txt
python -m pip freeze > pip-freeze.txt

pip check只检查依赖元数据,不能验证数据库或真实输入。安装失败时保留完整日志,对照固定提交的依赖要求逐项定位,不要混用不同教程的旧包。记录提交SHA、Python版本与环境清单。

填写配置并运行dry-run

初始化后编辑 run-001/Snakemake/config/config.yaml,保留该版本生成的字段结构。先逐一确认表中路径真实存在、当前账号可读,所有输出写入新的项目目录。特别检查RNA与ATAC的匹配模式、物种、基因组注释和数据库版本;如果改变了peak集合或物种,原有motif资源未必适用。

cd run-001/Snakemake
test -s config/config.yaml
snakemake --dry-run --cores 4 > dry-run.log 2>&1
# 查看dry-run.log中的输入路径、规则和预期输出
snakemake --cores 4 > run.log 2>&1

dry-run检查规则依赖和计划路径,不会完整读取并验证数据对象。若计划中出现旧目录、空文件或多余样本,先修配置;通过后再用代表性小样本跑通数据准备、motif富集和网络推断。

根据失败位置定位问题

按失败位置排错:导入或命令错误查环境;文件读取错误查路径、权限和格式;数据库覆盖异常查物种、基因组和peak坐标;仅在确认系统OOM或调度器终止后,才调整失败规则的内存。不同规则开销不同,不能只凭细胞数估算整条流程资源。

更换输入、数据库或参数后,确认相关规则实际重跑,避免新旧结果混合。每次运行使用独立目录,保存配置、输入清单、数据库校验值、提交SHA、日志和资源记录;不要手工拼接不同运行目录的中间文件。

验收网络,不把推断当成因果

检查motif富集、TF到区域和区域到基因关联及最终eRegulon对象的维度、ID和非空内容。网络是基于表达、可及性和motif证据的候选推断:motif命中不证明真实结合,关联边不证明因果。关键候选需用独立数据或扰动实验验证;条件比较应以生物学样本为重复。

参考:固定提交的项目元数据;固定提交的依赖清单;SCENIC+官方Snakemake教程。

下载练习材料

下载教程 PDF · 下载代码与示例数据 ZIP

先核对包内SHA256清单,再在独立目录复现。

需要额外算力时

适用前提:数据与方法适配,需要兼容软件栈及持续计算环境;CPU和内存分别按实测选型。如需额外资源,可评估服务器租赁及按需环境部署。咨询时说明软件版本、任务规模和使用期限,配置与支持范围另行确认。

咨询本任务的服务器配置

咨询本任务的服务器配置

留下手机号,我们会结合本文任务与您沟通服务器配置和报价。

也可联系云生信企业微信客服,说明本文任务。

参考与版本核对

按文中适用环境运行,所用版本与参数以实际安装环境和对应官方文档为准。

把知识用于当前任务

下一步可以直接开始分析

按研究目标查找在线工具、课程、计算资源或完整分析服务。

按目标找方案仍有疑问,联系客服 ↗