Open-Catalyst-Dataset 开源项目最佳实践

1. 项目介绍

Open-Catalyst-Dataset 是由 Open-Catalyst-Project 开发的一个开源项目，旨在为催化研究提供一套高质量的吸附剂-催化剂输入生成工作流程。该数据集通过自动化的方式生成吸附剂和催化剂的配置，支持多种吸附剂和催化剂的组合，为催化反应的研究提供了丰富的实验数据。

2. 项目快速启动

环境搭建

首先，确保安装了 Conda 环境。如果没有安装，可以通过以下命令安装：

conda install -n ocp python=3.9
conda activate ocp

接着，安装所需的 Python 包：

pip install pymatgen==2023.5.10 ase==3.22.1

克隆项目

将项目克隆到本地：

git clone https://github.com/Open-Catalyst-Project/Open-Catalyst-Dataset.git
cd Open-Catalyst-Dataset

安装项目：

pip install -e .

示例使用

以下是一个简单的示例，展示如何使用 Open-Catalyst-Dataset 工作流程将 CO 放置在 Cu (1,1,1) 表面上：

bulk_src_id = "mp-30"
adsorbate_smiles = "*CO"
bulk = Bulk(bulk_src_id_from_db=bulk_src_id, bulk_db_path="your-path-here.pkl")
adsorbate = Adsorbate(adsorbate_smiles_from_db=adsorbate_smiles, adsorbate_db_path="your-path-here.pkl")
slabs = Slab.from_bulk_get_specific_millers(bulk=bulk, specific_millers=(1, 1, 1))

# 执行启发式放置
heuristic_adslabs = AdsorbateSlabConfig(slabs[0], adsorbate, mode="heuristic")

# 执行随机位点，启发式放置
random_adslabs = AdsorbateSlabConfig(slabs[0], adsorbate, mode="random_site_heuristic_placement", num_sites=100)

请确保将 your-path-here.pkl 替换为实际的数据库文件路径。

3. 应用案例和最佳实践

生成吸附剂-催化剂配置

使用 Open-Catalyst-Dataset 生成吸附剂-催化剂配置时，可以采用不同的模式来放置吸附剂，包括启发式放置、随机放置和随机位点启发式放置。

• 启发式放置：在表面原子节点、两节点之间和三角形中心考虑放置位点。
• 随机放置：在 Delaunay 三角形的边上均匀随机采样放置位点。
• 随机位点启发式放置：结合启发式和随机放置的优点。

以下是一个使用启发式放置的示例：

heuristic_adslabs = AdsorbateSlabConfig(slabs[0], adsorbate, mode="heuristic")

生成 VASP 输入文件

Open-Catalyst-Dataset 提供了一个 StructureGenerator 辅助类，用于创建吸附剂、催化剂对象，并生成 VASP 输入文件和元数据。

# 示例：生成 VASP 输入文件
structure_generator = StructureGenerator(bulk_db_path="your-path-here.pkl", adsorbate_db_path="your-path-here.pkl")
structure_generator.generate_input_files(output_dir="output", bulk_index=0, adsorbate_index=0, surface_index=0)

请确保将 your-path-here.pkl 替换为实际的数据库文件路径。

4. 典型生态项目

Open-Catalyst-Dataset 可以作为催化研究的一个基础工具，与其他开源项目如 Open Catalyst、Pythia 等 结合使用，共同构建一个完整的催化研究生态。例如，可以使用 Open-Catalyst-Dataset 生成的数据集来训练机器学习模型，预测催化反应的活性。