OpenMC Monte Carlo 粒子输运代码技术文档

1. 安装指南

1.1 系统要求

在安装OpenMC之前，请确保您的系统满足以下要求：

• 支持的操作系统：Linux、macOS、Windows（通过WSL）
• 编译器：C++11或更高版本的编译器
• Python：3.6或更高版本
• HDF5库：1.8.14或更高版本

1.2 安装步骤

1. 通过Conda安装：

   • 打开终端并运行以下命令：

     conda install -c conda-forge openmc
     

   • 这将自动安装OpenMC及其依赖项。

2. 通过源码安装：

   • 克隆OpenMC仓库：

     git clone https://github.com/openmc-dev/openmc.git
     cd openmc
     

   • 创建并激活虚拟环境：

     conda create -n openmc python=3.8
     conda activate openmc
     

   • 安装依赖项：

     conda install -c conda-forge cmake make gxx_linux-64 hdf5
     

   • 编译并安装OpenMC：

     mkdir build
     cd build
     cmake ..
     make
     make install
     

2. 项目使用说明

2.1 基本使用

OpenMC是一个基于现代方法的蒙特卡罗粒子输运代码。它使用构造实体几何（CSG）和连续能量截面（HDF5格式）。以下是基本使用步骤：

1. 创建输入文件：

   • 创建几何文件（XML格式）。
   • 创建材料文件（XML格式）。
   • 创建设置文件（XML格式）。

2. 运行OpenMC：

   • 在终端中运行以下命令：

     openmc
     

   • 这将读取输入文件并执行粒子输运模拟。

2.2 结果分析

• 模拟结果将存储在HDF5格式的输出文件中。
• 使用Python脚本或其他工具分析结果。

3. 项目API使用文档

3.1 Python API

OpenMC提供了丰富的Python API，允许用户通过编程方式创建和运行模拟。以下是一些常用的API示例：

1. 创建几何：

   from openmc import Geometry, Universe, Cell
   
   universe = Universe()
   cell = Cell(universe=universe)
   geometry = Geometry([universe])
   

2. 创建材料：

   from openmc import Material
   
   mat = Material(name='fuel')
   mat.add_element('U', 1.0)
   mat.set_density('g/cm3', 10.0)
   

3. 设置模拟参数：

   from openmc import Settings
   
   settings = Settings()
   settings.batches = 100
   settings.particles = 1000
   

3.2 C++ API

OpenMC还提供了C++ API，允许用户通过C++代码创建和运行模拟。详细文档请参考OpenMC C++ API文档。

4. 项目安装方式

4.1 通过Conda安装

• 打开终端并运行以下命令：

  conda install -c conda-forge openmc
  

4.2 通过源码安装

• 克隆OpenMC仓库：

  git clone https://github.com/openmc-dev/openmc.git
  cd openmc
  

• 创建并激活虚拟环境：

  conda create -n openmc python=3.8
  conda activate openmc
  

• 安装依赖项：

  conda install -c conda-forge cmake make gxx_linux-64 hdf5
  

• 编译并安装OpenMC：

  mkdir build
  cd build
  cmake ..
  make
  make install
  

通过以上步骤，您可以成功安装并使用OpenMC进行粒子输运模拟。