The BROOD product contains four applications as well as a script that can be run in conjunction with OpenEye’s molecular visualizer VIDA. Two of the programs vBROOD and BROOD and the VIDA script provide the ability to generate queries, search for similar fragments, and visualize and triage the resulting analogs. The additional pair of applications, CHOMP and BROODDBMERGE, are utilities that generate and merge BROOD fragment databases respectively.
In these tutorials, we will primarily focus on generating and exploring analogs of an input molecule or molecules.
The basic workflow for BROOD is:
This example follows some of the work on Human Complement C3a Receptor (C3aR) from Reid and coworkers [Reid-2014]. C3aR is a G-protein coupled receptor important for the human inflammatory processes and has been identified as a potential drug target for several inflammatory diseases. In their work, Reid replaced a bridging ether with a heterocycle to convert a known antagonist compound into a potent and selective agonist for Human C3aR. In this example, we will design analogs to the known compound. The results will include several compounds studied by Reid.
Open vBROOD by double-clicking the icon or typing vBROOD at a command prompt. The GUI will start, displaying the information screen and the five primary task buttons (Build and Run, Build a new query, Run BROOD, Filtering, and View Results).
The first time you open vBROOD, you need to specify a default database. If you have not already done so, download the default database or build your own database and specify it:
- For this example, be sure to specify the default BROOD database.
- If you do not have the BROOD database available locally, you need to download it from OpenEye’s Download Page (select your platform and then the product BROOD).
- For help with installing a BROOD database, see Database Installation.
- To specify a database, select ->Edit Preferences... under the Edit menu and type the name of the database you want to use in the first line of the pop-up preferences dialog or click the Browse button to navigate to the database.
If you have previously specified the database, you will not need to do this again unless you want to change the database.
The BROOD database is a directory. After the default BROOD database has been downloaded, you need to unpack it and select the new directory. We do not recommend renaming the BROOD database, since you must then rename all the files contained within it. Consistency is required to prevent confusion between the name of the database and the files being searched under that name.
Of the five primary tasks, the one most commonly used Build and Run. This brings you to a five-step GUI wizard that takes you through building and editing a query, selecting an optional property filter, selecting parameters for the BROOD search, and visualizing the results.
- On the right, the c3a compound 4 is displayed in a 2D image and is highlighted to suggest several fragments for possible replacement.
- On the left, the current molecular property table is now filled to reflect the properties of the molecule. These calculated properties can be used as a guide to consider some of the things that might need to be changed in the loaded molecule.
The c3a compound 4 has appropriate aqueous formal charges. BROOD retains the state of the molecule as it is in the input file, so make sure your query molecule is in the charge and tautomer state you desire before loading it into BROOD.
Multiple fragments can be selected by shift-clicking. In this case, though, we will simply lasso the fragment we want to select. Hold down the Left button on your mouse and circle the fragment of the molecule shown in the image below. The lassoed fragment will then be highlighted (Figure: Selecting a query fragment).
When BROOD is run, the selected fragment will be replaced by fragments from the database with similar shape and chemistry.
After the fragment is selected, click the Next button to move on to query editing.
In general, if the molecule you loaded in this step has 3D coordinates, BROOD will use them and will replace the fragment in place. This allows fragment replacement to work in an active site. If the loaded molecule has only 2D coordinates, then a single low-energy conformer will be generated for the ligand using OMEGA technology.
As the wizard moves to the second stage, the fragment is extracted from the whole molecule and is displayed along with the color atoms generated from the input structure. This interface is designed to help users inspect and edit either the shape or color (i.e., chemistry) atoms of the query. Initially, the three heavy-atom, two attachment-point query will appear annotated with an acceptor color atom. In this example, Reid and coworkers discovered that this acceptor moiety is extremely important. Emphasis to the color force field at this point will be added as well as a constraint.
For additional information about the theory of shape and color force fields, please see the theory section of the ROCS or Shape manuals.
The query editing tools are located in icon form on the left-hand side of the 3D window. Hovering with the mouse cursor gives a brief description of each icon.
The first step is to increase the score for replacement fragments that match the constraint:
- Select the Color Editing tool (second icon down).
- Click on the small arrowhead to the right of the icon and choose Add Acceptor. This prepares the Selection tool for adding color atoms.
- Click on the current acceptor atom, thus adding a second color atom. The annotation on the 3D window should now read “acceptor x2” to reflect the change. This means that the color potential is doubly weighted in this position.
Second, a constraint must be added that requires that all analogs identified by BROOD include an acceptor near this position.
- Select the Constraint tool (the third icon down).
- Click on the small arrowhead to the right of the icon and choose Add Acceptor Constraint. This prepares the Selection tool to add a constraint.
- Now click on the same acceptor atom we chose above. A dashed circle will appear around the atom, annotating the newly added constraint. The query should now look similar to the figure Color and constrain on query fragment.
Third, click Next to move to the next step in the wizard.
This interface allows BROOD to filter the output by the properties of constructed molecules with replacement fragments. For example, BROOD filters by simple rule-of-five, predicted bioavailability, and complexity. Any constructed molecules that fail to meet these property filters will not appear in the output. In all cases, the property filters consider the properties of the whole molecule (rather than only the fragment).
For this example, we will leave property filtering turned off. Click Next to move to the Setup stage in the wizard.
There is a button for saving the query at this stage. In all cases, a copy of the query is written into the working directory when BROOD is run. This button is for saving another copy of the query or for saving a query when you don’t want to follow through and set up a BROOD run. Saving at this point is for convenience only and not necessary.
At some point, you may want to use the property filter:
#. Choose a default Drug-like filter or a filter that was built earlier. (See Filtering for more information about creating a filter.)
The Set up BROOD step has many options. Mousing over the options will reveal tooltips describing them. For this tutorial:
Select an Output Prefix. All output files will have this text pre-appended to their filenames. If the prefix has been used previously in the same directory, BROOD will automatically increment a trailing integer. If there is a danger of overwriting the previous output, the prefix will appear in red text.
Select an Output Directory. All output files will be written to this directory.
If you are running on a machine with more than two processors, click the multiprocessor box and set the number of processors.
In general, BROOD‘s speed scales by N-1, where N is the number of processors.
You should also verify that:
Click Run to start the search.
As BROOD searches, the GUI writes log information to the window’s lower portion and continuously updates the status information in the upper-left section. The lower right corner of the GUI displays a graphical progress bar. The search in this tutorial takes a few minutes to complete and results in 60 analog molecules in three clusters. At intermediate intervals, the current hitlist of fragments identified so far is displayed in vBROOD’s 2D depiction area. At the same time, a discrete progress bar in the lower right of the GUI presents progress. When the job is complete, the bottom half of the screen displays results in a spreadsheet while the upper-right portion gives a preliminary view of the 2D analogs (Figure: Search results).
Once the run is complete, vBROOD automatically passes the search results to VIDA along with a VIDA script that makes viewing the BROOD results convenient. The VIDA interface used by BROOD is simplified and specialized for viewing BROOD results.
BROOD results are organized into clusters; the interface is designed to help users explore these clusters. Along the way, you can identify analog molecules of particular interest and save them to a Favorites list that can be saved as a separate hitlist. This portion of the tutorial explains how to navigate through the clusters, add molecules to your Favorites list, and save the Favorites list as a new molecule file.
The results of a BROOD search are automatically organized into clusters based on the similarity of their molecular framework. Particular attention is given to rings and aromaticity while different chemistries are allowed to be grouped. The Arrow keys can be used to explore the results for this search. BROOD‘s clusters are not hierarchical; instead, they are a series of collections, each represented by the compound from the cluster that receives the best BROOD score (Figure: Exploring cluster in the BROOD results.).
A look at the upper-left pane of the BROOD Results Viewer shows the total number of clusters (three in the case of this tutorial) near the top left in bold. In addition, there are two tumblers that identify the molecules that are currently visible. The left tumbler represents the cluster being viewed. When the blue highlight is on the left tumbler, the 3D panes are showing the cluster representatives. Using the Up and Down Arrow keys causes the selected cluster head to change. The highlight on the tumbler will change and the matching blue square around the selected cluster representative in the 3D window will also change. If there are more than three clusters, the Up and Down Arrow keys will also handle scrolling through the all the cluster representatives.
Click the Down Arrow key. Note that the left tumbler changes from highlighting “1” to highlighting “2” and that the blue highlight box in the 3D window moves from highlighting the first cluster representative to highlighting the second representative. If you want to see all the members of a cluster, you can drill down into a cluster to see all of its members. In this section, we will explore navigation through Cluster 2 using the Arrow keys.
Use the Up and Down Arrows to select the representative molecule of Cluster 2. Note that it is labeled with “Cluster 2, 1 of 30,” indicating that it is the first molecule in a cluster with 30 total members.
Press the Right Arrow key to expand Cluster 2. Notice that in the top-left pane, the blue highlight has moved onto the right tumbler, indicating that you are now viewing cluster members. It is highlighting “1,” indicating that the highlighted molecule in the 3D window (the one surrounded by the blue box) is the first molecule in the cluster.
Use the Up and Down Arrows to move through the cluster members. By default, six panes will be visible and the Arrow keys will cause the molecules to scroll through the panes one by one. Look through some of the molecules in Cluster 2 using the Arrow keys. To toggle the number of molecules displayed, use the V hotkey.
The Page Up and Page Down keys can be used for more efficient navigation. If multiple panes are visible, Page Up and Page Down will change all the visible molecules at one time. This navigation is analogous to the Up and Down Arrow keys, but more efficient.
Use the Page Up and Page Down keys to move through the cluster members.
The Home and End keys will navigate to the first page or the last page of the cluster of molecules you are currently examining. Use the Home and End keys to navigate to the beginning and end of Cluster 2.
The Up Arrow, Down Arrow, Page Up, Page Down, Home, and End keys are all available for navigation throughout all the cluster representatives in the same way they were for navigating the molecules inside Cluster 2.
When examining BROOD hitlists, some users like to select particular molecules for future sharing or examination by saving them into a separate culled list. To facilitate this, the BROOD Results Viewer includes Favorites and Trash features. While navigating the analogs as discussed in the previous section, you can choose any molecule and move it to your Favorites. In addition, if you identify molecules you would prefer not to examine again, you can move them to the Trash. Both the Favorites and the Trash can be opened if you inadvertently placed a molecule in the wrong category.
In addition to keeping track of your favorite analogs, it can also be useful to get rid of some of the less desirable molecules. For this purpose, there is a garbage can that allows you to place molecules in the Trash.
In the fragment-based design setting, users may occasionally want to link two fragments with crystal orientations in the active site into a single molecule. Ideally, when the two fragments are linked without additional entropy, the binding energies will sum. In practice, this kind of additivity is often not possible for a number of reasons, including ligand strain, protein strain, entropy and desolvation. Nevertheless, BROOD can be quite useful in this setting to suggest potential linker groups that might span the fragment-fragment gap in a low energy manner. This tutorial will walk you through the steps for identifying linker fragments.
This tutorial follows the work of Ward et al. [Ward-2012], in which they designed linkers to join two crystallographic fragments to generate a lead.
If you have not yet installed the BROOD database, please see the section Database Installation for further information before continuing this tutorial.
For this exercise, we will take two fragments positioned in the same active site and join them with an unstrained linker.
#. Choose two separate fragment files using the appropriate function for your operating system. For this tutorial, select the files ward-22-21.oeb and ward-21-22.oeb from the brood directory in Examples and Tutorials Data.
When the files are properly loaded, the 2D window should display them as shown below(Figure: Two molecules loaded for query selection.).
In any BROOD run, whether fragment replacement or fragment joining, a protein context can be added. When the query molecule or molecules are from a protein active site and the protein is passed to BROOD, the new analogs will be constructed in the context of the protein active site. Before the final hitlist is generated, all the new analogs will be tested for clashes against the protein.
#. Select the file ward-protein-join.oeb. This will allow you to include the protein in the search and build joined fragment molecules in the active site of the protein.
When the two files are loaded, depictions of two separate molecules will appear in the 2D query window. As with a single query, the fragments for replacement, this time disconnected, can be lassoed (see Figure: Choosing a query to join two molecules.).
Click Next to move to the filter pane, then click Next again to move to the BROOD Run Setup window.
If you have a multiprocessor machine, click the Multiprocessor check box under General Options and select the maximum number of processors.
BROOD can use from 1 to N+1 processors, where N is the number of logical cores detected on the machine. On many desktop systems, the OS remains responsive even with all the processors engaged by BROOD. Users will have to explore performance on their own systems.
Under Search Options, select the Link Geometry search type. This will carry out a CAVEAT-like search [Bartlett-1994] that attempts to span the empty region between the two fragments.
Try this example with the Quick Search option (see below). Later you can also run without the Quick Search option to compare the calculation time and quality of results.
Next, consider ring selection in the search. By default, BROOD requires a ring in the atom path connecting every two-attachment hit. For this exercise, under the Ring Requirements section, select the “Zero Rings” option. This will require that fewer than 2 ring atoms are located on the shortest atom-path connecting the fragments in each brood hit.
Finally, when a protein is included in a search (as in this case), all solutions are checked for bumps with the protein using a 2.25 Angstrom cutoff by default. For this example, adjust the cutoff to 1.7 Angstroms. To do this, click the Advanced Search tab and adjust the number labeled “Protein-ligand bump radius” to 1.7.
Now click Run. The view will switch to the Results Tracking view while the job is running. When the run is complete, the results will be viewable in the vBROOD GUI and in the BROOD Results Viewer. Navigation and exploration of those results work similarly to those in the first tutorial. If you are not familiar with results navigation, it may be useful to review the first tutorial. Here, special attention will be paid to features that are different in this tutorial.
When the BROOD run is complete, click the Log button on the lower right of the vBROOD Results window. You can read the logging information to learn details about the number of molecules that were processed, how many were overlaid, how large the initial hitlist was, and the reason that any molecules were eliminated from the hitlist.
The Quick Search function’s goal is to complete its search in approximately two minutes. To accomplish this, the hitlist is truncated to (up to) the first 50 cluster representatives. Further, each cluster is represented only by its best scoring molecule. The Quick Search results are often interesting and contain a few attractive ideas. Quick Search allows users to assess whether a more time-consuming search is likely to be fruitful.
Now examine the results in 3D by clicking the Open in VIDA button. As in the previous example, this will open the BROOD Results Viewing script and automatically load the results with the modified interface. As before, the results are organized by cluster and displayed in the context of the query. When you examine the Quick Search results, each cluster will have at most one member, so navigation is simple.
The other features of the Results Viewer can be reviewed in the first tutorial.
This example demonstrates how users can create a BROOD database with fragment conformations pulled from small-molecule crystal structures rather than conformations generated by OMEGA. For this task, we will be using CHOMP, BROOD‘s fragment database-generating application.
For this exercise, CHOMP will require two molecular inputs. The first input will be the molecules you want CHOMP to use to generate molecular fragments for the BROOD database. The second input will be the 3D molecular structures CHOMP should use to extract example conformers for the fragments generated from the first input. The same file can be used for both inputs: for instance, if your company has a large collection of small-molecule crystal structures, you can use it to both generate the molecular fragments for the BROOD database and to define the allowable conformations of those fragments.
The molecular file for fragmentation can be in any supported 1D, 2D, or 3D molecular file format (including SMILES or 2D SDF). If the molecules include titles, these can be used in the BROOD Results to track the most common sources of each fragment.
The molecular file for crystal conformer specification must be a 3D structure file. We recommend you use SDF, MOL2, or OEB. These formats can be exported from common crystallographic database tools (refer to their manuals for details of the process). In our experience, PDB format has too many ambiguities for reliable handling of 3D fragment conformations and we recommend you avoid using PDB here if possible.
For this tutorial, example files have been included in the BROOD installation. For the first input, you will use the file biotin.ism; for the second input, you will use the structural file biotin.xtal.oeb.
Using the same input for fragment generation and conformer specification assures that there will be a crystallographic conformation for every fragment generated by CHOMP. If different files are used, then fragments may be produced that have no representative conformation in the structural data.
CHOMP generates BROOD databases in two phases. In the first phase, a unique set of fragments is extracted from the molecular input. In the second phase, conformers are generated for each fragment, the fragments are organized to optimize BROOD search times, then the fragments are written into a database. For this exercise, each fragment from the first phase will be searched for in the 3D molecules. If the fragment is identified as a substructure of any 3D molecule, the coordinates will be extracted and added as a new fragment conformer. Finally, duplicate conformers of each fragment will be removed before the fragment with its 3D conformations are passed on for organization and database writing.
CHOMP is a command-line only program. It is part of the BROOD product and is installed as part of the BROOD installation process. CHOMP is not available from within the BROOD GUI in this release, but is available in command-line form on all supported platforms.
#. Change directory to the brood directory under the Examples and Tutorials Data of your installation. It should contain the files biotin.ism and biotin.xtal.oeb. You can also copy these files to another directory if you would prefer.
There are many fragment generation and fragment filtering parameters that control the number and type of fragments generated from your input molecules by CHOMP. We have worked to make the defaults for all these parameters mimic our best practices for the general case. If you are generating a specific database for a special case, you may want to examine the fragments generated by CHOMP to determine in detail if you want to modify the default parameters. This section of the tutorial explains how to make this part of the database preparation workflow.
The following steps will quickly lead you to an intermediate Results file containing all the fragments generated for your database. Since this phase is typically significantly faster than full database generation, you can repeat it, adjusting the parameters until you are satisfied. Alternatively, you can hand edit the intermediate file using your own criteria and then pass it into the final 3D database generation phase when you are satisfied with the results.
Whenever CHOMP is executed (regardless of 3D options), an intermediate file is generated that contains all the fragments generated from the input molecules. With both of these options for conformations turned off, CHOMP will generate the fragment file and then stop.
In addition to modifying the Fragment Selection parameters, as with -maxHvy above, the -smarts parameter can have a powerful effect on the fragments that are generated by CHOMP. This can be an effective tool regardless of whether the 3D conformers for your database are being extracted from crystallographic conformations or generated by OMEGA.