/GNNImplicitSolvent

Implicit Solvent Approach Based on Generalised Born and Transferable Graph Neural Networks for Molecular Dynamics Simulations

Primary LanguageJupyter NotebookMIT No AttributionMIT-0

GNNImplicitSolvent

Publications

[2] Chem. Sci., 2024, DOI: https://doi.org/10.1039/D4SC02432J

[1] J. Chem. Phys. 158, 204101 (2023), DOI: https://doi.org/10.1063/5.0147027

Abstract

[2] The dynamical behavior of small molecules in their environment can be studied with classical molecular dynamics (MD) simulations to gain deeper insight on an atomic level and thus complement and rationalize the interpretation of experimental findings. Such approaches are of great value in various areas of research, e.g., in the development of new therapeutics. The accurate description of solvation effects in such simulations is thereby key and has in consequence been an active field of research since the introduction of MD. So far, the most accurate approaches involve computationally expensive explicit solvent simulations, while widely applied models using an implicit solvent description suffer from reduced accuracy. Recently, machine learning (ML) approaches that provide a probabilistic representation of solvation effects have been proposed as potential alternatives. However, the associated computational costs and minimal or lack of transferability render them unusable in practice. Here, we report the first example of a transferable ML-based implicit solvent model trained on a diverse set of 3 000 000 molecular structures that can be applied to organic small molecules for simulations in water. Extensive testing against reference calculations demonstrated that the model delivers on par accuracy with explicit solvent simulations while providing an up to 18-fold increase in sampling rate.

[1] Molecular dynamics (MD) simulations enable the study of the motion of small and large (bio)molecules and the estimation of their conformational ensembles. The description of the environment (solvent) has thereby a large impact. Implicit solvent representations are efficient but in many cases not accurate enough (especially for polar solvents such as water). More accurate but also computationally more expensive is the explicit treatment of the solvent molecules. Recently, machine learning (ML) has been proposed to bridge the gap and simulate in an implicit manner explicit solvation effects. However, the current approaches rely on prior knowledge of the entire conformational space, limiting their application in practice. Here, we introduce a graph neural network (GNN) based implicit solvent that is capable of describing explicit solvent effects for peptides with different composition than contained in the training set.

Data

[2] Data is available at doi: 10.3929/ethz-b-000667722

[1] Data is available at doi: 10.3929/ethz-b-000599309

Installation

For the exact environment composition used in publication [2] the environment.yml is provided. It can be installed with conda or mamba.

mamba env create -n GNNimplicit -f environment.yml

In case this fails (e.g., if a different operating system is used) or other packages are required the authors recommend to install pytorch and pytorch geometric first following the installation recomondations of pytorch and pytorch geometric. In addition the libraries torch-cluster, torch-sparse, and torch-scatter should be installed (pip is recommended).

Additional packagaes listed in the environment.yml can be installed using conda or mamba.

USAGE

Simulations

To run an implicit solvent simulation using the GNN as a solvent the Multi_simulator class can be used. An example is shown in file run_gnn_simulation.py. The necessary input is only the molecules SMILES (-s), the desired simulation time in ns (-ns), the number of parallel simulations (-nr), the random seed of the run (-r), and the path to the trained GNN (-m):

python run_gnn_simulation.py -s CCCO -ns 0.1 -nr 20 -r 1234 -m ../MachineLearning/trained_models/GNN.model

One pretrained GNN is provided in this repository GNN.model.

To run simulations using explicit solvent or GBNeck2 simulations as performed in publication [2] the run_simulation_for_small_molecules.py script can be used following the instructions as described in the file.

python run_simulation_for_small_molecules.py --help

Force Extraction

The complete dataset used in study [2] can be downloaded from the ETH Research Collection. In order to extract forces for new compounds or conformations the run_data_generation.py script can be used. By default the script stores all results in an hdf5 file. For easy access of a small number of results the user can also run the script with the --return_numpy_files flag, which will print the location of the stored positions and forces as numpy arrays.

Machine Learning

The training and test set used in this study [2] can be downloaded from the ETH Research Collection. A new model can be trained using the train_model.py and tested using the test_model.py scripts. To train a model with the same architecture as used in this study one could use the following command:

python train_model.py -b 32 -p 0.95 -f 0.1 -r 161311 -ra 0.6 -l 0.0005 -fpt datasets/train_set.pt -e 30 -m 64 -c 1.0

Analysis

Two examples for the analysis of the provided model and data are provided. For analysing the performance of a trained GNN the ForcePrediction.ipynb notebook can be used. For analysing trajectories the AnalysisExample.ipynb can be used.