Ucsfdock

ucsfdock is a Python package wrapping the DOCK program that provides tools to help standardize and automate the computational methods employed in molecular docking.

Programs:

• blastermaster: generate a specific docking configuration for a given receptor and ligand
• dockmaster: evaluate many different docking configurations in parallel using a specified job scheduler (e.g. Slurm)

Installation

1. TODO

Quickstart

blastermaster

blastermaster allows the generation of a specific docking configuration for a given receptor and ligand.

Invoking blastermaster commands below will produce a log file called blastermaster.log in your current working directory.

blastermaster configure

First you need to create the directory for your blastermaster job. To do so, simply type

blastermaster configure

By default, the job directory is named blastermaster_job. To specify a different name, type

blastermaster configure <JOB_DIR_NAME>

The job directory contains two sub-directories:

1. working: input files, intermediate blaster files, sub-directories for individual blastermaster subroutines
2. dockfiles: output files (DOCK parameter files & INDOCK)

If your current working directory contains any of the following files

• rec.pdb
• xtal-lig.pdb
• rec.crg.pdb
• reduce_wwPDB_het_dict.txt
• filt.params
• radii
• amb.crg.oxt
• vdw.siz
• delphi.def
• vdw.parms.amb.mindock
• prot.table.ambcrg.ambH

then they will be automatically copied into the working directory within the created job directory. This feature is intended to simplify the process of configuring the blastermaster job. If you would like to use files not present in your current working directory, copy them into your job's working directory, e.g.:

cp <FILE_PATH> <JOB_DIR_NAME>/working/

Finally, configure the blastermaster_config.yaml file in the job directory to your specifications. The parameters in this file govern the behavior of blastermaster.

blastermaster run

Once your job has been configured to your liking, navigate to the the job directory and run blastermaster:

cd <JOB_DIR_NAME>
blastermaster run

This will execute the many blastermaster subroutines in sequence. The state of the program will be printed to standard output as it runs.

dockmaster

dockmaster allows the evaluation of many different docking configurations in parallel using a specified job scheduler (e.g. Slurm).

The name "dockmaster", aside from being an uncreative rehash of the name "blastermaster", derives from the notion of a literal dockmaster, i.e., the person in charge of a dock who manages freight logistics and bosses around numerous dockworkers. In this analogy, a single dockworker corresponds to the processing of a single docking configuration.

Invoking dockmaster commands will produce a log file called dockmaster.log in your current working directory.