LAMMPS SPIN 包详解:fix precession/spin 磁自旋进动 fix 的参数、公式与源码实现

原创2026-10-15 11:01:121,846 阅读
文章标签:科学计算高性能计算科研机器学习

LAMMPS SPIN 包详解:fix precession/spin 磁自旋进动 fix 的参数、公式与源码实现

本文围绕 LAMMPS SPIN 包的 fix precession/spin 命令展开,系统讲解其四种磁场样式(zeeman / anisotropy / cubic / stt)的命令语法、物理公式、能量与标量输出机制,并结合 src/SPIN/fix_precession_spin.cpp 源码与 examples/SPIN 下的真实算例,说明如何在铁磁材料(如 hcp 钴、bcc 铁、fcc 镍)的自旋-晶格耦合模拟中正确配置磁场、读取进动能量以及排查常见报错。读完本文,你可以独立完成带外磁场、单轴/立方各向异性与自旋转移力矩的磁化动力学模拟,并能从源码层面理解单位换算与力矩计算的细节。

命令语法与参数

fix precession/spin 对组内每个磁性自旋施加一个进动扭矩(precession torque)。命令的基本形式为:

fix ID group precession/spin style args
  • ID、group 为通用 fix 参数(ID 为 fix 标识符,group 为作用原子组);
  • style 取值 zeeman 或 anisotropy 或 cubic 或 stt,各样式的 args 如下:
样式 参数 含义
zeeman H x y z H = 外磁场强度(单位 Tesla);x y z = 磁场方向向量
anisotropy K x y z K = 磁各向异性强度(单位 eV);x y z = 各向异性方向向量
cubic K1 K2c n1x n1y n1z n2x n2y n2z n3x n3y n3z K1、K2c = 立方各向异性强度(单位 eV);n1 至 n3 = 三个立方各向异性方向向量
stt J x y z J = 自旋转移力矩(spin-transfer torque)场强度;x y z = 场方向向量

文档中给出的四个典型示例(原文完整保留):

fix 1 all precession/spin zeeman 0.1 0.0 0.0 1.0
fix 1 3 precession/spin anisotropy 0.001 0.0 0.0 1.0
fix 1 iron precession/spin cubic 0.001 0.0005 1.0 0.0 0.0 0.0 1.0 0.0 0.0 0.0 1.0
fix 1 all precession/spin zeeman 0.1 0.0 0.0 1.0 anisotropy 0.001 0.0 0.0 1.0

注意两点:

  • 多种样式可在同一条命令中组合(如最后一个示例同时给出 zeeman 与 anisotropy)。仓库测试用例 fix-timestep-precession_spin.yaml 中使用的 fix test all precession/spin zeeman 10.0 0.0 0.0 1.0 anisotropy 0.001 0.0 1.0 0.0 即为组合用法。
  • 所有向量必须非零。文档明确警告:写成 fix 1 all precession/spin zeeman 0.1 0.0 0.0 0.0(零向量)会报错。原因是向量分量被用于计算方向向量模长的倒数,零向量会导致除零。从源码看,这一校验逐一对每个启用的样式进行:fix_precession_spin.cpp 中对每个方向向量计算 norm2,若 norm2 == 0.0 立即抛出 Illegal precession/spin command 错误,否则归一化为单位向量。

各样式的物理模型

zeeman:外磁场中的 Zeeman 能

zeeman 样式用于模拟组内磁自旋与外磁场的相互作用,哈密顿量为:

H_zeeman = -g * sum(i=0..N) mu_i * (s_i · B_ext)

其中:

  • B_ext 为外磁场(单位 T);
  • g 为 Landé 因子,源码中硬编码为 g = 2.0;
  • s_i 为描述自旋 i 取向的单位向量;
  • mu_i 为自旋 i 的原子磁矩,以玻尔磁子 mu_B 的倍数给出(例如体心立方铁中 mu_i ≈ 2.2)。

命令中以 Tesla 输入的场强会乘以旋磁比 g * mu_B / hbar,换算为进动频率(rad·THz;在 metal 单位制下,文档取 mu_B = 5.788e-5 eV/T)。对应到 fix_precession_spin.cpp 的 init():

const double hbar = force->hplanck/MY_2PI;    // eV/(rad.THz)
const double mub = 5.78901e-5;                // in eV/T
const double gyro = 2.0*mub/hbar;             // in rad.THz/T
...
hfield = H_field*gyro;
Kah = Ka/hbar;
k1ch = k1c/hbar;
k2ch = k2c/hbar;

可见源码中 Landé 因子同样硬编码为 2.0,且采用的 mu_B 值为 5.78901e-5 eV/T(与文档给出的 5.788e-5 略有舍入差异)。注释特别说明:这些换算不能修改用户输入的原始参数,因为 init() 在每次 run 时都会重新调用,若对同一成员反复换算会造成叠加(例如从 restart 继续运行时磁场会“漂移”)。

文档给出的验证图:一个模长 mu_i = 1.0 的单自旋,受沿 z 轴、|B_ext| = 10.0 T 的外磁场作用,上图是沿磁场方向的平均磁化强度、下图是 Zeeman 能量,均随温度变化,参考曲线为同参数 Langevin 函数:

单自旋在 10 T 外场下的磁化强度与 Zeeman 能量随温度的 Langevin 函数对比

温度效应通过给每个自旋连接热浴实现,即配合 Langevin 自旋热机使用(见 fix_langevin_spin.rst),后者实现随机 Landau-Lifshitz(sLL)方程,对每个自旋施加随机扭矩与横向耗散。

anisotropy:单轴/单面各向异性

anisotropy 样式模拟易轴(easy axis)或易面(easy plane):

H_aniso = -sum(i=1..N) K_an(r_i) * (s_i · n_i)^2

其中 n 定义各向异性方向,K(eV)定义强度。K > 0 定义易轴,K < 0 定义易面。

从源码看,力矩项实现为:先计算标量 scalar = nax*spi<a href="https://link.gitcode.com/i/59cdc9eaef33e8342e2f16b1ec4ae20d" target="_blank">0] + nay*spi[1] + naz*spi[2](即 s·n),力为 fmi += scalar * (2*Kah*n)(Kax/Kay/Kaz 在 [set_magneticprecession() 中初始化为 2*Kah*n),能量为 K_a * (s·n)^2,与哈密顿量一致。注意能量符号约定:代码中 epreci -= compute_anisotropy_energy(spi),即把正的 K(s·n)^2 作为负贡献累加进总磁能。

cubic:立方各向异性

cubic 样式模拟具有三个可能易轴的立方各向异性:

H_cubic = -sum(i=1..N) K1 [ (s_i·n1)^2(s_i·n2)^2 + (s_i·n2)^2(s_i·n3)^2 + (s_i·n1)^2(s_i·n3)^2 ]
          + K2c * (s_i·n1)^2 (s_i·n2)^2 (s_i·n3)^2

其中 K1 与 K2c(eV)为强度系数,n1、n2、n3 为命令中从 n1x 到 n3z 给出的三个各向异性方向。对于标准取向 n1=(1 0 0)、n2=(0 1 0)、n3=(0 0 1):

  • K1 < 0 定义铁型各向异性(易轴沿 (0 0 1) 型立方棱边);
  • K1 > 0 定义镍型各向异性(易轴沿 (1 1 1) 型立方对角线);
  • K2c > 0 同样使易轴偏向 (1 1 1) 型立方对角线。

立方各向异性的更多细节可参见 Skomski《Simple models of magnetism》第 2 章(原文档引用)。

源码实现见 compute_cubic() 与 compute_cubic_energy():先投影出 skx = s·n1、sky = s·n2、skz = s·n3,能量直接按上式计算 k1c*(skx²sky² + sky²skz² + skx²skz²) + k2c*skx²sky²skz²;力则由四阶项(k1ch 加权的 four1/four2/four3)与六阶项(k2ch 加权的 six1/six2/six3)合成,其中 k1ch = k1c/hbar、k2ch = k2c/hbar,单位换算与 zeeman 相同。

stt:自旋转移力矩

stt 样式模拟自旋与自旋转移力矩(spin-transfer torque)的相互作用,具体实现项参见原文档引用的 Chirac 等(Physical Review B 102, 134415, 2020)的方程 (7)。

从源码看,STT 力矩就是 J·(s × n) 的叉积形式(compute_stt()):

fmi[0] += 1.0*stt_field*( sy*nsttz - sz*nstty);
fmi[1] += 1.0*stt_field*(-sx*nsttz + sz*nsttx);
fmi[2] += 1.0*stt_field*( sx*nstty - sy*nsttx);

且 compute_stt_energy() 返回 0 并注释 “Non-conservative force”,说明 STT 项是不保守力,不贡献势能,只产生力矩。

方向向量的约定

所有样式中 (x y z) 只决定力的向量方向;向量的长度被忽略,输入向量会在内部归一化(见构造函数中的归一化代码)。因此 anisotropy 0.001 0.0 0.0 1.0 与 anisotropy 0.001 0.0 0.0 5.0 等价。

此外需要说明:当前源码中除文档所列四种样式外,还实现了 hexaniso(六角各向异性,compute_hexaniso()),但 fix precession/spin 页面尚未收录该样式,读者以实际安装的 LAMMPS 版本帮助页为准。从源码结构看,init() 与 post_force() 中保留有磁场随时间变化的框架(magstr/magfieldstyle/varflag 字段,见 fix_precession_spin.h),但当前版本参数解析中 varflag 恒为 CONSTANT,即时间相关外场机制尚未对外暴露。

能量、标量输出与 fix_modify

  • 标量输出:该 fix 计算一个全局标量,可被各种输出命令访问。该标量就是前述磁进动势能的总和(能量单位),是“广延量”(extensive)。从源码看,每个自旋的磁能先按样式累加进 emag<a href="https://link.gitcode.com/i/6a550f789e7c48f75a19757bf99a5b05" target="_blank">i] 与局部和 eprec([post_force()),再由 compute_scalar() 通过 MPI_Allreduce 做一次全局求和后返回,保证多进程下只汇总一次。
  • fix_modify energy:该 fix 支持 fix_modify energy yes 选项,将自旋进动扭矩对应的能量加入系统总势能(即 thermo 输出中的 pe)。默认设置为 fix_modify energy no。
  • restart 文件:二进制 restart 文件中不写入该 fix 的任何信息,需要在 restart 后重新声明 fix 命令。

实战算例:与算例输入文件的对照

SPIN 包的算例目录 examples/SPIN 提供了多组可直接运行的输入文件,其中用到 precession/spin 的典型组合如下。

hcp 钴:单轴各向异性 + Langevin 自旋热机(in.spin.cobalt_hcp):

units       metal
atom_style  spin
...
set         group all spin/random 31 1.72
velocity    all create 100 4928459 rot yes dist gaussian

pair_style  hybrid/overlay eam/alloy spin/exchange 4.0
pair_coeff  * * eam/alloy Co_PurjaPun_2012.eam.alloy Co
pair_coeff  * * spin/exchange exchange 4.0 -0.3593 1.135028015e-05 1.0645 offset yes

fix         1 all precession/spin anisotropy 0.01 0.0 0.0 1.0
fix_modify  1 energy yes
fix         2 all langevin/spin 0.0 0.0 21
fix         3 all nve/spin lattice moving

timestep    0.0001
compute     out_mag all spin
...
run         1000

可以看到几个关键点:atom_style spin 声明带磁矩的原子;set ... spin [random] <momentum> 设定每个原子的初始自旋模长(钴取 1.72 mu_B);磁交换作用(pair spin/exchange)负责自旋间的相互作用,而 precession/spin 只负责外场/各向异性/STT 场;fix_modify 1 energy yes 使各向异性能计入热力学输出;compute spin 输出总磁化强度、磁能与磁温。

bcc 铁:立方各向异性(in.spin.iron_cubic):

fix  1 all precession/spin cubic 0.001 0.0005 1.0 0.0 0.0 0.0 1.0 0.0 0.0 0.0 1.0
fix_modify 1 energy yes
fix  2 all langevin/spin 0.0 0.0 21
fix  3 all nve/spin lattice moving
timestep 0.0001

这里 K1 = 0.001 eV、K2c = 0.0005 eV,三个方向取标准立方轴,对应铁型立方各向异性。

fcc 镍:zeeman 与 cubic 组合(in.spin.nickel_cubic):

fix 1 all precession/spin cubic -0.0001 0.0 1.0 0.0 0.0 0.0 1.0 0.0 0.0 0.0 1.0

K1 取负值配合零外场,模拟镍的自发磁化动力学。此外 gnedb/iron/in.gneb.iron 展示了 zeeman + anisotropy 组合在自旋 NEB 计算中的用法:

fix 1 all precession/spin zeeman 0.1 0.0 0.0 1.0 anisotropy 0.0001 1.0 0.0 0.0

fix 的声明顺序需要注意:若同时使用 langevin/spin 热机,则 precession/spin 等产生力的磁 fix 必须声明在 langevin/spin 之前,而 langevin/spin 必须紧跟在 nve/spin(时间积分 fix)之前(见 fix_langevin_spin.rst 的顺序要求)。

数值实现与单元测试验证

从源码结构看,precession/spin 的执行流程为:在每一步力计算完成后(post_force / 最小化的 min_post_force / RESPA 的 post_force_respa,见 setmask()),遍历本进程所有原子,对属于目标组的自旋依次调用 compute_zeeman、compute_stt、compute_anisotropy、compute_cubic,把各样式力矩累加进原子磁力向量 atom->fm(fix_precession_spin.h 中注释为 “magnetic energies”),同时把每自旋磁能存入 emag<a href="https://link.gitcode.com/i/e01e71e2d35b56701d982b6c6a848814" target="_blank">i] 并累加 eprec。其中 Zeeman 力实现为 fmi += sp[i][3] * h([compute_zeeman()),sp[i][3] 正是自旋模长,即力正比于原子磁矩 mu_i,与哈密顿量中的 mu_i 因子对应。

仓库的单元测试 fix-timestep-precession_spin.yaml 为回归验证提供了基准:54 原子 spin 体系、时间步 1e-4,组合使用 zeeman 10.0 0.0 0.0 1.0 anisotropy 0.001 0.0 1.0 0.0,期望全局标量为 0.007960739406967482(epsilon 1e-12)。若本地修改了磁能计算逻辑,可对照该值检查标量输出是否一致。

限制条件与相关命令

  • precession/spin 属于 SPIN 包,只有在构建 LAMMPS 时启用了该包,且输入文件中声明了 atom_style spin,此 fix 才可用。SPIN 包的整体功能(自旋定义、自旋-晶格耦合积分、磁对势、磁化输出等)见 src/SPIN/README。
  • 单位制通常为 metal(能量 eV、磁场 Tesla、时间 fs,进动频率 rad·THz),与源码中 hbar、mu_B 的换算一致。
  • 相关命令:atom_style spin(见 atom_style.rst)、fix langevin/spin、fix nve/spin、compute spin、pair spin/exchange 系列。
  • 原文档参考文献:Skomski, R. (2008). Simple models of magnetism. Oxford University Press(立方各向异性理论);Chirac, Theophile, et al. “Ultrafast antiferromagnetic switching in NiO induced by spin transfer torques.” Physical Review B 102.13 (2020): 134415(STT 实现项)。
登录后查看全文
lammps