用途：pymatgen 是面向材料科学的 Python 库，用于创建、分析和操作晶体结构与分子，计算相图与热力学性质，分析电子结构（能带、态密度），生成表面与界面，并以编程方式访问 Materials Project 数据库。适用于处理 CIF、POSCAR、XYZ 等结构文件、对称性与配位环境分析、高通量计算流程搭建，以及 VASP、Gaussian、Quantum ESPRESSO 等代码的输入输出。
主要能力：结构创建与变换（超胞、元素替换、原胞转换）；100 多种文件格式的自动识别与互转；对称性、空间群与配位分析；相图构建与稳定性评估；能带结构与态密度分析；Slab 生成、Wulff 形状与吸附位点查找；Materials Project API 检索；VASP 等计算输入生成；XRD 图谱、弹性张量、磁序等高级分析。
使用方式：安装核心库 pip install pymatgen；如需 Materials Project API，pip install pymatgen mp-api，并设置 export MP_API_KEY="your_api_key_here"。常用入口包括 Structure.from_file() 读取结构、struct.to(filename=...) 写出、SpacegroupAnalyzer 做对称性分析、PhaseDiagram 构建相图、MPRester 访问数据库。随附脚本如 python scripts/structure_converter.py POSCAR structure.cif、python scripts/structure_analyzer.py structure.cif --symmetry --neighbors、python scripts/phase_diagram_generator.py Li-Fe-O --analyze "LiFeO2"。
限制：部分功能依赖 Materials Project API 密钥与网络；扩展分析与可视化需安装可选依赖 pymatgen[analysis]、pymatgen[vis]；具体收费、价格与平台支持情况暂未提供。