QE电荷密度切片与plotrho等值线
复用实际硅基态,演示pp.x导出平面网格、plotrho.x生成线性与对数等值线,以及Python绘制密度切片和线剖面,附完整输入、命令、数据与图片。
阅读本篇目录
基态计算完成后,想查看某个平面的电子分布,可以用pp.x提取密度,再用plotrho.x画等值线。本篇复用硅有限动量EELS教程已经完成的两原子硅基态,重点演示后处理,不重复做SCF。
本篇使用QE 7.6 CPU版,Intel oneAPI 2024.2、Intel MPI 2021.13;原基态采用20Ry截断、移位3×3×3 k网格。切片位于z=a/4≈1.357743 Å,平面上取33×33点。
1.下载、读数据和画图#
下载硅密度切片与等值线实例包,解压进入qe-density-contours:
bash read.sh
bash plot.sh
cat analysis/QE-density-contour-summary.csv
head -n 7 analysis/QE-density-contour-grid.csv
资料包已经包含从实际SCF提取的density.raw,重新导出平面和等值线不需要赝势或波函数。

左图来自三列网格数据,右图由相同旧格式网格和10个线性等值级别用Python重绘,便于直接浏览。plotrho.x实际生成的PostScript文件也保存在参考结果中。
2.重做后处理的完整顺序#
bash prepare.sh
sbatch submit.sh
squeue -u "$USER"
脚本依次完成:
- 从已有三维密度导出
plotrho格式平面; - 从同一密度导出三列格式平面;
- 用
plotrho.x生成10级线性等值线; - 用同一正值网格生成10级对数等值线。
完成后:
bash read.sh work-new analysis-new
bash plot.sh analysis-new figures-new
ls work-new/density*.ps
CPU分区按56核整节点申请与计费。提交脚本申请一个MPI进程、每进程56个CPU,本小例程序仍单线程执行;减少程序线程不会降低整节点费用。这类短后处理也适合放在自己已经申请的CPU资源内批量执行。
prepare.sh拒绝覆盖已有work-new,参考文件与新结果分开。
3.pp.x的平面输入怎么写#
资料包中的inputs/density2d.in:
&inputpp
/
&plot
nfile=1,
filepp(1)='density.raw',
weight(1)=1.0,
iflag=2,
output_format=2,
fileout='density2d.dat',
e1(1)=1.0, e1(2)=0.0, e1(3)=0.0,
e2(1)=0.0, e2(2)=1.0, e2(3)=0.0,
x0(1)=0.0, x0(2)=0.0, x0(3)=0.25,
nx=33, ny=33
/
执行:
module load qe/7.6-8173m
export OMP_NUM_THREADS=1
pp.x -in density2d.in > density2d.out
&inputpp留空表示跳过从SCF提取数据,直接读已经存在的density.raw。如果从自己的SCF开始,可将这一段改为:
&inputpp
prefix='Si',
outdir='./out',
filplot='density.raw',
plot_num=0
/
后面保留同一份&plot。此时prefix/outdir应指向自己的已完成基态;本篇实际首次导出就采用这一方式。
关键参数:
plot_num=0提取赝价电子密度。iflag=2选择二维平面。e1/e2给出平面的两个方向向量,x0给出起点;它们以alat为单位。本例沿笛卡尔x/y方向,两个方向互相垂直。x0(3)=0.25表示平面高度a/4,不是0.25 Å。nx/ny控制导出网格点数。plotrho本身不会把这个33×33网格重新加密。output_format=2产生plotrho需要的旧格式。
参数定义可查官方pp.x输入说明。
4.同时导出三列数据#
density2d-gnuplot.in使用相同平面,只把下面两项改为:
output_format=7,
fileout='density2d.gnu',
pp.x -in density2d-gnuplot.in > density2d-gnuplot.out
head -n 5 density2d.gnu
三列依次是平面坐标和密度。本例三列格式坐标单位为Bohr,旧plotrho文件的轴数组则按alat归一化,读取时不能把两种坐标直接当成同一单位。配套读取器统一换算后,CSV同时给出Bohr和Å坐标。
旧格式密度只保留约4位有效数字,三列格式保留更多位数。本例两种文本之间最大差约4.945×10⁻⁶ e/Bohr³,来自输出舍入;绘图和进一步取数时可优先使用三列数据。
5.运行plotrho:线性等值线#
先看文件:
head -n 3 density2d.dat
首行是32 32,对应的坐标数组分别有33个点。本例实际密度范围约为0.0009713到0.06125 e/Bohr³。
创建一个简短答案文件plotrho.in:
density2d.dat
density-linear.ps
n
0.0009713 0.06125 10
然后:
plotrho.x < plotrho.in > plotrho.out
ls -lh density-linear.ps
四行分别表示:输入网格、输出PostScript文件、不使用对数级别、等值线最小值/最大值/数量。这里是10个线性间隔级别。
本例的密度均为正,因此程序会询问是否使用对数级别。若换成含零或负值的数据,程序会跳过这一提问,手写答案文件时应去掉对应的n行。配套contour.py会根据实际数据处理这个输入差别。
6.对数等值线怎么画#
使用同一份正值网格,把答案中的输出文件和n改为:
density2d.dat
density-log.ps
y
0.0009713 0.06125 10
保存为plotrho-log.in并运行:
plotrho.x < plotrho-log.in > plotrho-log.out
ls -lh density-linear.ps density-log.ps
本例已经实际生成了两种原生PostScript结果。对数级别有助于同时查看强弱不同的密度区域,但必须使用正的上下界;增加等值线条数只改变显示,不会提高原始密度计算的精度。
日常直接运行资料包里的submit.sh即可,脚本会根据网格自动生成答案文件,无需每次手工输入数值。
7.从切片再取一条线#

本图把计算的两原子原胞作周期延拓,以便看清切片方向;没有增加新的DFT结构计算。右图使用同一33×33平面的对角线数据,虚线标出穿过硅原子的位置。
plot_num=0这里给出的是赝价电子密度,并不包含全电子核密度重构。因此图中原子位置附近出现低值,不能据此认为原子没有电子。
整个三维FFT网格为24×24×24点,积分得到约8个价电子。这个电子数来自三维密度与原胞体积,不能用二维平面积分代替体系总电子数。
实际使用可按“完成基态 → 选择所需密度或势 → 定义平面与单位 → 导出网格 → 画等值线/线剖面”操作。更换结构、切片方向或物理量后,应相应检查坐标、单位与电子数口径。