Subsections

6.3 Finding the right pose

Examples in this section deal with adjusting how FRED docks ligands (i.e. how it determines the pose, or poses if alternate poses are requested, of a ligand within the active site). None of the examples in this section address how the final ligand pose(s) are scored and outputted to the hitlist(s). Hence the same set of output files are returned in each example, the docked structures thus the scores of the outputted ligands will be different however (since these examples adjust how FRED generates the poses to score). The next section has examples of adjusting the final scoring and hitlists.

See section 4.2 for a general explanation of how FRED docks ligands.

6.3.1 Rescoring - scoring without docking

6.3.1.1 Command Line

fred -dbase my_poses.mol2 -rec my_receptor.oeb.gz -no_dock -opt none

6.3.1.2 Description

Using this command line FRED will assume that the ligand molecules passed to -dbase are already positioned within the active site, and rescore and re-rank the ligands using the default scoring function Chemgauss3 (see section 4.3.5) since we have not specified a scoring function to use.

6.3.1.3 Parameters

-dbase
my_poses.mol2

This specifies the poses to read in for rescoring and reranking.

-rec
my_receptor.oeb.gz

Specifies the receptor site to score the ligands in.

-no_dock

This flag tells FRED to skip the exhaustive search (which is how poses are initially generated).

-opt
none

tells FRED not to perform solid body optimization on the poses that are passed in.

6.3.1.4 Output

setup.txt
A file with the settings of all of FRED's parameters. Note that there will be many more parameters in this file than those specified on the command line because many parameters have default values. This file will be written at the beginning of the run.

receptor.oeb.gz
This file contains a copy of the receptor site used for the run. This file will be written at the beginning of the run.

status.txt
This file will be written every few seconds by FRED and indicates the status of the run.

chemgauss3_docked.oeb.gz
contains the structure of the top 1000 ligands as ranked by Chemgauss3 in gzipped sdf format.

chemgauss3_scores.txt
list the names, scores and SMILES representation of the top 1000 ligands as ranked by Chemgauss3 in a text format.

6.3.2 Setting the exhaustive scoring and optimization functions

6.3.2.1 Command Line

fred -dbase my_ligands.oeb.gz \
     -rec my_receptor.oeb.gz \
     -exhaustive_scoring plp \
     -opt plp

6.3.2.2 Description

The initial exhaustive search to generate candidate poses and the optimization step both have settings for the scoring functions they use to rank or optimize poses respectively. The default scoring function for these operations is Chemgauss3 (see section 4.3.5), however both operations can be set to use different scoring functions as shown in this example which sets both the exhaustive scoring and optimization scoring functions to PLP (see section 4.3.3).

6.3.2.3 Parameters

-dbase
my_ligands.oeb.gz

This tells FRED where the ligands it is going to dock are, in this case the file my_ligands.oeb.gz. The ligand file should have multiple conformers of all flexible ligands (see section 5.5 for more detail on preparing the ligand database).

-rec
my_receptor.oeb.gz

This specifies a receptor file to dock the ligands to. The receptor file must be created prior to running FRED with this command line. This file can be created by FRED or by the fred_receptor GUI.

-exhaustive_scoring
plp

Sets the exhaustive scoring function to PLP.

-opt
plp

Sets the optimization scoring function to PLP.

Note that -exhaustive_scoring and -opt are independent (i.e. you can specify one without the other).

6.3.2.4 Output

setup.txt
A file with the settings of all of FRED's parameters. Note that there will be many more parameters in this file than those specified on the command line because many parameters have default values. This file will be written at the beginning of the run.

receptor.oeb.gz
This file contains a copy of the receptor site used for the run. This file will be written at the beginning of the run.

status.txt
This file will be written every few seconds by FRED and indicates the status of the run.

chemgauss3_docked.oeb.gz
contains the structure of the top 1000 docked ligands as ranked by Chemgauss3.

chemgauss3_scores.txt
list the names, scores and SMILES representation of the top 1000 docked ligands as ranked by Chemgauss3 in a text format.

6.3.3 Adjusting consensus structure - changing weights

6.3.3.1 Command Line

fred -dbase my_ligands.oeb.gz \
     -rec my_ligands.oeb.gz \
     -pose_select_weight_shapegauss 1 \
     -pose_select_weight_plp 0 \
     -pose_select_weight_Chemgauss2 1 \
     -pose_select_weight_Chemgauss3 4 \
     -pose_select_weight_Chemscore 0 \
     -pose_select_weight_oeChemscore 2 \
     -pose_select_weight_screenscore 0 \
     -pose_select_weight_cgo 0

6.3.3.2 Description

Once candidate poses have been generated by the exhaustive search and optimization step FRED selects a single best pose from the set of candidates. This pose is then scored and the score is used to rank ligands in the output hitlist. The consensus structure step allows multiple scoring functions to vote for the best docked structure in a rank-by-vote approach. This example shows how to adjust the weight of each scoring function's vote.

6.3.3.3 Parameters

-dbase
my_ligands.oeb.gz

This tells FRED where the ligands it is going to dock are, in this case the file my_ligands.oeb.gz. The ligand file should have multiple conformers of all flexible ligands (see section 5.5 for more detail on preparing the ligand database).

-rec
my_receptor.oeb.gz

This specifies a receptor file to dock the ligand to. The receptor file must be created prior to running FRED with this command line. This file can be created by FRED or by the fred_receptor GUI.

-pose_select_weight_shapegauss
1

Gives shapegauss a weight of 1 for consensus structure voting.

-pose_select_weight_plp
0

Gives PLP a weight of 0 for consensus structure voting (i.e. PLP is ignored for consensus structure).

-pose_select_weight_Chemgauss2
1

Gives Chemgauss2 a weight of 1 for consensus structure voting.

-pose_select_weight_Chemgauss3
4

Gives Chemgauss3 a weight of 4 for consensus structure voting.

-pose_select_weight_Chemscore
0

Gives Chemscore a weight of 0 for consensus structure voting (i.e. Chemscore is ignored for consensus structure).

-pose_select_weight_oeChemscore
2

Gives OEChemscore a weight of 2 for consensus structure voting.

-pose_select_weight_screenscore
0

Gives Screenscore a weight of 0 for consensus structure voting (i.e. Screenscore is ignored for consensus structure).

-pose_select_weight_cgo
0 Gives CGO a weight of 0 for consensus structure voting (i.e. CGO is ignored for consensus structure). Note that CGO is a ligand based scoring function, which means that if CGO is to be used with a non-zero weight for consensus structure the receptor file must contain a bound ligand.

6.3.3.4 Output

setup.txt
A file with the settings of all of FRED's parameters. Note that there will be many more parameters in this file than those specified on the command line because many parameters have default values. This file will be written at the beginning of the run.

receptor.oeb.gz
This file contains a copy of the receptor site used for the run. This file will be written at the beginning of the run.

status.txt
This file will be written every few seconds by FRED and indicates the status of the run.

chemgauss3_docked.oeb.gz
contains the structure of the top 1000 docked ligands as ranked by Chemgauss3.

chemgauss3_scores.txt
list the names, scores and SMILES representation of the top 1000 docked ligands as ranked by Chemgauss3 in a text format.

6.3.4 Turning consensus structure off

6.3.4.1 Command Line

fred -dbase my_ligands.oeb.gz \
     -rec my_ligands.oeb.gz \
     -pose_select_weight_shapegauss 0 \
     -pose_select_weight_plp 0 \
     -pose_select_weight_Chemgauss2 0 \
     -pose_select_weight_Chemgauss3 0 \
     -pose_select_weight_Chemscore 0 \
     -pose_select_weight_oeChemscore 0 \
     -pose_select_weight_screenscore 0 \
     -pose_select_weight_cgo 0

6.3.4.2 Description

This example disables the consensus structure step by setting all the scoring function weights for consensus structure to zero. In this case the top ranked pose from the optimization step (or from the exhaustive search if optimization is also disabled) will scored with Chemgauss3 and outputted to the hitlist(s).

6.3.4.3 Parameters

-dbase
my_ligands.oeb.gz

This tells FRED where the ligands it is going to dock are, in this case the file my_ligands.oeb.gz. The ligand file should have multiple conformers of all flexible ligands (see section 5.5 for more detail on preparing the ligand database).

-rec
my_receptor.oeb.gz

This specifies a receptor file to dock to the ligand too. The receptor file must be created prior to running FRED with this command line. This file can be created by FRED or by the fred_receptor GUI.

-pose_select_weight_shapegauss
0

Gives shapegauss a weight of 0 for consensus structure voting.

-pose_select_weight_plp
0

Gives PLP a weight of 0 for consensus structure voting.

-pose_select_weight_Chemgauss2
0

Gives Chemgauss2 a weight of 0 for consensus structure voting.

-pose_select_weight_Chemgauss3
0

Gives Chemgauss3 a weight of 0 for consensus structure voting.

-pose_select_weight_Chemscore
0

Gives Chemscore a weight of 0 for consensus structure voting.

-pose_select_weight_oeChemscore
0

Gives OEChemscore a weight of 0 for consensus structure voting.

-pose_select_weight_screenscore
0

Gives Screenscore a weight of 0 for consensus structure voting,

-pose_select_weight_cgo
0

Gives CGO a weight of 0 for consensus structure voting.

6.3.4.4 Output

setup.txt
A file with the settings of all of FRED's parameters. Note that there will be many more parameters in this file than those specified on the command line because many parameters have default values. This file will be written at the beginning of the run.

receptor.oeb.gz
This file contains a copy of the receptor site used for the run. This file will be written at the beginning of the run.

status.txt
This file will be written every few seconds by FRED and indicates the status of the run.

chemgauss3_docked.oeb.gz
contains the structure of the top 1000 docked ligands as ranked by Chemgauss3.

chemgauss3_scores.txt
list the names, scores and SMILES representation of the top 1000 docked ligands as ranked by Chemgauss3 in a text format.