LAMMPS 中 compute smd/ulsph/strain/rate 命令详解:ULSPH 粒子应变率张量的计算与输出

原创2026-10-14 20:34:101,852 阅读
文章标签:科学计算高性能计算科研

LAMMPS 中 compute smd/ulsph/strain/rate 命令详解:ULSPH 粒子应变率张量的计算与输出

导读

本文围绕 LAMMPS 官方文档 doc/src/compute_smd_ulsph_strain_rate.rst 所定义的 compute smd/ulsph/strain/rate 命令展开,完整讲解其语法、输出语义、底层实现与使用前置条件。该命令服务于 LAMMPS 的 MACHDYN(Smooth Mach Dynamics)包,用于输出通过更新拉格朗日 SPH(Updated Lagrangian SPH,ULSPH)pair style 相互作用的粒子的对数应变张量变化率,是流体、可压缩介质及高速动力学仿真中量化局部变形速率的核心工具。读完本文,你将掌握该 compute 的调用方式、6 分量对称应变率张量的含义与单位约定、速度梯度张量的 SPH 离散原理,以及如何在实际输入脚本中配合 pair_style smd/ulsph、fix smd/integrate_ulsph 与 dump 输出完成一套可运行的配置。

命令语法与基本用法

compute smd/ulsph/strain/rate 的语法形式如下:

compute ID group-ID smd/ulsph/strain/rate
  • ID:为该 compute 指定的唯一标识符,供后续命令(如 dump、compute reduce、variable)引用;
  • group-ID:参与计算的原子组,只有该组内粒子会输出应变率数据;
  • smd/ulsph/strain/rate:该 compute 命令的固定样式名。

其中 ID、group-ID 的通用语义与 compute 命令 一致。官方文档给出的最小示例为:

compute 1 all smd/ulsph/strain/rate

从源码 <a href="https://link.gitcode.com/i/382ed0974bc653d2cd233e1d487791a3" target="_blank">compute_smd_ulsph_strain_rate.cpp</a> 可以看到,该命令严格不接受任何额外参数,构造函数中若参数个数不等于 3(即 compute ID group-ID smd/ulsph/strain/rate 三部分之外还有多余参数),会直接报错 Illegal compute smd/ulsph/strain/rate command:

ComputeSMDULSPHStrainRate::ComputeSMDULSPHStrainRate(LAMMPS *lmp, int narg, char **arg) :
    Compute(lmp, narg, arg)
{
  if (narg != 3) error->all(FLERR, 2, "Illegal compute smd/ulsph/strain/rate command");
  peratom_flag = 1;
  size_peratom_cols = 6;
  ...
}

输出信息:6 分量对称应变率张量

该 compute 计算的是逐粒子的张量数组(per-particle vector of vectors,即每个粒子对应一个 3×3 对称张量),可以供任何以 per-particle 值为输入的命令消费(dump、compute reduce、variable 等)。关于 LAMMPS 输出机制的总体介绍可参考 Howto output。

  • 单位:数值单位为时间的倒数(one over time),即 1/s 量级(具体取决于 units 设置,如 SI 单位下为 s⁻¹,GPa/mm/ms 单位制下为 ms⁻¹);
  • 条目数:每个粒子输出 6 个标量,依次对应对称应变率张量的 xx、yy、zz、xy、xz、yz 六个分量。

从源码 compute_peratom() 可以清晰看到这 6 个分量的生成方式。该函数先从 ULSPH pair style 中通过 extract() 机制取得速度梯度张量数组 L,随后取速度梯度的对称部分得到应变率张量 D:

D = 0.5 * (L[i] + L[i].transpose());
strain_rate_array[i][0] = D(0, 0);    // xx
strain_rate_array[i][1] = D(1, 1);    // yy
strain_rate_array[i][2] = D(2, 2);    // zz
strain_rate_array[i][3] = D(0, 1);    // xy
strain_rate_array[i][4] = D(0, 2);    // xz
strain_rate_array[i][5] = D(1, 2);    // yz

也就是说,该 compute 输出的正是速度梯度张量 L = ∇v 的对称化结果 D = (L + Lᵀ)/2,即率形式的应变张量(strain rate tensor)。它被文档定义为"对数应变张量的变化率",这是针对有限变形情形下连续介质应变度量在增量意义上的表述。组内未命中的粒子(mask 不含 groupbit)对应的 6 个分量全部置零。此外,每次计算前会根据 atom->nmax 动态扩容内部数组,memory_usage() 报告的内存占用为 6 * nmax * sizeof(double)(见 compute_smd_ulsph_strain_rate.cpp)。

底层原理:速度梯度张量 L 的 SPH 离散与梯度修正

compute smd/ulsph/strain/rate 本身并不直接计算速度梯度,而是通过 LAMMPS 的 extract() 接口从 pair_style smd/ulsph 中取回每个粒子的速度梯度张量 L。这一设计在 MACHDYN 包中是一致模式:fix smd/integrate_ulsph 同样通过 force->pair->extract("smd/ulsph/velocityGradient_ptr", itmp) 获取 L(见 fix_smd_integrate_ulsph.cpp),并据此更新粒子体积分数:

D = 0.5 * (L[i] + L[i].transpose());
vol_increment = vfrac[i] * update->dt * D.trace(); // Jacobian of deformation
vfrac[i] += vol_increment;

因此,本文 compute 与积分器共享同一份速度梯度数据,保证应变率输出与体积演化在数值上完全一致。

L 的 SPH 离散公式

速度梯度的计算位于 pair_smd_ulsph.cpp 的 PreCompute()。对粒子对 (i, j),设当前位置差 dx = xj - xi,速度差 dv = vj - vi,核函数梯度 g = (wfd / r) * dx,则速度梯度的 SPH 近似为:

Ltmp = -dv * g.transpose();
L[i] += jvol * Ltmp;   // jvol 为邻居粒子 j 的体积分数 vfrac[j]

即标准的 SPH 梯度离散:

L_i ≈ Σ_j V_j (v_j - v_i) ⊗ ∇W(x_i - x_j)

核梯度修正(Gradient Correction)

当开启 *GRADIENT_CORRECTION 时,pair style 还会构建形状矩阵(shape matrix)K:

Ktmp = -g * dx.transpose();
K[i] += jvol * Ktmp;

随后对 K 做 SVD 伪逆(pseudo_inverse_SVD)并限制特征值(LimitEigenvalues(K[i], 2.0)),用其修正速度梯度与变形梯度:

L[i] *= K[i];
F[i] *= K[i];

这一修正本质上是一阶一致性的核梯度修正,用于消除粒子分布不均匀带来的离散误差,对精度影响显著。此外,PreCompute() 还会同步累积应变增量到原子数组 atom_data_9 中,供 compute smd/ulsph/strain 一类的总量型输出使用。

extract() 接口

pair style 通过 extract() 向外部暴露内部数组(见 pair_smd_ulsph.cpp 的 extract()):

} else if (strcmp(str, "smd/ulsph/velocityGradient_ptr") == 0) {
    return (void *) L;
}

若 compute 无法取得该指针(例如未构建匹配的 pair style),会触发错误:

compute smd/ulsph/strain/rate could not access any velocity gradients. Are the matching pair styles present?

(见 compute_smd_ulsph_strain_rate.cpp)。

前置条件:MACHDYN 包与 *VELOCITY_GRADIENT 开关

该 compute 属于 MACHDYN 包,只有当 LAMMPS 以该包构建时才可用(构建方式参见 Build package)。同时,它只能用于与 pair_style smd/ulsph 相互作用的粒子。

这里有一个容易被忽视的关键点:速度梯度的计算在 ULSPH pair style 中默认是关闭的。pair_style smd/ulsph 的第二个关键字控制是否计算速度梯度(见 pair_smd_ulsph.cpp 的 settings()):

pair_style smd/ulsph *DENSITY_CONTINUITY *VELOCITY_GRADIENT *NO_GRADIENT_CORRECTION
pair_style smd/ulsph *DENSITY_SUMMATION *NO_VELOCITY_GRADIENT *GRADIENT_CORRECTION

三个位置参数分别为:密度更新方式(*DENSITY_CONTINUITY 或 *DENSITY_SUMMATION)、是否计算速度梯度(*VELOCITY_GRADIENT 或 *NO_VELOCITY_GRADIENT)、是否做核梯度修正(*GRADIENT_CORRECTION 或 *NO_GRADIENT_CORRECTION)。若使用 *NO_VELOCITY_GRADIENT,L 数组不会被计算,本 compute 将无法工作。

进一步的约束来自材料模型:在 pair_coeff 中请求强度模型或牛顿黏性模型时,源码会强制检查速度梯度开关。例如 *STRENGTH_LINEAR_PLASTIC(见 pair_smd_ulsph.cpp)与 *STRENGTH_LINEAR、*VISCOSITY_NEWTON 均会执行:

if (!velocity_gradient) {
  error->all(FLERR, "A strength model was requested but *VELOCITY_GRADIENT is not set");
}

换言之,凡是需要变形率信息的材料模型,都会强制要求 *VELOCITY_GRADIENT,这也保证了 strain/rate 类输出在强度/黏性介质仿真中的可用性。

完整可运行的实战配置

官方 MACHDYN 示例 examples/PACKAGES/machdyn/fluid_structure_interaction/in.fluid_structure_interaction 演示了 ULSPH 水柱坍塌问题的完整配置,其中 ULSPH 部分的交互物理定义如下:

# 更新拉格朗日 SPH 用于水体
pair_style      hybrid/overlay smd/ulsph *DENSITY_CONTINUITY *VELOCITY_GRADIENT *NO_GRADIENT_CORRECTION &
                               smd/tlsph smd/hertz ${contact_scale}
pair_coeff      1 1 smd/ulsph *COMMON ${rho_water} ${c0} ${q1} ${Cp} 0 &
                *EOS_TAIT 7.0 &
                *END

其中 *COMMON 之后的 5 个参数依次为参考密度、参考声速、线性黏性系数、热容与沙漏控制幅值(参考密度×参考声速² 会被推导为体积模量,见 pair_smd_ulsph.cpp 的 coeff()),*EOS_TAIT 7.0 指定 Tait 状态方程及指数。另一个示例 examples/PACKAGES/machdyn/funnel_flow/in.funnel_flow 同样采用 *VELOCITY_GRADIENT 配置。

与 compute smd/ulsph/strain/rate 配合的完整输出段落可组织为:

units           si
atom_style      smd
pair_style      smd/ulsph *DENSITY_CONTINUITY *VELOCITY_GRADIENT *NO_GRADIENT_CORRECTION
pair_coeff      1 1 smd/ulsph *COMMON 1000 10 1 1 0 *EOS_TAIT 7.0 *END

compute         D all smd/ulsph/strain/rate
compute         Dxx all reduce sum c_D[1]   # 汇总 xx 分量(示例性用法)
fix             integration water smd/integrate_ulsph adjust_radius 1.01 10 15

dump            d1 all custom 100 dump.strain id type x y vx vy &
                c_D[1] c_D[2] c_D[3] c_D[4] c_D[5] c_D[6]

通过 c_D[1] … c_D[6] 即可在 dump 中逐时间步输出每个粒子的应变率张量 6 分量(xx、yy、zz、xy、xz、yz)。示例中同时展示了 compute smd/ulsph/num/neighs、compute smd/ulsph/stress 等 MACHDYN 系列 compute 的组合使用方式。

与 TLSPH 应变率输出的对比

MACHDYN 包还提供了对应的总拉格朗日 SPH 版本 compute smd/tlsph/strain/rate(见 compute_smd_tlsph_strain_rate.rst),两者语法、输出结构(6 个分量)与单位约定完全一致,区别在于数据来源与适用对象:

对比项 compute smd/ulsph/strain/rate compute smd/tlsph/strain/rate
适用 pair style pair_style smd/ulsph(更新拉格朗日) pair_style smd/tlsph(总拉格朗日)
数据来源 pair 内部速度梯度 L(smd/ulsph/velocityGradient_ptr) pair 内部应变率 D(smd/tlsph/strain_rate_ptr)
输出分量 xx, yy, zz, xy, xz, yz xx, yy, zz, xy, xz, yz
底层计算 D = (L + Lᵀ)/2(compute_smd_ulsph_strain_rate.cpp) 直接取 pair 提供的应变率(compute_smd_tlsph_strain_rate.cpp)

在固体力学场景(如 examples/PACKAGES/machdyn/aluminum_strip_pull/in.aluminum_strip_pull 中的铝条拉伸)中常使用 TLSPH 版本;而在流体/可压缩介质场景(水柱坍塌、漏斗流动)中则使用本文的 ULSPH 版本。fluid_structure_interaction 示例正是将两者通过 hybrid/overlay 混合使用的典型。关于整个 Smooth Mach Dynamics 框架的完整方法论,官方提供了配套 PDF 指南 doc/src/PDF/MACHDYN_LAMMPS_userguide.pdf。

限制与相关命令

  • 包依赖:必须启用 MACHDYN 包构建 LAMMPS(见 Build package);
  • 适用范围:仅对与 pair_style smd/ulsph 相互作用的粒子有效,且该 pair style 必须开启 *VELOCITY_GRADIENT;
  • 重复声明:源码会在 master 进程上对同名 compute 的多次声明给出警告(More than one compute smd/ulsph/strain/rate,见 compute_smd_ulsph_strain_rate.cpp),因此一个输入脚本内通常只声明一次;
  • 默认值:无(该命令没有可选的默认参数)。

相关命令:compute smd/tlsph/strain/rate、compute smd/ulsph/stress(应力张量)、compute smd/ulsph/strain(应变累积量)、compute smd/ulsph/num/neighs(邻居数)、fix smd/integrate_ulsph(ULSPH 积分器,与应变率共享速度梯度数据)。

总结

compute smd/ulsph/strain/rate 是 LAMMPS MACHDYN 包中获取 ULSPH 粒子局部变形速率的官方入口。它的数据本质是速度梯度张量 L 的对称部分 D = (L + Lᵀ)/2,通过 extract() 接口从 pair_style smd/ulsph 取数,输出 6 分量的逐粒子数组(单位 1/时间),可无缝接入 dump、compute reduce 与 variable 等输出链路。使用时务必满足三个前提:启用 MACHDYN 包、使用 pair_style smd/ulsph、并在 pair_style 设置中开启 *VELOCITY_GRADIENT。理解其底层的 SPH 梯度离散与核梯度修正机制,有助于在流固耦合、高速冲击等仿真中正确解释并利用应变率数据。

登录后查看全文
lammps