QE专题

QE电荷密度切片与plotrho等值线

复用实际硅基态,演示pp.x导出平面网格、plotrho.x生成线性与对数等值线,以及Python绘制密度切片和线剖面,附完整输入、命令、数据与图片。

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

基态计算完成后,想查看某个平面的电子分布,可以用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"

脚本依次完成:

  1. 从已有三维密度导出plotrho格式平面;
  2. 从同一密度导出三列格式平面;
  3. 用plotrho.x生成10级线性等值线;
  4. 用同一正值网格生成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.从切片再取一条线#

切片在周期延拓硅结构中的位置,以及同一平面沿x=y方向提取的实际密度剖面

本图把计算的两原子原胞作周期延拓,以便看清切片方向;没有增加新的DFT结构计算。右图使用同一33×33平面的对角线数据,虚线标出穿过硅原子的位置。

plot_num=0这里给出的是赝价电子密度,并不包含全电子核密度重构。因此图中原子位置附近出现低值,不能据此认为原子没有电子。

整个三维FFT网格为24×24×24点,积分得到约8个价电子。这个电子数来自三维密度与原胞体积,不能用二维平面积分代替体系总电子数。

实际使用可按“完成基态 → 选择所需密度或势 → 定义平面与单位 → 导出网格 → 画等值线/线剖面”操作。更换结构、切片方向或物理量后,应相应检查坐标、单位与电子数口径。

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

查看配图

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

100%查看原图 ↗