WannierTools功能导航:计算开关与实例入口
对照当前2.7.0的77个CONTROL名称寻找实例,区分原生入口、等效名称、独立兼容方法和版本中未接入的开关,说明磁场与谱输出的实际用法。
阅读本篇目录
本页帮助你从“想计算什么、输入哪个开关”找到对应实例,固定针对集群当前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模板提交;图和数据已经在附件中时,可以先运行读取和作图脚本了解结果,不必为浏览示例重新提交完整计算。当前实例覆盖的是有限小体系的操作与输出解释,不代表所有模型、参数组合、收敛设置或原版数值问题都已解决。