云生信学生物信息学

用一张切片试跑测资源,再规划空间组学服务器

作者:发布于 2026-11-17更新于 2026-11-15约 6 分钟阅读
一张切片,测完整任务

一张切片,测完整任务:固定切片和输出选项;新ID运行并保存日志;记录盘占用与聚合峰值;验收后测多切片重叠
本文操作与检查路径示意。

空间组学试跑的单位应是明确的一张切片捕获区及其完整输入,而非随手挑一个小TIFF。读段、图像、配准和分割可能在不同阶段形成峰值。下面以Space Ranger v4.1的探针型Visium HD为例,完成一次有日志、可验收的资源测量。

冻结切片与输出方案

确认同一捕获区的FASTQ、CytAssist及组织图像、参考和probe set。记录slide、area、样本前缀与图像尺寸。此命令不用于Visium HD 3′,后者不指定probe-set;荧光、手工配准或其他建库需按其入口调整,不能比较资源时顺便改变分析任务。

BAM和细胞注释影响任务范围,试跑前确定是否需要。示例显式保留BAM并关闭4.1细胞注释,以固定测量范围;它不代表正式项目应关闭注释。正式任务增加该功能后应另测,不能把当前耗时直接当完整任务耗时。

在获配环境启动新运行

全部变量先按真实输入设置;核心、内存必须符合平台额度及任务要求。以下需Linux Bash、GNU time和兼容Space Ranger,输出名称不得复用,失败现场保留。先用前篇检查单核对路径与建库,不以文件名猜测切片身份。

set -u
for name in SR_ID SR_REF SR_FASTQS SR_SAMPLE SR_PROBES SR_SLIDE SR_AREA SR_CYTAIMAGE SR_IMAGE SR_CORES SR_MEM_GB; do
  test -n "${!name:-}" || { echo "missing: $name"; exit 2; }
done
case "$SR_ID" in *[!A-Za-z0-9_-]*|"") exit 2;; esac
case "$SR_CORES:$SR_MEM_GB" in *[!0-9:]*|:*|*:) exit 2;; esac
test "$SR_CORES" -gt 0 && test "$SR_MEM_GB" -gt 0 || exit 2
test ! -e "$SR_ID" || exit 2
mkdir -p pilot-logs
spaceranger --version > "pilot-logs/$SR_ID.version.txt"
/usr/bin/time -v -o "pilot-logs/$SR_ID.time.txt" \
  spaceranger count --id="$SR_ID" --transcriptome="$SR_REF" \
  --fastqs="$SR_FASTQS" --sample="$SR_SAMPLE" --probe-set="$SR_PROBES" \
  --slide="$SR_SLIDE" --area="$SR_AREA" --cytaimage="$SR_CYTAIMAGE" \
  --image="$SR_IMAGE" --create-bam=true --disable-cell-annotation \
  --localcores="$SR_CORES" --localmem="$SR_MEM_GB" \
  > "pilot-logs/$SR_ID.stdout.txt" 2> "pilot-logs/$SR_ID.stderr.txt"
status=$?
printf '%s\n' "$status" > "pilot-logs/$SR_ID.exit.txt"
test "$status" -eq 0

运行中记录容量时间轴

在另一终端低频查看运行目录和目标文件系统空间,记录观察时间与当前阶段。大目录du会产生额外I/O,不每秒递归扫描。参考、图像、输入和运行目录若分属不同挂载点,应分别记录,不能把盘间空闲量相加给同一个输出路径。

占用组成 本项目值 是否同时存在
FASTQ与两类图像 ____GB ____
展开参考与probe set ____GB ____
临时文件和本次输出峰值 ____GB或待测 ____
上次结果与独立备份 ____GB 位置____
实际可用量 ____GB 配额及其他用户____

GNU time最大RSS不是全部活跃进程的同时内存总和。多进程流水线应补充作业或控制组聚合统计;若只能看到单进程记录,注明测量限制。localmem是程序申请安排,也不等于操作系统对整个任务的硬隔离。

先验收,再安排多切片

核对退出码与web_summary,检查样本身份、捕获区、配准和组织检测,打开适用分辨率矩阵,检查需要的空间与分割结果。图像错配时,资源数字不能作为有效任务基准;先修输入再重测。成功结束也不自动证明切片实验质量合格。

选择图像和读段规模有代表性的另一张切片补测。准备并发时,用少量重叠任务测总峰值、工作盘和整批时间,不按单张文件体积乘倍数保证容量。将版本、建库、输出选项、实际额度和日志一起放入配置记录,结果回传与复核窗口也要纳入安排。

启动前在真实工作目录试写小文件并核对用户配额。整盘有空余,不表示账号或作业还能写;运行期的No space left on device、Disk quota exceeded与内存终止应分别处理。若只在写BAM阶段失败,先根据该阶段盘增长记录判断,不应直接把localmem调大重跑。对照不同机器日志时,先统一时间与时区。

下载练习材料

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

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

需要额外算力时

适用前提:切片类型与版本已匹配且本地资源不足。如需额外资源,可评估大内存独享CPU服务器租赁。咨询时说明软件版本、任务规模和使用期限,配置与支持范围另行确认。

咨询本任务的服务器配置

咨询本任务的服务器配置

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

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

参考与版本核对

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

把知识用于当前任务

先确定合适的计算资源

根据数据规模和分析任务,快速测算 CPU、内存、存储与 GPU 配置。

测算服务器配置仍有疑问,联系客服 ↗