FEP+ Pose Builder Panel

Generate FEP+ ready poses using a workflow integrating reference ligand selection, ligand alignment, and clash resolution.

To open this panel: click the Tasks button and browse to Free Energy Perturbation → FEP Pose Builder.

  • Using
  • Features
  • Additional Resources

Using the FEP+ Pose Builder Panel

The FEP+ Pose Builder Panel is a workflow integrating reference ligand selection, ligand alignment, and clash resolution aiming for generating FEP+ ready poses, and is Schrödinger’s preferred tool for pose generation for FEP+. It has outperformed other methods on benchmarks, and incorporates many of the best practices shown in Pose Generation for FEP that would otherwise have to be done manually.

The features of the FEP+ Pose Builder Panel are contained almost entirely in five sections, which are described in depth in the Features section. With the exception of the Specify Ligands section, the other sections can be enabled or disabled using the checkmark icon located to the left of the section name. Disabled sections appear in gray and are not utilized in the task to be performed.

To begin, upload a ligand file in the Specify Ligands section. The label at the top left of the area reflects the uploaded file. In the Prepare Ligands section, you can click on the More Options link to open up a pane with additional options. In the Filter Prepared Ligands section, you can either load a file in using the Browse button, or create a file by pressing on the Create button which links to the Ligand Filtering Panel. In the Align Ligands section, you can upload a file of reference ligands. Use the Reference selection option menus to select various options. In the Resolve Clashes section, you can simply upload a receptor file.

You can provide membrane structure components (e.g. POPC and water box) together with receptor structures. In order to associate membrane structures with the receptor structure, especially when multiple receptors are used, you must group the receptor structure with the membrane structures together in Maestro. The membrane structures are not used in clash resolution if the ligand binds at the interface.

The panel outputs the following set of metrics for assessing the pose quality:

 

Pose Metrics Description
pose similarity (Core group)%+ Shape Similarity * (Non-core groups)%
fep similarity Similarity score of the FEP edge between reference and aligned ligands
core rmsd RMSD of core atoms between reference and aligned ligands
rgroup shape sim Shape similarity of non-core region
shape sim Shape similarity of whole ligands
num ring spears Number of ring spears between aligned ligand and receptor
num steric clashes Number of steric clashes between aligned ligand and receptor

 

To write out the input file and a script for running the job from the command line, click the arrow next to the Settings button and choose Write. For information on command usage and options, see fep_pose_builder.py Command Help.

FEP+ Pose Builder Panel Features

Note: With the exception of the Specify Ligands section, the other sections can be enabled or disabled using the checkmark icon located at the left of the section name. Disabled sections appear in gray and will not be utilized in the task.

Specify Ligands

Select ligands to process. The number of ligands loaded into the panel is displayed as text to the right of the section name.

Ligands to process option menu

Choose the structure source for the ligands. You can load 2D or 3D structures.

  • Project Table (n selected)—Use the entries that are currently selected in the Project Table or Entry List. The number of entries selected is shown on the menu item. Click the Load button to load the entries into the panel.
  • Workspace (n entries)—Use the entries that are currently included in the Workspace, treated as separate structures. The number of entries in the Workspace is shown on the menu item. Click the Load button to load the entries into the panel.
  • File—Use the specified file. Click the Browse button to navigate to the file.
Prepare Ligands section

Adjust various parameters for ligand preparation.

pH text boxes

Enter a numerical value for the pH in the pH text box, with the range in pH value specified in the +/- text box. The values can be specified to two decimal places, and the values can be adjusted using the arrow buttons.

Generate tautomers option

Select this option to generate tautomers. This option is disabled by default.

More Options link

Click to open a separate pane with the following options:

  • Using options—Select between Ionizer or Epik. If Epik is selected, the Add Epik metal binding states option is available.

  • Obtain stereochemical information from options—Select either Specified 2D stereo properties or 3D geometry for obtaining the stereochemical information.

  • Unspecified stereocenters—use the text box to define the number of stereoisomers to retain.

Filter Prepared Ligands section

Define the criteria for ligand filtering. You can define it manually or load a file. Matching ligands are kept.

Define link

Click to open the Ligand Filtering Panel, where you can set up filtering criteria for a set of structures.

Load File link

Click to select a Ligrep Filter file (*.lff) for defining filtering criteria.

Align Ligands section

Specify aligned 3D structures.

Reference Ligands option menu

Choose the structure source for the ligands.

  • Project Table (n selected)—Use the entries that are currently selected in the Project Table or Entry List. The number of entries selected is shown on the menu item. Click the Load button to load the entries into the panel.
  • Workspace (n entries)—Use the entries that are currently included in the Workspace, treated as separate structures. The number of entries in the Workspace is shown on the menu item. Click the Load button to load the entries into the panel.
  • File—Use the specified file. Click the Browse button to navigate to the file.
Settings icon

Multiple poses can be returned for ligands that have asymmetric rings in their R-groups. Click to define the maximum number of poses per ligand to return for these ligands.

Reference selection option menus

  • Fixed Reference—Use a fixed reference to align ligands. Choose a reference from the second option menu. If this option is selected, the Align R-Groups option is present and can be used to define rules for alignment. Ligands that do not match the defined rules are aligned using common cores.

  • SMARTS or Similarity—Use the Define SMARTS link to define SMARTS patterns for selecting a reference. You can define SMARTS for R-groups or the common core between the ligand and reference. If the defined SMARTS pattern is for R-groups, it is used for alignment in addition to reference selection.

    If a match is not found using the defined SMARTS patterns, similarity matching is used for reference selection and ligand alignment. Choose whether to use 2D Similarity or FEP+ 3D Similarity from the second option menu.

  • Similarity Only—Use similarity matching for reference selection and ligand alignment. Choose whether to use 2D Similarity or FEP+ 3D Similarity from the second option menu.

Align R-Groups option

Select this option to define rules for aligning R-groups using the Define SMARTS link. Only present if Fixed Reference is selected.

Define SMARTS link

Click the link to open the Define SMARTS Dialog Box. The number of definitions is displayed as text to the right of the link. Only present if Fixed Reference or SMARTS or Similarity is selected.

Resolve Clashes section

Identify the prepared structure.

Receptor option menu

Choose the structure source for the receptor. Multiple receptors can be selected.

  • Project Table (n selected)—Use the entries that are currently selected in the Project Table or Entry List. The number of entries selected is shown on the menu item. Click the Load button to load the entries into the panel.
  • Workspace (n entries)—Use the entries that are currently included in the Workspace, treated as separate structures. The number of entries in the Workspace is shown on the menu item. Click the Load button to load the entries into the panel.
  • File—Use the specified file. Click the Browse button to navigate to the file.
Map to References link

When there are multiple receptors selected, click to define the receptor mapping for each reference. A CSV file with this mapping is created when the job is run. Only available if the Align Ligands section is also enabled and multiple receptors are selected from the Receptor option menu.

Job toolbar

Manage job submission and settings. See Job Toolbar for a description of this toolbar.

The Job Settings button opens the Job Settings Dialog Box, where you can make settings for running the job.

Status bar

The status bar displays information about the current job settings and status for the panel. The settings includes the job name, task name and task settings (if any), number of subjobs (if any) and the host name and job incorporation setting. The job status can include messages about job start, job completion and incorporation.

Use the Reset button to reset the panel to its default settings and clear any data from the panel. You can also reset the panel from the Job toolbar.

The status bar also contains the Help button , which opens the help topic for the panel in your browser. If the panel is used by one or more tutorials, hovering over the Help button displays a button, which you can click to display a list of tutorials (or you can right-click the Help button instead). Choosing a tutorial opens the tutorial topic.

Tutorials

Related Topics