技能介绍

要解决什么问题

做第一性原理或高通量材料计算时，结构文件在 CIF、POSCAR、XYZ 等格式间来回换、对称性与配位要手工查、相图与 MP 数据要脚本 glue——pymatgen 把 Materials Project 侧常用的结构对象、I/O 与热力学/电子结构分析收进一个 Python 库，并对接 VASP、Gaussian、Quantum ESPRESSO 等主流代码的输入输出。

技能如何工作

结构与分子：用 Structure.from_file() 读入并做晶格变换、原胞化（如 SpacegroupAnalyzer）、组成与距离分析；需要不可变对象时用 IStructure。
格式与代码 I/O：在 100+ 格式间转换，配套 structure_converter.py 等脚本做批量与自动格式检测。
热力学与电子结构：构建相图、稳定性判断；处理能带、DOS 及带隙等性质（见分析模块与 VASP I/O 文档）。
表面与界面：薄层生成、Wulff 形、吸附位点等表面化学相关流程。
Materials Project：通过 mp-api 与 MPRester（需 MP_API_KEY）检索与拉取计算数据，相图脚本可结合化学体系做稳定性分析。
工作流：提供 MPRelaxSet、MPStaticSet 等输入集与变换框架，便于高通量结构生成、能带与表面能等常见流水线。

捆绑的 references/（核心类、I/O、分析、MP API、变换工作流）与 scripts/ 在需要细节时按需加载。

适用边界与注意

面向 Python 3.10+、pymatgen 2023.x/2024.x；MP 访问用 mp-api，与旧版 pymatgen.ext.matproj 不同。
库内默认单位：长度 Å、能量 eV、角度 °；对称性分析对数值噪声敏感，读结构后宜检查重叠原子与键长。
复杂多步、长时工作流可结合 K-Dense Web 等托管环境；简单单步结构转换或单次 MP 查询用本技能即可。