Open-Catalyst-Dataset 的安装和配置教程

项目基础介绍

Open-Catalyst-Dataset 是一个开源项目，它旨在为催化研究提供一个包含吸附质-催化剂输入生成工作流的数据库。该项目主要由 Python 编程语言编写，用于生成和分析和催化反应相关的数据。

项目使用的关键技术和框架

Open-Catalyst-Dataset 使用了以下关键技术和框架：

• Pymatgen：一个用于材料分析的 Python 库，提供了大量用于处理和分析材料数据的工具。
• ASE（Atomic Simulation Environment）：一个用于原子尺度模拟的 Python 库，用于构建和操作原子结构。
• Delauany 网格：用于在催化剂表面识别吸附位点的几何方法。

项目安装和配置的准备工作

在开始安装和配置 Open-Catalyst-Dataset 之前，请确保您的计算机上已经安装了以下软件：

• Python 3.9 或更高版本
• Conda 或其他 Python 环境管理器
• Git

安装步骤

以下是详细的安装步骤：

1. 创建新的 Conda 环境

首先，打开命令行界面，然后创建一个名为 ocp 的新环境，指定 Python 版本为 3.9 或更高：

conda create -n ocp python=3.9

2. 激活 Conda 环境

创建环境后，激活它：

conda activate ocp

3. 安装依赖

在激活的环境中，安装 Pymatgen 和 ASE 的特定版本：

pip install pymatgen==2023.5.10 ase==3.22.1

4. 克隆项目仓库

使用 Git 克隆 Open-Catalyst-Dataset 的仓库：

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

5. 安装项目

进入克隆的仓库目录，然后安装项目：

cd Open-Catalyst-Dataset
pip install -e .

6. 使用示例

以下是使用 Open-Catalyst-Dataset 工作流的一个简单示例：

# 导入需要的类
from ocdata import Bulk, Adsorbate, Slab

# 初始化一个_bulk对象
bulk_src_id = "mp-30"
bulk = Bulk(bulk_src_id_from_db=bulk_src_id, bulk_db_path="your-path-here.pkl")

# 初始化一个_adsorbate对象
adsorbate_smiles = "*CO"
adsorbate = Adsorbate(adsorbate_smiles_from_db=adsorbate_smiles, adsorbate_db_path="your-path-here.pkl")

# 生成一个特定的slab
slabs = Slab.from_bulk_get_specific_millers(bulk=bulk, specific_millers=(1, 1, 1))

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

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

以上步骤完成后，您就可以开始使用 Open-Catalyst-Dataset 进行工作了。