VTST split_dos:逐原子 DOS 与自旋绘图
用真实Si和Co输出运行旧split_dos入口,说明DOS0/DOSn列、OUTCAR费米能、自旋负号和POSCAR格式。
阅读本篇目录
本篇补充 vtstscripts/1040 中无扩展名的旧工具 split_dos。它与其他 DOS 拆分脚本的文件格式有差异;示例复用已完成的非自旋极化 Si₂ 和自旋极化 Co 数据,不重新运行 VASP。
1. 下载与查看#
unzip vtst-split-dos-legacy-wave1229-*.zip
cd vtst-split-dos-legacy
bash read.sh
bash plot.sh
ls analysis figures
reference-results/Si2 和 reference-results/Co-vasp5 保留实际输出。CSV 包括总 DOS、逐原子九轨道投影,以及费米能和文件维度汇总。更完整的 DOS 计算输入与其他 VTST 工具入口可参考 DOS 拆分、自旋与轨道求和。
2. 需要准备什么#
每个目录放同一次计算的 DOSCAR、OUTCAR、POSCAR,并保留原 INCAR、KPOINTS 以便核对。Si₂ 来自 VASP 6.6.1,Co 来自 6.5.1,本例两者都用 LORBIT=11,Co 另有 ISPIN=2。
cat inputs/Co-vasp5/INCAR
cat inputs/Co-vasp5/POSCAR
head -6 inputs/Co-vasp5/DOSCAR
本工具是旧 shell 脚本,无需编译。本例直接用 Bash 执行安装版 split_dos 原始正文;它调用的 vp 辅助脚本采用此前实际使用过的独立 Bash 兼容入口,供没有 ksh 的环境使用。兼容副本只处理解释器和数组初始化,不改变数据提取逻辑,不修改公共脚本。
3. 重新执行拆分#
bash prepare.sh
bash run.sh
bash read.sh work-new analysis-new
bash plot.sh analysis-new figures-new
prepare.sh 创建独立的工作目录,已有 work-new 时停止避免覆盖。run.sh 在私有 tools 中建立原始 split_dos 的入口,并放好 vp 兼容副本;依次处理 Si₂ 和 Co。它只读已有输出,不提交 VASP 作业。
要看单个目录运行所用的命令形式,生成工作目录后可以在其中一个尚未处理的目录执行:
cd work-new/Co-vasp5
bash ../tools/split_dos
ls DOS0 DOS1
运行前需已经由包内入口准备好 tools。如果自己的目录已经有 DOS0 等文件,先复制到独立后处理目录;旧脚本会覆盖这些同名输出及若干 tmp.* 文件。
4. POSCAR 为什么要用带元素行的格式#
vp 从 POSCAR 第 7 行读取原子数,因此本例输入统一采用 VASP 5 格式:第 6 行是元素名,第 7 行是组分原子数。Co 原文件采用旧格式,只有计数行;本包仅插入 Co 元素行,其余所有行保持不变,晶胞和原子坐标不变。
如果把旧格式直接交给这个 vp,它可能把 Cartesian 当成计数,导致原子坐标注释错误,尽管 DOS 数值表仍能输出。自己的结构应先检查:
sed -n '1,9p' POSCAR
多元素结构必须保持元素、计数及 OUTCAR 原子顺序一致,不能照搬单元素 Co 的插行方式。可使用 ASE 或其他结构工具转换,并核对原子顺序和坐标。
5. DOS0 与 DOSn 的列#
Si₂ 的 DOS0 有 301 行、3 列:
E-EF total_DOS integrated_DOS
Co 的 DOS0 有 4001 行、5 列:
E-EF DOS_up -DOS_down integrated_up -integrated_down
后面两列是累计积分,不是态密度;自旋向下两列取负号,是这份旧脚本的绘图约定,不表示态密度或电子数真的为负。
DOS1 对应第一个原子,Si₂ 还有 DOS2。它们第一行是 # x y z,记录 OUTCAR 最后一个位置块的坐标,单位 Å;读取数字表时需要跳过这行注释。LORBIT=11 的投影顺序为:
s py pz px dxy dyz dz2 dxz dx2-y2
非自旋极化时,每个轨道一列,共能量加九列;自旋极化时每个轨道依次是向上、取负后的向下,共能量加十八列。想画 p 或 d 总投影,应按相应轨道求和,不能只取其中一列。
6. 本工具减去哪个费米能#
split_dos 读取 OUTCAR 最后一次打印的 E-fermi。DOSCAR 头部的费米能可能保留更多小数,本例存在很小的差异:
| 数据 | DOSCAR / eV | OUTCAR / eV | DOSCAR−OUTCAR / eV |
|---|---|---|---|
| Si₂ | 6.24106330 | 6.2411 | −0.0000367 |
| Co | 10.06483600 | 10.0648 | 0.0000360 |
因此,若另一工具使用 DOSCAR 的精细费米能,横坐标会相差约 3.6×10⁻⁵ eV,这是本例的打印和读取约定,不是重新做 DFT 得到了不同能带。原 DOSCAR 能量网格本身还有打印精度限制,输出更多小数不能恢复已丢失的精度。
7. 实际总 DOS 与轨道投影#


图中展示完整导出能量范围,以本工具读取的费米能为 0。Co 向下通道画在负半轴,便于比较自旋;如果导出给其他分析程序,需要先确认其要求的是原始正值还是绘图负值。
投影 DOS 只包含选定原子与投影通道,不能要求图中的第一个原子 s+p+d 与全晶胞总 DOS 完全相等。Si₂ 两个原子的全部数据都保留在 CSV 中;图只选第一个原子作操作示范。
逐原子输出的全部数值已与原 DOSCAR 对应块比较,原子坐标注释与 OUTCAR 末帧一致。这里展示的是已有教学计算的后处理;需要定量分析金属费米面附近特征或提取带隙时,还应按自己的体系检查 k 网格、展宽、能量采样及计算方法,不能把“拆分文件成功”等同于原始计算已经收敛。