pbe

<p align="center"> <strong> <span style="font-size: 30px;">PBE</span> </strong> </p> ## 数据集介绍 PBE 是面向 `OneScience/matris` 的材料声子参考数据集，包含 PBE 和 PBESOL 两套交换关联泛函下的声子计算结果。数据集由汇总 CSV 索引文件和大量 bzip2 压缩 YAML 文件组成，可用于 MatRIS 等机器学习原子间势模型的训练、验证和测试。 当前数据包包含约 9960 个文件，约 2.0 GB，具体包括： - `data/pbe.csv`：PBE 声子参考汇总索引 - `data/pbesol.csv`：PBESOL 声子参考汇总索引 - `data/pbe/*.yaml.bz2`：约 9958 个材料的位移-力声子参考文件 ## 仓库说明 本数据集适配 `OneScience/matris`，用于其 `matchem/pbe` 路径。MatRIS 模型标准包应引用本数据集 `OneScience/pbe`，而不是旧的同名 `OneScience/matris` 数据集 ID。供模型使用时，推荐保持本数据集包根目录下的 `data/` 结构。 ## 文件说明 ### 数据下载 ```bash modelscope download --dataset OneScience/pbe --local_dir session_workdir ``` ### 数据文件 数据文件位于 `data/` 目录下： | 数据 | 格式 | 说明 | |---|---|---| | PBE 汇总 | CSV | `data/pbe.csv`，包含 `mp_id`、`nsites`、`energy_pa`、`volume_pa`、`entropy`、`heat_capacity`、`free_energy`、`max_freq`、`avg_freq`、`stable` | | PBESOL 汇总 | CSV | `data/pbesol.csv`，表头与 `pbe.csv` 一致 | | 声子参考 | YAML+bz2 | `data/pbe/*.yaml.bz2`，约 9958 个文件，包含材料条目的位移和力等声子参考信息 | | 校验清单 | SHA256 | `metadata/sha256_manifest.txt` | ### 数据格式 `pbe.csv` 和 `pbesol.csv` 为逗号分隔表格，表头为： ```text mp_id,nsites,energy_pa,volume_pa,entropy,heat_capacity,free_energy,max_freq,avg_freq,stable ``` `data/pbe/*.yaml.bz2` 是 bzip2 压缩 YAML 文件，顶层包含 `displacements` 等键，记录材料条目的位移和力等声子参考信息。 ## 数据放置与验证 独立验证时数据应放在： ```text data/ ├── pbe.csv ├── pbesol.csv └── pbe/ └── *.yaml.bz2 ``` 验证命令： ```bash python scripts/validate_pbe.py --dataset-root data --checksum-manifest metadata/sha256_manifest.txt ``` 验证会检查 CSV 表头、CSV 行数、`* .yaml.bz2` 文件数量、抽样解压可读性和 SHA256。 ## 使用说明（支持的OneScience模型） 本数据集适配 `OneScience/matris`，可用于 preflight、train、evaluate。使用时应保持本数据集包根目录下的 `data/` 结构，或在 MatRIS 配置中指定实际下载位置。 ## OneScience 官方信息 | 平台 | OneScience 主仓库 | Skills 仓库 | |---|---|---| | Gitee | https://gitee.com/onescience-ai/onescience | https://gitee.com/onescience-ai/oneskills | | GitHub | https://github.com/onescience-ai/OneScience | https://github.com/onescience-ai/oneskills | ## 引用与许可证 本数据集是 `OneScience/matris` 声子参考示例的配套数据，没有生成新样本或改变原始数据内容。使用限制和许可证以原始 PBE 数据来源、OneScience 仓库和 ModelScope 页面说明为准。