{"id":2668,"date":"2015-07-22T10:39:54","date_gmt":"2015-07-22T10:39:54","guid":{"rendered":"http:\/\/ri.itservices.manchester.ac.uk\/csf-apps\/?page_id=2668"},"modified":"2018-10-04T14:47:26","modified_gmt":"2018-10-04T14:47:26","slug":"castepconv","status":"publish","type":"page","link":"https:\/\/ri.itservices.manchester.ac.uk\/csf-apps\/software\/applications\/castepconv\/","title":{"rendered":"CASTEPconv"},"content":{"rendered":"<h2>Overview<\/h2>\n<p><a href=\"https:\/\/ccpforge.cse.rl.ac.uk\/gf\/project\/castepconv\/\">CASTEPconv<\/a> Python script designed to automate the process of calculating system convergence with cutoff energy and kpoints against final energy, forces, and stresses.<\/p>\n<p>Versions 0.9.5, 1.0.1 and 1.0.2 are installed on the CSF.<\/p>\n<h2>Restrictions on use<\/h2>\n<p>There are no restrictions on accessing this software.<\/p>\n<h2>Set up procedure<\/h2>\n<p>To access the software you must first load the modulefile:<\/p>\n<pre>\r\nmodule load apps\/binapps\/castepconv\/1.0.2\r\nmodule load apps\/binapps\/castepconv\/1.0.1\r\nmodule load apps\/binapps\/castepconv\/0.9.5\r\n<\/pre>\n<p>This will automatically load the python 2.7.1 modulefile.<\/p>\n<h2>Running the application<\/h2>\n<p>It is strongly recommended that you read the short user guide by running the following command on the login node:<\/p>\n<pre>\r\nevince $CASTEPCONV_HOME\/doc\/user_guide.pdf\r\n<\/pre>\n<p>The CASTEPconv command is a python script that is run using:<\/p>\n<pre>\r\ncastepconv.py <em>options<\/em> <em>seedname<\/em>\r\n<\/pre>\n<p>The following file must be present in the directory where you run the script:<\/p>\n<ul>\n<li><code><em>seedname<\/em>.cell<\/code><\/li>\n<\/ul>\n<p>Additional optional files can also be present in the directory:<\/p>\n<ul>\n<li><code><em>seedname<\/em>.param<\/code> &#8211; specify additional parameters (e.g., redefined convergence criteria for SCF iterations, add dispersion correction etc.)<\/li>\n<li><code><em>seedname<\/em>.conv<\/code> &#8211; to control the convergence of the job itself.<\/li>\n<\/ul>\n<p>The <code>castepconv.py<\/code> script can be run from within your own jobscript. It will eventually run CASTEP and so you <em>must<\/em> have loaded the appropriate <a href=\"..\/castep\">CASTEP modulefile<\/a> so that CASTEP will run correctly. The CASTEP command executed by the castepconv.py script is defined in the <em>seedname<\/em>.conv file by the line:<\/p>\n<pre>\r\nrunning_command: castep.serial &lt;seedname&gt;\r\n<\/pre>\n<p>You can change this if your castep command is different &#8211; here we use <code>castep.serial<\/code>. But you <em>must<\/em> keep the <code>&lt;seedname&gt;<\/code> keyword exactly as written. <em>Do not<\/em> replace it with your own filename. We will let the castepconv.py script do the replacement instead. It won&#8217;t work if you enter your own filename here!<\/p>\n<p>An alternative method of running the <code>castepconv.py<\/code> script is to allow it to submit jobs to the batch queues. This means that the castepconv.py script should be run on the login node. You must still write a jobscript in the usual manner for CASTEP and copy it to the directory from where you will be running the python script. Any instances of the string <code>&lt;seedname&gt;<\/code> in your jobscript will be replaced with the seedname specified on the castepconv.py command-line. You should then edit your <code><em>seedname<\/em>.conv<\/code> file and set the following parameters<\/p>\n<pre>\r\nrunning_command: qsub &lt;seedname&gt;\r\nsubmission script: my_jobscript\r\n<\/pre>\n<p>The optional <code><em>options<\/em><\/code> before the seedname can be used to override settings in the <code><em>seedname<\/em>.conv<\/code> file (currently only the <code>convergence_task<\/code> keyword can be overridden).<\/p>\n<h3>Serial batch job submission<\/h3>\n<p>Make sure you have the castepconv modulefile loaded <strong>AND<\/strong> the CASTEP modulefile for the version of CASTEP you wish to use. 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\ncastepconv.py <em>seedname<\/em>\r\n                    #\r\n                    # Ensure you have written a <em>seedname<\/em>.conv file\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>Tutorial<\/h3>\n<p>The User Guide contains a simple tutorial. The example files for the tutorial are available by running the following command on the login node:<\/p>\n<pre>\r\ncp $CASTEPCONV_HOME\/example\/* .          # The . at the end is important\r\n<\/pre>\n<h2>Further info<\/h2>\n<ul>\n<li>The User Guide is available via\n<pre>\r\nevince $CASTEPCONV_HOME\/doc\/user_guide.pdf\r\n<\/pre>\n<\/li>\n<\/ul>\n<h2>Updates<\/h2>\n<p>None.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Overview CASTEPconv Python script designed to automate the process of calculating system convergence with cutoff energy and kpoints against final energy, forces, and stresses. Versions 0.9.5, 1.0.1 and 1.0.2 are installed on the CSF. Restrictions on use There are no restrictions on accessing this software. Set up procedure To access the software you must first load the modulefile: module load apps\/binapps\/castepconv\/1.0.2 module load apps\/binapps\/castepconv\/1.0.1 module load apps\/binapps\/castepconv\/0.9.5 This will automatically load the python 2.7.1 modulefile&#8230; <a href=\"https:\/\/ri.itservices.manchester.ac.uk\/csf-apps\/software\/applications\/castepconv\/\">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-2668","page","type-page","status-publish","hentry"],"_links":{"self":[{"href":"https:\/\/ri.itservices.manchester.ac.uk\/csf-apps\/wp-json\/wp\/v2\/pages\/2668","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=2668"}],"version-history":[{"count":13,"href":"https:\/\/ri.itservices.manchester.ac.uk\/csf-apps\/wp-json\/wp\/v2\/pages\/2668\/revisions"}],"predecessor-version":[{"id":4864,"href":"https:\/\/ri.itservices.manchester.ac.uk\/csf-apps\/wp-json\/wp\/v2\/pages\/2668\/revisions\/4864"}],"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=2668"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}