Subsections

6.1 Simple command lines

6.1.1 Docking with an existing receptor

6.1.1.1 Command Line

fred -dbase my_ligands.oeb.gz -rec my_rec.oeb.gz

6.1.1.2 Description

FRED will dock the ligands in the file my_ligands.oeb.gz to the receptor my_rec.oeb.gz. No scoring function has been specified so FRED will use its default scoring function Chemgauss3 (see section 4.3.5).

6.1.1.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_rec.oeb.gz

This specifies a receptor file to dock to the ligand into. 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.

6.1.1.4 Output Files

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.1.2 Creating a receptor and docking

6.1.2.1 Command Line

fred -dbase my_ligands.oeb.gz \
     -pro my_protein.pdb \
     -box bound_ligand.mol2 \
     -addbox 4.0

6.1.2.2 Description

FRED will create a receptor and then dock the ligands in the file my_ligands.oeb.gz to it. No scoring function has been specified so FRED will use its default scoring function Chemgauss3 (see section 4.3.5).

6.1.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).

-pro
my_protein.pdb

This specifies the protein structure used to create the receptor file. This file should not contain a bound ligand.

-box
bound_ligand.mol2

This specifies a box defining the extents of the active site. The format of this file is any supported 3d molecule format. The box will always be aligned along the x,y and z axis. The max and min x,y and z values denoting the sides of the box will the the max and min x,y and z values of any heavy atom on the molecule passed.

This example uses a bound ligand. Without modification the box created around it would be unreasonably small, however we are also using the -addbox flag which increases the size of the box created.

-addbox
4.0

This flag tells FRED to extend each side of the box it created with the -box flag by 4 Angstroms. (if the dimensions of the box were initially 12x12x12, the modified box would have dimensions 20x20x20).

6.1.2.4 Output Files

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 FRED created. 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.1.3 Changing the output file format

6.1.3.1 Command Line

fred -dbase my_ligands.oeb.gz -rec my_rec.oeb.gz -oformat sdf.gz

6.1.3.2 Description

FRED will dock the ligands in the file my_ligands.oeb.gz to the receptor my_rec.oeb.gz. No scoring function has been specified so FRED will use its default scoring function Chemgauss3 (see section 4.3.5).

The output format of docked structures will be gzipped sdf.

6.1.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_rec.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.

-oformat
sdf.gz

This flag tells FRED that the docked structures it outputs should be in sdf gzipped format, rather than the default OEB gzipped format. If sdf were specified instead of sdf.gz regular non-gzipped SDF format would be used.

6.1.3.4 Output Files

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.sdf.gz
contains the structure of the top 1000 docked ligands as ranked by Chemgauss3 in gzipped sdf format. This file can be unzipped like any gzipped file after the run, although almost all OpenEye programs can read the zipped version of the file.

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.1.4 Setting a prefix and/or an output directory

6.1.4.1 Command Line

fred -dbase my_ligands.oeb.gz \
     -rec my_rec.oeb.gz \
     -prefix myrun \
     -output_dir /results/site/FRED

6.1.4.2 Description

FRED will dock the ligands in the file my_ligands.oeb.gz to the receptor my_rec.oeb.gz. No scoring function has been specified so FRED will use it's default scoring function Chemgauss3 (see section 4.3.5).

All output file will be prefixed with the text "myrun_", and placed in the directory /results/site/FRED (which must exist). Note that it is not necessary to specify both -prefix and -output_dir, you can specify one (or none) if you only want to set the a prefix to the output filenames or an output directory respectively.

6.1.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_rec.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.

-prefix
myrun

This flag tells FRED to pre-append all output files it writes with the text "myrun_" (the _ is added automatically).

-output_dir
/results/site/FRED

This flag tells FRED that all output files should be written in the directory /results/site/FRED.

6.1.4.4 Output Files

These files will all be written to /results/site/FRED, rather than the working directory as they normally would.

myrun_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.

myrun_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.

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

myrun_chemgauss3_docked.sdf.gz
contains the structure of the top 1000 docked ligands as ranked by Chemgauss3.

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