genomicpariscentre/guppy

Guppy Basecaller Docker镜像文档

镜像概述

本镜像包含Oxford Nanopore Technologies开发的Guppy碱基识别软件，用于将纳米孔测序设备产生的原始信号数据转换为DNA或RNA序列。该Dockerfile源自Genomic Paris Centre使用的镜像构建配置，提供了标准化的Guppy运行环境，确保跨平台的一致性和可重复性。

核心功能与特性

• 碱基识别（Basecalling）：核心功能为将纳米孔测序原始电信号转换为碱基序列（A/T/C/G）
• 多模式支持：兼容多种纳米孔测序芯片（如FLO-MIN106、FLO-MIN111等）和测序模式
• 算法优化：集成高效信号处理算法，支持高准确度（high-accuracy）和快速（fast）两种识别模式
• 容器化优势：预配置运行环境，避免依赖冲突，简化部署流程

使用场景

• 纳米孔测序数据的碱基识别处理
• 基因组学、转录组学研究中的测序数据分析流程
• 生物信息学实验室标准化分析 pipeline 构建
• 测序中心日常数据处理任务

使用方法与配置说明

基本使用流程

1. 拉取镜像（需根据实际镜像名称调整）
2. 挂载输入输出目录
3. 指定测序数据路径和输出路径
4. 选择适当的碱基识别模型和参数

环境变量与参数

Docker部署示例

基础运行命令（CPU模式）

bash
docker run -v /local/raw_data:/data/raw -v /local/output:/data/results \
  docker.xuanyuan.run/guppy-image:latest \
  guppy_basecaller --input /data/raw --save_path /data/results --model dna_r9.4.1_450bps_fast --device cpu

GPU加速运行命令

bash
docker run --gpus all -v /local/raw_data:/data/raw -v /local/output:/data/results \
  docker.xuanyuan.run/guppy-image:latest \
  guppy_basecaller --input /data/raw --save_path /data/results --model dna_r9.4.1_450bps_hac --device cuda:0

Docker Compose配置示例

yaml
version: '3'
services:
  guppy:
    image: docker.xuanyuan.run/guppy-image:latest
    volumes:
      - /local/raw_data:/data/raw
      - /local/output:/data/results
    command: guppy_basecaller --input /data/raw --save_path /data/results --model dna_r9.4.1_450bps_hac --device cpu

注意事项

• 运行前需确保输入目录包含有效的纳米孔测序原始数据（.fast5格式文件）
• GPU模式需宿主环境支持NVIDIA Docker运行时
• 不同测序芯片和化学版本需匹配相应的模型文件（可通过guppy_basecaller --list_models查看支持的模型）