用途：pymatgen（Python Materials Genomics）是面向材料科学的综合 Python 库，用于创建、分析和操作晶体结构与分子，计算相图与热力学性质，分析电子结构（能带、态密度），生成表面与界面，并以编程方式访问 Materials Project 数据库。适用于结构文件格式转换、对称性与配位环境分析、相图与稳定性评估、电子结构分析、表面/界面研究、高通量计算流程搭建，以及 VASP、Gaussian、Quantum ESPRESSO 等代码的输入输出处理。
主要能力：结构创建与变换（超胞、元素替换、原胞转换）；100 多种格式互转（CIF、POSCAR、XYZ 等，自动识别格式）；对称性与空间群分析、配位环境计算；相图构建与 hull 以上能量、分解产物分析；能带结构与态密度读取和绘图；Slab 生成、Wulff 形状、吸附位点查找；Materials Project API 检索与结构/能带获取；VASP 等计算输入集生成；XRD 图谱、弹性张量、磁序枚举等高级分析。
使用方式：安装核心库 uv pip install pymatgen；需 Materials Project 访问时 uv pip install pymatgen mp-api，并设置 export MP_API_KEY="your_api_key_here"。常用入口包括 Structure.from_file() 读取、struct.to(filename=...) 写出、SpacegroupAnalyzer、PhaseDiagram、MPRester、MPRelaxSet 等。随附脚本 structure_converter.py、structure_analyzer.py、phase_diagram_generator.py 可执行常见任务，例如 python scripts/structure_converter.py POSCAR structure.cif。
限制：资料未提供收费、价格、平台与效果信息；部分功能依赖可选依赖（analysis、vis）及外部 API 密钥；具体支持范围以官方文档为准。