mgibio/samtools

docker-samtools 镜像文档

镜像概述和主要用途

docker-samtools是Samtools工具的Docker容器化版本。Samtools是HTSlib项目（[***]

核心功能和特性

核心功能

• 格式转换：支持SAM与BAM格式互转（如samtools view -bS实现SAM到BAM转换）。
• 文件排序：对BAM文件按坐标或读取名排序（如samtools sort）。
• 索引创建：生成BAM文件索引（.bai），支持快速随机访问（如samtools index）。
• 数据统计：计算测序深度、覆盖度、碱基质量等指标（如samtools depth、samtools flagstat）。
• 视图筛选：按区域、标签等条件筛选并查看SAM/BAM文件内容（如samtools view）。

主要特性

• 基于HTSlib库，高效处理大型测序文件，支持压缩格式。
• 容器化部署确保跨平台环境一致性，简化依赖管理。
• 保留原生命令行接口，兼容所有Samtools标准操作。

使用场景和适用范围

适用场景

• 基因组学研究中的测序数据预处理（比对结果格式转换、排序）。
• 测序数据分析流程集成（与GATK、BWA等工具链配合使用）。
• 教学/科研环境中快速搭建标准化Samtools运行环境。
• 集群或多平台环境中统一工具版本与依赖配置。

适用范围

• 生物信息学研究人员、测序数据分析工程师。
• 基因组学、转录组学等高通量测序领域的实验室/机构。
• 需处理SAM/BAM格式数据的生物信息学项目。

使用方法和配置说明

前提条件

已安装Docker引擎（参考：[***]

获取镜像

方式1：拉取第三方可信镜像（示例）

bash
docker pull biocontainers/samtools:latest  # 生物信息学常用镜像源

方式2：本地构建（推荐）

1. 编写Dockerfile：

dockerfile
FROM ubuntu:22.04
RUN apt-get update && apt-get install -y samtools && rm -rf /var/lib/apt/lists/*
ENTRYPOINT ["samtools"]

2. 构建镜像：

bash
docker build -t samtools .

基本使用命令

通过-v参数挂载本地目录实现文件共享，基本格式：

bash
docker run --rm -v <本地数据目录>:/data samtools <命令及参数>

• --rm：容器退出后自动清理
• -v <本地目录>:/data：挂载本地目录到容器内/data路径

常用操作示例

1. 查看版本信息

bash
docker run --rm samtools --version

2. SAM转BAM（本地input.sam转output.bam）

bash
docker run --rm -v $(pwd):/data samtools view -bS /data/input.sam > /data/output.bam

3. BAM文件排序（按坐标排序input.bam为sorted.bam）

bash
docker run --rm -v $(pwd):/data samtools sort /data/input.bam -o /data/sorted.bam

4. 创建BAM索引（为排序后BAM生成索引）

bash
docker run --rm -v $(pwd):/data samtools index /data/sorted.bam

5. 统计比对质量（生成flag统计报告）

bash
docker run --rm -v $(pwd):/data samtools flagstat /data/sorted.bam > /data/flagstat_report.txt

配置说明

无特殊环境变量，所有操作通过命令行参数实现。完整参数列表可通过以下命令查看：

bash
docker run --rm samtools --help

或参考官方文档：[***]