Deep generative models such as generative adversarial networks, variational autoencoders, and autoregressive models are rapidly growing in popularity for the discovery of new molecules and materials. In this work, we introduce MOlecular SEtS (MOSES), a benchmarking platform to support research on machine learning for drug discovery. MOSES implements several popular molecular generation models and includes a set of metrics that evaluate the diversity and quality of generated molecules. MOSES is meant to standardize the research on molecular generation and facilitate the sharing and comparison of new models. Additionally, we provide a large-scale comparison of existing state of the art models and elaborate on current challenges for generative models that might prove fertile ground for new research. Our platform and source code are freely available here.
For more details, please refer to the paper.
We propose a benchmarking dataset refined from the ZINC database.
The set is based on the ZINC Clean Leads collection. It contains 4,591,276 molecules in total, filtered by molecular weight in the range from 250 to 350 Daltons, a number of rotatable bonds not greater than 7, and XlogP less than or equal to 3.5. We removed molecules containing charged atoms or atoms besides C, N, S, O, F, Cl, Br, H or cycles longer than 8 atoms. The molecules were filtered via medicinal chemistry filters (MCFs) and PAINS filters.
The dataset contains 1,936,962 molecular structures. For experiments, we also provide a training, test and scaffold test sets containing 250k, 10k, and 10k molecules respectively. The scaffold test set contains unique Bemis-Murcko scaffolds that were not present in the training and test sets. We use this set to assess how well the model can generate previously unobserved scaffolds.
- Character-level Recurrent Neural Network (CharRNN)
- Variational Autoencoder (VAE)
- Adversarial Autoencoder (AAE)
- Objective-Reinforced Generative Adversarial Network (ORGAN)
- Junction Tree Variational Autoencoder (JTN-VAE)
Besides standard uniqueness and validity metrics, MOSES provides other metrics to access the overall quality of generated molecules. Fragment similarity (Frag) and Scaffold similarity (Scaff) are cosine distances between vectors of fragment or scaffold frequencies correspondingly of the generated and test sets. Nearest neighbor similarity (SNN) is the average similarity of generated molecules to the nearest molecule from the test set. Internal diversity (IntDiv) is an average pairwise similarity of generated molecules. Fréchet ChemNet Distance (FCD) measures the difference in distributions of last layer activations of ChemNet.
Model | Valid (↑) | Unique@1k (↑) | Unique@10k (↑) | FCD (↓) | SNN (↓) | Frag (↑) | Scaff (↑) | IntDiv (↑) | Filters (↑) | ||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Test | TestSF | Test | TestSF | Test | TestSF | Test | TestSF | ||||||
CharRNN | 0.9598 | 1.0000 | 0.9993 | 0.3233 | 0.8355 | 0.4606 | 0.4492 | 0.9977 | 0.9962 | 0.7964 | 0.1281 | 0.8561 | 0.9920 |
VAE | 0.9528 | 1.0000 | 0.9992 | 0.2540 | 0.6959 | 0.4684 | 0.4547 | 0.9978 | 0.9963 | 0.8277 | 0.0925 | 0.8548 | 0.9925 |
AAE | 0.9341 | 1.0000 | 1.0000 | 1.3511 | 1.8587 | 0.4191 | 0.4113 | 0.9865 | 0.9852 | 0.6637 | 0.1538 | 0.8531 | 0.9759 |
ORGAN | 0.8731 | 0.9910 | 0.9260 | 1.5748 | 2.4306 | 0.4745 | 0.4593 | 0.9897 | 0.9883 | 0.7843 | 0.0632 | 0.8526 | 0.9934 |
JTN-VAE | 1.0000 | 0.9980 | 0.9972 | 4.3769 | 4.6299 | 0.3909 | 0.3902 | 0.9679 | 0.9699 | 0.3868 | 0.1163 | 0.8495 | 0.9566 |
For comparison of molecular properties, we computed the Frèchet distance between distributions of molecules in the generated and test sets. Below, we provide plots for lipophilicity (logP), Synthetic Accessibility (SA), Quantitative Estimation of Drug-likeness (QED), Natural Product-likeness (NP) and molecular weight.
logP | SA |
---|---|
NP | QED |
weight | |
-
Install docker and nvidia-docker.
-
Pull an existing image (4.1Gb to download) from DockerHub:
docker pull molecularsets/moses
or clone the repository and build it manually:
git clone https://github.com/molecularsets/moses.git
nvidia-docker image build --tag molecularsets/moses moses/
- Create a container:
nvidia-docker run -it --name moses --network="host" --shm-size 1G molecularsets/moses
- The dataset and source code are available inside the docker container at /moses:
docker exec -it molecularsets/moses bash
Alternatively, install dependencies and MOSES manually.
- Clone the repository:
git lfs install
git clone https://github.com/molecularsets/moses.git
-
Install RDKit for metrics calculation.
-
Install MOSES:
python setup.py install
-
Install MOSES as described in the previous section.
-
Calculate metrics for the trained model:
python scripts/metrics/eval.py --ref_path <reference dataset> --gen_path <generated dataset>
python scripts/train.py <model name> \
--train_load <train dataset> \
--model_save <path to model> \
--config_save <path to config> \
--vocab_save <path to vocabulary>
To get a list of supported models run python scripts/train.py --help
.
For more details of certain model run python scripts/train.py <model name> --help
.
python scripts/sample.py <model name> \
--model_load <path to model> \
--vocab_load <path to vocabulary> \
--config_load <path to config> \
--n_samples <number of samples> \
--gen_save <path to generated dataset>
To get a list of supported models run python scripts/sample.py --help
.
For more details of certain model run python scripts/sample.py <model name> --help
.
python scripts/metrics/eval.py \
--ref_path <reference dataset> \
--gen_path <generated dataset>
For more details run python scripts/metrics/eval.py --help
.
You can run pretty much everything with:
python scripts/run.py
This will split the dataset, train the models, generate new molecules, and calculate the metrics. Evaluation results will be saved in metrics.csv
.
You can specify the GPU index (-1 for CPU) and/or model by running:
python scripts/run.py --gpu 1 --model aae
For more details run python scripts/run.py --help
.