
Clair3部署先确认软件、模型和测序数据的组合,再测资源。platform写ont并不表示所有ONT化学与basecaller都能用同一权重。下面固定Clair3 v2.0.2的CPU入口,处理已验收的二倍体ONT DNA比对;样例通过后才安排多样本,不把局部试跑当整队列已经兼容。
先把模型来源和输入范围记清楚
参考FASTA、索引与坐标排序BAM来自同一组装,BAM索引有效,样本和实际contig范围已核对。模型需与该软件格式、测序化学、basecaller配置及是否使用信号特征相匹配。当前v2路线采用PyTorch,不能按旧教程要求六个TensorFlow文件来检验所有新模型。
| 检查项 | 本例约定 | 验收重点 |
|---|---|---|
| 软件 | 完整v2.0.2环境及配套依赖 | 主入口、解释器与工具均可用 |
| 模型 | 项目核对过的ONT模型目录 | 来源、版本、校验及适用数据 |
| 输入 | 可信DNA BAM与参考索引 | ID、组装、覆盖与contig范围 |
| 资源 | 单例4线程CPU试跑 | 完整墙钟、主机RAM及临时盘 |
带mv的信号感知模型另需相应BAM标签及启用特征的设置,本例不走该路线。小样例验证接口、文件和结果范围,正式质量还需要合适真值或独立证据;模型文件能被读取不等于对该项目准确率已经验证。
用一个完整样本入口建立基线
以下要求已激活兼容CPU环境,runner是完整安装中的脚本,model代表按本项目核验过的非mv模型目录。路径均需替换,4线程为演示。保存帮助与入口指纹,版本和模型升级后另建运行,避免混用旧临时产物。
#!/usr/bin/env bash
set -euo pipefail
runner=/opt/clair3-v2.0.2/run_clair3.sh
model=/models/project-verified-ont-no-mv
bam=/data/S1.bam
ref=/refs/genome.fa
test -s "$runner"
test -d "$model"
test -s "$bam"
test -s "$ref"
test -s "$ref.fai"
samtools quickcheck -v "$bam"
mkdir clair3-pilot-001
root="$PWD/clair3-pilot-001"
bash "$runner" --help > "$root/help.txt" 2>&1
sha256sum "$runner" "$bam" "$ref" > "$root/inputs.sha256"
/usr/bin/time -v -o "$root/resources.txt" \
bash "$runner" --bam_fn="$bam" --ref_fn="$ref" --threads=4 \
--platform=ont --model_path="$model" --sample_name=S1 --output="$root/calls" \
> "$root/run.log" 2>&1
test -s "$root/calls/merge_output.vcf.gz"
bcftools view -h "$root/calls/merge_output.vcf.gz" > "$root/header.txt"
bcftools query -l "$root/calls/merge_output.vcf.gz" > "$root/sample-names.txt"
检查输出样本名、实际调用contig、变异范围、FILTER与基因型,而不只看VCF文件大小。默认contig选择需按版本核验,非人类或特殊序列不能把未分析区域当无变异。基于pileup的快速路线和完整路线含义不同,不能只开启pileup-only后沿用完整流程的质量与资源结论。
按阶段定位问题
导入或ABI报错先检查固定环境;模型维度、权重加载问题先核包与模型组合;找不到参考序列先查BAM与FASTA。进入候选、全比对特征、推理、定相或合并后的失败分别保留日志,不能统一当RAM不足。CPU包也不能仅靠设置CUDA环境变量变成兼容GPU版本。
记录完整任务的墙钟、RAM、临时盘和输出;工具内各阶段并行方式不同,threads不应被解释为所有进程总CPU硬上限。GPU路线需要另一套兼容构建与设备验证,按完整任务测实际收益,不从模型名字推定必须使用GPU。
扩成队列时保留独立运行合同
每行样本清单包含BAM、参考、模型、平台、样本名、方法设置和新输出目录。先顺序完成代表样本,再测试平台允许的小并发;不同覆盖和读长可能改变全比对工作量,不只按BAM大小均分。失败样本留日志并标未完成,旧任务结束后用新目录重试。
只用一个小染色体或很短区域跑通时,明确标注局部范围,不能线性保证整基因组峰值。批量交付逐项核输入样本及contig覆盖、变异质量和所需文件;模型、basecaller或分析范围改变后重新验收,保留输入及模型指纹,便于解释前后结果差异。
需要额外算力时
适用前提:平台模型匹配且样例通过后,需要兼容环境和批量计算资源。如需额外资源,可评估服务器租赁及按需环境部署。咨询时说明软件版本、任务规模和使用期限,配置与支持范围另行确认。
咨询本任务的服务器配置
留下手机号,我们会结合本文任务与您沟通服务器配置和报价。 也可联系云生信企业微信客服,说明本文任务。咨询本任务的服务器配置
参考与版本核对
按文中适用环境运行,所用版本与参数以实际安装环境和对应官方文档为准。
