
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教程。
下载练习材料
先核对包内SHA256清单,再在独立目录复现。
需要额外算力时
适用前提:数据与方法适配,需要兼容软件栈及持续计算环境;CPU和内存分别按实测选型。如需额外资源,可评估服务器租赁及按需环境部署。咨询时说明软件版本、任务规模和使用期限,配置与支持范围另行确认。
咨询本任务的服务器配置
留下手机号,我们会结合本文任务与您沟通服务器配置和报价。 也可联系云生信企业微信客服,说明本文任务。咨询本任务的服务器配置
参考与版本核对
按文中适用环境运行,所用版本与参数以实际安装环境和对应官方文档为准。
