WannierTools专题

WannierTools功能导航:计算开关与实例入口

对照当前2.7.0的77个CONTROL名称寻找实例,区分原生入口、等效名称、独立兼容方法和版本中未接入的开关,说明磁场与谱输出的实际用法。

更新于 2026-11-16约 10 分钟阅读按任务与环境选择适用配置
阅读本篇目录

本页帮助你从“想计算什么、输入哪个开关”找到对应实例,固定针对集群当前WannierTools2.7.0。下表链接的教程均有实际运行记录与相应输入、读取命令;它们使用的模型、网格、能量范围和版本限制按各篇说明保留。

当前77个CONTROL名称分为:59个有原生实例的开关、3个等效名称、1个需要独立兼容方法的入口,以及14个没有独立调度入口的名称。 名称数不等于独立物理算法数,也不能只凭一个开关的名称推断它输出什么物理量。

下载可查询的功能导航和CSV,解压后进入wanniertools-feature-map:

bash read.sh
bash read.sh Berry
bash read.sh 磁场

查询只读取导航,不提交作业、不运行计算。集群用户和AI agent可按CSV里的local_guide读取公共实例库;也可先看:

cat /public/yskj-hpc/examples/START-HERE.md

1 从原生实例开始#

按下表选择教程,先读取其已有数据,再根据自己的HR模型和轨道定义修改输入。不要把模型示例中的费米能、轨道索引、磁场比例和截断参数直接当作所有材料的默认值。

开关名称 使用方式 对应教程
AHC_Calc 原生实例 WannierTools 异常霍尔电导
ANE_calc 原生实例 WannierTools 反常能斯特响应
BerryCurvature_calc 原生实例 WannierTools Berry 曲率平面图
BerryCurvature_Cube_calc 原生实例 WannierTools:三维Berry曲率扫描
BerryCurvature_EF_calc 原生实例 WannierTools费米能与Berry曲率
Berrycurvature_kpath_EF_calc 原生实例 WannierTools 路径 Berry 曲率与费米占据
BerryCurvature_kpath_Occupied_calc 原生实例 WannierTools 路径 Berry 曲率与费米占据
BerryCurvature_slab_calc 原生实例 WannierTools薄膜Berry曲率实操
BerryPhase_calc 原生实例 WannierTools:Berry相位的0与π实操
Boltz_evolve_k 原生实例 WannierTools:磁场中的k空间轨迹
Boltz_k_calc 原生实例 WannierTools按kz切片分析输运
Boltz_OHE_calc 原生实例 WannierTools:普通霍尔与磁阻计算
BulkBand_calc 原生实例 WannierTools声子LO–TO分裂实操
BulkBand_cube_calc 原生实例 WannierTools:二维平面与三维网格能量
BulkBand_plane_calc 原生实例 WannierTools:二维平面与三维网格能量
BulkBand_points_calc 原生实例 WannierTools体能带与费米面
BulkBand_unfold_line_calc 原生实例 WannierTools超胞能带展开实操
BulkBand_unfold_plane_calc 原生实例 WannierTools超胞能带展开实操
BulkFatBand_calc 原生实例 WannierTools稀疏投影能带实操
BulkFS_calc 原生实例 WannierTools体能带与费米面
BulkFS_Plane_calc 原生实例 WannierTools 体相自旋纹理与谱函数
BulkFS_plane_stack_calc 原生实例 WannierTools:堆叠谱扫描与求和尺度
BulkGap_cube_calc 原生实例 WannierTools 直接带隙与间接带隙
BulkGap_plane_calc 原生实例 WannierTools 直接带隙与间接带隙
BulkSpintexture_calc 原生实例 WannierTools 体相自旋纹理与谱函数
Chern_3D_calc 原生实例 WannierTools 六晶面 Chern 数与相位展开
Dos_calc 原生实例 WannierTools 态密度与联合态密度
EffectiveMass_calc 原生实例 WannierTools 有效质量张量
export_newhr 原生实例 WannierTools:自旋基组重排与HR导出
FermiLevel_calc 原生实例 WannierTools 按电子数求费米能级
FindNodes_calc 原生实例 WannierTools 外尔点搜索与手性
JDos_calc 原生实例 WannierTools 态密度与联合态密度
landau_chern_calc 原生实例 WannierTools磁场开边界与左右边缘态
LandauLevel_B_calc 原生实例,注意输出解释;;使用磁通比例,不直接把原生Tesla列当SI磁场 WannierTools:磁通扫描与Hofstadter能谱
LandauLevel_B_dos_calc 原生实例,注意输出解释;按教程分别核对谱归一化和磁场标记 WannierTools:磁场谱函数与Lanczos输出
LandauLevel_k_calc 原生实例,注意输出解释 WannierTools:固定磁通能带、权重与平面图
LandauLevel_k_dos_calc 原生实例,注意输出解释;原生负谱值不作LDOS;优先参照因果连分式兼容流程 WannierTools:磁场谱函数与Lanczos输出
LandauLevel_kplane_calc 原生实例,注意输出解释;使用按输入平面重建的坐标,不盲用原始坐标列 WannierTools:固定磁通能带、权重与平面图
Landaulevel_unfold_line_calc 原生实例 WannierTools磁场能带展开与选定能量谱
LandauLevel_wavefunction_calc 原生实例,注意输出解释;本例核对固定k轨道权重;不沿用未经说明的B扫描权重列 WannierTools:固定磁通能带、权重与平面图
LOTO_correction 原生实例 WannierTools声子LO–TO分裂实操
MirrorChern_calc 原生实例 WannierTools镜面Chern数实操
QPI_unfold_plane_calc 原生实例 WannierTools超胞能带展开实操
SHC_calc 原生实例 WannierTools:自旋霍尔电导操作
SlabArc_calc 原生实例 WannierTools Weyl节点与费米弧
SlabBand_calc 原生实例 WannierTools有限薄膜能带
SlabBand_plane_calc 原生实例 WannierTools:薄膜二维能带与表面着色
SlabBandWaveFunc_calc 原生实例 WannierTools:薄膜波函数的分层权重
SlabQPI_kpath_calc 原生实例 WannierTools沿路径的表面QPI
SlabQPI_kplane_calc 原生实例 WannierTools:表面QPI与谱函数自相关
SlabSpintexture_calc 原生实例 WannierTools:表面自旋纹理与零耦合对照
SlabSS_calc 原生实例 WannierTools半无限表面谱
Symmetry_Import_calc 原生实例 WannierTools对称性与k点归类
Translate_to_WS_calc 原生实例 WannierTools:堆叠谱扫描与求和尺度
valley_projection_calc 原生实例 WannierTools谷投影与简并态
WannierCenter_calc 原生实例 WannierTools Wilson loop与Z₂
WeylChirality_calc 原生实例 WannierTools 外尔点搜索与手性
WireBand_calc 原生实例 WannierTools 纳米线能带与截面设置
Z2_3D_calc 原生实例 WannierTools Wilson loop与Z₂

2 同一计算路径的不同名称#

下列三个名称与已有实例进入同一计算路径,使用对应教程即可;没有把名称替换计算为一套新的物理算法。

开关名称 使用方式 对应教程
BulkBand_line_calc 与已有入口等效;与BulkBand_calc进入同一计算路径 WannierTools声子LO–TO分裂实操
Hof_Butt_calc 与已有入口等效;与LandauLevel_B_calc进入同一计算路径;使用磁通比例,不直接把原生Tesla列当SI磁场 WannierTools:磁通扫描与Hofstadter能谱
SlabQPI_calc 与已有入口等效;与SlabQPI_kplane_calc进入同一计算路径 WannierTools:表面QPI与谱函数自相关

Landaulevel_unfold_line_calc虽然也会打开展开相关入口,但还选择磁超胞和轨道组扩展,不属于上述简单等效替换。请使用其磁超胞展开完整例子,保留磁场输入。

3 磁场HR导出使用独立兼容方法#

开关名称 使用方式 对应教程
export_maghr 使用独立兼容方法;原版导出入口保留限制;按独立兼容导出与原生回读教程操作 WannierTools磁场HR导出的独立兼容入口

当前原版磁场HR导出的限制仍保留。兼容教程在用户自己的目录中准备独立导出工具,随后用公共wt.x实际回读能带,核对导出矩阵的傅里叶约定。它不会替换公共程序,也不等于把原版export_maghr直接打开就能得到相同结果。

4 以下名称在当前版本没有独立调度入口#

这些名称被列入输入定义,不代表当前版本为它们各自接入了计算流程。只设为T不能据此期待产生一套新的结果。先从第1节按物理目标选择实际入口;查到其他版本教程时,核对版本和源码实现。

开关名称 使用方式 对应教程
BerryCurvature_plane_selectedbands_calc 当前版本未接入该开关;设为T不代表该名称会独立启动计算;按实际功能专题选择入口 WannierTools模型准备与操作路线
Boltz_Berry_correction 当前版本未接入该开关;设为T不代表该名称会独立启动计算;按实际功能专题选择入口 WannierTools模型准备与操作路线
ChargeDensity_selected_bands_calc 当前版本未接入该开关;设为T不代表该名称会独立启动计算;按实际功能专题选择入口 WannierTools模型准备与操作路线
ChargeDensity_selected_energies_calc 当前版本未接入该开关;设为T不代表该名称会独立启动计算;按实际功能专题选择入口 WannierTools模型准备与操作路线
DMFT_MAG_calc 当前版本未接入该开关;设为T不代表该名称会独立启动计算;按实际功能专题选择入口 WannierTools模型准备与操作路线
Fit_kp_calc 当前版本未接入该开关;设为T不代表该名称会独立启动计算;按实际功能专题选择入口 WannierTools模型准备与操作路线
LanczosBand_calc 当前版本未接入该开关;设为T不代表该名称会独立启动计算;按实际功能专题选择入口 WannierTools模型准备与操作路线
LanczosDos_calc 当前版本未接入该开关;设为T不代表该名称会独立启动计算;按实际功能专题选择入口 WannierTools模型准备与操作路线
LanczosSeqDOS_calc 当前版本未接入该开关;设为T不代表该名称会独立启动计算;按实际功能专题选择入口 WannierTools模型准备与操作路线
NLChirality_calc 当前版本未接入该开关;设为T不代表该名称会独立启动计算;按实际功能专题选择入口 WannierTools模型准备与操作路线
OrbitalTexture_3D_calc 当前版本未接入该开关;设为T不代表该名称会独立启动计算;按实际功能专题选择入口 WannierTools模型准备与操作路线
OrbitalTexture_calc 当前版本未接入该开关;设为T不代表该名称会独立启动计算;按实际功能专题选择入口 WannierTools模型准备与操作路线
TBtoKP_calc 当前版本未接入该开关;设为T不代表该名称会独立启动计算;按实际功能专题选择入口 WannierTools模型准备与操作路线
w3d_nested_calc 当前版本未接入该开关;设为T不代表该名称会独立启动计算;按实际功能专题选择入口 WannierTools模型准备与操作路线

例如原生OrbitalTexture相关结果在专题中有对应的可用路径,但不能因此认为这两个同名CONTROL开关各自已独立生效。LanczosDos_calc出现在提示文字中,也不构成开关已被接入的说明。

5 磁场、谱和坐标需要特别注意的地方#

  • **磁通与Tesla分开看。**本例磁场小模型的可靠横轴是输入的p/q。当前构建部分原生Tesla列存在面积单位或不同分支标记的差异,按磁通扫描教程的独立面积换算读取,不能直接复制为SI磁场。
  • 原生负谱值不作为LDOS。LandauLevel_k_dos_calc的原生例子有负谱值限制;需要使用谱函数时,参照因果连分式兼容流程或已核对能级的确定性展宽,按各自说明处理归一化和π因子。
  • **轨道权重对应具体分支。**本例固定k波函数权重有独立核对,不将B扫描分支的其他权重列直接套用为相同定义。
  • 平面坐标使用已说明的重建方式。磁场k带与平面教程根据输入平面重建坐标,避免盲用有差异的原始坐标列。
  • 开关名字不等于输出物理量。landau_chern_calc的本例实际输出开边界能谱和左右权重,不能直接当作程序给出一个Chern整数;拓扑整数按相应独立拓扑实例计算和读取。

正式计算仍按对应教程的Slurm模板提交;图和数据已经在附件中时,可以先运行读取和作图脚本了解结果,不必为浏览示例重新提交完整计算。当前实例覆盖的是有限小体系的操作与输出解释,不代表所有模型、参数组合、收敛设置或原版数值问题都已解决。

需要根据你的体系选择资源?联系讨论计算需求。实际可用软件与权限,以当前账户和运行环境为准。

查看配图

放大后可滚动查看细节,按 Esc 关闭。

100%查看原图 ↗