Official PyTorch-based implementation in the paper Chemical Structure-Aware Molecular Image Representation Learning, which is a simple and effective Contrastive Graph-Image Pre-training (CGIP) framework for molecular representation learning.
[2023/10/20] Accepted in Briefings in Bioinformatics.
[2022/11/17] Repository installation completed.
Current methods of molecular image-based drug discovery face two major challenges: 1) work effectively in absence of labels, 2) capture chemical structure from implicitly encoded images. Given that chemical structures are explicitly encoded by molecular graphs (such as nitrogen, benzene rings and double bonds), we leverage self-supervised contrastive learning to transfer chemical knowledge from graphs to images. Specifically, we propose a novel Contrastive Graph-Image Pre-training (CGIP) framework for molecular representation learning, which learns explicit information in graphs and implicit information in images from large-scale unlabeled molecules via carefully designed intra- and inter-modal contrastive learning. We evaluate the performance of CGIP on multiple experimental settings (molecular property prediction, cross-modal retrieval and distribution similarity), and the results show that CGIP can achieve state-of-the-art performance on all 12 benchmark datasets and demonstrate that CGIP transfers chemical knowledge in graphs to molecular images, enabling image encoder to perceive chemical structures in images. We hope this simple and effective framework will inspire people to think about the value of image for molecular representation learning.
CUDA 10.1
Ubuntu 18.04
conda create -n CGIP python=3.7.3
source activate CGIP
conda install -c rdkit rdkit
conda install pytorch==1.6.0 torchvision==0.7.0 cudatoolkit=10.1 -c pytorch
pip install torch-cluster torch-scatter torch-sparse torch-spline-conv -f https://pytorch-geometric.com/whl/torch-1.6.0%2Bcu101.html
pip install torch-geometric==1.6.0
pip install dgl-cu101
pip install ogb
pip install tensorboard
pip install -r requirements.txtYou can download pretraining data and push it into the folder datasets/pre-training/.
The data root should be as follows:
├─[dataroot]
│ └─[dataset]
│ | ├─raw
│ | └── [dataset].csvpython ./dataloader/initialize_dual_dataset.py --dataroot {your dataroot} --dataset {your dataset}
# you can use the following code for pre-training the downloaded data:
python ./dataloader/initialize_dual_dataset.py --dataroot ./datasets/pre-training/ --dataset dataYou can run code to generate toy data:
python ./dataloader/initialize_dual_dataset.py --dataroot ./datasets/pre-training/ --dataset toyAfter executing this command, the structure of data root is changed to:
├─[dataroot]
│ └─[dataset]
│ | ├─raw
│ | └── [dataset].csv
│ | ├─processed # this folder is newly created.
│ | ├── 224
│ | | └── 1.png
│ | | └── 2.png
│ | | └── ...
│ | └── geometric_data_processed.pt
│ | └── [dataset]_processed_ac.csvUsage:
usage: pretrain_cgip.py [-h] [--dataset DATASET] [--dataroot DATAROOT]
[--n_device N_DEVICE] [--gpu GPU] [--workers WORKERS]
[--lr LR] [--weight_decay WEIGHT_DECAY]
[--num_layers NUM_LAYERS] [--t_dropout T_DROPOUT]
[--feat_dim FEAT_DIM]
[--pretrained_pth PRETRAINED_PTH]
[--load_optim_scheduler] [--seed SEED]
[--epochs EPOCHS] [--start_epoch START_EPOCH]
[--batch BATCH] [--resume PATH]
[--imageSize IMAGESIZE] [--image_model IMAGE_MODEL]
[--temperature TEMPERATURE]
[--base_temperature BASE_TEMPERATURE]
[--lr_decay_epoch LR_DECAY_EPOCH]
[--graph_aug GRAPH_AUG]
[--graph_aug_ratio GRAPH_AUG_RATIO]
[--n_ckpt_save N_CKPT_SAVE]
[--n_batch_step_optim N_BATCH_STEP_OPTIM]
[--n_sub_checkpoints_each_epoch N_SUB_CHECKPOINTS_EACH_EPOCH]
[--log_dir LOG_DIR]Code to pretrain CGIP framework:
pretrain_cgip.py --dataroot ./datasets/pre-training/ \
--dataset data \
--batch 512 \
--num_layers 14 \
--t_dim 512 \
--temperature 0.1 \
--base_temperature 0.1 \
--lr 0.01 \
--graph_aug none+dropN+permE+maskN \
--lr_decay_epoch 1 \
--epochs 10 \
--workers 3 \
--n_batch_step_optim 1 \
--n_sub_checkpoints_each_epoch 4 \
--log_dir ./experiments/pretrain_cgip/For convenience, you can execute pre-training code using toy dataset, as following:
python pretrain_cgip.py --dataroot ./datasets/pre-training --dataset toy --epochs 10 --batch 8 --graph_aug none+dropN+permE+maskN --log_dir ./experiments/pretrain_cgip_on_toy/ --n_sub_checkpoints_each_epoch 0Download pre-trained model and push it into the folder ckpts/
Download molecular property prediction datasets and push them into the folder datasets/fine-tuning/
Usage of CGIP-DeeperGCN:
usage: finetune_deepergcn.py [-h] [--dataroot DATAROOT] [--dataset DATASET]
[--workers WORKERS] [--batch BATCH]
[--add_virtual_node] [--graph_aug GRAPH_AUG]
[--graph_aug_ratio GRAPH_AUG_RATIO] [--use_gpu]
[--device DEVICE] [--epochs EPOCHS] [--seed SEED]
[--lr LR] [--dropout DROPOUT]
[--grad_clip GRAD_CLIP] [--split_path SPLIT_PATH]
[--save_finetune_ckpt {0,1}]
[--num_layers NUM_LAYERS]
[--mlp_layers MLP_LAYERS]
[--hidden_channels HIDDEN_CHANNELS]
[--block BLOCK] [--conv CONV]
[--gcn_aggr GCN_AGGR] [--norm NORM]
[--num_tasks NUM_TASKS] [--runseed RUNSEED]
[--t T] [--p P] [--learn_t] [--learn_p] [--y Y]
[--learn_y] [--msg_norm] [--learn_msg_scale]
[--conv_encode_edge]
[--graph_pooling GRAPH_POOLING]
[--log_dir LOG_DIR] [--resume PATH]
[--task_type {classification,regression}]Usage of CGIP-ResNet18:
usage: finetune_resnet18.py [-h] [--dataset DATASET] [--dataroot DATAROOT]
[--use_gpu] [--device DEVICE] [--workers WORKERS]
[--lr LR] [--weight_decay WEIGHT_DECAY]
[--momentum MOMENTUM] [--runseed RUNSEED]
[--epochs EPOCHS] [--start_epoch START_EPOCH]
[--batch BATCH] [--resume PATH]
[--imageSize IMAGESIZE] [--image_aug]
[--task_type {classification,regression}]
[--save_finetune_ckpt {0,1}] [--log_dir LOG_DIR]For examples, you can run the following code to fine-tune:
-
CGIP-DeeperGCN:
python finetune_deepergcn.py --dataroot ./datasets/fine-tuning/ --dataset bbbp --resume ./ckpts/CGIP.pth --lr 0.005 --batch 16 --epochs 60 --runseed 0 --task_type classification --log_dir ./experiments/graph/ --use_gpu --device 0
-
CGIP-ResNet18:
python finetune_resnet18.py --dataroot ./datasets/fine-tuning/ --dataset bbbp --resume ./ckpts/CGIP.pth --lr 0.005 --batch 16 --epochs 60 --image_aug --runseed 0 --task_type classification --log_dir ./experiments/image/ --use_gpu --device 0
To ensure the reproducibility of CGIP, we provided finetuned models for eight datasets, including:
| No | Datasets | CGIP-DeeperGCN | CGIP-ResNet18 |
|---|---|---|---|
| 1 | BACE | cgip-deepergcn-bace.pth | cgip-resnet18-bace.pth |
| 2 | BBBP | cgip-deepergcn-bbbp.pth | cgip-resnet18-bbbp.pth |
| 3 | ClinTox | cgip-deepergcn-clintox.pth | cgip-resnet18-clintox.pth |
| 4 | Estrogen | cgip-deepergcn-estrogen.pth | cgip-resnet18-estrogen.pth |
| 5 | MetStab | cgip-deepergcn-metstab.pth | cgip-resnet18-metstab.pth |
| 6 | Sider | cgip-deepergcn-sider.pth | cgip-resnet18-sider.pth |
| 7 | Tox21 | cgip-deepergcn-tox21.pth | cgip-resnet18-tox21.pth |
| 8 | ToxCast | cgip-deepergcn-toxcast.pth | cgip-resnet18-toxcast.pth |
Usage of CGIP-DeeperGCN:
usage: evaluate_deepergcn.py [-h] [--dataroot DATAROOT] [--dataset DATASET]
[--workers WORKERS] [--batch BATCH]
[--add_virtual_node] [--graph_aug GRAPH_AUG]
[--graph_aug_ratio GRAPH_AUG_RATIO] [--use_gpu]
[--device DEVICE] [--epochs EPOCHS] [--seed SEED]
[--lr LR] [--dropout DROPOUT]
[--grad_clip GRAD_CLIP] [--split_path SPLIT_PATH]
[--save_finetune_ckpt {0,1}]
[--num_layers NUM_LAYERS]
[--mlp_layers MLP_LAYERS]
[--hidden_channels HIDDEN_CHANNELS]
[--block BLOCK] [--conv CONV]
[--gcn_aggr GCN_AGGR] [--norm NORM]
[--num_tasks NUM_TASKS] [--runseed RUNSEED]
[--t T] [--p P] [--learn_t] [--learn_p] [--y Y]
[--learn_y] [--msg_norm] [--learn_msg_scale]
[--conv_encode_edge]
[--graph_pooling GRAPH_POOLING]
[--log_dir LOG_DIR] [--resume PATH]
[--task_type {classification,regression}]Usage of CGIP-ResNet18:
usage: evaluate_resnet18.py [-h] [--dataset DATASET] [--dataroot DATAROOT]
[--use_gpu] [--device DEVICE] [--workers WORKERS]
[--batch BATCH] [--resume PATH]
[--imageSize IMAGESIZE] [--image_aug]
[--task_type {classification,regression}]You can evaluate the finetuned model by using the following command:
-
CGIP-DeeperGCN:
python evaluate_deepergcn.py --dataroot ./datasets/fine-tuning/ --dataset bbbp --task_type classification --resume ./ckpts/deepergcn/bbbp.pth --batch 32 --use_gpu --device 0
-
CGIP-ResNet18:
python evaluate_resnet18.py --dataroot ./datasets/fine-tuning/ --dataset bbbp --task_type classification --resume ./ckpts/resnet18/bbbp.pth --batch 32 --use_gpu --device 0
If you use CGIP in scholary publications, presentations or to communicate with your satellite, please cite the following work that presents the algorithms used:
@article{10.1093/bib/bbad404,
author = {Xiang, Hongxin and Jin, Shuting and Liu, Xiangrong and Zeng, Xiangxiang and Zeng, Li},
title = "{Chemical structure-aware molecular image representation learning}",
journal = {Briefings in Bioinformatics},
volume = {24},
number = {6},
pages = {bbad404},
year = {2023},
month = {11},
issn = {1477-4054},
doi = {10.1093/bib/bbad404},
url = {https://doi.org/10.1093/bib/bbad404},
eprint = {https://academic.oup.com/bib/article-pdf/24/6/bbad404/53471469/bbad404.pdf},
}
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent