vasptool入门与KPATH生成
确认有效配置，生成INCAR、k网格与每段20点的高对称路径。
阅读本篇目录
下载完整输入、结果和复跑脚本。解压后在集群运行 bash run.sh，结果位于 work/，原结果在 reference/。这是19个工具流程的实操资料，不会自动启动新的VASP计算。
1 先确认版本和配置#
module load vasptool/1.5.2
vasptool --version
vasptool --show-config
vasptool --list-features
vasptool
最后一条进入交互菜单，输入0退出。本集群的1.5.2为本地集成入口，包含VASPKIT内核和列出的扩展；可用功能以 --list-features 和本地菜单为准。它与独立的 vaspkit 模块分开选择。
--show-config显示当前选择的配置文件。若自己的 ~/.vaspkit 存在，优先使用整份用户配置；否则读取公共配置，并不逐项合并。不要为了切版本把公共配置覆盖到自己的文件。批量生成输入前，确认有效配置中 AUTO_SUBMIT_JOB = .FALSE.；包内脚本会检查这一点。
本次实际显示的扩展入口与教程对应如下；完整主菜单和帮助保留在下载包 menu.txt、help.txt、features.txt 中。
| 入口 | 用途与本次示例 |
|---|---|
| training-structures | 两个Si随机位移结构 |
| strain-series | Si三档应变 |
| deformation-potential | 形变势，需要匹配应变与能带计算，本组未运行 |
| piezo-polarization | 极化–应变压电流程，本组未运行 |
| translate-density | 实际NaCl网格和原子同步平移 |
| export-xyz | 保留晶胞的Si XYZ |
| vacancy-models / substitution-models | Si空位、Ge替位 |
| moire-superlattice | 双层石墨烯候选 |
| chiral-nanoribbon / chiral-nanotube | MoS2纳米带、两种管径 |
本表是本机实际可见入口，不代表已完成全部VASPKIT内核菜单的实算。实验性入口需按当前配置和输入条件另行核对。
2 准备一个真实Si结构#
资料包的 reference/supercell/POSCAR 是8原子金刚石常规胞，晶格常数5.43 Å。可另建目录操作：
mkdir si-input
cp reference/supercell/POSCAR si-input/POSCAR
cd si-input
vasptool 101
提示选择任务类型时输入 ST，得到静态计算INCAR模板。模板需要按体系检查，不能直接用于所有材料。随后：
vasptool 102
依次输入 2 和 0.04，本例生成Gamma中心的 5 5 5 网格：
Automatic mesh
0
Gamma
5 5 5
0 0 0
这里0.04是当前菜单采用的网格分辨率输入，不是每段能带点数。该入口还会生成INCAR和POTCAR，因此在单独目录里操作并检查新文件；POTCAR按各自VASP许可在集群本地生成，下载包不分发。
3 生成KPATH，默认保留20#
mkdir ../si-path
cp POSCAR ../si-path/
cd ../si-path
vasptool 303
按当前提示选择 3。本例得到 PRIMCELL.vasp、KPATH.in 和高对称标签等文件。KPATH开头为：
K-Path Generated by VASPKIT.
20
Line-Mode
Reciprocal
0.0000000000 0.0000000000 0.0000000000 GAMMA
0.5000000000 0.0000000000 0.5000000000 X
0.5000000000 0.0000000000 0.5000000000 X
0.6250000000 0.2500000000 0.6250000000 U
完整路径为Γ–X、X–U、K–Γ、Γ–L、L–W、W–X。20是每一条线段上的采样点数，包含端点；相邻段即使共用端点，也要保留各段顺序。用户可以修改这一整数，但一般教学示例继续用默认20。
路径坐标对应生成的标准原胞，不能只复制KPATH而继续使用不匹配的常规胞。生成路径不产生能带本征值：还需要先完成SCF，再在相同势函数和设置下做能带计算。
4 需要逐条分段算时#
使用鸢算分段能带工作流，终端输入：
yskit
选择菜单4，按页面流程先生成路径、检查结构、准备共同SCF，再逐条执行和拼接。vasptool负责这里的路径准备；分段计算和续算由yskit完成。不要将不同晶胞、不同费米参照或不同路径顺序的数据直接拼到一起。