{"id":135,"date":"2013-04-22T13:08:05","date_gmt":"2013-04-22T13:08:05","guid":{"rendered":"http:\/\/ri.itservices.manchester.ac.uk\/csf-apps\/?page_id=135"},"modified":"2016-06-22T14:22:43","modified_gmt":"2016-06-22T14:22:43","slug":"dl_poly","status":"publish","type":"page","link":"https:\/\/ri.itservices.manchester.ac.uk\/csf-apps\/software\/applications\/dl_poly\/","title":{"rendered":"DL_POLY"},"content":{"rendered":"<h2>Overview<\/h2>\n<p>DL_POLY refers to a suite of general purpose molecular dynamics simulation packages, including<\/p>\n<ul>\n<li><a href=\"\/csf-apps\/software\/applications\/dl_poly4\">DL_POLY_4<\/a> &#8211; version 4 of the STFC codes with a STFC licence and requires MPI2 to allow parallel I\/O. Its general parallel approach is domain decomposition. This version is not currently available on the CSF.<\/li>\n<li>DL_POLY_CLASSIC &#8211; (documented on this page) an Open Source branch of DL_POLY_2 with a BSD (ie less restrictive) licence. This is installed on CSF and available to all users. It replicates data to allow parallelism.<\/li>\n<\/ul>\n<p>Please see <a href=\"#FurtherInfo\">Further Info<\/a> for more details<\/p>\n<h2>Running DL_POLY_CLASSIC<\/h2>\n<p>The CSF has four versions of DL_POLY_CLASSIC:<\/p>\n<table>\n<tr>\n<td width=\"26%\"><strong>Build<\/strong><\/td>\n<td><strong>DL_POLY_CLASSIC Module<\/strong><\/td>\n<td width=\"27%\"><strong>Required Modules<\/strong><\/td>\n<\/tr>\n<tr>\n<td>serial, low optimisation (higher accuracy) <\/td>\n<td> apps\/intel-11.1\/dl_poly_classic\/1.2\/parallel-lowOpt <\/td>\n<td> &#8211; <\/td>\n<\/tr>\n<tr>\n<td>serial, high optimisation (lower accuracy) <\/td>\n<td> apps\/intel-11.1\/dl_poly_classic\/1.2\/parallel-maxOpt <\/td>\n<td> &#8211; <\/td>\n<\/tr>\n<tr>\n<td>parallel, low optimisation (higher accuracy) <\/td>\n<td> apps\/intel-11.1\/dl_poly_classic\/1.2\/serial-lowOpt <\/td>\n<td> mpi\/intel-11.1\/openmpi\/1.4.3<\/td>\n<\/tr>\n<tr>\n<td>parallel, high optimisation (lower accuracy) <\/td>\n<td> apps\/intel-11.1\/dl_poly_classic\/1.2\/serial-maxOpt  <\/td>\n<td>mpi\/intel-11.1\/openmpi\/1.4.3<\/td>\n<\/tr>\n<\/table>\n<p>To run DL_POLY_CLASSIC<\/p>\n<ol>\n<li>load the required modules<\/li>\n<li>create your input deck<\/li>\n<li>run DLPOLY.X in batch, either in serial or under MPI<\/li>\n<\/ol>\n<h2>Requirements<\/h2>\n<ul>\n<li>the MPI versions were compiled against the Gigabit Ethernet and are not compatible with the Infiniband implementation of MPI<\/li>\n<li>all versions were compiled with Intel 11.1 compilers<\/li>\n<\/ul>\n<h3>Example<\/h3>\n<p>MPI, high optimisation example:<\/p>\n<pre>\r\n# load the compiler, MPI and DLPOLY modules\r\nmodule load compilers\/intel\/fortran\/11.1.064\r\nmodule load mpi\/intel-11.1\/openmpi\/1.4.3 \r\nmodule load apps\/intel-11.1\/dl_poly_classic\/1.2\/parallel-maxOpt\r\n \r\n# change to user DLPOLY directory, for example (change to suit your own dir names):\r\ncd ~\/scratch\/sim1\r\n\r\n# submit job to 4 cores on Gigabit Ethernet connected nodes\r\nqsub -b y -V -cwd -pe smp.pe 4 mpirun -n 4 DLPOLY.X\r\n<\/pre>\n<p>An example of the batch submission command as a jobscript:<\/p>\n<pre>\r\n#!\/bin\/basg\r\n#$ -S \/bin\/bash\r\n#$ -cwd\r\n#$ -V\r\n#$ -pe smp.pe 4\r\n\r\nmpirun -n $NSLOTS DLPOLY.X\r\n<\/pre>\n<p>Submit the jobscript thus:<\/p>\n<pre>\r\nqsub jobscript\r\n<\/pre>\n<p>where <code>jobscript<\/code> is the name of your jobscript file.<\/p>\n<h2>Running the DL_POLY_CLASSIC Java GUI<\/h2>\n<p>Please note that we do not provide support on how to use the GUI. Instructions are given here to launch the GUI but you should consult the DL POLY documentation for help with using the GUI.<\/p>\n<p>The Java GUI allows interactive use of DL POLY. While batch use of DL POLY is preferred (see above) the GUI may be useful when building systems for simulation.<\/p>\n<p>To run the GUI you must create a couple of local directories in your account and copy two system files in to these directories. You then run the GUI from one of these directories. A script is available on the CSF to automate this procedure. Note that it requires that one of the serial DL POLY modules is loaded, as described above. The complete procedure is as follows:<\/p>\n<p>Log in to the CSF with X forwarding enabled<\/p>\n<pre class=\"in1\">ssh -X u&#115;&#x65;&#x72;n&#97;&#109;&#x65;&#x40;c&#115;&#102;&#x2e;&#x69;t&#115;&#x65;&#x72;&#x76;i&#99;&#x65;&#x73;&#46;&#109;&#97;&#x6e;&#x63;h&#101;&#115;&#x74;&#x65;r&#46;&#x61;&#x63;&#x2e;u&#107;<\/pre>\n<p>Start a shell on the appropriate compute node. The resource name specified may vary depending on which resources you have access to. Here the <code>short<\/code> resource is used for a short interactive session<\/p>\n<pre class=\"in1\">qrsh -l short<\/pre>\n<p>In the new shell load the appropriate DL POLY module to set up your environment. You should only use the serial versions interactively (see table above). You should then run the <code>csf_DL_POLY_CLASSIC_gui.sh<\/code> script to give you a local copy of certain system files before running the gui from the required directory:<\/p>\n<pre class=\"in1\">\r\nmodule load apps\/intel-11.1\/dl_poly_classic\/1.2\/serial-maxOpt   # or serial-lowOpt\r\ncsf_DL_POLY_CLASSIC_gui.sh\r\ncd execute\r\ngui\r\n<\/pre>\n<p>The <code>csf_DL_POLY_CLASSIC_gui.sh<\/code> script will create an <code>execute\/<\/code> and <code>java\/<\/code> directory in <strong>your current directory<\/strong>. Ensure you are in the desired directory when you run this command. For example, you may want to first create a directory based on the name of your simulation or molecule and then run the script command from within there. You should then go in to the new <code>execute\/<\/code> directory. This contains a copy of the <code>DLPOLY.X<\/code> executable specific to the version specified by the <code>module load<\/code> command. Running <code>gui<\/code> from within the <code>execute\/<\/code> directory will start the Java GUI.<\/p>\n<p>You only need to run the <code>csf_DL_POLY_CLASSIC_gui.sh<\/code> once if you are using the same version of DLPOLY every time you run it. However, you may want to run it in different directories if running different simulations. Your input decks can be copied to the specific <code>execute\/<\/code> directory for each simulation.<\/p>\n<p>If you rerun the <code>csf_DL_POLY_CLASSIC_gui.sh<\/code> script it will copy the DLPOLY.X executable again. This may overwrite a previous version. If you have loaded a different DL POLY module then you will get a different DLPOLY.X file. Please ensure you know which module you have loaded.<\/p>\n<p><a name=\"FurtherInfo\"><\/a><\/p>\n<h2>Further info<\/h2>\n<ul>\n<li>DL_POLY_CLASSIC<\/li>\n<ol style=\"list-style-type: lower-roman\">\n<li><a href=\"http:\/\/ccpforge.cse.rl.ac.uk\/gf\/project\/dl_poly_classic\/ \">CCP Forge web page<\/a><\/li>\n<li><a href=\"http:\/\/www.cse.scitech.ac.uk\/ccg\/software\/DL_POLY_CLASSIC\/ \">STFC web page<\/a><\/li>\n<\/ol>\n<li>DL_POLY<\/li>\n<ol style=\"list-style-type: lower-roman\">\n<li><a href=\"http:\/\/www.cse.scitech.ac.uk\/ccg\/software\/DL_POLY\/\">STFC web page<\/a><\/li>\n<\/ol>\n<\/ul>\n","protected":false},"excerpt":{"rendered":"<p>Overview DL_POLY refers to a suite of general purpose molecular dynamics simulation packages, including DL_POLY_4 &#8211; version 4 of the STFC codes with a STFC licence and requires MPI2 to allow parallel I\/O. Its general parallel approach is domain decomposition. This version is not currently available on the CSF. DL_POLY_CLASSIC &#8211; (documented on this page) an Open Source branch of DL_POLY_2 with a BSD (ie less restrictive) licence. This is installed on CSF and available.. <a href=\"https:\/\/ri.itservices.manchester.ac.uk\/csf-apps\/software\/applications\/dl_poly\/\">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-135","page","type-page","status-publish","hentry"],"_links":{"self":[{"href":"https:\/\/ri.itservices.manchester.ac.uk\/csf-apps\/wp-json\/wp\/v2\/pages\/135","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=135"}],"version-history":[{"count":18,"href":"https:\/\/ri.itservices.manchester.ac.uk\/csf-apps\/wp-json\/wp\/v2\/pages\/135\/revisions"}],"predecessor-version":[{"id":3172,"href":"https:\/\/ri.itservices.manchester.ac.uk\/csf-apps\/wp-json\/wp\/v2\/pages\/135\/revisions\/3172"}],"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=135"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}