🎇NEWS!!!🎇
Our paper has been recently accepted by Advanced Science (impact factor = 17.5).
Please see the published version here or the arXiv version there.
This is the official code for ProtMD, a novel pre-training method based on the trajectories of protein-ligand pairs generated by molecular dynamics (MD) simulations. ProtMD can be divided into two stages: first is to pre-train the molecule encoder, and then transfer it to the downstream tasks with fine-tuning or linear-probing. This research is highly supported by MindrankAI, a pioneering AI-based drug discovery company located in Hangzhou, China.
Below is the basic running environment.
python==3.9.10
torch==1.10.2+cu113
Start by setting up a virtual environment.
conda create -n md python=3.9
conda install pytorch torchvision torchaudio cudatoolkit=11.3 -c pytorch
pip install einops
source activate md
# for visualization
pip install pandas matplotlib seaborn scipy
pip install -U scikit-learn
We use the MD data as the pretraining data source. Unfortunately, the MD data is currently not publicly available since the data provider MindrankAI does not agree to make it open. However, we offer a very detailed description on how to produce the MD trajectories independently. The following programs or packages are convenient ways to process the MD trajectories.
[1] GROMACS: First download the zipped file and then install GROMACS following this instruction.
[2] MDanalysis: MDanalysis is highly recommended. You can master it quickly by reading this tutorial.
conda install -c conda-forge mdanalysis`
conda install -c conda-forge MDAnalysisTests` (for sample data)
[3] mdtraj: mdtraj is another convenient package to process MD trajectories.
conda install -c conda-forge mdtraj
[4] VMD: VMD can be leveraged to visualize the MD trajectories easily.
First you need to register and download VMD. Then load the MD trajectories (.xtc
file) into VMD along with its conformation (.gro
).
At last, you have to save the trajectories (.pdb
file) all at once.
We use the well-curated dataset provided by Atom3d [1].
First you have to install atom3D by pip install atom3d
. Next, just download
split-by-sequence-identity-30
and split-by-sequence-identity-60
datasets from https://www.atom3d.ai/
.
Later, preprocess the data by running:
python pdbbind/dataloader_pdb.py
Attention!
The 60% identity split is changed in Atom3d [1] official data source. The latest sizes of training and test
sizes are 3563 and 452. However, as we followed the results of HoloProt [2], which used th original splits of atom3d with 60%
identity. It is necessary to find the previous-version splits, which is available in HoloProt's github:
https://github.com/vsomnath/holoprot . The training, validaition and test have 3678, 460 and 460 samples, respectively.
Then just use the index in identity60_split.json
file to split the PDBbind dataset.
Updated! The author of HoloProt [2] told me that 'Indeed there were some pdb files missing - some of them were just corrupted and surface associated binaries could not be used on them, so they were left out. But I did notice that the test set had only a couple of files missing and decided to train the models on a limited training set.' Therefore, it means the dataset used by HoloProt has some problems.
For ligand efficacy prediction task, we also utilize the dataset offered by ATOM3D [1]. You have to download the corresponding data from https://zenodo.org/record/4914734.
To verify the generalization capability of ProtMD, we test it on the predicted structures that is docked by EquiBind [3]. The Equibind preprocessed dataset is here.
There are several implementations and reproductions of diverse methods for the binding affinity prediction task and the ligand efficacy task. We mainly refer to three papers published in top AI conferences, containing ATOM3D [1], HoloProt [2], and MXMNet [4].
We use four GPUs to pretrain the geometric neural networks.
python pretrain.py --gpu=0,1,2,3
After the pretraining, it is time to use the pretrained model weight as the initialization for a wide variety of specific problems.
Run the following script to test the effectiveness of ProtMD in downstream tasks. You ought to set pretrain
as the path to get access to
the saved model parameters. You can also choose the argument data
from [lba
, lep
] to
select different tasks, including ligand binding affinity prediction (lba
) and ligand efficacy prediction (lep
).
You can also add the argument linear_probe
to only tune the final output layer.
python main.py --data=lba --split=30 --linear_probe --pretrain=model.pt --gpu=0,1,2,3
Here we provide some interesting content that may be helpful for people who are new to GPU parallel, which is necessary for a fast and efficient pretraining on especially a large protein dataset. This tutorial provides a comprehensive overview of multi-GPU training on a single node with mainstream deep learning frameworks, such as Pytorch, Tensorflow and Keras.
# a Chinese introduction to distributed training:https://zhuanlan.zhihu.com/p/86441879
torch.distributed.init_process_group(backend='nccl', init_method='tcp://localhost:23456', rank=0, world_size=1)
# note the difference between nn.DistributedDataParallel and nn.DataParallel
https://discuss.pytorch.org/t/dataparallel-vs-distributeddataparallel/77891/4
# some outputs fail to participate in the backpropagation:https://github.com/pytorch/pytorch/issues/43259#
model = DistributedDataParallel(model, device_ids=[int(x) for x in args.gpu.split(',')], find_unused_parameters=True)
Apex is a more flexible framework for mixed precision and distributed training in Pytorch. The github website is here. The main API for parallel training is here. A simple example for training ResNet with Apex is here.
Someone may encounter a problem, where the pytorch works well with 4 GPUs but is stuck with 2-GPU parallel.
Some blogs reporing the similar issue:
https://discuss.pytorch.org/t/distrubuteddataparallel-and-dataparallel-hangs-in-specified-model/74322.
This person resolve the problem by adopting AMP, but it does not work for me.
https://discuss.pytorch.org/t/dataparallel-and-distributeddataparallel-stuck-at-100-gpu-usage/125490/6.
Someone recommends using DistributedDataParalle, but it still fails for me.
https://discuss.pytorch.org/t/nn-dataparallel-gets-stuck/125427/7.
A potential solution: https://github.com/pytorch/pytorch/issues/1637#issuecomment-338268158.
If you are interested in our work and recognize our contributions, please cite it!
Also, please do not hesitate to email me (fw2359@columbia.edu) immediately if you have any sort of questions or
fancy points that deserve further communication.
@article{wu2022pre,
title={Pre-training of Deep Protein Models with Molecular Dynamics Simulations for Drug Binding},
author={Wu, Fang and Zhang, Qiang and Radev, Dragomir and Wang, Yuyang and Jin, Xurui and Jiang, Yinghui and Niu, Zhangming and Li, Stan Z},
journal={arXiv preprint arXiv:2204.08663},
year={2022}
}
[1]
Townshend, Raphael JL, et al. "Atom3d: Tasks on molecules in three dimensions." arXiv preprint arXiv:2012.04035 (2020).
[2]
Somnath, Vignesh Ram, Charlotte Bunne, and Andreas Krause. "Multi-scale representation learning on proteins." Advances in Neural Information Processing Systems 34 (2021): 25244-25255.
[3]
Stärk, Hannes, et al. "Equibind: Geometric deep learning for drug binding structure prediction." International Conference on Machine Learning. PMLR, 2022.
[4]
Zhang, Shuo, Yang Liu, and Lei Xie. "Molecular mechanics-driven graph neural network with multiplex graph for molecular structures." arXiv preprint arXiv:2011.07457 (2020).