
souporcell利用单细胞RNA测序读段中的遗传变异,把混在同一文库里的细胞分成遗传簇。它回答的是“哪些细胞的遗传信号相近”,不会自动告诉你cluster 0是谁。实操先以一份文库跑通输入、参数和结果检查,再扩展到其他文库。
先对齐三类输入
| 输入 | 核对内容 | 常见问题 |
|---|---|---|
| Cell Ranger BAM | 对应本次文库;保留CB细胞条码和UB UMI标签 | 中间转换时标签被移除 |
| filtered barcodes | 来自同一文库,一行一个细胞条码 | 误用raw条码或另一批次文件 |
| 参考FASTA | 物种及基因组版本与比对结果相符 | 变异坐标和参考序列不一致 |
先确认预期混样供者数 k,并检查实验是否真的把多个供者混在一份文库中。供者遗传差异不足或可用读段太少时,增加CPU和内存不能补出信号。当前官方流程要求BAM、barcode文件、FASTA、线程数、输出目录和簇数;具体参数随安装版本变化,先保存本机帮助。
单文库运行并保留证据
下面示例使用默认重比对路线。把变量替换为实际路径;输出目录必须是新目录,线程数不要超过获配额度:
set -euo pipefail
BAM=/data/run1/possorted_genome_bam.bam
BARCODES=/data/run1/filtered_feature_bc_matrix/barcodes.tsv.gz
FASTA=/ref/genome.fa
OUT=/work/souporcell/run1_attempt1
THREADS=8
K=4
PIPELINE=/opt/souporcell/souporcell_pipeline.py
command -v samtools
python "$PIPELINE" -h > /work/souporcell/help.txt 2>&1
samtools quickcheck "$BAM"
test -s "$BARCODES" && test -s "$FASTA"
test ! -e "$OUT"
mkdir -p "$(dirname "$OUT")"
sha256sum "$BAM" "$BARCODES" "$FASTA" > "$OUT.inputs.sha256"
/usr/bin/time -v -o "$OUT.resources.txt" python "$PIPELINE" -i "$BAM" -b "$BARCODES" -f "$FASTA" -t "$THREADS" -o "$OUT" -k "$K" > "$OUT.stdout.log" 2> "$OUT.stderr.log"
samtools quickcheck只能发现部分头部或文件末端问题,不能证明barcode匹配、标签存在或样本来源正确。正式跑前还应抽查BAM的CB/UB标签,并确认barcode文件是对应的过滤细胞列表。pipeline若因barcode比例、标签或输入守卫报错,应回头查文件和标签,不要直接加 --ignore 放过检查。
看结果时分开三件事
先确认进程正常结束,再核对本版本要求的结果文件。通常重点看:
clusters.tsv:每个细胞的分配状态及singlet/doublet判断;比较条形码覆盖,查找未分配细胞。cluster_genotypes.vcf:算法推断的簇基因型,检查是否有足够变异支持。ambient_rna.txt:环境RNA估计;它是后续判断的线索,不代表已自动校正所有污染。- 阶段日志与资源记录:定位失败阶段,记录峰值内存、耗时和临时盘占用。
输出簇数与预期不符、未分配比例偏高或doublet比例异常时,先依次检查输入条码、CB/UB标签、测序覆盖、参考版本和 k,再判断是否需要重跑。不要为得到预期簇数而反复调参后只挑最“好看”的结果。更改筛选或参数时,保留原始结果并记录理由。
避免两种常见误读
第一,cluster编号只是本次运行的标签;不同文库的cluster 0不能直接合并,也不能直接写成供者姓名。若要映射真实身份,需要经批准的已知基因型或独立实验信息。第二,跳过重比对不是通用加速开关;官方流程要求为该模式提供匹配的常见变异或已知基因型信息,具体按当前版本文档执行。
每个文库单独保存输入校验值、软件版本、运行参数、日志、结果目录和复核状态。跨文库汇总时用“文库编号+簇编号”作为联合键,并单独保存身份映射表。若试跑显示主要耗时在重比对或临时文件写入,再按实测核算CPU、工作盘和并行数;现有资源不足时,才有依据比较可用计算环境。
下载练习材料
先核对包内SHA256清单,再在独立目录复现。
需要额外算力时
适用前提:数据适合所选拆样方法且流程已验证,批量计算需要额外资源。如需额外资源,可评估按任务测算的CPU服务器租赁。咨询时说明软件版本、任务规模和使用期限,配置与支持范围另行确认。
咨询本任务的服务器配置
留下手机号,我们会结合本文任务与您沟通服务器配置和报价。 也可联系云生信企业微信客服,说明本文任务。咨询本任务的服务器配置
参考与版本核对
按文中适用环境运行,所用版本与参数以实际安装环境和对应官方文档为准。
