Skip to main content

A benchmark for machine learning energy models on inorganic crystal stability prediction from unrelaxed structures

Project description

Logo
Matbench Discovery

arXiv Tests GitHub Pages Requires Python 3.11+ PyPI

Disclaimer: We evaluate how accurately ML models predict solid-state thermodynamic stability. Although this is an important aspect of high-throughput materials discovery, the ranking cannot give a complete picture of a model's general applicability to materials. A high ranking does not constitute endorsement by the Materials Project.

Matbench Discovery is an interactive leaderboard and associated PyPI package which together make it easy to rank ML energy models on a task designed to simulate high-throughput discovery of new stable inorganic crystals.

We've tested models covering multiple methodologies including graph neural network (GNN) interatomic potentials, GNN one-shot predictors, iterative Bayesian optimizers and random forests with shallow-learning structure fingerprints.

Our results show that ML models have become robust enough to deploy them as triaging steps to more effectively allocate compute in high-throughput DFT relaxations. This work provides valuable insights for anyone looking to build large-scale materials databases.

If you'd like to refer to Matbench Discovery in a publication, please cite the preprint:

Janosh Riebesell, Rhys E. A. Goodall, Philipp Benner, Yuan Chiang, Bowen Deng, Alpha A. Lee, Anubhav Jain, and Kristin A. Persson. "Matbench Discovery -- A Framework to Evaluate Machine Learning Crystal Stability Predictions." arXiv, August 28, 2023. https://doi.org/10.48550/arXiv.2308.14920.

We welcome new models additions to the leaderboard through GitHub PRs. See the contributing guide for details and ask support questions via GitHub discussion.

For detailed results and analysis, check out the preprint.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

matbench_discovery-1.3.1.tar.gz (44.1 kB view details)

Uploaded Source

Built Distribution

matbench_discovery-1.3.1-py2.py3-none-any.whl (36.0 kB view details)

Uploaded Python 2 Python 3

File details

Details for the file matbench_discovery-1.3.1.tar.gz.

File metadata

  • Download URL: matbench_discovery-1.3.1.tar.gz
  • Upload date:
  • Size: 44.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.12.4

File hashes

Hashes for matbench_discovery-1.3.1.tar.gz
Algorithm Hash digest
SHA256 431f3ce3f7f8ad42cd4105b9f6c5e8727c9e0a947d343f5ed15cfedda6c3dbda
MD5 e10eb26c285136f693d1ba442560ba8f
BLAKE2b-256 c0e9c536734e580bd1226249f3b9219c12d5eecf2c61036779369cb46f74eac1

See more details on using hashes here.

File details

Details for the file matbench_discovery-1.3.1-py2.py3-none-any.whl.

File metadata

File hashes

Hashes for matbench_discovery-1.3.1-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 5d744f2c6dd1760a6b2b0421d7d677206f9f9838574c4d03db43fc8260158914
MD5 511b2ec734c4ec8851e3b0083ed8364d
BLAKE2b-256 647a86d45860f25da1a950d72d1dbca28068d2f2f7016af1fd91388eeb5ed120

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page