• Docs »
  • Viewing Results in VIDA

Viewing Results in VIDA

BROOD cluster browser in VIDA

BROOD cluster browser in VIDA

VIDA is OpenEye’s molecular visualization tool. Although vBROOD provides some facility for browsing results, VIDA allows for more full-featured cluster browsing. vBROOD can launch the Results Brower tool from either the last page of a BROOD run or from the Results Browser in vBROOD. Click Open in VIDA to launch VIDA with the BROOD cluster browser loaded.

Getting started

To open the BROOD cluster browser in VIDA, click Open in VIDA from either the Browse Results wizard or from the Run BROOD page in the either the Run BROOD wizard or the Build and Run wizard. If VIDA can’t be found or hasn’t been previously launched, vBROOD will prompt you to locate it. The path to VIDA can also be specified in the vBROOD preferences dialog. For more information, see the Installation chapter.

When vBROOD launches VIDA with the cluster browser, it first displays the new user interface and then loads the BROOD results. After the results have been loaded, the cluster browser will pop up the Hotkey Help dialog displaying the various shortcut keys that can be used in the 3D window. This dialog can be closed by clicking OK and opened at a later time by clicking on the Hotkey Help button in the BROOD cluster browser window.

The BROOD cluster browser window displays information about the hitlist as well as tools for controlling the visualization of results, marking favorite molecules, and hiding other molecules in the Trash.

The BROOD cluster browser also adds a new menu, BROOD View, which allows for loading and reloading BROOD results.

Viewing Clusters

The BROOD cluster viewer has four sections: a Browsing Information section, a Visualization Control section, a Favorites section, and a Garbage section.

Browsing

VIDA cluster browser 'Browsing' section

VIDA Cluster Browser Browsing section

The Browsing Information section provides general information about the displayed hitlist. It shows which hitlist, query, and protein are being displayed, information about the clusters in the file, and the current cluster being viewed.

The browsing window also contains a spinner that displays which cluster and which member you are currently browsing. The left spinner lists the clusters. If the selected cluster is blue, you are navigating the cluster heads. The right spinner shows the members of the current cluster. If the selected number in the right spinner is highlighted in blue, you are navigating with the cluster. This spinner can be useful for keyboard navigation.

Visualization

VIDA cluster browser 'Visualization' section

VIDA Cluster Browser Visualization section

The Visualization section contains the primary set of controls. The first four buttons Favorites, Heads, Clusters and Garbage control which structures are being displayed in the main view:

  • Heads navigates among the cluster heads.
  • Clusters switches to browsing the current cluster members.
  • Favorites displays any structures marked as favorites by the user.
  • Garbage displays any molecules hidden in the garbage through the use of the Delete button.

The Visualization section also provides a set of checks to control the view:

  • Lock Query displays the query alongside a result in each pane in 3D.
  • Lock Protein displays the protein alongside a result in each pane in 3D.
  • View in 3D toggles the cluster display between 3D and 2D.
  • View Multiple Structures switches between viewing a single result structure and a grid of structures.
  • Properties toggles the display of a context-sensitive spreadsheet which displays medicinal chemistry properties for the current cluster.
  • Show Color Atoms turns on the display of color atoms, if enabled (by Attach Color Atoms under Advanced Options in vBROOD).
  • Show Hydrogen Bonds toggles the display of hydrogen bonds between the protein and the result molecules.
  • Display Structures controls the number of structures displayed in Multiple Structure view.

Favorites and Garbage

VIDA cluster browser 'Favorites' and 'Garbage' sections

VIDA Cluster Browser, Favorites, and Garbage sections

The Favorites section allows users to tag individual molecules as Favorites for further follow-up or saving. The number of favorites are displayed in the caption. Below the caption are four buttons:

  • Add puts the structure currently selected (surrounded by the blue box) to the Favorites list.
  • Remove takes the structure currently selected (surrounded by the blue box) out of the Favorites list.
  • Save prompts you for a filename then saves the Favorites list to disk.
  • Clear empties the Favorites list, moving all molecules back to their original location.

Garbage provides a way to hide structures from view. They are still available, just hidden from normal browsing. The number of structures in the Garbage can is displayed in the heading. The Garbage can be browsed by clicking View Garbage. Clicking Recover while viewing a structure in the Garbage will put the molecule surrounded by the blue box back into its original cluster.

Keyboard control

VIDA cluster browser hotkey help screen

VIDA Cluster Browser Hotkey Help screen

The VIDA Cluster Browser script has key bindings for many common operations. The keyboard operations fall into two categories: cluster navigation and display control.

Cluster navigation

The arrow keys are the primary navigation tool. They allow users to switch between navigating cluster heads and cluster members, as well as to navigate among the cluster heads or cluster members.

  • Right Arrow switches from navigating the cluster heads into the cluster of the currently selected head.
  • Left Arrow switches back from a given cluster to the cluster heads.
  • Up Arrow and Down Arrow navigate among the cluster or the cluster heads, whichever is currently being browsed.
  • Page Up and Page Down navigate by several molecules at once when multiple structures are displayed.
  • Delete moves a molecule to the Garbage.
  • Home moves to the first page of molecules (in the cluster members or among the heads).
  • End moves to the last page of molecules (in the cluster members or among the heads).

Display control

Many of the controls available in the Visualization section are also keyboard accessible:

  • Q toggles display of the query.
  • E toggles hydrogen bond display.
  • C toggles between navigation of the heads and the clusters.
  • D toggles between 2D and 3D display.
  • A toggles display of the protein (if any).
  • S toggles display of the spreadsheet.
  • V toggles display of multiple structures.
  • F adds a molecule to favorites.