{"id":958,"date":"2013-08-05T09:09:44","date_gmt":"2013-08-05T09:09:44","guid":{"rendered":"http:\/\/ri.itservices.manchester.ac.uk\/csf-apps\/?page_id=958"},"modified":"2017-09-18T10:14:23","modified_gmt":"2017-09-18T10:14:23","slug":"crystal","status":"publish","type":"page","link":"https:\/\/ri.itservices.manchester.ac.uk\/csf-apps\/software\/applications\/crystal\/","title":{"rendered":"Crystal"},"content":{"rendered":"<h2>Overview<\/h2>\n<p>The CRYSTAL09 program computes the electronic structure of periodic systems within Hartree Fock, density functional or various hybrid HF\/DFT approximations.<\/p>\n<p>Version Crystal09 2.0.1 MPP emt64 is installed on the CSF.<\/p>\n<h2>Restrictions on use<\/h2>\n<p>CRYSTAL09 is protected by a unix group. Only users who belong to a research group which has been granted a license by may be added to the unix group.  <\/p>\n<p>Licenses are normally in the name of the Project Investigator or Head of a research group. Members of the research group will be given access but they must confirm that they will abide by the terms and conditions set out in the <a href=\"http:\/\/www.crystalsolutions.eu\/upload\/CRYSTAL%20EULA%20academic%20140825.pdf\">licence<\/a> (pdf). The following notes cover the main points of, but are not intended as a replacement for, the license:<\/p>\n<p>You are not permitted to:<\/p>\n<ul>\n<li>Copy the software or share it with anyone else.<\/li>\n<li>Modify the software or incorporate it into any other software code without permission of the CRYSTAL authors<\/li>\n<\/ul>\n<p>You must:<\/p>\n<ul>\n<li>use the software for not-for profit, non-commercial academic research only.<\/li>\n<li>cite your usage of the software in your work as per clauses 8, 9 and 10 of the license.<\/li>\n<\/ul>\n<p>To get access to the software on the CSF we will need proof that your group has a license. Please email <a href=\"mail&#116;&#111;&#58;&#105;&#116;&#115;&#45;&#x72;&#x69;&#x2d;&#x74;&#x65;&#x61;&#x6d;&#x40;&#x6d;anch&#101;&#115;&#116;&#101;&#114;&#46;&#97;&#x63;&#x2e;&#x75;&#x6b;\">its-ri-t&#101;&#97;&#109;&#64;&#109;&#97;&#110;&#99;&#104;&#101;&#x73;&#x74;&#x65;&#x72;&#x2e;&#x61;&#x63;&#x2e;&#x75;&#x6b;<\/a> with your details and we will confirm when access has been granted.<\/p>\n<h2>Set up procedure<\/h2>\n<p>To access the software you must first load the modulefile. This will load the apppropriate compiler, MKL, and MPI modulefiles automatically.<\/p>\n<p>Choose <strong>one<\/strong> of the following:<\/p>\n<pre>\r\n# For multi-core (single compute node) jobs\r\nmodule load apps\/intel-12.0\/crystal\/c09_201_emt64\r\n\r\n# For multi-node (large jobs) \r\nmodule load apps\/intel-12.0\/crystal\/c09_201_emt64-ib\r\n<\/pre>\n<h2>Running the application<\/h2>\n<p>Please do not run CRYSTAL on the login node. Jobs should be submitted to the compute nodes via batch. There is a script named <code>csf_runmpi09<\/code> which is a modified version of the CRYSTAL <Code>runmpi09<\/code> script that runs your job on the CSF. The script will call <code>mpirun<\/code> and also copy your input files to the scratch filesystem to run the job from there. Results will be copied back to the current directory. Use of this script is optional but recommended because of the way it ensures all required input files are in place.<\/p>\n<p>The script requires the number of cores you wish to use followed by the CRYSTAL input file (see examples below).<\/p>\n<p>It is permissible to run <code>csf_runmpi09<\/code> without any arguments on the login node to print out some help text that indicates which input files it will copy and a few optional environment variables that can be set. However, you must <strong>not<\/strong> run a real job on the login node &#8211; use a jobscript instead.<\/p>\n<h3>Parallel batch job submission<\/h3>\n<p>Make sure you have the <code>-ib<\/code> version of the modulefile (see above) loaded then create a batch submission script (example below). The <code>csf_runmpi09<\/code> script is used to start the MPI processes, for example:<\/p>\n<pre>\r\n#!\/bin\/bash\r\n#$ -S \/bin\/bash\r\n#$ -cwd                     # App will run from current directory\r\n#$ -V                       # Inherit current environment for use when job runs\r\n#$ -pe orte-24-ib.pe 48     # Specify a parallel environment and number of cores\r\n                            # NOTE: example uses an IB pe so we must load the c09_201_emt64-ib modulefile\r\n\r\n# $NSLOTS is automatically set to the number of cores requested on the -pe line\r\ncsf_runmpi09 $NSLOTS inpfilename\r\n    #   \r\n    # inpfilename.d12        CRYSTAL input deck for wave function calculation\r\n<\/pre>\n<p>Submit the jobscript using: <\/p>\n<pre>qsub scriptname<\/pre>\n<p>If you want to run the <code>MPPcrystal<\/code> executable manually, without using the inputfile checking performed by the <code>csf_runmpi09<\/code> script then use a jobscript similar to the following:<\/p>\n<pre>\r\n#!\/bin\/bash\r\n#$ -S \/bin\/bash\r\n#$ -cwd                     # App will run from current directory\r\n#$ -V                       # Inherit current environment for use when job runs\r\n#$ -pe orte-24-ib.pe 48     # Specify a parallel environment and number of cores\r\n\r\nmpirun -n $NSLOTS MPPcrystal inpfilename\r\n    #   \r\n    # inpfilename.d12        CRYSTAL input deck for wave function calculation\r\n<\/pre>\n<h2>Further info<\/h2>\n<ul>\n<li>The CRYSTAL09 manual is available on the CSF using:\n<pre>evince $CRY2K9_ROOT\/doc\/crystal09_manual.pdf<\/pre>\n<\/li>\n<li><a href=\"http:\/\/www.crystal.unito.it\/\">CRYSTAL website<\/a><\/li>\n<\/ul>\n<h2>Updates<\/h2>\n<p>None.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Overview The CRYSTAL09 program computes the electronic structure of periodic systems within Hartree Fock, density functional or various hybrid HF\/DFT approximations. Version Crystal09 2.0.1 MPP emt64 is installed on the CSF. Restrictions on use CRYSTAL09 is protected by a unix group. Only users who belong to a research group which has been granted a license by may be added to the unix group. Licenses are normally in the name of the Project Investigator or Head.. <a href=\"https:\/\/ri.itservices.manchester.ac.uk\/csf-apps\/software\/applications\/crystal\/\">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-958","page","type-page","status-publish","hentry"],"_links":{"self":[{"href":"https:\/\/ri.itservices.manchester.ac.uk\/csf-apps\/wp-json\/wp\/v2\/pages\/958","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=958"}],"version-history":[{"count":20,"href":"https:\/\/ri.itservices.manchester.ac.uk\/csf-apps\/wp-json\/wp\/v2\/pages\/958\/revisions"}],"predecessor-version":[{"id":4266,"href":"https:\/\/ri.itservices.manchester.ac.uk\/csf-apps\/wp-json\/wp\/v2\/pages\/958\/revisions\/4266"}],"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=958"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}