{"id":5808,"date":"2022-01-13T14:59:19","date_gmt":"2022-01-13T14:59:19","guid":{"rendered":"http:\/\/ri.itservices.manchester.ac.uk\/csf3\/?page_id=5808"},"modified":"2025-12-04T11:35:35","modified_gmt":"2025-12-04T11:35:35","slug":"alphafold","status":"publish","type":"page","link":"https:\/\/ri.itservices.manchester.ac.uk\/csf3\/software\/applications\/alphafold\/","title":{"rendered":"Alphafold 2"},"content":{"rendered":"<h2>Overview<\/h2>\n<p>AlphaFold is an application for predicting models of protein structures.<\/p>\n<p>AlphaFold requires a suite of supporting tools to be installed, therefore Alphafold and all supporting tools are available within a singularity container.<\/p>\n<h2>Restrictions on use<\/h2>\n<p>Although the AlphaFold code is licensed under the <a href=\"https:\/\/www.apache.org\/licenses\/LICENSE-2.0\">Apache License, Version 2.0 (the &#8220;License&#8221;)<\/a> and therefore is considered open source. Alphafold utilises various genetic databases, model parameters, and third party software all using a variety of licenses.<\/p>\n<p><strong>Users wishing to access Alphafold should review and agree, in a support request submitted using the <a href=\"https:\/\/ri.itservices.manchester.ac.uk\/hpc-help\">Connect Portal HPC form<\/a>, that they will abide to the T&amp;Cs of the various licenses.<\/strong><\/p>\n<p>Please follow this link for further information and to view all associated licenses\u00a0 &#8211; <a href=\"https:\/\/github.com\/deepmind\/alphafold#license-and-disclaimer\">Alphafold License and Disclaimer\u00a0<\/a><\/p>\n<p>Only users who have been added to the Alphafold group can run the application.<\/p>\n<p>Any publication that discloses findings arising from using this source code or the model parameters should\u00a0<a href=\"https:\/\/github.com\/deepmind\/alphafold#citing-this-work\">cite<\/a>\u00a0the\u00a0<a href=\"https:\/\/doi.org\/10.1038\/s41586-021-03819-2\" rel=\"nofollow\">AlphaFold paper<\/a>\u00a0and, if applicable, the\u00a0<a href=\"https:\/\/www.biorxiv.org\/content\/10.1101\/2021.10.04.463034v1\" rel=\"nofollow\">AlphaFold-Multimer paper<\/a>.<\/p>\n<p><strong>Access to GPUs maybe controlled<\/strong>. If you do not have access to GPUs and you wish to use this software on GPUs please let us know when you request access.<\/p>\n<h2>Set up procedure<\/h2>\n<p>We now recommend loading modulefiles within your jobscript so that you have a full record of how the job was run. See the example jobscript below for how to do this. Alternatively, you may load modulefiles on the login node and let the job inherit these settings.<\/p>\n<p>Load one of the following modulefiles:<\/p>\n<pre>module load apps\/singularity\/alphafold\/2.3.0\r\nmodule load apps\/singularity\/alphafold\/2.1.1  \r\nmodule load apps\/singularity\/alphafold\/2.0\r\n<\/pre>\n<p>Version 2.1.1 (and up) supports multimer modelling, however should not be considered as stable as the monomer Alphafold system<\/p>\n<h2>Running the application<\/h2>\n<p>Please do not run Alphafold on the login node. Jobs should be submitted to the compute nodes via batch.<\/p>\n<p>Ideally, Alphafold should be run in a parallel environment using 8 cores (there are steps in the code which are hardcoded to use 8 cores) with or without a single GPU (by default will use GPU).\u00a0 Unfortunately, Alphafold cannot use more than 1x GPU<\/p>\n<h3><strong>Genetic Databases<\/strong><\/h3>\n<p>AlphaFold needs multiple genetic (sequence) databases to run, they have already been downloaded and Alphafold has been setup to access them by default.\u00a0 Please note users will need to be a member of the <code>alphafold<\/code> unix group in order to access them see <a href=\"#Restrictions_on_use\">Restrictions on use section<\/a>.<\/p>\n<h3>Parallel batch jobscript with GPU<\/h3>\n<p><strong>Please note that access to GPUs maybe <a href=\"https:\/\/ri.itservices.manchester.ac.uk\/csf3\/batch-slurm\/gpu-jobs-slurm\/\">controlled<\/a><\/strong>, depending on your group. <\/p>\n<p>Create a batch submission script (which will load the modulefile in the jobscript), for example:<\/p>\n<pre class=\"slurm\">\r\n#!\/bin\/bash --login\r\n#SBATCH -p gpuV  # Partition is required, choose based on type of CPU you want\r\n#SBATCH -G 1     # use only 1 x v100 GPU\r\n#SBATCH -n 8     # Job will run using 8 CPU cores (max 8 CPU cores per v100 GPU)\r\n#SBATCH -t 2-0   # Wallclock limit (days-hours). Required!\r\n                 # Max permitted is 7 days (7-0).\r\n\r\n# Clear any loaded modules in pre-existing environment, then load the required version\r\nmodule purge\r\nmodule load apps\/singularity\/alphafold\/2.1.1\r\n\r\nrun_alphafold.sh -f $PWD\/<em>filename.fasta<\/em> -t <em>YYYY-MM-DD<\/em> -o $PWD\/<em>output_directory<\/em> -m <em>model_preset<\/em>\r\n  #\r\n  # PLEASE NOTE: $PWD is required so the singularity container is able to map to the CSF filesystem \r\n<\/pre>\n<h3>Parallel batch jobscript without GPU<\/h3>\n<p>Create a batch submission script (which will load the modulefile in the jobscript), for example:<\/p>\n<pre class=\"slurm\">#!\/bin\/bash --login\r\n#SBATCH -p multicore     # Partition is required. Runs on an AMD Genoa hardware.\r\n#SBATCH -n 8             # Job will run using 8 CPU cores\r\n#SBATCH -t 2-0           # Wallclock limit (days-hours). Required!\r\n                         # Max permitted is 7 days (7-0).\r\n\r\n# Clear any loaded modules in pre-existing environment, then load the required version\r\nmodule purge\r\nmodule load apps\/singularity\/alphafold\/2.1.1\r\n\r\nrun_alphafold.sh -f $PWD\/<em>filename.fasta<\/em> -t <em>YYYY-MM-DD<\/em> -o $PWD\/<em>output_directory<\/em> -m <em>model_preset<\/em> -g false\r\n  #\r\n  # PLEASE NOTE: $PWD is required so the singularity container is able to map to the CSF filesystem\r\n<\/pre>\n<h3>Required and Optional Parameters<\/h3>\n<p><strong>Required Parameters:<\/strong><\/p>\n<pre><strong>-o<\/strong> &lt;output_dir&gt; Path to a directory that will store the results.\r\n<strong>-m<\/strong> &lt;model_preset&gt; Choose preset model configuration - the monomer model (<strong>monomer<\/strong>), the monomer model with extra ensembling (<strong>monomer_casp14<\/strong>), monomer model with pTM head (<strong>monomer_ptm<\/strong>), or multimer model (<strong>multimer<\/strong>) (default: 'monomer')\r\n<strong>-f<\/strong> &lt;fasta_path&gt; Path to a FASTA file containing one sequence\r\n<strong>-t<\/strong> &lt;max_template_date&gt; Maximum template release date to consider (ISO-8601 format - i.e. <strong>YYYY-MM-DD<\/strong>). Important if folding historical test sets\r\n<\/pre>\n<p><strong>Optional Parameters:<\/strong><\/p>\n<pre><strong>-g<\/strong> &lt;use_gpu&gt; Enable NVIDIA runtime to run with GPUs (default: <strong>true<\/strong>)\r\n<strong>-c<\/strong> &lt;db_preset&gt; Choose preset MSA database configuration - smaller genetic database config (<strong>reduced_dbs<\/strong>) or full genetic database config (<strong>full_dbs<\/strong>) (default: '<strong>full_dbs<\/strong>')\r\n<strong>-p<\/strong> &lt;use_precomputed_msas&gt; Whether to read MSAs that have been written to disk. WARNING: This will not check if the sequence, database or configuration have changed (default: '<strong>false<\/strong>')\r\n<strong>-l<\/strong> &lt;is_prokaryote&gt; Optional for multimer system, not used by the single chain system. A boolean specifying true where the target complex is from a prokaryote, and false where it is not, or where the origin is unknown. This value determine the pairing method for the MSA (default: '<strong>None<\/strong>')\r\n<strong>-b<\/strong> &lt;benchmark&gt; Run multiple JAX model evaluations to obtain a timing that excludes the compilation time, which should be more indicative of the time required for inferencing many proteins (default: '<strong>false<\/strong>')\r\n<\/pre>\n<h3>Batch jobs submission<\/h3>\n<p>Submit the jobscript using:<\/p>\n<pre class=\"slurm\">sbatch <em>scriptname<\/em><\/pre>\n<p>where <em>scriptname<\/em> is the name of your jobscript.<\/p>\n<h3>Own singularity container image<\/h3>\n<p>If you wish to build your own singularity image you should copy the above files to your local PC and run singularity there. For security reasons only the sysadmins can build images on the CSF.<\/p>\n<h2>Further info<\/h2>\n<p><a href=\"https:\/\/github.com\/deepmind\/alphafold\">Github Deepmind\/alphafold\u00a0<\/a><\/p>\n<h2>Guide with input files<\/h2>\n<p>One of our Alphafold users on CSF3 has very kindly provided a <a href=\"https:\/\/ri.itservices.manchester.ac.uk\/csf3\/wp-content\/uploads\/Alphafold_on_HPC.pdf\">guide<\/a> with example <a href=\"https:\/\/ri.itservices.manchester.ac.uk\/csf3\/wp-content\/uploads\/example.zip\">input files<\/a> to help get new users started.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Overview AlphaFold is an application for predicting models of protein structures. AlphaFold requires a suite of supporting tools to be installed, therefore Alphafold and all supporting tools are available within a singularity container. Restrictions on use Although the AlphaFold code is licensed under the Apache License, Version 2.0 (the &#8220;License&#8221;) and therefore is considered open source. Alphafold utilises various genetic databases, model parameters, and third party software all using a variety of licenses. Users wishing.. <a href=\"https:\/\/ri.itservices.manchester.ac.uk\/csf3\/software\/applications\/alphafold\/\">Read more &raquo;<\/a><\/p>\n","protected":false},"author":12,"featured_media":0,"parent":86,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"","meta":{"footnotes":""},"class_list":["post-5808","page","type-page","status-publish","hentry"],"_links":{"self":[{"href":"https:\/\/ri.itservices.manchester.ac.uk\/csf3\/wp-json\/wp\/v2\/pages\/5808","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/ri.itservices.manchester.ac.uk\/csf3\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/ri.itservices.manchester.ac.uk\/csf3\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/ri.itservices.manchester.ac.uk\/csf3\/wp-json\/wp\/v2\/users\/12"}],"replies":[{"embeddable":true,"href":"https:\/\/ri.itservices.manchester.ac.uk\/csf3\/wp-json\/wp\/v2\/comments?post=5808"}],"version-history":[{"count":22,"href":"https:\/\/ri.itservices.manchester.ac.uk\/csf3\/wp-json\/wp\/v2\/pages\/5808\/revisions"}],"predecessor-version":[{"id":11462,"href":"https:\/\/ri.itservices.manchester.ac.uk\/csf3\/wp-json\/wp\/v2\/pages\/5808\/revisions\/11462"}],"up":[{"embeddable":true,"href":"https:\/\/ri.itservices.manchester.ac.uk\/csf3\/wp-json\/wp\/v2\/pages\/86"}],"wp:attachment":[{"href":"https:\/\/ri.itservices.manchester.ac.uk\/csf3\/wp-json\/wp\/v2\/media?parent=5808"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}