legendexp/remage

remage

镜像概述和主要用途

remage是一个基于Geant4的现代C++库，旨在为典型的低背景物理实验提供高效的粒子物理过程模拟。该库与实验装置无关，仅要求用户定义实验装置的几何结构。支持的几何规范语言包括C++、GDML等。一旦提供几何结构，用户即可访问一套全面的工具，用于常见任务如物理生成和标准输出处理。

核心功能和特性

• 低入门门槛：大多数模拟可直接使用remage可执行文件和宏文件运行，无需编写或编译C++代码。
• Docker Hub可用：多种预编译的remage版本可在https://hub.docker.com/r/legendexp/remage获取。
• 支持现代Geant4：
  • 多线程
  • https://gdml.web.cern.ch/GDML支持
  • 多种输出文件格式（https://root.cern.ch、HDF5等）
• LEGEND HDF5 (LH5)输出格式：支持https://legend-exp.github.io/legend-data-format-specs/dev/hdf5/。
• 快速第三方宇宙缪子生成器：通过https://doi.org/10.1016/j.nima.2021.***实现。
• 外部生成器支持：
  • https://doi.org/10.1016/j.cpc.2008.10.013
  • https://doi.org/10.1140/epja/s***-024-01336-0
• 第三方双β衰变生成器：通过https://github.com/BxCppDev/bxdecay0实现。
• 高级顶点限制：支持物理体积、几何固体、表面和交集中的顶点限制。
• HPGe和光学探测器的合理输出方案：为高纯度锗探测器和光学探测器提供优化的输出格式。

使用场景和适用范围

remage适用于需要模拟粒子物理过程的低背景物理实验，包括但不限于：

• 暗物质探测实验
• 中微子实验
• 双β衰变实验
• 其他低本底辐射测量实验

使用方法和配置说明

Docker部署

从Docker Hub拉取镜像

bash
docker pull docker.xuanyuan.run/legendexp/remage:latest

运行容器

使用宏文件执行模拟：

bash
docker run -v /path/to/your/macro:/macro docker.xuanyuan.run/legendexp/remage:latest remage /macro/your_macro.mac

其中/path/to/your/macro是本地宏文件所在目录，your_macro.mac是模拟所需的宏文件。

宏文件配置

宏文件用于定义模拟参数，包括几何结构、物理过程、粒子源、输出设置等。详细的宏文件语法和配置选项可参考https://remage.readthedocs.io。

输出文件

模拟结果可输出为多种格式，如ROOT、HDF5、LH5等，具体格式由宏文件中的配置指定。输出文件将保存在容器内的工作目录，可通过挂载本地目录将结果导出：

bash
docker run -v /path/to/local/output:/output -v /path/to/macro:/macro docker.xuanyuan.run/legendexp/remage:latest remage /macro/your_macro.mac -o /output/results

更多资源

• https://remage.readthedocs.io
• https://github.com/legend-exp/remage
• https://hub.docker.com/r/legendexp/remage