GeinDock Suite
Home › The Docking Panel

The Docking Panel

The numbered workflow that drives every docking study: what each of the six steps asks of you, what the state chips mean, and how the docking mode changes step 4.

A docking study in GeinDock Suite is six steps taken in order down the panel on the left. The panel enforces the order only where the science requires it: you cannot define a binding site before there is a protein to define it on, and you cannot run a job before the receptor, the ligands and the site all exist. Everything else you may revisit at any time.

The Docking Panel with the first two steps complete
The Docking Panel partway through a study. Steps 1 and 2 are complete and carry green chips; step 3 has not been touched yet, so Run Docking is still disabled.

The mode heading

Above step 1, and not numbered as a step of its own, the panel names the docking mode that is active and summarises what it means. The default is Ligand Docking, described as a rigid receptor with a flexible ligand.

The mode is not chosen here. It is chosen from Docking › Docking Mode, and the panel reflects it. The reason is that the mode decides what step 4 even is, so it belongs above the whole list rather than inside it, and putting it in the menu makes it reachable from the keyboard and visible even when the panel is closed.

The docking mode submenu
The four protocols. Exactly one is active at any time, and the active one is ticked.
Mode What changes What step 4 becomes
Ligand DockingNothing. The receptor is held rigid and the ligand is free to rotate about its rotatable bonds.Settings
Flexible DockingSelected receptor side chains are allowed to move during the search.Flexible Side Chains
Constraint DockingPoses must satisfy geometric conditions that you define.Constraints
Covalent DockingThe ligand is bonded to a named receptor residue.Covalent Attachment
The three specialised modes have no settings page, and that is deliberate. Each of them derives its own search parameters from the protocol it implements. Those derivations are part of the validated method rather than a matter of preference, so exposing them as knobs would let a run be quietly invalidated. Step 4 in those modes is therefore the one thing only you can supply: which residues, which constraints, which attachment.

The six steps

1. Receptor

Load Receptor opens the protein selection and preparation dialog, where you browse for a file or fetch one from the Protein Data Bank, choose which chains to keep, set the cleanup and protonation options, and run the preparation. When the dialog closes the receptor is ready to dock and the step summary names the file, the chains and its state. Full details are in Step 1: Receptor.

2. Ligands

Add Ligands opens the ligand upload and preparation dialog. Add files, a whole folder, text formulae or a structure you draw, review what was read in the ligand table, then prepare them all in one pass. See Step 2: Ligands.

3. Binding Site

Define opens the grid box dialog, which offers three ways to arrive at a box: cover the whole protein, centre it on a ligand already present in the crystal structure, or set the centre and size yourself. Validation beside it runs a redocking protocol that measures whether the box you have chosen can actually reproduce a known pose. See Step 3: Binding site and Binding site validation.

4. Settings

In ligand docking this is the search configuration: scoring function, exhaustiveness, how many binding modes to keep, the energy window, how many cores to use, and the padding around the site. It always has a value for every field, so it is never incomplete and its chip reads defaults until you change something. See Step 4: Settings.

5. Run Docking

Starts the job. The progress bar names the phase it is in and how far through the whole run it is, and the line above it carries the detail. Stop ends the run. See Step 5: Running a job.

6. Analysis

Open Analysis raises the pose table for the most recent run. It stays disabled until a run has produced poses. See The pose table.

Reading the chips

Chip Meaning
not setNothing has been supplied for this step.
loadedA receptor has been read in, but it has not been prepared, so it cannot be docked yet.
addedLigands are listed, but not all of them have been prepared.
preparedThe receptor, or every ligand, is ready for the search.
configuredA binding site box has been committed, or a mode picker has been filled in.
validatedThe committed box has been checked by a redocking protocol and passed.
attachedA covalent attachment has been set up.
idleShown on step 5 whenever no job is running, both before the first run and after one has finished. It is grey because there is nothing to report, not because something is missing.
runningA job is in progress.
resultsPoses exist and can be opened.
If Run Docking will not enable, hover over it. The button's tooltip names the exact thing that is missing rather than simply reporting that it is unavailable.

The worked examples used in this guide

The workflow chapters follow one study from a blank window to a ranked pose table, and each mode chapter uses a system that shows that mode at its most characteristic.

Chapter Receptor Why this one
The workflow and ligand dockingA viral protease with an inhibitor bound in its active siteA small, well ordered two chain enzyme with a clear pocket, which makes every step easy to see.
Flexible dockingA protein kinaseKinase pockets rearrange on binding, which is exactly the case flexible docking exists for.
Constraint dockingA serine proteaseThe catalytic residues make an obvious and chemically meaningful anchor to constrain against.
Covalent dockingA signalling enzyme with a covalent inhibitorThe structure carries an explicit link record, so the attachment can be detected rather than assumed.

You can follow along with any structure of your own. Nothing in the workflow depends on the particular example, and the receptor can be fetched inside the application by its four character identifier.