ResidueWalker is a PyMol plugin designed for residue-wise inspection of protein-ligand models. It is a navigation tool for PyMOL that allows users to rapidly iterate through residues, ligands, and water molecules. It provides a synchronized view between a searchable list and the 3D viewer.
- Download and save the plugin code as a Python file (residue_walker.py)
- Open PyMOL
- Go to Plugin > Plugin Manager from the top menu
- Select the Install New Plugin tab
- Click Choose file and select residue_walker.py.
PyMOL will confirm the installation.
Once installed, the way to launch the interface is via pymol command line. Type the following command in the PyMOL console:
initWalker- Selection Input: In the "Selection" box, type the object or selection you want to inspect (default is all)
- Filters: Toggle the checkboxes to include/exclude
- Polymer: Proteins, DNA, and RNA
- Small Molecules: Ligands, ions, organic cofactors, stc
- Waters: Solvent molecules (HOH/WAT)
Click the Load List button. The plugin will automatically:
- Creat a list of residues based on the selection and checked residue types
- Show proteins/ligands as Balls & Sticks
- Show waters as Non-bonded Spheres (nb_spheres)
To navigate, simply click any residue in the list with your mouse, use the UI buttons, or press the Left/Down and Right/Up Arrow keys.