LAMMPS SPIN 包详解:fix precession/spin 磁自旋进动 fix 的参数、公式与源码实现
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 函数:
温度效应通过给每个自旋连接热浴实现,即配合 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 实现项)。
