{"id":1478,"date":"2014-05-28T15:49:22","date_gmt":"2014-05-28T15:49:22","guid":{"rendered":"http:\/\/ri.itservices.manchester.ac.uk\/csf-apps\/?page_id=1478"},"modified":"2017-06-01T08:48:24","modified_gmt":"2017-06-01T08:48:24","slug":"exciting","status":"publish","type":"page","link":"https:\/\/ri.itservices.manchester.ac.uk\/csf-apps\/software\/applications\/exciting\/","title":{"rendered":"Exciting"},"content":{"rendered":"<h2>Overview<\/h2>\n<p>EXCITING is full-potential linearised augmented-plane wave (FP-LAPW) code with many advanced features. It has been compiled with the Intel v12.0.5 compiler with the Intel Math Kernel Library v10u3 (which also provides the FFT functions). The executables will automatically take advantage of Sandybridge and Ivybridge extra hardware features if run on those nodes.<\/p>\n<p>There are two versions of EXCITING installed on the CSF:<\/p>\n<ul class=\"gaplist\">\n<li><em>beryllium<\/em> &#8211; the new code base as described at <a href=\"http:\/\/exciting-code.org\/\">http:\/\/exciting-code.org\/<\/a>. This can run in serial, multi-threaded (OpenMP) or multi-node (MPI) modes.<\/li>\n<li>0.9.224 &#8211; the old deprecated code base as described at <a href=\"http:\/\/exciting.sourceforge.net\/index_old.html\">http:\/\/exciting.sourceforge.net\/index_old.html<\/a>. This can run in serial or multi-threaded (OpenMP) modes. It is recommended that the newer version be used as the old code is no longer actively developed.<\/li>\n<\/ul>\n<h2>Restrictions on use<\/h2>\n<p>All users may access this software. It is licensed under the GNU GPL. Please see the <a href=\"http:\/\/exciting.sourceforge.net\/faq.html\">EXCITING FAQ<\/a> for license and citation details.<\/p>\n<h2>Set up procedure<\/h2>\n<p>To access the software you must first load the required modulefiles:<\/p>\n<p>For the NEW <em>beryllium<\/em> code OpenMP multi-core shared memory parallelism (or serial):<\/p>\n<pre>\r\nmodule load apps\/intel-12.0\/exciting\/beryllium\r\n<\/pre>\n<p>For new NEW <em>beryllium<\/em> code multi-node (MPI) parallelism using InfiniBand (faster networking)<\/p>\n<pre>\r\nmodule load mpi\/intel-12.0\/openmpi\/1.6-ib\r\nmodule load apps\/intel-12.0\/exciting\/beryllium\r\n<\/pre>\n<p>For the NEW <em>beryllium<\/em> code multi-node (MPI) parallelism using Ethernet (slower networking)<\/p>\n<pre>\r\nmodule load mpi\/intel-12.0\/openmpi\/1.6\r\nmodule load apps\/intel-12.0\/exciting\/beryllium\r\n<\/pre>\n<p>For OLD code serial or multi-core\/SMP (OpenMP) single node shared memory parallelism:<\/p>\n<pre>\r\nmodule load apps\/intel-12.0\/exciting\/0.9.224\r\n<\/pre>\n<p>The above modulefiles will load all necessary compiler modulefiles.<\/p>\n<h2>Running the application<\/h2>\n<p>Please do not run Exciting on the login node. Jobs should be submitted to the compute nodes via batch.<\/p>\n<p>Note that after loading the exciting modulefile, the <code>exciting<\/code> executable (and others) are in your path. You can also find the <em>species<\/em> files in the directory:<\/p>\n<pre>\r\n$EXCITING_HOME\/species\/\r\n<\/pre>\n<p>If you wish to set the <code>sppath<\/code> option in your <code>exciting.in<\/code> file the use the absolute value of this path &#8211; the output of the command:<\/p>\n<pre>\r\necho $EXCITING_HOME\/species\/\r\n<\/pre>\n<h3>Serial batch job submission<\/h3>\n<p>Make sure you have the required Exciting 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# To run the <em>beryllium<\/em> version:\r\nexcitingser\r\n\r\n# To run the old 0.9.224 version:\r\nexport OMP_NUM_THREADS=$NSLOTS\r\nexciting\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>Parallel Multi-core\/SMP batch job submission<\/h3>\n<p>Make sure you have the required Exciting 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 (16 is the maximum)\r\n\r\n# $NSLOTS automatically set to the number you used above\r\nexport OMP_NUM_THREADS=$NSLOTS\r\n\r\n # To run the <em>beryllium<\/em> version:\r\nexcitingsmp\r\n\r\n# To run the old 0.9.224 version:\r\nexciting\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>Parallel Multi-node\/MPI batch job submission with InfiniBand Networking<\/h3>\n<p>Make sure you have the required Exciting modulefiles 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 48     # Number of cores (multiple of 24 required, minimum 48)\r\n\r\n# Only available with <em>beryllium<\/em>\r\nmpirun -n $NSLOTS excitingmpi\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>For further details of which parallel environments can be specified in the <code>$# -pe<\/code> line please see the <a href=\"http:\/\/ri.itservices.manchester.ac.uk\/csf2\/csf-user-documentation\/parallel-jobs\/\">Parallel Jobs<\/a> page.<\/p>\n<h2>Template Processing with xsltproc<\/h2>\n<p>If using <code>xsltproc<\/code> to generate visualizations, as described at the <a href=\"http:\/\/exciting-code.org\/templating-tools\">EXCITING Templating Tools page<\/a>, please run this as a serial batch job. <code>xsltproc<\/code> should <strong>not<\/strong> be run on the login node.<\/p>\n<p>A simple batch script can be used.<\/p>\n<pre>\r\n#!\/bin\/bash\r\n#$ -S bash\r\n#$ -cwd\r\n#$ -V\r\n#$ -l short   # optional but post-processing is often a short task\r\n\r\nxsltproc template.xsl data.xml > outputfile\r\n<\/pre>\n<p>Change the names of the input and output files to match your own. Submit the jobscript using:<\/p>\n<pre>qsub <em>jobscript<\/em><\/pre>\n<p>where <em>jobscript<\/em> is the name of the script file. <\/p>\n<h2>Further info<\/h2>\n<ul>\n<li>PDF documentation is available on the CSF in the directory tree:\n<pre>$EXCITING_HOME\/docs\/<\/pre>\n<\/li>\n<li><a href=\"http:\/\/exciting-code.org\">Current EXCITING website<\/a><\/li>\n<li><a href=\"http:\/\/exciting.sourceforge.net\/index_old.html\">Old EXCITING website<\/a><\/li>\n<\/ul>\n<h2>Updates<\/h2>\n<p>8-June-2014 &#8211; <em>Beryllium<\/em> version installed<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Overview EXCITING is full-potential linearised augmented-plane wave (FP-LAPW) code with many advanced features. It has been compiled with the Intel v12.0.5 compiler with the Intel Math Kernel Library v10u3 (which also provides the FFT functions). The executables will automatically take advantage of Sandybridge and Ivybridge extra hardware features if run on those nodes. There are two versions of EXCITING installed on the CSF: beryllium &#8211; the new code base as described at http:\/\/exciting-code.org\/. This can.. <a href=\"https:\/\/ri.itservices.manchester.ac.uk\/csf-apps\/software\/applications\/exciting\/\">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-1478","page","type-page","status-publish","hentry"],"_links":{"self":[{"href":"https:\/\/ri.itservices.manchester.ac.uk\/csf-apps\/wp-json\/wp\/v2\/pages\/1478","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=1478"}],"version-history":[{"count":13,"href":"https:\/\/ri.itservices.manchester.ac.uk\/csf-apps\/wp-json\/wp\/v2\/pages\/1478\/revisions"}],"predecessor-version":[{"id":3856,"href":"https:\/\/ri.itservices.manchester.ac.uk\/csf-apps\/wp-json\/wp\/v2\/pages\/1478\/revisions\/3856"}],"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=1478"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}