Skip to content

Chemically-Informed Large-scale Inorganic Nanomaterials Dataset for Advancing Graph Machine Learning

License

Notifications You must be signed in to change notification settings

UlrikFriisJensen/CHILI

Repository files navigation

arXiv

CHILI: Chemically-Informed Large-scale Inorganic Nanomaterials Dataset for Advancing Graph Machine Learning

Ulrik Friis-Jensen $^{1,2,†}$, Frederik L. Johansen $^{1,2,†}$, Andy S. Anker $^{3,4}$, Erik B. Dam $^{2}$, Kirsten M. Ø. Jensen $^{1}$, Raghavendra Selvan $^{2}$

1: Department of Chemistry, University of Copenhagen, Denmark

2: Department of Computer Science, University of Copenhagen, Denmark

3: Department of Energy Conversion and Storage, Technical University of Denmark, Denmark

4: Department of Chemistry, University of Oxford, United Kingdom

† Both authors contributed equally to this research.

Abstract

Advances in graph machine learning (ML) have been driven by applications in chemistry as graphs have remained the most expressive representations of molecules. This has led to progress within both fields, as challenging chemical data has helped improve existing methods and to develop new ones. While early graph ML methods focused primarily on small organic molecules, more recently, the scope of graph ML has expanded to include inorganic materials. Modelling the periodicity and symmetry of inorganic crystalline materials poses unique challenges, which existing graph ML methods are unable to immediately address. Moving to inorganic nanomaterials further increases complexity as the scale of number of nodes within each graph can be broad ($10$ to $10^5$).

In addition, the bulk of existing graph ML focuses on characterising molecules and materials by predicting target properties with graphs as input. The most exciting applications of graph ML will be in their generative capabilities, in order to explore the vast chemical space from a data-driven perspective. Currently, generative modelling of graphs is not at par with other domains such as images or text, as generating chemically valid molecules and materials of varying properties is not straightforward.

In this work, we invite the graph ML community to address these open challenges by presenting two new chemically-informed large-scale inorganic (CHILI) nanomaterials datasets. These datasets contain nanomaterials of different scales and properties represented as graphs of varying sizes. The first dataset is a medium-scale dataset (with overall >6M nodes, >49M edges) of mono-metallic oxide nanomaterials generated from 12 selected crystal types (CHILI-3K). This dataset has a narrower chemical scope focused on an interesting part of chemical space with a lot of active research. The second is a large-scale dataset (with overall >183M nodes, >1.2B edges) of nanomaterials generated from experimentally determined crystal structures (CHILI-100K). The crystal structures used in CHILI-100K are obtained from a curated subset from the Crystallography Open Database (COD) and has a broader chemical scope covering database entries for 68 metals and 11 non-metals. We define 11 property prediction tasks covering node-, edge-, and graph- level tasks that span classification and regression. In addition we also define structure prediction tasks, which are of special interest for nanomaterial research. We benchmark the performance of a wide array of baseline methods starting with simple baselines to multiple off-the-shelf graph neural networks. Based on these benchmarking results, we highlight areas which need future work to achieve useful performance for applications in (nano)materials chemistry. To the best of our knowledge, CHILI-3K and CHILI-100K are the first open-source nanomaterial datasets of this scale -- both on the individual graph level and of the dataset as a whole -- and the only nanomaterials datasets with high structural and elemental diversity.

Data access

Access via CHILI dataset class

The CHILI datasets can be accessed using the provided dataset class, which can be found here.
Ensure that you have the following packages installed before attempting to use the dataset class:

  1. PyTorch                    (https://pytorch.org/get-started/locally/)
  2. PyTorch Geometric  (https://pytorch-geometric.readthedocs.io/en/latest/install/installation.html)
  3. h5py                         (https://docs.h5py.org/en/stable/build.html)
  4. pandas                     (https://pandas.pydata.org/docs/getting_started/install.html)

Initialising the dataset class, like

dataset_object = CHILI(root = 'dataset', dataset = 'CHILI-3K')

will automatically download and correctly unpack the CHILI-3K dataset into .pt files containing PyTorch Geometric Data objects. The raw data is stored in .h5 files, with each file containing all 5 sizes of nanoparticles generated from the same crystalline material. All data will be stored in the specified root directory, here dataset.

We have provided an example in this Python file as well as this Jupyter Notebook with more details on how to use the CHILI dataset class to train a basic GCN model on distance regression.

Direct download

Click on the following hyperlinks to directly download the raw data for CHILI-3K and CHILI-100K.

Cite

Kindly cite our publication if you use the dataset or any part of the code:

@misc{friisjensen2024chili,
      title={CHILI: Chemically-Informed Large-scale Inorganic Nanomaterials Dataset for Advancing Graph Machine Learning}, 
      author={Ulrik Friis-Jensen and Frederik L. Johansen and Andy S. Anker and Erik B. Dam and Kirsten M. Ø. Jensen and Raghavendra Selvan},
      year={2024},
      month={February},
      note={arXiv preprint arXiv:2402.13221]
}

About

Chemically-Informed Large-scale Inorganic Nanomaterials Dataset for Advancing Graph Machine Learning

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages