# 任务书：用 Quantum ESPRESSO 计算单层与体相 MoS2 的能带——收敛性、自旋轨道耦合与文献对照

## 1. 背景

MoS2 是最常见的二维过渡金属硫族化合物，也是第一性原理计算的经典入门体系：体相是间接带隙，减薄到单层变为 K 点直接带隙；单层价带顶在自旋轨道耦合（SOC）下明显劈裂。因为有大量公开的计算与实验数据，它很适合用来检验一套 DFT 流程是否可信。

第一次用 Quantum ESPRESSO（QE）的研究生常卡在这些地方：赝势怎么选、`ecutwfc` 和 `ecutrho` 怎么定、k 点网格怎么收敛、二维体系的真空层取多厚、结构怎么优化、SCF 不收敛怎么办、`bands.x` 和 `projwfc.x` 怎么用、高对称路径怎么写、能带图怎么画、带隙到底是直接还是间接、SOC 怎么开、算出来的带隙为什么比实验小。本任务要求从零完成一套可复现的计算，并把结果和公开文献核对。

## 2. 研究问题

1. 单层 MoS2 的平衡晶格常数、Mo–S 键长、带隙大小与带隙类型是什么？带隙的价带顶和导带底分别在哪个 k 点？
2. 体相 2H-MoS2 的带隙大小与类型是什么？从体相到单层，带隙类型如何变化？
3. 平面波截断能、k 点网格和真空层厚度分别对总能和带隙有多大影响？用什么判据说明已经收敛？
4. 单层价带顶在 K 点的 SOC 劈裂是多少？开 SOC 后带隙变化多少？
5. 本次结果与公开的 DFT 计算、GW 或实验结果相差多少？差异能否由泛函、赝势、结构或是否计入 SOC 与激子效应解释？

## 3. 计算设置

- **软件**：使用云电脑预装的 Quantum ESPRESSO（`pw.x`、`bands.x`、`projwfc.x`、`dos.x` 等）。先确认版本与并行能力，写进运行记录。不要自行编译另一套 QE。
- **算力**：先在云电脑 CPU 上估算单次 SCF 的耗时与内存。云电脑资源足够时不要租用外部算力；确实不够时，先说明估算依据，再按平台指南租用合适的 CPU 或 GPU 配置，用完立即释放，并写明起止时间与费用。
- **赝势与泛函**：主线用 PBE。自行选择来源可靠、经过基准测试的赝势（例如 SSSP 或 PseudoDojo），写明来源 URL、版本、文件名与 SHA256，并按其推荐值确定截断能的起点。计算 SOC 时使用相应的全相对论赝势，并说明它和标量相对论赝势的差异。
- **单层结构**：P-6m2 结构，自行决定真空层厚度并做收敛测试。说明如何避免层间周期性镜像的相互作用，优化时如何保持真空层不变。
- **体相结构**：2H 相。说明层间范德华作用如何处理（例如 DFT-D3 或 vdW-DF），并比较开启与不开启时的层间距和带隙。
- **收敛测试**：分别对 `ecutwfc`（及 `ecutrho`）、k 点网格、真空层厚度（单层）做系统测试，固定其他参数，每项至少 4 个取值。报告总能（每原子）、带隙、晶格常数或受力的变化。先定收敛判据，再选参数，不要用测试结果反过来凑文献值。
- **结构优化**：报告优化前后的晶格常数、键长、残余受力与应力。
- **能带与态密度**：沿高对称路径（单层 Γ–M–K–Γ；体相自行确定并说明）计算能带；计算总态密度和投影态密度，说明带边主要由哪些轨道贡献。
- **带隙判定**：不要只看图。用数值从 `bands.x` 输出中找到价带顶、导带底及其 k 点，并用更密的 k 点确认带边位置，给出直接带隙与间接带隙两个数。
- **SOC**：对单层做非共线加 SOC 的能带计算，报告 K 点价带劈裂与带隙变化。

## 4. 验证与对照

- 查 3 篇以上公开文献或数据库（可包括 Materials Project、C2DB 等），列出各自报告的晶格常数、带隙、SOC 劈裂及其计算条件（泛函、赝势或基组、是否含 SOC）。若有实验或 GW 结果，单独列出，并写明 DOI 或链接与查阅日期。
- 把本次结果和文献放在同一张表里对照，给出偏差。明确区分 PBE 带隙、准粒子带隙和光学带隙，不要把不同定义的量直接比较。
- 差异较大时分析原因并如实报告。参数先定、再算、再比。

## 5. 出图要求

300 dpi PNG，另存矢量版：

1. 单层与体相 MoS2 的晶体结构图（俯视与侧视）。
2. 收敛曲线：截断能、k 点网格、真空层。
3. 单层能带图，标出价带顶、导带底和带隙。
4. 体相能带图，标出间接带隙的路径。
5. 单层开与不开 SOC 的能带对比，放大 K 点附近并标出劈裂值。
6. 单层投影态密度（Mo d 与 S p 轨道）。

## 6. 交付物

全部放在工作区的 `qe_mos2/` 目录下：

| 文件或目录 | 内容 |
| --- | --- |
| `report.pdf` | 中文研究报告：背景、计算方法与参数、收敛测试、结构、能带、态密度、SOC、文献对照、误差来源与局限。正文每个数字都能在表格或日志中找到出处 |
| `figures/` | 上述图表，300 dpi PNG 并附矢量版 |
| `tables/` | 收敛测试、结构参数、带边位置与带隙、SOC 劈裂、文献对照表；csv 与 xlsx |
| `inputs/` | 全部 QE 输入文件（`scf`、`relax`、`bands`、`projwfc`、`dos`），以及赝势清单 |
| `outputs/` | 全部 QE 输出与能带数据文件。波函数与 charge 等体积大且可由输入重新生成的文件可以不保留，但要写明如何重新生成 |
| `code/` | 生成输入、批量运行、解析输出、找带边、出图的脚本，以及一键复现入口；记录软件版本 |
| `data_manifest.csv` | 赝势与外部数据的来源 URL、版本、下载时间、SHA256 |
| `methods_notes.md` | 中文操作说明，写给第一次用 QE 的研究生：输入文件各段的含义、赝势怎么选和下载、`ecutwfc` 与 `ecutrho` 的关系、k 点网格和收敛测试怎么做、二维真空层怎么设、`relax` 与 `vc-relax` 的区别、能带计算的完整步骤（scf → bands → bands.x）、高对称路径怎么写、怎么判断直接或间接带隙、SOC 怎么开、常见报错与解决办法 |
| `run_log.md` | 运行记录：每一步做了什么、用时、报错原文与解决办法、每个决策的理由；QE 版本、CPU 核数、并行设置、每类计算的墙钟时间与峰值内存 |
| `comparison.md` | 与已发表结果的对照表和差异解释 |

## 7. 工作方式

- 请独立完成全部步骤。遇到问题先自己查文档、尝试解决，并记录在 `run_log.md`；不要因为可以自行判断的问题停下来等待确认。只有在确实无法继续时才提问。
- 所有数字必须来自实际运行的输出，不得估计或编造。结果与文献差距大时，如实报告并分析原因。
- 如果租用了算力：全部结果同步回云电脑工作区并核对后再释放。赝势等可重新下载的内容不需要从租用服务器回传。
- 长时间计算期间不要反复汇报没有变化的进度；在同一轮里继续等待，有实质进展再说。
- 保留全部中间结果，包括没有采用的参数和失败的尝试。
- 完成后，在对话中用简短的中文总结主要结果（晶格常数、带隙类型与大小、SOC 劈裂、文献对照），并列出交付物清单与路径。
