cosmonaut/hdf5-builder

cosmonaut/hdf5-builder镜像说明

镜像概述

cosmonaut/hdf5-builder是一个专注于C/C++软件构建的Docker镜像，集成了autotools、cmake、gcc编译器及最新HDF5库（1.10.1+），旨在为科学计算项目（如PDP3等离子体模拟）提供稳定、高效的编译环境，简化依赖配置流程。

核心功能

• 完整C/C++编译工具链：autotools、cmake、gcc（6.X及以上版本）
• 集成最新HDF5库：支持C++接口，避免1.10.0版本的已知bug
• 并行计算支持：依赖libgomp（OpenMP 3.0+）
• 文档生成工具：doxygen、LaTeX等（可选）
• 可视化依赖兼容：Python、Jupyter、Matplotlib、Numpy等

使用场景

• 科学计算项目（如PDP3等离子体模拟）的编译环境搭建
• 需要HDF5库支持的C/C++程序开发与测试
• 并行计算应用的构建与性能优化
• 科学数据可视化前的编译准备

配置说明

Docker部署示例

1. 挂载本地项目运行容器

bash
docker run -it --rm \
  -v $(pwd)/pdp3:/app/pdp3 \
  cosmonaut/hdf5-builder bash

（将本地PDP3项目目录挂载到容器内/app/pdp3路径）

2. 容器内编译PDP3项目

进入容器后执行以下步骤：

bash
# 1. 初始化子模块（若未挂载本地目录）
git submodule update --init

# 2. 配置项目
./autogen.sh
./configure --enable-cxx --enable-build-mode=production

# 3. 安装HDF5库（可选）
make hdf5 && make hdf5-install

# 4. 编译项目
make

# 5. 运行项目
mkdir -p pdp_result  # 手动创建结果目录
./pdp3 -f parameters.xml

关键注意事项

• 运行前需根据parameters.xml中的result_path创建结果目录
• 禁用HDF5文件锁定：export HDF5_USE_FILE_LOCKING=FALSE
• 可视化工具需额外安装依赖（如apt-get install python3-matplotlib）
• 文档生成需安装doxygen、LaTeX等工具（apt-get install doxygen texlive-latex-base）