{"id":15659548,"url":"https://github.com/rasbt/bondpack","last_synced_at":"2025-05-05T19:35:08.217Z","repository":{"id":11913815,"uuid":"14478954","full_name":"rasbt/BondPack","owner":"rasbt","description":"A collection of PyMOL plugins to visualize atomic bonds.","archived":false,"fork":false,"pushed_at":"2020-09-02T13:51:35.000Z","size":9368,"stargazers_count":21,"open_issues_count":2,"forks_count":12,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-03-30T23:05:22.601Z","etag":null,"topics":["atom","hydrogen-atoms","pymol-plugin","python"],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/rasbt.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}},"created_at":"2013-11-18T00:58:00.000Z","updated_at":"2025-02-21T13:22:28.000Z","dependencies_parsed_at":"2022-08-26T12:34:11.808Z","dependency_job_id":null,"html_url":"https://github.com/rasbt/BondPack","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rasbt%2FBondPack","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rasbt%2FBondPack/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rasbt%2FBondPack/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rasbt%2FBondPack/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/rasbt","download_url":"https://codeload.github.com/rasbt/BondPack/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252563068,"owners_count":21768395,"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":["atom","hydrogen-atoms","pymol-plugin","python"],"created_at":"2024-10-03T13:17:24.651Z","updated_at":"2025-05-05T19:35:08.202Z","avatar_url":"https://github.com/rasbt.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"BondPack\n========\n\nA collection of PyMOL plugins to visualize atomic bonds.\n\n\n# Sections\n\n- [Introduction](#introduction)\n- [HydroBond](#hydrobond)\n- [BondVis](#bondvis)\n- [BondLab](#bondlab)\n- [Enabling Plugins in MacPyMOL](#enabling-plugins-in-macpymol)\n- [Installing PyMOL Plugins](#installing-pymol-plugins)\n\n\u003cbr\u003e\n\u003cbr\u003e\n\n## Introduction\n[[back to top](#sections)]\n\nPyMOL is without any doubt a great tool to visualize protein and ligand molecules. However, drawing interactions between atoms can be often quite cumbersome when done manually. For the sake of convenience, I developed three plugins for PyMOL that will make our life as protein biologists a little bit easier.  \nAll three PyMOL plugins can be installed and used separately; they don't depend on each other, but rather complement each other.\nAt the end of this article, you will find brief instructions on how to install plugins in PyMOL - a very quick and simple process.   \n\n\u003cbr\u003e\n\u003cbr\u003e\n\n## HydroBond\n[[back to top](#sections)]\n\nHydroBond visualizes all potential polar contacts between protein and ligand molecules within a user-specified distance.   \nThe underlying function is based on the different atom types, such as hydrogen bond acceptor and donor atoms, and thus it is required to have hydrogen atoms present in the structure. If your structure file doesn't contain hydrogen atoms already, you can add them directly in PyMOL as shown in the image below.  \n![title](img/add_hydrogens.png)\nHydroBond is related to PyMOLs \"[A]-\u003efind-\u003epolar contacts\" command, however, it doesn't consider geometry criteria and angle thresholds, but is rather based on atom types.   \nWhen you select HydroBond from the \"Plugin\" menu, you will be prompted to enter the name of the protein object, the ligand object, and a distance cutoff as shown in the figure below. If HydroBond was able to detect hydrogen bond and acceptor atoms within the specified distance, potential interactions will be visualized as yellow dashed lines.\n![title](img/hydrobond_action.png)\n\n\u003cbr\u003e\n\u003cbr\u003e\n\n## BondVis\n[[back to top](#sections)]\n\nThe BondVis plugin lets you visualize interactions between any pair of atoms you specified.  \nOften I find it helpful for my understanding (and for verification) to visualize the bonds between certain atoms that were assigned in docking or any other prediction software. Most software will provide you with information about the atoms that were \"connected\" to perform the analysis.\nIf you run BondVis from the \"Plugin\" menu, it will ask you to select a \"bond info file.\" \n![title](img/bondinfo.png)\nThis is just a simple text file that contains the atom numbers of connected atoms in pairs. Those can be separated by spaces or tabs. An example file with bond information could look like this:  \n\u003ccode\u003e\u003cpre\u003e\n1174\t\t1357\n1175\t\t1358\n1176\t\t1359\n\u003c/pre\u003e\u003c/code\u003e\nWhen you selected a \"bond info\" file, BondVis will connect all atom pairs by yellow dashed lines and print out the connected atoms in the command field.\n![title](img/bondvis.png)\n\nOptionally, a user-defined \"bond type\" name can be added as a third column to display different bond types in different colors, which can be useful to differentiate between hydrogen bonds and salt bridges, for example.\n\n\u003ccode\u003e\u003cpre\u003e\n1174     1357     mybondtypeI\n1175     1358     mybondtypeII\n1176     1359     mybondtypeI\n\u003c/pre\u003e\u003c/code\u003e\n\n![title](img/bondvis_bondtype.png)\n\n\u003cbr\u003e\n\u003cbr\u003e\n\n## BondLab\n[[back to top](#sections)]\n\nIf you are not happy with the looks of the lines that were drawn to visualize connections between atoms, you will like to use BondLab. This plugin offers a simple interface that allows you to change the diameter, gap width, and color of the lines. \n![title](img/bondlab.png)\nThe following video demonstrates the different features of BondLab:\nhttp://youtu.be/14UZctxtK3w\n\n\u003cbr\u003e\n\u003cbr\u003e\n\n## Enabling Plugins in MacPyMOL\n[[back to top](#sections)]\n\nIf you are a Mac user, you may have noticed that the UI looks a little bit different from PyMOL on Linux and Windows. I have to admit that it looks prettier on MacOS, but unfortunately, the \"Plugin\" tab is missing.\nBut there is a simple remedy. You just have to rename the \"MacPyMOL.app\" in the Applications folder to \"PyMOLX11Hybrid.app\" and you are good to go (you might have to install X11 to support the Tkinter UI if you haven't done so yet).\n![title](img/macpymol_rename.png)\n\n\u003cbr\u003e\n\u003cbr\u003e\n\n## Installing PyMOL Plugins\n[[back to top](#sections)]\n\nInstalling new plugins is pretty straight forward in PyMOL. All you need to do is to click on the \"Plugin\" button in the menu bar, select \"Manage Plugins,\" click on \"Install...,\" and select the plugin file from the file browser window that pops up. After you restarted PyMOL, the new plugin will appear in the menu under \"Plugin\" and will be ready to use.\n![title](img/install_plugins.png)","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frasbt%2Fbondpack","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frasbt%2Fbondpack","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frasbt%2Fbondpack/lists"}