{"id":79,"date":"2013-04-19T15:53:28","date_gmt":"2013-04-19T15:53:28","guid":{"rendered":"http:\/\/ri.itservices.manchester.ac.uk\/csf-apps\/?page_id=79"},"modified":"2016-07-22T14:25:19","modified_gmt":"2016-07-22T14:25:19","slug":"charmm","status":"publish","type":"page","link":"https:\/\/ri.itservices.manchester.ac.uk\/csf-apps\/software\/applications\/charmm\/","title":{"rendered":"CHARMM"},"content":{"rendered":"<h2>Overview<\/h2>\n<p>CHARMM is a many-particle molecular simulation program which focuses on biological systems, e.g. peptides, proteins, prosthetic groups, small molecule ligands, nucleic acids, lipids, and carbohydrates. <\/p>\n<p>Version c35b2 and c36b2 of CHARMM are available both compiled with the xlarge, MPI and em64t options using Intel compilers v11.1. Version c36b2 has also been compiled with the Intel 12.0 compiler (e.g., for use with <a href=\"\/csf-apps\/software\/applications\/chemshell\/\">ChemShell<\/a> 3.5.0 which has also been compiled with the Intel 12.0 compiler).<\/p>\n<h2>Restrictions on use<\/h2>\n<p>The CHARMM installs are restricted to specific research groups. Only these groups may use the software and only the version they have a license for. The head of any research group holding a license can email <a href=\"m&#97;&#105;&#108;&#x74;&#x6f;&#x3a;it&#115;&#45;&#x72;&#x69;&#x2d;&#x74;ea&#109;&#64;&#x6d;&#x61;&#x6e;&#x63;h&#101;&#115;&#116;&#x65;&#x72;&#x2e;ac&#46;&#117;&#107;\">&#x69;&#x74;&#x73;&#x2d;&#x72;&#x69;&#x2d;&#x74;&#x65;&#x61;&#x6d;&#x40;&#x6d;&#x61;&#110;&#99;&#104;&#101;&#115;&#116;&#101;&#114;&#46;&#97;&#99;&#46;uk<\/a> to find out how to get access to CHARMM.<\/p>\n<p>Version c35b2 &#8211; A full copy of the license is available from the Head of the Research Group.<\/p>\n<p>Version c36b2 &#8211; A full copy of the license is available in <code>\/opt\/gridware\/apps\/intel-11.1\/charmm\/c36b2\/CharmmLicenseForm.pdf<\/code><\/p>\n<p>Important points to note are:<\/p>\n<ul>\n<li>The software can only be used internally for non-commercial purposes and cannot be used for any work that is funded by a commercial organisations. Check the license (usually Section 5) for a full definition of what is classed as non-commercial.<\/li>\n<li>The software may only be used on campus.<\/li>\n<li>Any reports or publications must contain an acknowledgement as set out in the license (usually Section 12).<\/li>\n<\/ul>\n<p>Users wishing to access the software should request access via <a href=\"&#109;a&#x69;l&#x74;o&#x3a;&#105;&#x74;&#115;&#x2d;&#114;i&#x2d;t&#x65;a&#x6d;&#64;&#x6d;&#97;&#x6e;&#99;&#x68;&#101;s&#x74;e&#x72;&#46;&#x61;&#99;&#x2e;&#117;&#x6b;\">&#105;&#x74;&#x73;&#45;&#x72;&#x69;&#45;&#x74;&#x65;&#97;&#x6d;&#x40;&#109;&#x61;&#x6e;&#99;&#x68;&#x65;&#115;&#x74;&#x65;&#114;&#x2e;&#x61;&#99;&#x2e;&#x75;k<\/a>. A confirmation email will be sent once a user has been added to the appropriate unix group and users who are not part of an eligible research group will be given additional advice on how to proceed.<\/p>\n<h2>Set up procedure<\/h2>\n<p>To use CHARMM load <em>one<\/em> of the following modulefiles: <\/p>\n<pre>\r\n# Version c35b2\r\nmodule load apps\/intel-11.1\/charmm\/c35b2\r\n\r\n# Version c36b2 (with different compiler versions and possibly infiniband)\r\nmodule load apps\/intel-12.0\/charmm\/c36b2-ib     # Use for multi-node MPI jobs\r\nmodule load apps\/intel-12.0\/charmm\/c36b2\r\nmodule load apps\/intel-11.1\/charmm\/c36b2\r\n<\/pre>\n<p>The above modulefiles will automatically load the appropriate compiler and MPI modulefiles.<\/p>\n<h2>Running the application<\/h2>\n<h3>Charmm c36b2<\/h3>\n<p>Charmm will read a file named <code>charmm.inp<\/code> in the current directory if no input files are specified on the charmm command-line in your jobscript (never run charmm on the login node!)<\/p>\n<p>Alternatively you may specify input and output files using command-line flags:<\/p>\n<pre>\r\ncharmm -i myinputfile.inp -o myoutputfile.out\r\n<\/pre>\n<p>A third method will <strong>fail<\/strong> when running in parallel where input\/output is done by reading from <em>stdin<\/em> and writing to <em>stdout<\/em> using a command-line such as:<\/p>\n<pre>\r\n# This will FAIL when running charmm in parallel\r\ncharmm < myinputfile.inp > myoutputfile.out\r\n<\/pre>\n<p>It is safest to always use the <code>-i<\/code> and <code>-o<\/code> flags.<\/p>\n<h3>Charmm c35b2<\/h3>\n<p>First load the required module (see above) and create a directory containing a file called charmm.inp containing the job parameters. <\/p>\n<p>Note: a feature of the MPI, em64t c35b2 version of CHARMM is that it will read input only from a file named charmm.inp, i.e. CHARMM will not read from standard input. This is described <a href=\"http:\/\/www.charmm.org\/ubbthreads-7-5-5\/ubbthreads.php?ubb=showflat&#038;Number=21389 for info \">here<\/a>. If you see messages which look like:<\/p>\n<pre>\r\n# forrtl: No such file or directory\r\n# forrtl: severe (29): file not found, unit 5, file \/opt\/gridware\/apps\/intel-11.1\/charmm\/c35b2\/test\/charmm.inp\r\n<\/pre>\n<p>it is likely to be for this reason.<\/p>\n<h2>Serial job<\/h2>\n<p>1. An example batch submission script:<\/p>\n<pre>\r\n### SGE Job Stuff\r\n#$ -cwd\r\n#$ -V\r\n\r\ncharmm\r\n<\/pre>\n<p>2. Submit with the command: `qsub scriptname`<\/p>\n<h2>Parallel job<\/h2>\n<h3>Single node job &#8211; 2 to 24 cores<\/h3>\n<p>Ensure you have an modulefile without &#8216;ib&#8217; in the name loaded.<\/p>\n<p>An example batch submission script that will read a file named <code>charmm.inp<\/code> in the current directory:<\/p>\n<pre>\r\n#!\/bin\/bash\r\n#$ -S bash\r\n#$ -cwd\r\n#$ -V\r\n#$ -pe smp.pe 8       # Use 8 cores on a single node. Min 2, max 24.\r\n\r\nmpiexec -n $NSLOTS charmm\r\n<\/pre>\n<p>Submit with the command <code>qsub <em>scriptname<\/em><\/code> where <em>scriptname<\/em> is the name of your jobscript from above.<\/p>\n<h3>Multi-node jobs &#8211; 48+ cores<\/h3>\n<p>Ensure you have loaded a charmm modulefile with <code>-ib<\/code> in the name.<\/p>\n<p>An example batch submission script that will read a file named <code>charmm.inp<\/code> in the current directory:<\/p>\n<pre>\r\n#!\/bin\/bash\r\n#$ -S bash\r\n#$ -cwd\r\n#$ -V\r\n#$ -pe orte-24-ib 48       # Use two nodes, each with 24 cores\r\n\r\nmpiexec -n $NSLOTS charmm\r\n<\/pre>\n<p>Submit with the command <code>qsub <em>scriptname<\/em><\/code> where <em>scriptname<\/em> is the name of your jobscript from above.<\/p>\n<p>The following is an example batch submission script that will read and write named files:<\/p>\n<pre>\r\n#!\/bin\/bash\r\n#$ -S bash\r\n#$ -cwd\r\n#$ -V\r\n#$ -pe orte-24-ib 48       # Use two nodes, each with 24 cores\r\n\r\nmpiexec -n $NSLOTS charmm -i myinputfile.inp -o myoutputfile.out\r\n<\/pre>\n<p>Submit the job using <code>qsub <em>jobscript<\/em><\/code> where <em>jobscript<\/em> is the name of your script above.<\/p>\n<p>If your jobscript contains file input\/output using redirection, such as:<\/p>\n<pre>\r\n# WARNING: This will FAIL!\r\nmpiexec -n $NSLOTS charmm < myinputfile.inp > myoutputfile.out\r\n<\/pre>\n<p>it will fail when run in parallel. Use the <code>-i<\/code> and <code>-o<\/code> flags instead.<\/p>\n<h2>Further info<\/h2>\n<ul>\n<li><a href=\"http:\/\/www.charmm.org\/\">CHARMM web pages<\/a><\/li>\n<li><a href=\"http:\/\/www.charmm.org\/ubbthreads-7-5-5\/ubbthreads.php?ubb=cfrm\">CHARMM forums<\/a><\/li>\n<\/ul>\n<h2>Updates<\/h2>\n<p>None at this time.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Overview CHARMM is a many-particle molecular simulation program which focuses on biological systems, e.g. peptides, proteins, prosthetic groups, small molecule ligands, nucleic acids, lipids, and carbohydrates. Version c35b2 and c36b2 of CHARMM are available both compiled with the xlarge, MPI and em64t options using Intel compilers v11.1. Version c36b2 has also been compiled with the Intel 12.0 compiler (e.g., for use with ChemShell 3.5.0 which has also been compiled with the Intel 12.0 compiler). Restrictions.. <a href=\"https:\/\/ri.itservices.manchester.ac.uk\/csf-apps\/software\/applications\/charmm\/\">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-79","page","type-page","status-publish","hentry"],"_links":{"self":[{"href":"https:\/\/ri.itservices.manchester.ac.uk\/csf-apps\/wp-json\/wp\/v2\/pages\/79","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=79"}],"version-history":[{"count":14,"href":"https:\/\/ri.itservices.manchester.ac.uk\/csf-apps\/wp-json\/wp\/v2\/pages\/79\/revisions"}],"predecessor-version":[{"id":3243,"href":"https:\/\/ri.itservices.manchester.ac.uk\/csf-apps\/wp-json\/wp\/v2\/pages\/79\/revisions\/3243"}],"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=79"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}