材料模拟软件：LIGGGHTS二次开发_LIGGGHTS的二次开发基础.docx

PAGE1

PAGE1

LIGGGHTS的二次开发基础

1.LIGGGHTS简介

LIGGGHTS（LImitedGranularGeoHydroThermodynamicSimulator）是一个开源的离散元模拟软件，主要用于模拟颗粒材料的力学行为。它基于LAMMPS（Large-scaleAtomic/MolecularMassivelyParallelSimulator）开发，继承了LAMMPS的高性能计算能力和并行处理能力。LIGGGHTS广泛应用于材料科学、工程力学、化工、制药等领域，可以模拟从微观到宏观尺度的颗粒系统，包括粉体、砂土、颗粒流等。

LIGGGHTS的核心功能包括：-颗粒运动的模拟-颗粒间的相互作用-外部力场的施加-多物理场耦合模拟

LIGGGHTS的二次开发是指在原有软件的基础上，通过增加自定义的模块、修改现有功能或优化性能来满足特定研究或工业应用的需求。二次开发可以使LIGGGHTS更加灵活，适应更多的应用场景。

2.LIGGGHTS的安装与配置

2.1安装LIGGGHTS

LIGGGHTS可以通过多种方式进行安装，包括从源代码编译安装和使用预编译的二进制包。以下是使用源代码编译安装LIGGGHTS的步骤：

下载源代码访问LIGGGHTS的官方网站或GitHub仓库，下载最新版本的源代码。

gitclone/CFDEMproject/LIGGGHTS-PUBLIC.git

cdLIGGGHTS-PUBLIC

安装依赖项LIGGGHTS依赖于一些外部库，如MPI、FFTW等。确保这些库已经安装在您的系统中。

sudoapt-getupdate

sudoapt-getinstallcmakegfortranmpichlibfftw3-dev

配置编译选项使用CMake配置编译选项。您可以选择是否启用并行计算、图形输出等功能。

mkdirbuild

cdbuild

cmake..-DMPICH_PATH=/usr/lib/mpich-DFFT3D=ON

编译源代码编译源代码并生成可执行文件。

make-j4

验证安装运行一个简单的测试案例来验证LIGGGHTS是否安装成功。

cd../examples/DEM/basic

../../build/liggghtsin.basic

2.2配置开发环境

为了进行LIGGGHTS的二次开发，您需要一个合适的开发环境。以下是配置开发环境的步骤：

安装文本编辑器推荐使用VisualStudioCode、SublimeText或Vim等文本编辑器。

sudoapt-getinstallvisual-studio-code

安装调试工具使用GDB等调试工具可以帮助您更好地进行代码调试。

sudoapt-getinstallgdb

设置编译器确保您的系统中安装了C++编译器，如GCC或Clang。

sudoapt-getinstallgccg++

配置CMake使用CMake来管理项目的构建过程。

sudoapt-getinstallcmake

设置环境变量将LIGGGHTS的可执行文件路径添加到环境变量中。

exportPATH=$PATH:/path/to/liggghts/build

3.LIGGGHTS的基本结构

3.1源代码结构

LIGGGHTS的源代码结构如下：

src:包含LIGGGHTS的核心源代码。

lib:包含第三方库的源代码。

examples:包含示例输入文件和脚本。

doc:包含文档和用户手册。

python:包含Python接口的相关代码。

3.2核心模块

LIGGGHTS的核心模块包括：

pair:定义颗粒间的相互作用力模型。

fix:定义模拟中的约束条件和控制参数。

compute:计算模拟过程中的物理量。

domain:定义模拟区域的几何形状和边界条件。

force:定义外部力场和力的计算方法。

neigh:定义邻域列表的构建方法。

output:定义模拟结果的输出方式。

3.3输入文件格式

LIGGGHTS使用输入文件来定义模拟任务。输入文件通常包含以下几个部分：

初始化设置:定义模拟的基本参数，如模拟区域、时间步长等。

颗粒定义:定义颗粒的类型、属性和初始位置。

力场定义:定义颗粒间的相互作用力模型。

模拟命令:定义模拟的具体步骤，如时间积分、输出结果等。

以下是一个简单的输入文件示例：

unitslj

atom_stylesphere

boundaryppp

#定义模拟区域

region