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 a high-throughput discovery campaign for new stable inorganic crystals.

We've tested models covering multiple methodologies ranging from random forests with structure fingerprints to graph neural networks, from one-shot predictors to iterative Bayesian optimizers and interatomic potential relaxers.

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:

Riebesell, Janosh, 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.

If you're interested in joining this work, please reach out via GitHub discussion or email.

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.0.tar.gz (44.1 kB view details)

Uploaded Source

Built Distribution

matbench_discovery-1.3.0-py2.py3-none-any.whl (35.9 kB view details)

Uploaded Python 2 Python 3

File details

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

File metadata

  • Download URL: matbench_discovery-1.3.0.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.0.tar.gz
Algorithm Hash digest
SHA256 7ee0a49c22f12a56d2ce732fc1710cd2475b2d81cd984b9a450b936057a62fc0
MD5 8449a64202cf4fb2f8b83e55150a1428
BLAKE2b-256 90f77e6f2bea2e4fcc2c68fba9777f7cdd694dfd1e6813666f1d0260e362006e

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for matbench_discovery-1.3.0-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 94f7094f534c3f783b8cb5fc2aa778517e6a3a0690010ef00d4950b990449c86
MD5 c585081b34a8ffeac835ebec6bb88aa8
BLAKE2b-256 4eb31d3e71eb11d11a1958219a04dd76c55cf6d61697ac6436f71833ba2071fe

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