mgibio/r-singlecell

docker-single-cell 镜像文档

镜像概述

docker-single-cell是一个基于Ubuntu的单细胞分析基础Docker镜像，集成了多种便捷工具，旨在为单细胞数据分析提供统一、便捷的运行环境，特别适用于数据探索和快速原型开发场景。

核心功能与特性

• 基础环境：基于Ubuntu系统构建，提供稳定的底层运行环境
• R环境：预装R 3.5版本及常用单细胞分析包，包括：
  • Seurat：单细胞RNA测序数据分析的主流R包
  • DropletUtils：用于处理 droplet-based 单细胞RNA测序数据的工具包
• 灵活性：支持用户自定义R库安装路径，实现库文件的持久化存储

使用场景

• 单细胞RNA测序（scRNAseq）数据的初步探索与分析
• 单细胞数据分析流程的快速原型开发与测试
• 需要统一环境的单细胞研究团队协作

使用方法与配置说明

基本使用

通过以下命令启动容器（假设镜像名称为docker-single-cell）：

bash
docker run -it docker-single-cell

R库持久化配置

为避免每次容器重启丢失自定义安装的R包，建议在.Rprofile中配置持久化库路径。具体步骤如下：

1. 在容器内编辑或创建.Rprofile文件：

   bash
   vi ~/.Rprofile
   

2. 添加以下配置（请根据实际需求修改路径）：

   r
   # 设置自定义R库路径
   devlib <- paste('/gscuser/cmiller/usr/lib/R', paste(R.version$major, R.version$minor, sep="."), sep="")
   
   # 若路径不存在则创建
   if (!file.exists(devlib)) {
     dir.create(devlib, recursive = TRUE)
   }
   
   # 更新库路径，优先使用自定义路径
   current_libs <- .libPaths()
   .libPaths(c(devlib, current_libs))
   
   # 清理临时变量
   rm(current_libs, devlib)
   

3. 保存配置后，重启R即可生效。

注意事项

• 该镜像主要用于快速原型开发，若需与他人共享分析代码，应构建包含所有依赖库的新容器，以确保环境一致性。
• 自定义R库路径需确保容器内有足够的存储空间，建议通过Docker卷（Volume）挂载宿主机目录以实现数据持久化。