/ocp

https://opencatalystproject.org/

Primary LanguagePythonMIT LicenseMIT

ocp by Open Catalyst Project

CircleCI codecov

ocp is the Open Catalyst Project's library of state-of-the-art machine learning algorithms for catalysis.

It provides training and evaluation code for tasks and models that take arbitrary chemical structures as input to predict energies / forces / positions, and can be used as a base scaffold for research projects. For an overview of tasks, data, and metrics, please read our papers:

Projects developed on ocp:

Installation

See installation instructions.

Download data

Dataset download links and instructions are in DATASET.md.

Train and evaluate models

A detailed description of how to train and evaluate models, run ML-based relaxations, and generate EvalAI submission files can be found in TRAIN.md.

Our evaluation server is hosted on EvalAI. Numbers (in papers, etc.) should be reported from the evaluation server.

Interactive tutorial notebooks can be found here to get familiar with various components of the codebase.

Pretrained model weights

We provide several pretrained model weights for download here.

Discussion

For all non-codebase related questions and to keep up-to-date with the latest OCP announcements, please join the discussion board.

All code-related questions and issues should be posted directly on our issues page.

Acknowledgements

License

ocp is released under the MIT license.

Citing ocp

If you use this codebase in your work, please consider citing:

@article{ocp_dataset,
    author = {Chanussot*, Lowik and Das*, Abhishek and Goyal*, Siddharth and Lavril*, Thibaut and Shuaibi*, Muhammed and Riviere, Morgane and Tran, Kevin and Heras-Domingo, Javier and Ho, Caleb and Hu, Weihua and Palizhati, Aini and Sriram, Anuroop and Wood, Brandon and Yoon, Junwoong and Parikh, Devi and Zitnick, C. Lawrence and Ulissi, Zachary},
    title = {Open Catalyst 2020 (OC20) Dataset and Community Challenges},
    journal = {ACS Catalysis},
    year = {2021},
    doi = {10.1021/acscatal.0c04525},
}