{"id":13958608,"url":"https://github.com/aqlaboratory/hsm","last_synced_at":"2025-04-25T15:33:11.361Z","repository":{"id":46183246,"uuid":"217408467","full_name":"aqlaboratory/hsm","owner":"aqlaboratory","description":"Code associated with \"Biophysical prediction of protein-peptide interactions and signaling networks using machine learning.\"","archived":false,"fork":false,"pushed_at":"2024-04-26T18:13:25.000Z","size":32477,"stargazers_count":67,"open_issues_count":3,"forks_count":21,"subscribers_count":6,"default_branch":"master","last_synced_at":"2024-08-09T13:20:28.305Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://proteinpeptide.io","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/aqlaboratory.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}},"created_at":"2019-10-24T22:48:58.000Z","updated_at":"2024-06-06T03:02:39.000Z","dependencies_parsed_at":"2023-10-20T17:31:01.105Z","dependency_job_id":null,"html_url":"https://github.com/aqlaboratory/hsm","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aqlaboratory%2Fhsm","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aqlaboratory%2Fhsm/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aqlaboratory%2Fhsm/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aqlaboratory%2Fhsm/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/aqlaboratory","download_url":"https://codeload.github.com/aqlaboratory/hsm/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":224007933,"owners_count":17240294,"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":[],"created_at":"2024-08-08T13:01:46.308Z","updated_at":"2024-11-10T20:10:50.036Z","avatar_url":"https://github.com/aqlaboratory.png","language":"Jupyter Notebook","funding_links":[],"categories":["药物-靶标 药物-药物 化合物-蛋白质 相互作用"],"sub_categories":["网络服务_其他"],"readme":"# hsm - Biophysical prediction of protein-peptide interactions and signaling networks using machine learning. \n\n\u003cimg align=\"left\" src=\"misc/symbol_name.png\" style=\"width: 25%; height: 25%\"/\u003e \n\nThis repository implements the hierarchical statistical mechanical (HSM) model described in the paper [Biophysical prediction of protein-peptide interactions and signaling networks using machine learning](https://doi.org/10.1038/s41592-019-0687-1). \n\nAn **associated website** is available at [proteinpeptide.io](https://proteinpeptide.io). The website is built to facilitate interactions with results from the model including: (1) specific domain-peptide and protein-protein predictions, (2) the resulting networks, and (3) structures colored using the inferred energy functions from the model. Code for the website is available via the parallel repo: [aqlaboratory/hsm-web](https://github.com/aqlaboratory/hsm-web). Note that the results on the website were obtained using an [old model](#model-updates).\n\nThis file documents how this package might be [used](#usage), the [location of associated data](#data), and [other metadata](#reference). \n\n## Usage\n\nThe model was implemented in Python (\u003e= 3.5) primarily using TensorFlow (\u003e= 1.14) ([Software Requirements](#requirements)). To work with this repository, either download pre-processed data (see below) or include new data. The folder contains three major directories: `train/`, `predict/`, and `publication_analysis/`. Each directory is accompanied by a `README.md` file detailing usage. \n\nTo train / re-train new models, use the `train.py` script in `train/`. To make predictions using a model, use one of two scripts, `predict_domains.py` and `predict_proteins.py`, for predicting either domain-peptide interactions or protein-protein interactions. Scripts are designed with a CLI and should be used from the command line: \n\n```bash\npython [SCRIPT] [OPTIONS]\n```\n\nOptions for any script may be listed using the `-h/--help` flag.\n\nTo reproduce analysis and figures presented in the paper [Biophysical prediction of protein-peptide interactions and signaling networks using machine learning](https://doi.org/10.1038/s41592-019-0687-1), use the scripts in `publication_analysis/`.\n\nPre-trained models are released with this repo. An alternative use case would be to train / re-train a new model in the `train/` code and make new predictions using the `predict/` code. \n\n### Model updates\n\nWe identified an issue in the original datasets used to train the model published in [Biophysical prediction of protein-peptide interactions and signaling networks using machine learning](https://doi.org/10.1038/s41592-019-0687-1). We have released corrected datasets on [figshare (doi:10.6084/m9.figshare.22105529)](https://doi.org/10.6084/m9.figshare.22105529) (published on February 16, 2023), and replaced the original models released with this repo with corrected ones (on January 9, 2023). Please verify that you use the corrected models for all predictions (see documentation in `predict/`).\n\n## Data\n\nAll associated data may be downloaded from [figshare (doi:10.6084/m9.figshare.22105529)](https://doi.org/10.6084/m9.figshare.22105529).\n\n\n## Requirements\n- Python (\u003e= 3.5)\n- TensorFlow (1.14)\n- numpy (1.18)\n- scipy (1.4)\n- scikit-learn (0.20)\n- tqdm (4.41) (Progressbar. Not strictly necessary for functionality; needed to ensure package runs.)\n\n\n## Reference\nPlease reference the associated publication:\n\nCunningham, J.M., Koytiger, G., Sorger, P.K., \u0026 AlQuraishi, M. \"Biophysical prediction of protein-peptide interactions and signaling networks using machine learning.\" *Nature Methods* (2020). [doi:10.1038/s41592-019-0687-1](https://doi.org/10.1038/s41592-019-0687-1). ([citation.bib](misc/citation.bib))\n\nSee also, a **website** at [proteinpeptide.io](https://proteinpeptide.io) for exploring the associated analyses (code: [aqlaboratory/hsm-web](https://github.com/aqlaboratory/hsm-web)). Note that the results on the website were obtained using an [old model](#model-updates). \n\n## Funding\n\nThis work was supported by the following sources:\n\n| **Funder** | **Grant number** |\n| ---------- | ---------------- |\n| NIH | U54-CA225088 |\n| NIH | P50-GM107618 |\n| DARPA / DOD | W911NF-14-1-0397 |\n\n## License\nThis repository is released under an [MIT License](LICENSE)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faqlaboratory%2Fhsm","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faqlaboratory%2Fhsm","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faqlaboratory%2Fhsm/lists"}