{"id":22096171,"url":"https://github.com/aspirincode/alphappimd","last_synced_at":"2025-07-24T22:31:44.587Z","repository":{"id":224648934,"uuid":"618811678","full_name":"AspirinCode/AlphaPPImd","owner":"AspirinCode","description":"Exploring the conformational ensembles of protein-protein complexes with transformer-based generative neural networks","archived":false,"fork":false,"pushed_at":"2024-06-01T10:49:27.000Z","size":8362,"stargazers_count":15,"open_issues_count":0,"forks_count":2,"subscribers_count":2,"default_branch":"main","last_synced_at":"2024-06-01T19:45:56.844Z","etag":null,"topics":["ambertools","deep-generative-model","dockq","molecular-dynamics","openmm","ppi","protein-protein-complexes","transformers"],"latest_commit_sha":null,"homepage":"","language":"Jupyter Notebook","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/AspirinCode.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-03-25T12:28:03.000Z","updated_at":"2024-06-01T11:44:26.000Z","dependencies_parsed_at":"2024-05-29T07:24:37.205Z","dependency_job_id":null,"html_url":"https://github.com/AspirinCode/AlphaPPImd","commit_stats":null,"previous_names":["aspirincode/alphappimd"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AspirinCode%2FAlphaPPImd","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AspirinCode%2FAlphaPPImd/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AspirinCode%2FAlphaPPImd/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AspirinCode%2FAlphaPPImd/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/AspirinCode","download_url":"https://codeload.github.com/AspirinCode/AlphaPPImd/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":227482494,"owners_count":17779968,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ambertools","deep-generative-model","dockq","molecular-dynamics","openmm","ppi","protein-protein-complexes","transformers"],"created_at":"2024-12-01T04:09:50.777Z","updated_at":"2024-12-01T04:09:51.832Z","avatar_url":"https://github.com/AspirinCode.png","language":"Jupyter Notebook","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![License: MIT](https://img.shields.io/badge/License-MIT-yellow)](https://github.com/AspirinCode/DeepPPImd)\n[![bioRxiv](https://img.shields.io/badge/bioRxiv2024.02.24.581708-green)](https://doi.org/10.1101/2024.02.24.581708)\n[![bioRxiv](https://img.shields.io/badge/10.1021%2Facs.jctc.4c00255-pink)](https://doi.org/10.1021/acs.jctc.4c00255)\n\n\n# AlphaPPImd\n**Exploring the conformational ensembles of protein-protein complexes with transformer-based generative model**  \n\nProtein-protein interactions are the basis of many protein functions, and understanding the contact and conformational changes of protein-protein interactions is crucial for linking protein structure to biological function. Although difficult to detect experimentally, molecular dynamics (MD) simulations are widely used to study the conformational space and dynamics of protein-protein complexes, but there are significant limitations in sampling efficiency and computational costs. In this study, a generative neural network was trained on protein-protein complex conformations obtained from molecular simulations to directly generate new conformations with physical realism. We demonstrated the use of a deep learning model based on the transformer architecture to explore the conformational space of protein-protein complexes through MD simulations. The results showed that the learned latent space can be used to generate unsampled conformations of protein-protein complexes for obtaining new conformations complementing pre-existing ones, which can be used as an exploratory tool for the analysis and enhancement of molecular simulations of protein-protein complexes.\n\n\n## Framework of AlphaPPImd\n![Model Architecture of AlphaPPImd](https://github.com/AspirinCode/AlphaPPImd/blob/main/figure/DeepPPImd_framework.png)\n\n\n## Acknowledgements\nWe thank the authors of Molecular dynamics without molecules: searching the conformational space of proteins with generative neural networks for releasing their code. The code in this repository is based on their source code release (https://github.com/dgattiwsu/MD_without_molecules). If you find this code useful, please consider citing their work.\n\n\n## News!\n\n**[2024/05/30]** AlphaPPImd is [online(J. Chem. Theory Comput.)](https://doi.org/10.1021/acs.jctc.4c00255).\n\n**[2024/05/22]** Accepted in **Journal of Chemical Theory and Computation**, 2024.\n\n\n\n## Requirements\n```python\nPython==3.7\nbiopython==1.7.9\nambertools==21    #conda install -c conda-forge ambertools=23\nopenmm==7.7.0\nmdanalysis==2.1.0\nmdtraj==1.9.7\npytraj==2.0.6\nmodeller==10.2\nnglview==3.0.3\ntensorflow==2.8.0\n```\n\n\n*  biopython\n\nhttps://github.com/biopython/biopython\n\n*  OpenMM\n\nhttps://openmm.org/\n\n*  modeller\n\nhttps://salilab.org/modeller/\n\n*  MDAnalysis\n\nhttps://www.mdanalysis.org/\n\n*  nglview\n\nhttps://github.com/nglviewer/nglview\n\n*  pytraj\n\nhttps://github.com/Amber-MD/pytraj\n\n*  mdtraj\n\nhttps://github.com/mdtraj/mdtraj\n\n\n## Molecular dynamics\n\n### prpepare  topology and coordinate files\n```python\npdb4amber -i A.pdb -o a.pdb -y -d\n\npdb4amber -i a.pdb -o inputA.pdb --reduce\n\npdb4amber -i B.pdb -o b.pdb -y -d\n\npdb4amber -i b.pdb -o inputB.pdb --reduce\n\n\n************tleap.in**********************************************\nsource leaprc.protein.ff14SB #Source leaprc file for ff14SB protein force field\nsource leaprc.water.tip3p #Source leaprc file for TIP3P water model\n\nProA = loadpdb inputA.pdb #Load A PDB file for protein\nProB = loadpdb inputB.pdb #Load B PDB file for protein\n\nmol = combine {ProA,ProB}\n\ncheck mol\nsolvatebox mol TIP3PBOX 12.0 #Solvate the complex with a cubic water box\naddions mol Cl- 0 #Add Cl- ions to neutralize the system\naddions mol Na+ 0 #Add Na+ ions to neutralize the system\ncharge mol\nsavepdb mol ppcomplex_solv.pdb\nsaveamberparm mol ppcomplex_solv.prmtop ppcomplex_solv.inpcrd #Save AMBER topology and coordinate files\nquit #Quit tleap program\n**********************************************************************\n\ntleap -s -f tleap.in \u003e tleap.out\n\n```\n\n### run rolecular dynamics\n\n```python\n\npython run_openmm_simulation.py\n\n```\n\n\n## Model Metrics\n\n### DockQ\nDockQ: A Quality Measure for Protein-Protein Docking Models\n\nhttps://github.com/bjornwallner/DockQ\n\n*  Basu, S. and Wallner, B., 2016. DockQ: a quality measure for protein-protein docking models. PloS one, 11(8), p.e0161879.\n*  Mirabello, C. and Wallner, B., 2024. DockQ v2: Improved automatic quality measure for protein multimers, nucleic acids, and small molecules. bioRxiv, pp.2024-05.  \n\n## License\nCode is released under MIT LICENSE.\n\n\n## Cite:\n*  Jianmin Wang, Xun Wang, Yanyi Chu, Chunyan Li, Xue Li, Xiangyu Meng, Yitian Fang, Kyoung Tai No, Jiashun Mao, Xiangxiang Zeng. **\"Exploring the conformational ensembles of protein-protein complex with transformer-based generative model.\"** Journal of Chemical Theory and Computation; doi: https://doi.org/10.1021/acs.jctc.4c00255\n*  Schwing, Gregory, Luigi L. Palese, Ariel Fernández, Loren Schwiebert, and Domenico L. Gatti. **\"Molecular dynamics without molecules: searching the conformational space of proteins with generative neural networks.\"** arXiv preprint arXiv:2206.04683 (2022).\n*  Jianmin Wang, Xun Wang, Yanyi Chu, Chunyan Li, Xue Li, Xiangyu Meng, Yitian Fang, Kyoung Tai No, Jiashun Mao, Xiangxiang Zeng. **\"Exploring the conformational ensembles of protein-protein complex with transformer-based generative model.\"** bioRxiv 2024.02.24.581708; doi: https://doi.org/10.1101/2024.02.24.581708\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faspirincode%2Falphappimd","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faspirincode%2Falphappimd","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faspirincode%2Falphappimd/lists"}