空间转录组项目最容易低估的,不是某条命令,而是数据在同一条流程里同时叠加:FASTQ、参考文件、组织图像、比对中间文件、表达矩阵和下游对象都要占资源。小测试能跑通,不代表完整切片、多样本并行也能稳定完成。
以 10x Genomics 当前 Space Ranger v4.1 为例,官方最低配置是 8 核 CPU、64 GB 内存和 1 TB 可用磁盘,推荐 32 核、128 GB 内存。官方资源测试还使用了一个 2.68 亿 reads 的 Visium HD 数据集。这些数字不是“越大越好”的采购口号,而是项目排队、并发和存储规划的起点。

先回答一个常见误区:Space Ranger 一定要 GPU 吗?
标准 spaceranger count 的核心压力通常在 CPU、内存、磁盘吞吐和文件系统限制,并不是先看显卡。GPU 更常出现在后续的图像分割、深度学习、病理基础模型或某些空间域识别方法中。只为跑标准流程就先买高端 GPU,可能解决不了内存不足、磁盘写满或 I/O 等待。
真正要做的是把流程拆开:原始数据处理需要多少 CPU 和内存;大图是否会抬高峰值;多个样本是否同时运行;下游是否进入 GPU 工具。资源要跟任务阶段匹配,而不是只看一张硬件参数表。
一张表看清主要瓶颈
| 环节 | 可核对的数字或现象 | 更稳妥的处理 |
|---|---|---|
| 基础运行 | 最低 8 核、64 GB;推荐 32 核、128 GB | 先单样本跑通,再按峰值决定并发 |
| 本地调度 | 默认用可用内存的 90%,并使用全部核心 | 显式设置 --localcores 和 --localmem |
| 存储 | 官方要求 1 TB 可用磁盘 | 原始、临时和结果目录分开规划 |
| 大组织图像 | 1–100 GB;64 GB 内存上限示例约 4.5 gigapixels | 记录像素尺寸、格式、通道数 |
| 多样本并行 | 峰值近似随同时运行任务数累加 | 给系统留 20%–25% 余量 |
| Linux 文件限制 | open files 16k;user processes 每核 64 | 上机前检查 ulimit |
这些是配置起点,不是对所有样本的耗时保证。读长、测序深度、图像大小、是否输出 BAM、参考版本和文件系统速度都会改变实际表现。
多样本时,别把“能跑一个”当成“能并行四个”
假设单个任务通过监控发现峰值接近 96 GB,两任务同时运行理论上就要约 192 GB。再为操作系统、缓存和波动保留 20%–25%,256 GB 级内存比把 192 GB 刚好分满更合理。若只有 128 GB,就应该排队串行,而不是让两个任务互相抢内存。
并发规划还要看共享盘。四个任务同时读取 FASTQ、写入中间文件,即使内存够,也可能把磁盘吞吐打满,使每个任务都变慢。更稳妥的做法是先测一个任务,再逐步增加到两个,比较总吞吐、等待时间和失败率;只有整体效率提高,增加并发才有意义。团队多人共用节点时,还应给每个任务设置资源上限和独立目录。
核心数增加也不一定线性缩短时间。Space Ranger 会为每个核心派生多个进程;核心越多,进程数和文件句柄压力也会上升。看到“CPU 没跑满”时,先看 I/O、内存和文件限制,不要只继续加线程。
运行中不要只盯着进度条
至少同时记录四类指标:进程峰值内存、CPU 利用率、磁盘 iowait 和工作目录剩余空间。峰值内存持续贴近上限,说明下一次更大样本容易被系统终止;CPU 利用率不高但 iowait 长时间升高,通常应先检查磁盘和共享存储;磁盘剩余空间快速下降,则要判断增长来自临时文件、BAM 还是最终输出。
可以用 /usr/bin/time -v 记录单任务最大常驻内存,用 free -h 和 df -h 看内存、交换空间和磁盘余量,用 iostat -x 观察设备等待。每次保留命令、版本、日志和资源记录,下一批样本才能按实测排队。
spaceranger count --id=sample01 \
--fastqs=/data/fastq \
--transcriptome=/refs/GRCh38 \
--localcores=32 --localmem=128
具体输入参数要按实验类型和 Space Ranger 版本调整。若下游明确不需要 BAM,可评估 --create-bam=false 是否适用;这能减少部分输出,但不能把它当成所有项目的默认选项。
上机前先做这 5 项检查
- 锁定版本与输入。记录版本、FASTQ 总量、参考或 probe set、图像格式和像素尺寸。
- 先跑代表性样本。选择 reads 较多、图像较大的样本,记录峰值内存、时间和目录增长。
- 明确限制资源。用
--localcores、--localmem控制单任务上限。 - 把存储当作流程资源。把原始数据、临时文件、最终结果和备份一起计算。
- 再决定并发。用“单任务峰值 × 并发数 + 系统余量”估算内存。
如果使用超大切片,图像本身也不能忽略。10x 的成像说明指出,相关图像可达到 1–100 GB;64 GB 内存对应的图像处理上限示例约为 4.5 gigapixels,也就是约 67,000 × 67,000 像素。压缩文件看起来不大,解码和处理时的内存占用仍可能明显上升。
什么时候更适合放到服务器上?
当项目满足任意两项——Visium HD、大图、多样本、需要并行、团队协作、后续还要做分割或深度学习——服务器通常比个人电脑更合适。价值不只是“配置更高”,还包括固定软件版本、集中存储、任务排队、日志保留和复现实验环境。
但服务器租用、环境部署和委托分析是三种不同服务。租用环境不等于自动包含分析交付;委托分析也要先确认数据、目标和结果范围。
把资源问题提前算清楚
如果 Space Ranger 在比对、图像处理或矩阵生成阶段中断,可以先准备:软件版本、样本数、FASTQ 总量、图像尺寸与格式、当前机器配置、报错阶段和希望完成的时间。云生信会先判断瓶颈属于内存、存储、I/O、环境还是并发策略,再沟通适合的服务器环境、部署支持或分析服务范围。
