注:内容为AI辅助生成并由本人进行校对,部分未校对的内容未必正确,后面会持续更新并校对。
目录
概述与基本结构
控制参数(&CONTROL)
系统参数(&SYSTEM)
计算参数(&PARAMETERS)
晶格与 k 路径(&LATTICE / &KPATH)
表面与紧束缚文件(&SURFACE / &TB_FILE)
能带与态密度计算
拓扑性质计算
表面态计算(Arpes / 自旋纹理)
量子输运计算(NEGF)
光学性质计算
手性反常与磁输运
超导计算(BdG)
典型输入文件模板
常见问题
1. 概述与基本结构
WannierTools 是一款基于紧束缚模型(通常来自 Wannier90 的 *_hr.dat)的开源软件,用于计算拓扑性质、表面态和量子输运。主输入文件为 wt.in ,采用 Fortran namelist 格式,由多个 &BLOCK 组成。
文件基本框架
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 &TB_FILE HRfile = 'wannier90_hr.dat' / &CONTROL name = 'my_system' task = 'BulkBand' / &SYSTEM SOC = 1 E_Fermi = 5.6789 / &PARAMETERS Nk1 = 100 Nk2 = 100 Nk3 = 100 / &LATTICE ang 4.000 0.000 0.000 0.000 4.000 0.000 0.000 0.000 6.000 / &KPATH K 0.333 0.333 0.000 G 0.000 0.000 0.000 M 0.500 0.000 0.000 /
命名块一览
Block
作用
必须
&TB_FILE
指定紧束缚哈密顿量文件
是
&CONTROL
设置计算任务和输出文件前缀
是
&SYSTEM
体系基本参数(SOC、费米能、占据数)
是
&PARAMETERS
数值参数(k 网格、展宽、磁场等)
多数任务是
&LATTICE
晶格矢量(与 Wannier90 输出一致)
是
&KPATH
k 点路径(能带计算用)
能带/DOS 需要
&SURFACE
表面定义(表面态计算用)
表面态任务需要
&TRANSPORT
输运器件参数
输运任务需要
2. 控制参数(&CONTROL)
name
项目
说明
含义
输出文件前缀。所有输出文件以 <name>.dat 命名
注意
不含路径和特殊字符
task
task 是 WannierTools 最核心的开关,定义了本次计算的目标。每次运行只能设置一个 task 。
能带与 DOS 类
task 取值
含义
BulkBand
计算体能带结构(k 路径)
BulkFS
计算三维费米面
BulkFS_2D
计算二维费米面(指定 kz 切片)
DOS
计算态密度
JDOS
计算联合态密度(光学跃迁)
拓扑性质类
task 取值
含义
BerryCurv
计算 Berry 曲率 Ω(k)
BerryPhase
计算 Berry 相位 / 极化
ChernNumber
计算 Chern 数(二维 BZ 积分)
AHC
计算反常霍尔电导(从 Berry 曲率积分)
Z2
计算 2D Z₂ 拓扑不变量(Wilson loop)
Z2_3D
计算 3D 强/弱 Z₂ 不变量
FindNodes
搜索能带交叉点(Weyl/Dirac 节点)
WeylChirality
计算 Weyl 点的手性电荷(±1)
WannierCenter
计算 Wannier 电荷中心(WCC)演化
表面态类
task 取值
含义
SlabBand
计算半无限表面的能带(能带弯曲图)
SlabSS
计算表面态谱函数 A(k, ω)
SlabArc
计算表面费米弧(固定能量下的 k 空间谱函数)
SpinTexture
计算表面态的自旋纹理
输运类
task 取值
含义
Transport
基于 NEGF 的弹道输运(两端/多端器件)
L_B_Psi
计算 Landauer-Büttiker 波函数分布
光学与磁输运类
task 取值
含义
Optical
计算光电导张量 σ(ω)
Chirality
手性反常磁输运(负磁阻、CME)
超导类
task 取值
含义
BdG_BulkBand
BdG 超导体能带
BdG_SlabBand
BdG 超导体表面态
BdG_SlabSS
BdG 超导体表面谱函数
批量任务控制
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 BulkBand_calc = T SlabBand_calc = T SlabSS_calc = T BerryCurv_calc = T BerryPhase_calc = T ChernNumber_calc = T Z2_calc = T WeylChirality_calc = T FindNodes_calc = T WannierCenter_calc = T DOS_calc = T JDOS_calc = T Transport_calc = T Optical_calc = T Chirality_calc = T FermiSurf_calc = T SpinTexture_calc = T
这些布尔开关用于 task = 'all' 模式,允许在一次运行中执行多个任务。如果设置了具体的 task 值(如 'BulkBand'),则这些开关将被忽略。
3. 系统参数(&SYSTEM)
1 2 3 4 5 6 &SYSTEM SOC = 1 E_Fermi = 5.6789 NumOccupied = 18 Nslab = 40 /
参数
含义
默认值
注意
SOC
自旋轨道耦合开关
0
必须与 Wannier90 的 spinors 设置一致
E_Fermi
费米能 (eV)
—
必须与第一性原理计算一致
NumOccupied
占据能带数
由程序从 HR 推断
在绝缘体/半导体中程序自动判断;金属体系可能需要手动指定
Nslab
slab 层数
40
用于 SlabBand / SlabSS 等表面态计算。越大越精确但越慢
4. 计算参数(&PARAMETERS)
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 &PARAMETERS Nk1 = 100 Nk2 = 100 Nk3 = 100 Eta_Arc = 0.001 OmegaMin = 0.0 OmegaMax = 3.0 OmegaNum = 300 E_min = -1.0 E_max = 1.0 dE = 0.001 Bx = 0.0 By = 0.0 Bz = 1.0 NPoles = 20 Gap_threshold = 0.001 /
核心参数详解
参数
含义
典型值
影响范围
Nk1, Nk2, Nk3
倒空间 Monkhorst-Pack 网格
50–200
拓扑不变量、Berry 曲率、输运:越大越精确但计算量剧增
Eta_Arc
表面态/谱函数的 Lorentz 展宽 (eV)
0.001–0.01
越小越尖锐;过大则费米弧模糊
OmegaMin/Max/Num
光学频率扫描范围与点数
—
Optical、JDOS 任务
E_min, E_max, dE
DOS/能带能量范围和步长
—
DOS、JDOS 任务
Bx, By, Bz
磁场分量 (T)
—
Chirality、磁输运任务
NPoles
表面格林函数极点数目
20–50
表面态计算:越大越精确但越慢
Gap_threshold
带隙判定阈值 (eV)
0.001
FindNodes:能量差小于此值视为简并
自适应 k 网格(Berry 曲率专用)
1 2 BerryCurv_adpt_kmesh = 1 BerryCurv_kmesh = 100
用于 AHC / Chern 数计算中在带隙闭合处自动加密 k 网格。
5. 晶格与 k 路径(&LATTICE / &KPATH)
&LATTICE
1 2 3 4 5 6 &LATTICE ang 4.000 0.000 0.000 0.000 4.000 0.000 0.000 0.000 6.000 /
项目
说明
第一行
长度单位:ang (Å) 或 Bohr (a₀)
后三行
三个晶格矢量 a₁, a₂, a₃(行向量)
注意
必须与第一性原理计算和 Wannier90 的晶格完全一致 ,否则倒空间所有物理量错位
&KPATH
1 2 3 4 5 6 &KPATH 20 G 0.000 0.000 0.000 K 0.333 0.333 0.000 K 0.333 0.333 0.000 M 0.500 0.000 0.000 M 0.500 0.000 0.000 G 0.000 0.000 0.000 /
项目
说明
第一行
每段路径的 k 点数目(高对称线采样密度)
后续行
<起点标签> <kx> <ky> <kz> <终点标签> <kx> <ky> <kz>
高对称点标签
G(Γ), K, M, X, L, W, U, Z, Y, A, H, S, T 等标准符号
坐标系统
倒空间分数坐标(以倒格矢为基)
6. 表面与紧束缚文件(&SURFACE / &TB_FILE)
&TB_FILE
1 2 3 &TB_FILE HRfile = 'wannier90_hr.dat' /
参数
含义
HRfile
紧束缚哈密顿量文件路径(相对或绝对)
格式
与 Wannier90 的 *_hr.dat 完全兼容
注意
运行 Wannier90 时必须设置 write_hr = .true.
&SURFACE
1 2 3 4 5 &SURFACE MillerIndices = 0 , 0 , 1 /
参数
含义
MillerIndices
表面的 Miller 指数 (h, k, l),定义了法向量 n = h b₁ + k b₂ + l b₃
常用表面
0 0 1 (ab 面), 1 0 0 (bc 面), 1 1 1 (对角线面)
面内方向
程序自动选取两个垂直法向量且互相垂直的面内晶格矢量
7. 能带与态密度计算
BulkBand — 体能带
1 2 3 4 5 6 7 8 9 10 &CONTROL task = 'BulkBand' / &KPATH 100 G 0 0 0 X 0.5 0 0 X 0.5 0 0 M 0.5 0.5 0 M 0.5 0.5 0 G 0 0 0 /
输出文件 :<name>.bulkband.dat — 格式:k-path index, energy bands (每列一条带)
BulkFS — 费米面
输出 :<name>.BulkFS.dat — (kx, ky, kz) 坐标的费米面截面点
BulkFS_2D — 二维费米面切片
1 2 3 task = 'BulkFS_2D' Kz_slice = 0.0
DOS — 态密度
1 2 3 4 5 6 7 8 task = 'DOS' &PARAMETERS E_min = -2.0 E_max = 2.0 dE = 0.001 Nk1 = 200 ; Nk2 = 200 ; Nk3 = 200 /
输出 :<name>.dos.dat — (Energy, DOS)
JDOS — 联合态密度
1 2 3 4 5 6 7 task = 'JDOS' &PARAMETERS OmegaMin = 0.0 OmegaMax = 5.0 OmegaNum = 500 /
JDOS: J(ω) = Σ_{cv} Σ_k δ(ε_{ck} - ε_{vk} - ħω)
输出 :<name>.jdos.dat — (ω, J(ω))
8. 拓扑性质计算
BerryCurv — Berry 曲率
1 2 3 4 5 task = 'BerryCurv' &PARAMETERS Nk1 = 100 ; Nk2 = 100 /
输出 :<name>.BerryCurv.dat — (kx, ky, Ω(k)),可导入作图。
ChernNumber — Chern 数
1 2 3 4 5 task = 'ChernNumber' &PARAMETERS Nk1 = 200 ; Nk2 = 200 /
对二维 BZ 积分:C = (1/2π) Σ_n ∫ d²k Ω_n(k)
输出 :<name>.ChernNumber.dat — 每条占据能带的 Chern 数及总 Chern 数。
AHC — 反常霍尔电导
1 2 3 4 5 task = 'AHC' &PARAMETERS Nk1 = 200 ; Nk2 = 200 ; Nk3 = 200 /
积分公式:σ_{xy} = -(e²/ħ) Σ_n ∫ dk Ω_{n,z}(k) f(ε_{nk})
输出 :<name>.AHC.dat — 各方向的 AHC 张量分量。
Z2 — 二维 Z₂ 不变量
1 2 3 4 5 task = 'Z2' &PARAMETERS Nk1 = 200 ; Nk2 = 200 /
方法 :Wilson loop / Wannier 电荷中心(WCC)演化。通过追踪占据态 Wannier 函数的极化演化判断 Z₂ 拓扑。
输出 :<name>.Z2.dat — WCC 演化数据;Z₂ = 0 (平凡) 或 1 (非平凡)。
Z2_3D — 三维 Z₂ 不变量
1 2 3 4 5 task = 'Z2_3D' &PARAMETERS Nk1 = 100 ; Nk2 = 100 ; Nk3 = 100 /
计算强拓扑指数 ν₀ 和弱拓扑指数 (ν₁, ν₂, ν₃)。六个时间反演不变平面上的 Z₂ 指数。
FindNodes — 能带交叉点搜索
1 2 3 4 5 task = 'FindNodes' &PARAMETERS Gap_threshold = 0.001 /
输出 :<name>.nodes.dat — 所有找到的能带交叉点坐标 (kx, ky, kz) 及能量。
WeylChirality — Weyl 点手性
1 2 3 4 5 task = 'WeylChirality' &PARAMETERS Nk1 = 100 ; Nk2 = 100 ; Nk3 = 100 /
方法 :在以每个候选节点为中心的小球面上积分 Berry 通量,得到 ±1 的手性电荷。
输出 :<name>.WeylChirality.dat — (k_x, k_y, k_z, chirality, energy)。
WannierCenter — Wannier 电荷中心
1 2 3 4 5 task = 'WannierCenter' &PARAMETERS Nk1 = 100 /
计算 1D Wilson loop 的本征值(Wannier 函数中心沿 k 方向的演化)。
输出 :<name>.WannierCenter.dat — (k, θ/2π)。
9. 表面态计算(Arpes / 自旋纹理)
表面态计算基于迭代格林函数方法 ,构造半无限体系的表面格林函数,得到动量-能量分辨的谱函数 A(k, ω)。
SlabBand — 表面能带(能带弯曲)
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 task = 'SlabBand' &SURFACE MillerIndices = 0 , 0 , 1 / &SYSTEM Nslab = 60 / &KPATH 100 G 0 0 0 M 0.5 0 0 M 0.5 0 0 K 0.333 0.333 0 /
输出 :<name>.SlabBand.dat — k 路径上的表面投影能带。颜色深浅表示态在表面层的权重。
SlabSS — 表面态谱函数
1 2 3 4 5 6 7 8 9 task = 'SlabSS' &PARAMETERS E_min = -1.0 E_max = 1.0 dE = 0.005 Eta_Arc = 0.001 Nk1 = 200 ; Nk2 = 200 /
输出 :<name>.SlabSS.dat — 完整的 A(k, ω) 数据(可直接画 ARPES 谱图)。
SlabArc — 费米弧
1 2 3 4 5 6 task = 'SlabArc' &PARAMETERS Nk1 = 200 ; Nk2 = 200 Eta_Arc = 0.001 /
输出 :<name>.SlabArc.dat — 固定能量(默认为 E_Fermi)下 k 空间的谱函数强度图。
SpinTexture — 自旋纹理
1 2 3 4 5 6 task = 'SpinTexture' &PARAMETERS Nk1 = 200 ; Nk2 = 200 Eta_Arc = 0.001 /
输出 :<name>.SpinTexture.dat — (kx, ky, Sx, Sy, Sz) 或等能面上自旋方向分布。对 Rashba/Dresselhaus 效应和拓扑表面态的自旋-动量锁定分析至关重要。
10. 量子输运计算(NEGF)
WannierTools 采用非平衡格林函数(NEGF)方法计算弹道输运。器件由中心散射区 + 左右半无限引线(lead)构成。
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 task = 'Transport' &TRANSPORT PrincipalLayers = 40 TransportDirection = 3 Lead_Left = 1 , 5 Lead_Right = 36 , 40 E_min = -1.0 E_max = 1.0 dE = 0.001 /
&TRANSPORT 参数详解
参数
含义
PrincipalLayers
中心散射区域的 principal layer 数。每个 PL 通常包含一个原胞
TransportDirection
输运方向(沿哪个晶格矢量):1=x, 2=y, 3=z
Lead_Left
左引线的晶胞索引范围
Lead_Right
右引线的晶胞索引范围
E_min, E_max, dE
输运能量扫描范围
I-V 特性
1 2 3 4 Vb_min = -0.5 Vb_max = 0.5 Vb_step = 0.01
关键输出
文件
内容
<name>.conductance.dat
能量依赖的电导 G(E) = (e²/h) T(E)
<name>.IV.dat
电流-电压特性 I(V)
<name>.transmission.dat
透射系数 T(E)
<name>.dos.dat
器件态密度
11. 光学性质计算
1 2 3 4 5 6 7 8 task = 'Optical' &PARAMETERS OmegaMin = 0.0 OmegaMax = 5.0 OmegaNum = 500 Nk1 = 100 ; Nk2 = 100 ; Nk3 = 100 /
计算光电导张量 σ_{αβ}(ω) 的实部和虚部。
输出 :<name>.optical.dat — (ω, Re σ_xx, Im σ_xx, Re σ_xy, Im σ_xy, …)
注意 :Optical 任务基于紧束缚模型的 Kubo 公式。对于精确的光电导率,通常更推荐直接在 Wannier90 中使用 kubo = .true.,因为它利用了 Wannier 插值的位置矩阵元,精度更高。
12. 手性反常与磁输运
1 2 3 4 5 6 task = 'Chirality' &PARAMETERS Bx = 0.0 ; By = 0.0 ; Bz = 5.0 Nk1 = 200 ; Nk2 = 200 ; Nk3 = 200 /
磁场的作用 :程序在紧束缚哈密顿量中加入 Peierls 相因子(通过修改 hopping 的相位模拟轨道效应)。
可计算的效应 :
负磁阻(Negative MR):E ∥ B 时电导随磁场增大
手性磁效应(CME):磁场诱导的平衡电流
Landau 能级谱
输出 :磁场依赖的电导张量。
13. 超导计算(BdG)
WannierTools 支持 Bogoliubov-de Gennes (BdG) 框架,在紧束缚模型上加入超导配对势。
BdG 基本参数
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 &CONTROL task = 'BdG_BulkBand' / &SYSTEM SOC = 1 / &PARAMETERS Delta = 0.001 /
BdG 任务类型
task
含义
BdG_BulkBand
BdG 体能带(电子+空穴分支)
BdG_SlabBand
BdG 表面能带
BdG_SlabSS
BdG 表面态谱函数
应用场景 :
Majorana 零能模搜索(拓扑超导体的边缘/表面态)
超导涡旋束缚态
Andreev 反射谱
14. 典型输入文件模板
模板 1:体能带 + DOS
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 &TB_FILE HRfile = 'wannier90_hr.dat' / &CONTROL name = 'Bi2Se3_bulk' task = 'BulkBand' / &SYSTEM SOC = 1 E_Fermi = 6.2047 / &PARAMETERS Nk1 = 100 ; Nk2 = 100 ; Nk3 = 100 E_min = -2.0 ; E_max = 2.0 ; dE = 0.001 / &LATTICE ang 4.140 0.000 0.000 0.000 4.140 0.000 0.000 0.000 28.640 / &KPATH G 0.000 0.000 0.000 K 0.333 0.333 0.000 K 0.333 0.333 0.000 M 0.500 0.000 0.000 M 0.500 0.000 0.000 G 0.000 0.000 0.000 /
模板 2:Chern 数 + AHC(2D 体系)
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 &TB_FILE HRfile = 'wannier90_hr.dat' / &CONTROL name = 'Chern_insulator' task = 'ChernNumber' / &SYSTEM SOC = 1 E_Fermi = 5.6789 / &PARAMETERS Nk1 = 200 ; Nk2 = 200 / &LATTICE ang 5.000 0.000 0.000 0.000 5.000 0.000 0.000 0.000 20.000 /
模板 3:Weyl 半金属全套
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 &TB_FILE HRfile = 'wannier90_hr.dat' / &CONTROL name = 'Weyl_SM' task = 'FindNodes' / &SYSTEM SOC = 1 E_Fermi = 5.6789 / &PARAMETERS Gap_threshold = 0.001 Nk1 = 100 ; Nk2 = 100 ; Nk3 = 100 / &LATTICE ang 5.000 0.000 0.000 0.000 5.000 0.000 0.000 0.000 5.000 /
找到节点后,将 task 改为 WeylChirality 计算手性,再改为 SlabArc 画费米弧。
模板 4:表面费米弧
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 &TB_FILE HRfile = 'wannier90_hr.dat' / &CONTROL name = 'Weyl_arc' task = 'SlabArc' / &SYSTEM SOC = 1 ; E_Fermi = 5.6789 Nslab = 50 / &PARAMETERS Nk1 = 200 ; Nk2 = 200 Eta_Arc = 0.001 / &SURFACE MillerIndices = 0 , 0 , 1 / &LATTICE ang 5.000 0.000 0.000 0.000 5.000 0.000 0.000 0.000 5.000 /
模板 5:量子输运(两端器件)
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 &TB_FILE HRfile = 'wannier90_hr.dat' / &CONTROL name = 'device' task = 'Transport' / &SYSTEM SOC = 1 ; E_Fermi = 5.6789 / &PARAMETERS E_min = -1.0 ; E_max = 1.0 ; dE = 0.001 / &TRANSPORT PrincipalLayers = 20 TransportDirection = 3 Lead_Left = 1 , 5 Lead_Right = 16 , 20 Vb_min = -0.5 ; Vb_max = 0.5 ; Vb_step = 0.01 / &LATTICE ang 5.000 0.000 0.000 0.000 5.000 0.000 0.000 0.000 20.000 /
模板 6:手性反常磁输运
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 &TB_FILE HRfile = 'wannier90_hr.dat' / &CONTROL name = 'chiral_anomaly' task = 'Chirality' / &SYSTEM SOC = 1 ; E_Fermi = 5.6789 / &PARAMETERS Bx = 0.0 ; By = 0.0 ; Bz = 5.0 Nk1 = 200 ; Nk2 = 200 ; Nk3 = 200 / &LATTICE ang 5.000 0.000 0.000 0.000 5.000 0.000 0.000 0.000 5.000 /
参考文献
Q. Wu, S. Zhang, H. Song, M. Troyer, A. A. Soluyanov, Comput. Phys. Commun. 224 , 405 (2018). — WannierTools 主要文献
M. P. L. Sancho, J. M. L. Sancho, J. Rubio, J. Phys. F: Met. Phys. 15 , 851 (1985). — 迭代格林函数表面态方法
S. Datta, Electronic Transport in Mesoscopic Systems , Cambridge (1995). — NEGF 输运理论
A. A. Soluyanov, D. Vanderbilt, Phys. Rev. B 83 , 235401 (2011). — Wannier 电荷中心与 Z₂ 拓扑不变量