muegamma/offline

镜像概述和主要用途

这是PSI的MEG II实验离线分析环境镜像，基于centos:7或almalinux:9构建，已安装必要软件包，包括MEG II标准版本的ROOT、GenFit、ONNX Runtime和Geant4。需注意，meg2和rome包未包含在内，需用户在容器内自行安装。

核心功能和特性

• 基于AlmaLinux 9或CentOS 7构建，提供稳定的实验分析环境
• 预安装MEG II实验所需核心软件：ROOT、GenFit、ONNX Runtime、Geant4
• 支持多平台运行（Linux、Windows、Mac），包括ARM架构（AlmaLinux标签）

状态

• Linux：在RHEL7上测试通过
• Windows：通过Docker for Windows（Hyper-V和WSL2）测试通过
• Mac：通过Docker for Mac测试通过；AlmaLinux标签提供ARM架构镜像（尚未测试）

以下Geant4数据未包含在镜像中，如需使用需自行添加：

• G4NDL（>400 MB）
• RealSurface（>700 MB）

发布说明

详见Dockerfile历史。

• 2026a

  • 2026年标准版本，基于AlmaLinux9，包含GCC14、Python3.12、ROOT6.36.08、Geant4.11.1.3、ONNX Runtime v1.19.2

• 2025a

  • 2025年标准版本，基于AlmaLinux9，包含GCC13、ROOT6.32.10、Geant4.11.1.3、ONNX Runtime v1.19.2
  • 包含指定版本的SQLite3

• 2024A

  • 2024年标准版本，基于AlmaLinux9，包含GCC11、ROOT6.30.04、Geant4.11.1.3、ONNX Runtime v1.13.1

• 2024a

  • 2024年标准版本，包含GCC11、ROOT6.30.04、Geant4.11.1.3、ONNX Runtime v1.13.1
  • 添加执行离线处理所需的Perl模块

• 2023a

  • 2023年标准版本，包含GCC11、ROOT6.28.00、Geant4.11.1.1、ONNX Runtime v1.13.1

• 2022b

  • 添加git-lfs
  • 更新ROOT版本至6.26.06以修复RooFit中的bug

• 2022a

  • 基于CentOS7.9.2009
  • 2022年标准版本，包含GCC10.3、ROOT6.24.06、Geant4.10.6.p03、ONNX Runtime v1.10.0

• 2021a

  • 2021年标准版本，包含GCC9.3、ROOT6.22.06、Geant4.10.6.p03
  • 添加ONNX Runtime v1.6.0
  • 添加qt5-qtbase和qt5-qtbase-devel以支持新版Geant4

• 2020b

  • 添加Singularity使用脚本
  • 添加Astyle3.1
  • 手动修改geant4make以抑制CLHEP代码编译时的警告
  • 定制RooProdPdf.h以适应MEG似然分析（针对ROOT6.20的变更）

• 2020a

  • 2020年标准版本，包含GCC8.4、ROOT6.20.00、Geant4.10.4.p03
  • 添加boost和boost-devel（gem4代码自2019年起使用）

• 2019a

  • 2019年标准版本，包含GCC6.4、ROOT6.16.00、Geant4.10.4.p02

版本2025a注意事项

如已使用旧版本并升级到2025a，可能需要手动修改.bash_profile（文件仅在容器首次运行时复制到主卷）：

bash
# GCC
source /opt/rh/devtoolset-*/enable
# Python
# source /opt/rh/rh-python*/enable

版本2024A注意事项

如已使用旧版本并升级到2024A，需手动修改.bash_profile（文件仅在容器首次运行时复制到主卷）：

原内容：

bash
# GCC
source /opt/rh/devtoolset-*/enable
# Python
source /opt/rh/rh-python*/enable

修改为：

bash
# GCC
# source /opt/rh/devtoolset-*/enable
# Python
# source /opt/rh/rh-python*/enable

版本2023a注意事项

如已使用旧版本并升级到2023a，进入容器时可能出现以下错误：

bash
-bash: /cern/geant4/share/Geant4-*/geant4make/geant4make.sh: No such file or directory

需手动修改.bash_profile或将/root/.bash_profile复制到主目录（使用sudo），将：

bash
source ${GEANT4SYS}/share/Geant4-*/geant4make/geant4make.sh

修改为：

bash
source ${GEANT4SYS}/share/Geant4*/geant4make/geant4make.sh

版本2021a注意事项

如已使用旧版本并升级到2021a，需手动修改.bash_profile或从/root/.bash_profile复制以包含ONNX和（可选）Astyle的设置（文件仅在容器首次运行时复制到主卷）。

版本2020a注意事项

如已使用旧版本并升级到2020a，需手动修改.bash_profile（文件仅在容器首次运行时复制到主卷）：

原内容：

bash
# GCC
source /opt/rh/devtoolset-6/enable
# Python
source /opt/rh/rh-python36/enable

修改为：

bash
# GCC
source /opt/rh/devtoolset-*/enable
# Python
source /opt/rh/rh-python*/enable

使用场景和适用范围

适用于MEG II实验的离线数据分析，提供标准化软件环境，确保实验分析的一致性和可重复性。

使用方法和配置说明

详见wiki。（Singularity使用方法见此处。）

基本运行命令

bash
$ WORKDIR=/path/to/work_dir
$ docker run -it -e LOCAL_UID=$(id -u $USER) -e LOCAL_GID=$(id -g $USER) -v ${WORKDIR}:/home/meg --name offline  muegamma/offline

运行后将以用户'meg'登录容器。

自定义用户名登录

bash
$ LOGIN_NAME=your_name; WORKDIR=/path/to/work_dir
$ docker run -it -e LOCAL_UID=$(id -u $USER) -e LOCAL_GID=$(id -g $USER) -e LOCAL_USER=$LOGIN_NAME -v ${WORKDIR}:/home/${LOGIN_NAME} --name offline  muegamma/offline su - ${LOGIN_NAME}

GUI使用配置

从容器获取X窗口需根据系统添加相应选项：

远程服务器（Linux -> Linux）

bash
--net host -v $HOME/.Xauthority:/home/${LOGIN_NAME}/.Xauthority -e DISPLAY=localhost:10.0

Windows本地Docker

• 版本<2.2：

  bash
  -e DISPLAY=10.0.75.1:0.0
  

  其中1０.0.75.1是DockerNAT的IP地址，可通过ipconfig查看。
• 版本≥2.2：

  bash
  -e DISPLAY=host.docker.internal