Skip to main content

MatGL (Materials Graph Library) is a framework for graph deep learning for materials science.

Project description

Introduction

MatGL (Materials Graph Library) is a graph deep learning library for materials. Mathematical graphs are a natural representation for a collection of atoms (e.g., molecules or crystals). Graph deep learning models have been shown to consistently deliver exceptional performance as surrogate models for the prediction of materials properties.

In this repository, we have reimplemented the 3-body MatErials Graph Network (m3gnet) and its predecessors, MEGNet using the Deep Graph Library (DGL). The goal is to improve the usability, extensibility and scalability of these models. The original M3GNet and MEGNet were implemented in TensorFlow.

This effort is a collaboration between the Materials Virtual Lab and Intel Labs (Santiago Miret, Marcel Nassar, Carmelo Gonzales).

Status

Feb 16 2023: Both initial implementations of M3GNet and MEGNet architectures have been completed. Expect bugs!

References

Please cite the following works:

  • MEGNET
    Chen, C.; Ye, W.; Zuo, Y.; Zheng, C.; Ong, S. P. Graph Networks as a Universal Machine Learning Framework for
    Molecules and Crystals. Chem. Mater. 2019, 31 (9), 3564–3572. https://doi.org/10.1021/acs.chemmater.9b01294.
    
  • M3GNet
    Chen, C., Ong, S.P. A universal graph deep learning interatomic potential for the periodic table. Nat Comput Sci,
    2, 718–728 (2022). https://doi.org/10.1038/s43588-022-00349-3.
    

Acknowledgements

This work was primarily supported by the Materials Project, funded by the U.S. Department of Energy, Office of Science, Office of Basic Energy Sciences, Materials Sciences and Engineering Division under contract no. DE-AC02-05-CH11231: Materials Project program KC23MP. This work used the Expanse supercomputing cluster at the Extreme Science and Engineering Discovery Environment (XSEDE), which is supported by National Science Foundation grant number ACI-1548562.

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

matgl-0.1.0.dev0.tar.gz (152.7 kB view details)

Uploaded Source

Built Distribution

matgl-0.1.0.dev0-py3-none-any.whl (157.7 kB view details)

Uploaded Python 3

File details

Details for the file matgl-0.1.0.dev0.tar.gz.

File metadata

  • Download URL: matgl-0.1.0.dev0.tar.gz
  • Upload date:
  • Size: 152.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.9.13

File hashes

Hashes for matgl-0.1.0.dev0.tar.gz
Algorithm Hash digest
SHA256 f11916f5a08a6dda34a577e96f0f4b90570e39c2e1ec320b9327ea063f6f0d1a
MD5 c502386e8674dfd6f05b03e29810ce2d
BLAKE2b-256 d90a7412126c19a1443b430ebb06f97f8f7cf95dc99db2a266617d83ae094c2c

See more details on using hashes here.

File details

Details for the file matgl-0.1.0.dev0-py3-none-any.whl.

File metadata

  • Download URL: matgl-0.1.0.dev0-py3-none-any.whl
  • Upload date:
  • Size: 157.7 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.9.13

File hashes

Hashes for matgl-0.1.0.dev0-py3-none-any.whl
Algorithm Hash digest
SHA256 6432934f66865a8d7206c7a982e621e42fa3a60377fff681d2e1438226f1d325
MD5 585aed3af14ee902b5d466529d9ab3dc
BLAKE2b-256 a7b17c8636b7b8e4725f1b540ea5f30c37341b2755e84286e45aab0326b36430

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