{"id":1704,"date":"2014-07-16T14:58:57","date_gmt":"2014-07-16T14:58:57","guid":{"rendered":"http:\/\/ri.itservices.manchester.ac.uk\/csf-apps\/?page_id=1704"},"modified":"2016-07-22T13:42:15","modified_gmt":"2016-07-22T13:42:15","slug":"autodock","status":"publish","type":"page","link":"https:\/\/ri.itservices.manchester.ac.uk\/csf-apps\/software\/applications\/autodock\/","title":{"rendered":"Autodock4 and Vina"},"content":{"rendered":"<h2>Overview<\/h2>\n<p>Autodock is a suite of automated docking tools. It is designed to predict how small molecules, such as substrates or drug candidates, bind to a receptor of known 3D structure. <\/p>\n<p>The following versions are installed on the CSF:<\/p>\n<ul>\n<li><a href=\"http:\/\/autodock.scripps.edu\/\">Autodock4<\/a> v4.2.5.1<\/li>\n<li><a href=\"http:\/\/autodock.scripps.edu\/downloads\/multilevel-parallel-autodock4.2\">Autodock4-MP<\/a> v4.2.2.1<\/li>\n<li><a href=\"http:\/\/vina.scripps.edu\/index.html\">Autodock Vina<\/a> v1.1.2<\/li>\n<\/ul>\n<p>Autodock Vina is the new version and can run in parallel (unlike Autodock4). Autodock4-MP is a parallelized version of Autodock4 but should be considered experimental on the CSF. Users are encouraged to try Autodock Vina first.<\/p>\n<h2>Restrictions on use<\/h2>\n<p>Access to Autodock4 and Autodock Vina is not restricted. However users must abide by the license terms of the software and provide citations in publications.<\/p>\n<p>Please see the <a href=\"http:\/\/www.gnu.org\/licenses\/gpl-2.0.html\">Autodock4 license<\/a> (GPL v2) and the <a href=\"http:\/\/vina.scripps.edu\/LICENSE\">Autodock Vina license<\/a> (a permissive Apache license).<\/p>\n<h2>Set up procedure<\/h2>\n<p>To access Vina you must first load the modulefile:<\/p>\n<pre>\r\nmodule load apps\/intel-12.0\/autodock\/vina-1.1.2\r\n<\/pre>\n<p>or, for serial autodock4:<\/p>\n<pre>\r\nmodule load apps\/intel-12.0\/autodock\/4.2.5.1\r\n<\/pre>\n<p>For parallel autodock4 load <em>one<\/em> of the following modulefiles:<\/p>\n<pre>\r\nmodule load apps\/intel-12.0\/autodock\/4.2.2.1-MP-omp              # Single node multithreaded\r\nmodule load apps\/intel-12.0\/autodock\/4.2.2.1-MP-mpi              # Single-node MPI\r\nmodule load apps\/intel-12.0\/autodock\/4.2.2.1-MP-mpi-ib           # Multi-node MPI\r\n<\/pre>\n<p>Any dependent modulefiles will be automatically loaded for you.<\/p>\n<p>The <code>4.2.2.1-MP-omp<\/code> modulefile provides a version that can be used on single Intel compute nodes (up to 24 cores). This also provides a serial version of Autodock4 MP which can be used to verify results from the parallel versions. It is highly recommended you do this to ensure the parallel versions are producing the results you expect!<\/p>\n<p>The <code>4.2.2.1-MP-mpi<\/code> modulefile provides a version that can be used on single compute node (up to 24 cores) using MPI.<\/p>\n<p>The <code>4.2.2.1-MP-mpi-ib<\/code> modulefile provides a version that can be used across multiple InfiniBand-connected Intel nodes and hence uses fast networking. The number of cores must be a multiple of 24 and the minimum number of cores is 48. This is the recommended MPI version.<\/p>\n<h2>Running the application<\/h2>\n<p>Please do not run Autodock on the login node. Jobs should be submitted to the compute nodes via batch.<\/p>\n<h3>Autodock4 Serial batch job submission<\/h3>\n<p>Make sure you have the modulefile loaded then create a batch submission script, for example:<\/p>\n<pre>\r\n#!\/bin\/bash\r\n#$ -S \/bin\/bash\r\n#$ -cwd             # Job will run from the current directory\r\n#$ -V               # Job will inherit current environment settings\r\n\r\nautodock4 -p macro.dpf\r\n<\/pre>\n<p>Submit the jobscript using: <\/p>\n<pre>qsub <em>scriptname<\/em><\/pre>\n<p>where <em>scriptname<\/em> is the name of your jobscript.<\/p>\n<h3>Autodock Vina Serial batch job submission<\/h3>\n<p>Make sure you have the modulefile loaded then create a batch submission script, for example:<\/p>\n<pre>\r\n#!\/bin\/bash\r\n#$ -S \/bin\/bash\r\n#$ -cwd             # Job will run from the current directory\r\n#$ -V               # Job will inherit current environment settings\r\n\r\n# NSLOTS will be set to 1, use it to inform vina how many CPUs we requested\r\nvina --cpu $NSLOTS --receptor file1 --flex file2 --ligand file3 -out outfile\r\n<\/pre>\n<p>Submit the jobscript using: <\/p>\n<pre>qsub <em>scriptname<\/em><\/pre>\n<p>where <em>scriptname<\/em> is the name of your jobscript.<\/p>\n<h3> Autodock Vina Parallel batch job submission<\/h3>\n<p>Note: Autodock4 will not run in parallel (see Autodock MP below).<\/p>\n<p>Make sure you have the modulefile loaded then create a batch submission script, for example:<\/p>\n<pre>\r\n#!\/bin\/bash\r\n#$ -S \/bin\/bash\r\n#$ -cwd             # Job will run from the current directory\r\n#$ -V               # Job will inherit current environment settings\r\n#$ -pe smp.pe 8     # Number of cores (2-24 permitted)\r\n\r\n# NSLOTS will be set to 8 (in this case), use it to inform vina how many CPUs we requested\r\nvina --cpu $NSLOTS --receptor file1 --flex file2 --ligand file3 -out outfile\r\n<\/pre>\n<p>Submit the jobscript using: <\/p>\n<pre>qsub <em>scriptname<\/em><\/pre>\n<p>where <em>scriptname<\/em> is the name of your jobscript.<\/p>\n<h3>Autodock4 MP Serial batch job submission<\/h3>\n<p>We recommend running the Autodock4 MP version&#8217;s serial compilation to give you a set of result against which you can compare the parallel version (see below for how to run in parallel). Make sure you have the modulefile loaded then create a batch submission script, for example:<\/p>\n<pre>\r\n#!\/bin\/bash\r\n#$ -S \/bin\/bash\r\n#$ -cwd             # Job will run from the current directory\r\n#$ -V               # Job will inherit current environment settings\r\n\r\nautodock4_serial -p macro.dpf\r\n<\/pre>\n<p>Submit the jobscript using: <\/p>\n<pre>qsub <em>scriptname<\/em><\/pre>\n<p>where <em>scriptname<\/em> is the name of your jobscript.<\/p>\n<p>To see the complete list of command-line flags simply run <code>autodock4_serial<\/code> on the login node without any input file.<\/p>\n<h3>Autodock4 MP Parallel batch job submission (multithreaded)<\/h3>\n<p>Note that the OpenMP (multithreaded) version uses the same command-line flags as the above serial version with the addition of a <code>-r<\/code> option for the seed type (if unspecified the default_seed is used):<\/p>\n<pre>\r\n-r <em>seed_type<\/em>\r\n<\/pre>\n<p>The <em>seed_type<\/em> accepted values are:<\/p>\n<ul>\n<li><code>same_seed<\/code> &#8211; Use a hard-coded seed value, useful only in doing performance measurements by deterministically running the docking.<\/li>\n<li><code>default_seed<\/code> &#8211; Use the time of day plus the threadid for the seed.<\/li>\n<\/ul>\n<p>Make sure you have the modulefile loaded then create a batch submission script, for example:<\/p>\n<pre>\r\n#!\/bin\/bash\r\n#$ -S \/bin\/bash\r\n#$ -cwd             # Job will run from the current directory\r\n#$ -V               # Job will inherit current environment settings\r\n#$ -pe smp.pe 8     # Number of cores (max 24) in a single node\r\n\r\n# You MUST set this to inform autodock how many cores to use:\r\nexport OMP_NUM_THREADS=$NSLOTS\r\n\r\nautodock4_omp -p macro.dpf -l macro.dlg        # Send output to logfile macro.dlg\r\n<\/pre>\n<p>Submit the jobscript using: <\/p>\n<pre>qsub <em>scriptname<\/em><\/pre>\n<p>where <em>scriptname<\/em> is the name of your jobscript.<\/p>\n<h3>Autodock4 MP Parallel batch job submission (multi-node)<\/h3>\n<p>Note that the MPI version (multi-node) uses a <em>different<\/em> set of command-line flags to the above two examples. It requires the following options <em>in the order given here<\/em>:<\/p>\n<pre>\r\n<em>docking_list_file docking_base_directory status_directory seed_type map_file_usage<\/em>\r\n<\/pre>\n<p>where<\/p>\n<ul>\n<li>docking_list_file: file containing the list of ligands to be docked<\/li>\n<li>docking_base_directory: base directory containing the ligand directories created with the python scripts for the virtual screening setup (eg. the &#8216;Dockings&#8217; directory from the UsingAutoDock4forVirtualScreening_v4.pdf tutorial)<\/li>\n<li>status_directory: directory containing the following status and performance logging files, updated in real time as each docking finishes<\/li>\n<li>seed_type: Indicator for the value used to seed the RNG, values must be:\n<ul>\n<li><code>same_seed<\/code> &#8211; Use a hard-coded seed value, useful only in doing performance measurements.<\/li>\n<li><code>default_seed<\/code>&#8211; Use the time of day plus the threadid for the seed.<\/li>\n<li><code>unique_node_seed<\/code>&#8211; Use the time of day plus the threadid plus the MPI rank for the seed.<\/li>\n<\/ul>\n<p>Note that in this version the MPI ranks are single-threaded.<\/li>\n<li>map_file_usage: Indicator for whether or not grid maps should persist in memory on the slave nodes from docking to docking &#8211; value must be either <code>reuse_maps<\/code> or <code>reload_maps<\/code>.<\/li>\n<\/ul>\n<p>Refer to the paper <a href=\"http:\/\/www.jcheminf.com\/content\/3\/1\/12\">Multilevel Parallelization of AutoDock 4.2<\/a> for further information for these runtime options and for details on the parallelization strategy and performance improvements.<\/p>\n<h3>Further Advice on Running MPI Jobs<\/h3>\n<p>We have received the following advice from a CSF user who has tested autodock4_mpi:<\/p>\n<p>Assuming you are running the job from the <em>scratch<\/em> directory, the following files should be placed there:<\/p>\n<ul>\n<li><code>receptor.pdbqt<\/code> &#8211; to be read by <code>autogrid4.py<\/code>, a script that can be downloaded from the AutoDock website. It must be run before the <code>autodock4_mpi<\/code> job to have the grid map files previously generated (see below).<\/li>\n<li><code>file.gpf<\/code> &#8211; file you use to create the grid map files. Take into account that if you reload the grid maps, all the gpf files used must be also in that directory.<\/li>\n<li><code><em>ligand_receptor<\/em>.dpf<\/code> &#8211; a file you create with the <code>prepare_dpf4.py<\/code> script that is available on the CSF by doing:\n<pre>\r\nmodule load apps\/binapps\/mgltools\/1.5.6\r\n$ADTUTILS\/prepare_dpf4.py -l <em>ligand<\/em>.pdbqt -r <em>receptor<\/em>.pdbqt\r\n<\/pre>\n<p>This will output a <code><em>ligand_receptor<\/em>.dpf<\/code> file by default.\n<\/li>\n<\/ul>\n<p>To run the <code>autogrid4<\/code> command to generate grid map files run:<\/p>\n<pre>\r\nmodule load apps\/intel-12.0\/autodock\/4.2.5.1\r\nautogrid4 -p sample.gpf -l sample.glg\r\n  #\r\n  # This will also read the receptor.pdbqt file\r\n<\/pre>\n<p>For further information see the <a href=\"http:\/\/autodock.scripps.edu\/faqs-help\/how-to\/how-to-prepare-a-docking-parameter-file-for-autodock4-1\">tutorial<\/a> on the AutoDock website.<br \/>\nYou will also need to create the following directories using the <code>mkdir<\/code> command in your <em>scratch<\/em> area (we assume you are running from your <em>scratch<\/em> area):<\/p>\n<ul>\n<li><code>etc\/<\/code> (here one must save a <em>docking.list<\/em> file with a list of all the names of the ligands. The UsingAutoDock4forVirtualScreening_v4.pdf tutorial can help to know how to create it)<\/li>\n<li><code>results\/pdbqt_lip_rules\/<\/code> (inside the <code>pdbqt_lip_rules\/<\/code> directory one must save all the <code>ligands.pdbqt<\/code> files)<\/li>\n<\/ul>\n<p>Make sure you have the modulefile loaded then create a batch submission script, for example:<\/p>\n<pre>\r\n#!\/bin\/bash\r\n#$ -S \/bin\/bash\r\n#$ -cwd                   # Job will run from the current directory\r\n#$ -V                     # Job will inherit current environment settings\r\n#$ -pe orte-24-ib.pe 48   # Run on faster IB-connected h\/w (multiple of 24 cores)\r\n\r\n# $NSLOTS is automatically set to the number of cores given above\r\nmpirun -np $NSLOTS autodock4_mpi <em>docking_list_file docking_base_directory \\\r\n                                     status_directory seed_type map_file_usage<\/em>\r\n\r\n<\/pre>\n<p>where the path of the <em>docking_base_directory<\/em> and the <em>status_directory<\/em> should be the directory where all the files have been saved (<em>scratch<\/em> in our example).<\/p>\n<p>Submit the jobscript using: <\/p>\n<pre>qsub <em>scriptname<\/em><\/pre>\n<p>where <em>scriptname<\/em> is the name of your jobscript.<\/p>\n<p>Once autodock4 has run, it will generate:<\/p>\n<ul>\n<li>The glg file or files (depending on the number of file.gpf used)<\/li>\n<li>The dlg files<\/li>\n<li>The following files: <em>docking_performance.csv<\/em>, <em>failed_dockings<\/em>, <em>submitted_dockings<\/em>, <em>successful_dockings<\/em>.<\/li>\n<\/ul>\n<h2>Further info<\/h2>\n<ul>\n<li><a href=\"http:\/\/autodock.scripps.edu\/\">Autodock4 website<\/a><\/li>\n<li><a href=\"http:\/\/autodock.scripps.edu\/downloads\/multilevel-parallel-autodock4.2\">Autodock4-MP website<\/a><\/li>\n<li><a href=\"http:\/\/vina.scripps.edu\/\">Autodock Vina website<\/a><\/li>\n<\/ul>\n<h2>Updates<\/h2>\n<p>None.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Overview Autodock is a suite of automated docking tools. It is designed to predict how small molecules, such as substrates or drug candidates, bind to a receptor of known 3D structure. The following versions are installed on the CSF: Autodock4 v4.2.5.1 Autodock4-MP v4.2.2.1 Autodock Vina v1.1.2 Autodock Vina is the new version and can run in parallel (unlike Autodock4). Autodock4-MP is a parallelized version of Autodock4 but should be considered experimental on the CSF. Users.. <a href=\"https:\/\/ri.itservices.manchester.ac.uk\/csf-apps\/software\/applications\/autodock\/\">Read more &raquo;<\/a><\/p>\n","protected":false},"author":2,"featured_media":0,"parent":31,"menu_order":0,"comment_status":"open","ping_status":"closed","template":"","meta":{"footnotes":""},"class_list":["post-1704","page","type-page","status-publish","hentry"],"_links":{"self":[{"href":"https:\/\/ri.itservices.manchester.ac.uk\/csf-apps\/wp-json\/wp\/v2\/pages\/1704","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/ri.itservices.manchester.ac.uk\/csf-apps\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/ri.itservices.manchester.ac.uk\/csf-apps\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/ri.itservices.manchester.ac.uk\/csf-apps\/wp-json\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/ri.itservices.manchester.ac.uk\/csf-apps\/wp-json\/wp\/v2\/comments?post=1704"}],"version-history":[{"count":20,"href":"https:\/\/ri.itservices.manchester.ac.uk\/csf-apps\/wp-json\/wp\/v2\/pages\/1704\/revisions"}],"predecessor-version":[{"id":3235,"href":"https:\/\/ri.itservices.manchester.ac.uk\/csf-apps\/wp-json\/wp\/v2\/pages\/1704\/revisions\/3235"}],"up":[{"embeddable":true,"href":"https:\/\/ri.itservices.manchester.ac.uk\/csf-apps\/wp-json\/wp\/v2\/pages\/31"}],"wp:attachment":[{"href":"https:\/\/ri.itservices.manchester.ac.uk\/csf-apps\/wp-json\/wp\/v2\/media?parent=1704"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}