FCC_Cu

<p align="center"> <strong> <span style="font-size: 30px;">FCC_Cu</span> </strong> </p> ## 数据集介绍 FCC_Cu 是用于材料机器学习原子间势训练、验证和流程 smoke 测试的 ASE extxyz 数据集。数据包含 C/H/O/Cu 元素的周期结构，并提供每个结构的晶胞、总能量和原子力。 数据包含 6,855 个结构，每个结构包含 52 个原子，元素集合为 C、H、O 和 Cu。该数据集适合教程、回归测试和小规模流程验证，不用于复现全量研究规模的训练。 ## 仓库说明 本数据集适配 `OneScience/nequip`，用于其 NequIP MatChem 示例和 OAM-L 微调流程。数据集与模型仓库分开发布，模型使用时推荐将原始文件放到共享数据目录的 `NequIP/` 子目录下。 ## 文件说明 ### 数据下载 ```bash modelscope download --dataset OneScience/FCC_Cu --local_dir session_workdir ``` ### 数据文件 数据文件位于 `data/FCC_Cu/raw/` 目录下： | 数据 | 格式 | 说明 | |---|---|---| | FCC Cu 数据集 | extxyz | `fcu.xyz`，共 6,855 帧，每帧 52 个原子 | | 校验清单 | SHA256 | `metadata/sha256_manifest.txt` | | 数据结构说明 | YAML | `metadata/schema.yaml` | ### 数据格式 数据格式为 extxyz。每个构型由原子数行、comment 行和原子行组成。原子行包含元素、坐标和原子力；comment 行包含周期晶格、周期性边界条件和总能量。 | 字段 | 说明 | |---|---| | `species` | 元素符号，当前元素集合为 C、H、O、Cu | | `pos` | 笛卡尔坐标，shape `[num_atoms, 3]` | | `forces` | 原子力，shape `[num_atoms, 3]` | | `Lattice` | 周期晶格信息 | | `pbc` | 周期边界条件 | | `energy` | 构型总能量 | ## 数据放置与验证 NequIP 示例通过 `ONESCIENCE_DATASETS_DIR` 查找数据。可将数据文件放到： ```text $ONESCIENCE_DATASETS_DIR/NequIP/fcu.xyz ``` 复制并验证： ```bash mkdir -p "$ONESCIENCE_DATASETS_DIR/NequIP" cp data/FCC_Cu/raw/fcu.xyz "$ONESCIENCE_DATASETS_DIR/NequIP/fcu.xyz" python scripts/validate_fcc_cu.py ``` 验证脚本会检查文件 SHA-256、帧数、每帧原子数、元素集合和必要的 extxyz 属性。 ## 使用说明（支持的OneScience模型） 本数据集当前适配 [OneScience/nequip](https://modelscope.cn/models/OneScience/nequip)，可用于 NequIP 从头训练、OAM-L 微调以及训练流程 smoke 测试。使用时请确保数据的体系、单位、能量和力的定义与训练配置一致。 ## 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 NequIP 数据准备流程从 Materials Cloud 的 FCC 教程文件下载并校验： - 原始文件：[fcu.xyz](https://archive.materialscloud.org/records/ycbvx-knj69/files/fcu.xyz?download=1) - 固定 SHA-256：`57f00395d6945a3018a873d229fd7fbb7352a44a66f00f3c6e8a36247e0851e5` - 来源模型仓库：[mir-group/nequip](https://github.com/mir-group/nequip) - 来源模型许可证：[NequIP LICENSE](https://github.com/mir-group/nequip/blob/main/LICENSE)，MIT License 原始 Materials Cloud 页面在本次发布准备中未找到明确的数据再分发许可证。因此，按照本发布流程的许可证回退规则，本数据集当前按来源 GitHub 模型仓库 NequIP 的 MIT License 标记和说明；这是发布标记的回退依据，不代表对原始数据来源条款的重新解释。使用者仍应遵守原始来源的引用、使用和再分发要求。