staphb/bowtie2

minimap2 Docker镜像文档

概述

minimap2是一款由lh3开发的超快且内存高效的序列比对工具，主要用于将测序reads（尤其是长读长数据如PacBio、ONT）比对到长参考序列（如基因组、转录组）。本Docker镜像由StaPH-B（State Public Health Lab Bioinformatics）联盟提供，旨在为用户提供便捷、一致的minimap2运行环境。

核心功能与特性

• 超高速度与低内存占用：相比传统比对工具，minimap2在保持高准确性的同时，显著提升比对速度并降低内存消耗。
• 多数据类型支持：兼容PacBio HiFi/CLR、ONT、Illumina等多种测序平台数据。
• 灵活比对模式：支持局部比对（map-ont, map-pb）、联配比对（asm5, asm10）、 spliced比对（splice, splice:hq）等多种模式，满足不同分析需求。
• 广泛应用场景：适用于基因组组装验证、转录组异构体分析、宏基因组物种鉴定等。

适用范围

• 生物信息学研究者及实验室人员
• 需要处理长读长测序数据的比对分析
• 基因组、转录组、宏基因组等领域的序列比对任务

版本信息

使用方法

1. 拉取镜像

从Docker Hub拉取指定版本的minimap2镜像：

bash
docker pull staphb/minimap2:2.22  # 拉取2.22版本，可替换为其他版本号

2. 基本运行示例

将本地数据目录挂载到容器中，执行比对命令：

bash
# 格式：docker run -v [本地数据目录]:/data staphb/minimap2:[版本号] minimap2 [参数] [参考序列] [reads文件] > [输出文件]
docker run -v $(pwd):/data staphb/minimap2:2.22 minimap2 -x map-ont ref_genome.fasta reads.fastq > alignment.sam

• -v $(pwd):/data：将当前目录挂载到容器内的/data目录，实现数据共享
• -x map-ont：指定比对模式为ONT长读长数据
• ref_genome.fasta：参考序列文件（需位于本地当前目录）
• reads.fastq：测序reads文件（需位于本地当前目录）
• alignment.sam：输出的SAM格式比对结果

3. 常用参数说明

• -x <preset>：预设比对模式（如map-ont、map-pb、splice等）
• -a：输出SAM格式比对结果
• -t <int>：指定线程数
• -o <file>：输出结果到指定文件（替代重定向>）

4. Singularity兼容性

minimap2 Docker镜像可转换为Singularity格式使用，适合无Docker权限的环境：

bash
# 下载Docker镜像并转换为Singularity镜像
singularity pull docker://staphb/minimap2:2.22
# 运行Singularity容器
singularity exec minimap2_2.22.sif minimap2 -x map-ont ref_genome.fasta reads.fastq > alignment.sam

注意事项

• 确保输入文件路径正确，本地目录需通过-v参数挂载到容器内
• 不同版本的minimap2可能存在参数差异，建议参考对应版本的官方文档
• 大规模数据比对时，可通过-t参数增加线程数提升效率

反馈与贡献

如使用中遇到问题，可通过https://github.com/StaPH-B/docker-builds%E6%8F%90%E4%BA%A4issue%E3%80%82%E6%AC%A2%E8%BF%8E%E9%80%9A%E8%BF%87fork%E4%BB%93%E5%BA%93%E3%80%81%E6%8F%90%E4%BA%A4PR%E7%9A%84%E6%96%B9%E5%BC%8F%E8%B4%A1%E7%8C%AE%E4%BB%A3%E7%A0%81%E6%88%96%E6%94%B9%E8%BF%9B%E9%95%9C%E5%83%8F%E3%80%82