navir/opensuseleap-for-flexiblesusy

openSUSE Leap for FlexibleSUSY 镜像文档

镜像概述

本镜像基于openSUSE Leap操作系统构建，专为运行FlexibleSUSY软件设计。FlexibleSUSY是一款用于计算超对称（SUSY）模型物理性质的专业工具，广泛应用于理论物理研究领域，可精确计算超对称粒子的质量、耦合常数、衰变宽度等关键物理参数。该镜像提供预配置的稳定运行环境，简化FlexibleSUSY的部署与使用流程。

核心功能与特性

• 稳定基础系统：基于openSUSE Leap构建，提供可靠的Linux运行环境，确保软件兼容性与系统稳定性。
• 预配置运行环境：集成FlexibleSUSY及其依赖组件（如编译器、数学库等），用户无需手动配置即可直接启动计算任务。
• 优化计算支持：针对物理计算需求优化系统设置，支持多线程计算，提升大规模物理参数计算效率。
• 轻量级设计：在保证功能完整性的前提下最小化镜像体积，减少资源占用，适合多种部署场景。

使用场景与适用范围

• 理论物理研究：供物理学家、研究人员进行超对称模型理论研究，计算模型参数与物理可观测量。
• 学术机构部署：大学、研究所等学术单位快速部署FlexibleSUSY计算环境，支持科研项目高效开展。
• 教学演示：物理教学中演示超对称模型计算过程，帮助学生直观理解相关理论与计算方法。

使用方法与配置说明

基本运行命令

使用以下命令启动容器，默认进入交互式终端环境：

bash
docker run -it --name flexiblesusy-container docker.xuanyuan.run/opensuse/leap-flexiblesusy

挂载数据卷（推荐）

为持久化保存计算数据与结果，建议挂载本地目录至容器内工作目录：

bash
docker run -it --name flexiblesusy-container -v /本地数据目录:/workspace docker.xuanyuan.run/opensuse/leap-flexiblesusy

上述命令将本地/本地数据目录挂载到容器内/workspace目录，计算结果可直接保存在该目录并同步至本地。

指定工作目录

通过-w参数指定容器内工作目录，便于集中管理计算任务：

bash
docker run -it --name flexiblesusy-container -v /本地数据目录:/workspace -w /workspace docker.xuanyuan.run/opensuse/leap-flexiblesusy

运行计算任务

进入容器后，可直接执行FlexibleSUSY相关命令，例如运行示例模型计算：

bash
flexiblesusy-run --model=CMSSM input.dat output.results

（注：具体命令需根据FlexibleSUSY实际使用规范调整，上述为通用示例格式）

环境变量配置

当前镜像支持以下可选环境变量（根据实际需求设置）：

• FLEXIBLE_SUSY_THREADS：设置计算线程数，默认使用全部可用CPU核心，例如限制为4线程：

  bash
  docker run -it -e FLEXIBLE_SUSY_THREADS=4 docker.xuanyuan.run/opensuse/leap-flexiblesusy
  

注意事项

• 确保本地Docker环境已正确安装并运行（推荐Docker 20.10+版本）。
• 首次启动容器可能需要一定时间拉取镜像，请确保网络通畅。
• 大规模计算任务建议配置足够的系统资源（CPU、内存）以保证计算效率。