DockStream
Description
DockStream is a docking wrapper providing access to a collection of ligand embedders and docking backends. Docking execution and post hoc analysis can be automated via the benchmarking and analysis workflow. The flexilibity to specifiy a large variety of docking configurations allows tailored protocols for diverse end applications. DockStream can also parallelize docking across CPU cores, increasing throughput. DockStream is integrated with the de novo design platform, REINVENT, allowing one to incorporate docking into the generative process, thus providing the agent with 3D structural information.
Supported Backends
Ligand Embedders
Docking Backends
Note: The CCDC
package, the OpenEye
toolkit and Schrodinger
's tools require you to obtain the respective software from those vendors.
Tutorials and Usage
Detailed Jupyter Notebook
tutorials for all DockStream
functionalities and workflows are provided in DockStreamCommunity. The DockStream
repository here contains input JSON
templates located in examples. The templates are organized as follows:
target_preparation
: Preparing targets for dockingligand_preparation
: Generating 3D coordinates for ligandsdocking
: Docking ligandsintegration
: Combining different ligand embedders and docking backends into a single inputJSON
to run successively
Requirements
Two Conda environments are provided: DockStream
via environment.yml
and DockStreamFull
via environment_full.yml
. DockStream
suffices for all use cases except when CCDC GOLD
software is used, in which case DockStreamFull
is required.
git clone <DockStream repository>
cd <DockStream directory>
conda env create -f environment.yml
conda activate DockStream
REINVENT README)
Enable use of OpenEye software (fromYou will need to set the environmental variable OE_LICENSE to activate the oechem license. One way to do this and keep it conda environment specific is: On the command-line, first:
cd $CONDA_PREFIX
mkdir -p ./etc/conda/activate.d
mkdir -p ./etc/conda/deactivate.d
touch ./etc/conda/activate.d/env_vars.sh
touch ./etc/conda/deactivate.d/env_vars.sh
Then edit ./etc/conda/activate.d/env_vars.sh
as follows:
#!/bin/sh
export OE_LICENSE='/opt/scp/software/oelicense/1.0/oe_license.seq1'
and finally, edit ./etc/conda/deactivate.d/env_vars.sh :
#!/bin/sh
unset OE_LICENSE
Unit Tests
After cloning the DockStream
repository, enable licenses, if applicable (OpenEye
, CCDC
, Schrodinger
). Then execute the following:
python unit_tests.py
Contributors
Christian Margreitter ([email protected]) Jeff Guo ([email protected]) Alexey Voronov ([email protected])