Repository files navigation

• 1. Introduction
• 2. Reference
• 3. Installation
• 4. Documentation
• 5. Get Help

LightDock is a protein-protein, protein-peptide and protein-DNA docking framework based on theGlowworm Swarm Optimization (GSO) algorithm.

The framework is written in the Python programming language (version 2.7) and allows the users to incorporate their own scoring function.

The LightDock framework is highly versatile, with many options that can be further developed and optimized by the users: it can accept any user-defined scoring function, can use local gradient-free minimization, the simulation can be restrained from the beginning to focus on user-assigned interacting regions,it supports residue restraints in both receptor and ligand partners and it has support for the use of pre-calculated conformers for both receptor and ligand.

LightDock protocol and the updates to make use of residue restraints have been published inOxford Bioinformatics journal. Please cite these references if you use LightDock in your research:

LightDock: a new multi-scale approach to protein–protein docking
Brian Jiménez-García, Jorge Roel-Touris, Miguel Romero-Durana, Miquel Vidal, Daniel Jiménez-González and Juan Fernández-Recio
Bioinformatics, Volume 34, Issue 1, 1 January 2018, Pages 49–55,https://doi.org/10.1093/bioinformatics/btx555

LightDock goes information-driven
Jorge Roel-Touris, Alexandre M.J.J. Bonvin,Brian Jiménez-García
Bioinformatics, btz642; doi:https://doi.org/10.1093/bioinformatics/btz642

LightDock has the following dependencies:

• Python 2.7.x
• Nose (http://nose.readthedocs.io/en/latest/)
• NumPy (http://www.numpy.org/)
• Scipy (http://www.scipy.org/)
• Cython (http://cython.org/)
• BioPython (http://biopython.org)
• MPI4py (http://pythonhosted.org/mpi4py/)
• ProDy (http://prody.csb.pitt.edu/)
• Freesasa (only ifcpydock scoring function is used and to run the complete test set,http://freesasa.github.io/)

NumPy, Scipy, Cython, Biopython, Nose and MPI4py libraries are usually available as packages in most of GNU/Linux distributions. For example, to install them in Ubuntu execute:

sudo apt-get update&& apt-get install python-numpy python-scipy cython python-biopython python-nose python-nose2 python-mpi4py

Make sure all libraries are from the Python 2.7.x series.

To install ProDy library, the simplest way is to use pip (you can use sudo to install it system-wide):

pip install -U ProDy

You may also need to installpyparsing dependency:

pip install pyparsing

More instructions on how to install it can be found in the official documentation (http://prody.csb.pitt.edu/downloads/).

In case of usingcpydock scoring function or to execute the tests,Freesasa library has to be installed and compiled with the python-binding options. Tested version inLightDock is 1.1 (https://github.com/mittinatten/freesasa/tree/1.1). To install freesasa 1.1, please follow these instructions (changepath/to/install):

git clone https://github.com/mittinatten/freesasa.gitcd freesasagit checkout tags/1.1autoreconf -i./configure --enable-python-bindings --prefix=path/to/installmakemake install

For more recent versions of freesasa, please check the instructions for installing it on its Github (https://github.com/mittinatten/freesasa).

The fastest way to install LightDock is to usegit to clone the repository from GitHub:

git clone https://github.com/lightdock/lightdock-python2.7.git

A directory calledlightdock-python2.7 is now available. This is the path necessary for setting the enviroment variableLIGHTDOCK_HOME in your bash. Change your~/.bashrc accordingly (add the following lines to your~/.bashrc):

export LIGHTDOCK_HOME=/path/to/lightdock/folderexport PATH=$PATH:$LIGHTDOCK_HOME/bin:$LIGHTDOCK_HOME/bin/post:$LIGHTDOCK_HOME/bin/supportexport PYTHONPATH=$PYTHONPATH:$LIGHTDOCK_HOME

Once the library dependencies are installed, a compilation of some high-intensive calculation parts is required. To do so, a script is provided:

cd${LIGHTDOCK_HOME}/bin/setup./setup.sh

LightDock makes use of nosetests library for testing the different parts of the framework. There are two levels of testing: unitary and regression.

Library unit tests. To run them execute:

cd$LIGHTDOCK_HOME./run_tests.sh lib

Regression short tests. To run them execute:

cd$LIGHTDOCK_HOME./run_tests.sh reg

Regression long tests. To run them execute (this may take several minutes):

cd$LIGHTDOCK_HOMEexport LIGHTDOCK_LONG_TEST=true./run_tests.sh reg

NOTE: some tests may fail depending on float accuracy in your installation. This is probably not relevant unless you plan to run lightdock using that piece of code. Please, open an issue in this GitHub repository to get help.

This GitHubREADME.md file is intendedonly as an installation guide.

The complete documentation about how to run the LightDock protocol can be found athttps://lightdock.org.

Please visit theofficial website for instructions.