deepmi/fastsurfer-build

镜像概述

该镜像为FastSurfer的构建辅助工具。FastSurfer是一款快速、自动化的脑MRI影像分析工具，用于皮层重建、脑结构分割等神经影像研究。本镜像旨在提供标准化的构建环境，包含FastSurfer编译所需的依赖库、工具链及配置，帮助用户简化FastSurfer的本地编译、定制化构建与部署流程，避免因环境差异导致的构建失败。

核心功能与特性

1. 预配置构建环境

• 集成FastSurfer编译必需的依赖库（如Python、CUDA、ITK、VTK等）及工具链（CMake、GCC、Git），无需用户手动安装复杂依赖。
• 包含FastSurfer子模块（如surfer、pyrecon）的依赖管理逻辑，自动处理版本兼容性。

2. 环境标准化

• 统一构建环境配置，确保不同用户、不同操作系统（如Linux）下的构建流程一致，减少环境相关的构建错误。
• 固化依赖版本，避免因依赖库更新导致的构建不稳定问题。

3. 简化构建流程

• 内置构建脚本模板，支持一键执行FastSurfer的编译、测试与安装流程。
• 支持自定义构建参数传递，满足定制化编译需求（如指定安装路径、开启/关闭功能模块）。

4. 跨平台支持

• 适配主流Linux架构（如x86_64），支持在服务器、工作站等设备上构建FastSurfer。

使用场景

• FastSurfer开发者：需对FastSurfer源码进行修改（如功能扩展、性能优化）后重新构建的用户。
• 研究机构/实验室：需要在本地集群或私有环境中部署定制版FastSurfer的研究团队。
• 二次开发人员：基于FastSurfer进行插件开发或集成的技术人员。

使用方法

前提条件

• 已安装Docker引擎（版本≥19.03）。
• 本地已获取FastSurfer源码（可通过git clone https://github.com/Deep-MI/FastSurfer.git克隆）。

1. 拉取镜像

从Docker仓库拉取最新版本的辅助镜像（具体镜像名称以官方发布为准，以下示例使用fastsurfer/build-helper）：

bash
docker pull fastsurfer/build-helper:latest

2. 运行容器并构建FastSurfer

通过挂载本地FastSurfer源码目录到容器，执行构建命令。以下为基础构建流程示例：

bash
docker run -it --rm \
  -v /path/to/local/fastsurfer:/workspace/fastsurfer \  # 挂载本地FastSurfer源码目录
  -v /path/to/output:/install \  # 可选，挂载输出目录用于保存构建结果
  -w /workspace/fastsurfer \  # 设置工作目录为源码根目录
  fastsurfer/build-helper:latest \
  bash -c "./build.sh --install_prefix /install"  # 执行构建脚本（以FastSurfer官方build.sh为例）

参数说明：

• -v /path/to/local/fastsurfer:/workspace/fastsurfer：将本地FastSurfer源码目录映射到容器内/workspace/fastsurfer，确保容器可访问源码。
• -v /path/to/output:/install：可选，将构建产物输出到本地目录，避免容器退出后文件丢失。
• -w /workspace/fastsurfer：指定容器内工作目录为源码根目录，简化命令路径。
• bash -c "./build.sh --install_prefix /install"：执行FastSurfer构建脚本，--install_prefix /install指定安装路径（需与挂载的输出目录一致）。

3. 定制化构建

可通过环境变量或命令行参数传递定制化构建选项，例如指定构建类型（Release/Debug）或启用特定功能：

bash
docker run -it --rm \
  -v /path/to/local/fastsurfer:/workspace/fastsurfer \
  -e BUILD_TYPE=Debug \  # 指定构建类型为调试模式
  -e CMAKE_ARGS="-DENABLE_CUDA=ON -DCMAKE_CUDA_ARCHITECTURES=75" \  # 传递CMake参数（如启用CUDA支持）
  fastsurfer/build-helper:latest \
  bash -c "./build.sh --install_prefix /install"

配置参数

关键挂载点

环境变量

注意事项

• 若需启用CUDA支持，需确保主机已安装NVIDIA Docker运行时（nvidia-docker），并在docker run命令中添加--gpus all参数。
• 构建过程中若需访问网络（如下载子模块或依赖），容器需保持网络连接（默认已启用）。
• 不同版本的FastSurfer可能依赖特定版本的辅助镜像，建议根据FastSurfer源码中的说明文档选择匹配的镜像标签。