{"id":181,"date":"2013-04-22T14:50:55","date_gmt":"2013-04-22T14:50:55","guid":{"rendered":"http:\/\/ri.itservices.manchester.ac.uk\/csf-apps\/?page_id=181"},"modified":"2018-04-18T10:27:46","modified_gmt":"2018-04-18T10:27:46","slug":"gaussian","status":"publish","type":"page","link":"https:\/\/ri.itservices.manchester.ac.uk\/csf-apps\/software\/applications\/gaussian\/","title":{"rendered":"Gaussian"},"content":{"rendered":"<h2>Overview<\/h2>\n<p>Gaussian is a general purpose suite of electronic structure programs. Two versions are currently available on the system:<\/p>\n<ul>\n<li>g09d01 &#8211; installed 25\/09\/15<\/li>\n<li>g03d01 &#8211; this version is subject to review and may not always be available. Please consider moving to g09.We do not automatically grant access to this version.<\/li>\n<\/ul>\n<p>Both are binary installs only. The source code is not available on the CSF.<\/p>\n<h2>Restrictions on use<\/h2>\n<p>The University of Manchester site license allows access for all staff and students of the university, however strict licensing restrictions require that all users who wish to use the software must complete some paperwork and be in a restricted unix group. There are two separate unix groups &#8211; one for g09 and one for g03. The procedure for getting access on the CSF is as follows:<\/p>\n<ol>\n<li>Complete and submit the <a href=\"https:\/\/www.applications.itservices.manchester.ac.uk\/show_product.php?id=22&amp;tab=licensing\" target=\"_blank\" rel=\"noopener\">University&#8217;s gaussian paperwork<\/a>. <strong>Note<\/strong> &#8211; you <strong>must<\/strong> submit a copy of the <strong>whole<\/strong> document, with the appropriate section(s) signed in <strong>ink<\/strong> (anything else will be rejected).<\/li>\n<li>Email <a href=\"&#x6d;&#97;&#x69;&#x6c;&#116;&#x6f;&#x3a;&#105;&#x74;&#x73;&#45;&#x72;&#x69;-&#x74;&#x65;a&#x6d;&#64;m&#x61;&#110;c&#x68;&#101;s&#x74;&#101;r&#x2e;&#97;c&#x2e;&#117;k\">&#105;&#x74;&#115;&#x2d;r&#105;&#x2d;&#116;&#x65;a&#x6d;&#64;&#109;&#x61;&#110;&#x63;h&#x65;&#x73;&#116;&#x65;r&#x2e;a&#99;&#x2e;&#117;&#x6b;<\/a> to request being added to the g03 or g09 gaussian group on CSF (attaching a copy of the completed paperwork can help speed the process up).<\/li>\n<li>Once your paperwork appears in the ITS database of gaussian users (or if you have sent it to us directly) you will be added to the appropriate group on the CSF and we will send a confirmation to you.<\/li>\n<\/ol>\n<h2>Set up procedure<\/h2>\n<p>After being added to the relevant unix group, you will be able to access the executables loading <em>one<\/em> of the appropriate modulefiles:<\/p>\n<p>For g09:<\/p>\n<pre>module load apps\/binapps\/gaussian\/g09d01_em64t\r\n\r\nmodule load apps\/binapps\/gaussian\/g09b01_em64t\r\n<\/pre>\n<p>For g03 (by default we no longer grant access to this version unless it is essential to the work being undertaken):<\/p>\n<pre>module load apps\/binapps\/gaussian03\/g03d01_em64t_amd\r\n<\/pre>\n<h2>Gaussian Scratch<\/h2>\n<p>Gaussian uses an environment variable <code>$GAUSS_SCRDIR<\/code> to specify a directory path for where to write <em>scratch<\/em> (temporary) files (two-electron integral files, integral derivative files and a <em>read-write<\/em> file for temporary workings). It is set to your <em>scratch<\/em> directory (<code>~\/scratch<\/code>) when you load the modulefile. This is a Lustre filesystem which provides good I\/O performance. Do not be tempted to use your home directory for Gaussian scratch files &#8211; the files can be huge making the home area at risk of going over quota. We also recommend using a directory-per-job in your scratch area. See below for how to do this.<\/p>\n<p>A faster, but smaller, local <code>\/tmp<\/code> on each compute node is available should users prefer to use that. It can be more efficient if you have to a need to create lots of small files, but space is limited. The minimum <code>\/tmp<\/code> on intel compute nodes is 800GB, the largest is 3.5TB.<\/p>\n<p>Gaussian <em>should<\/em> delete scratch files automatically when a job completes successfully or dies cleanly. However, it often fails to do this. Scratch files are also <em>not<\/em> deleted when a job is killed externally or terminates abnormally so that you can use the scratch files to restart the job (if possible). Consequently, leftover files may accumulate in the scratch directory, and it is your responsibility to delete these files. Please <strong>check periodically<\/strong> whether you have a lot of temporary Gaussian files that can be deleted.<\/p>\n<h3>Using a Scratch Directory per Job<\/h3>\n<p><strong>Update:<\/strong> We now recommend using a different scratch directory for each job. This improves file access times if you run many jobs &#8211; writing 1000s of scratch files to a single directory can slow down your jobs. It is much better to create a directory <em>for each<\/em> job within your <code>scratch<\/code> area. It is also then easy to delete the entire directory if Gaussian has left unwanted scratch files behind.<\/p>\n<p>The example jobscripts below show how to use this method (it is simple &#8211; just two extra lines in your jobscript).<\/p>\n<h3>Very large Gaussian scratch files<\/h3>\n<p>Occasionally some jobs create <code>.rwf<\/code> files which are very large (several TB). The batch system will not permit a job to create files bigger than 4TB. If your gaussian job fails and the <code>.rwf<\/code> file is 4TB then it may be that this limit has prevented your job from completing. You should re-run the job and in your input file request that the <code>.rwf<\/code> file be split into multiple files. For example to split the file into two 3TB files:<\/p>\n<pre>\r\n%rwf=\/scratch\/$USER\/myjob\/one.rwf,3000GB,\/scratch\/$USER\/myjob\/two.rwf,3000GB\r\n<\/pre>\n<h2>Running the application<\/h2>\n<h3>Serial batch job<\/h3>\n<ol class=\"gaplist\">\n<li>Make sure you have loaded the appropriate module.<\/li>\n<li>It is recommended you run from within your <code>scratch<\/code> area:\n<pre>cd ~\/scratch\r\n<\/pre>\n<\/li>\n<li>Create a job script, for example:\n<pre>#!\/bin\/bash\r\n#$ -S \/bin\/bash\r\n#$ -cwd                       # Run job in directory you submitted from\r\n#$ -V                         # Use current environment settings, e.g. from \r\n                              # loaded modulefiles, when the job runs.\r\n\r\n# We now recommend using a scratch directory per job\r\nexport GAUSS_SCRDIR=\/scratch\/$USER\/gau_temp_$JOB_ID\r\nmkdir -p $GAUSS_SCRDIR\r\n\r\n$g09root\/g09\/g09 &lt; file.inp &gt; file.out\r\n<\/pre>\n<\/li>\n<li>Submit with the command:\n<pre>qsub <em>scriptname<\/em><\/pre>\n<p>where <em>scriptname<\/em> is the name of your job script.<\/li>\n<li>When the job has finished check whether Gaussian has left behind unwanted scratch files (you&#8217;ll need to know the job id). For example, assuming my job id was 456789:\n<pre>cd ~\/scratch\/gau_temp_456789\r\nls\r\nGau-21738.inp  Gau-21738.chk  Gau-21738.d2e  Gau-21738.int  Gau-21738.scr\r\n\r\n# Example: Remove a specific scratch file\r\nrm Gau-21738.scr\r\n\r\n# Example: Remove all files in the directory (use with caution)\r\nrm Gau*\r\n\r\n# Example: go up and remove the empty directory\r\ncd ..\r\nrmdir gau_temp_456789\r\n<\/pre>\n<\/li>\n<\/ol>\n<h3>Parallel batch job<\/h3>\n<p>Gaussian is a multi-threaded application (shared memory) so a job can not run across nodes, and you are limited to a maximum of 24 processors. This means that you <em>must<\/em> run in <code>smp.pe<\/code> to confine your job to a single node. Follow the steps below to submit a parallel Gaussian job.<\/p>\n<table style=\"text-align: center; width: 66%; margin-left: 22%; margin-right: 22%;\">\n<tbody>\n<tr>\n<td><em>You MUST declare the number of cores for your job twice &#8211; once in the batch submission script and once in the input file. See below for further details.<\/em><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<ol class=\"gaplist\">\n<li>Make sure you have the appropriate module loaded<\/li>\n<li>It is recommended you run from within your <code>scratch<\/code> area:\n<pre>cd ~\/scratch\r\n<\/pre>\n<\/li>\n<li>You <strong>must<\/strong> have a line in your Gaussian input file that tells Gaussian how many cores to use:\n<pre>%nprocshared=<em>N<\/em>              (or %nprocs=<em>N<\/em>)\r\n<\/pre>\n<p>where <em><code>N<\/code><\/em> is the number of cores you request in the jobscript (see below). Failure to have these match can lead to two main issues a) nodes get overloaded and the efficient running of other users jobs on that node being impacted as a result b) without it jobs will only use one core leaving the others allocated to you idle and increasing queueing time for other people.<\/li>\n<li>Create a job script, for example:\n<pre>#!\/bin\/bash\r\n#$ -S \/bin\/bash\r\n#$ -cwd                       # Run job in directory you submitted from\r\n#$ -V                         # Use current environment settings, e.g. from \r\n                              # loaded modulefiles, when the job runs.\r\n#$ -pe smp.pe 12              # Run in SMP parallel environment with e.g. 12 cores\r\n                              # Ensure this matches '%nprocs=' line in .inp file.\r\n\r\n# We now recommend using a scratch directory per job\r\nexport GAUSS_SCRDIR=\/scratch\/$USER\/gau_temp_$JOB_ID\r\nmkdir -p $GAUSS_SCRDIR\r\n\r\n$g09root\/g09\/g09 &lt; file.inp &gt; file.out\r\n                     #\r\n                     # You MUST set %nprocs=<em>N<\/em> (12 in this example) in the .inp file!\r\n<\/pre>\n<\/li>\n<li>Submit with the command:\n<pre>qsub <em>scriptname<\/em><\/pre>\n<p>where <em>scriptname<\/em> is the name of your job script.<\/li>\n<li>See above for how to tidy up your scratch directory if Gaussian leaves scratch files behind once the job has finished.<\/li>\n<\/ol>\n<h2>Further info<\/h2>\n<ul>\n<li>The <a href=\"http:\/\/www.applications.itservices.manchester.ac.uk\/show_product.php?id=22\">IT Services Gaussian webpage<\/a> contains important information applicable to all users of the software.<\/li>\n<li>Gaussian Inc. <a href=\"http:\/\/www.gaussian.com\/g_tech\/g_ur\/g09help.htm\">g09 reference pages<\/a>.<\/li>\n<li>Gaussian Inc. <a href=\"http:\/\/www.gaussian.com\/g_tech\/g_ur\/m_running.htm\">Running Gaussian pages<\/a>.<\/li>\n<\/ul>\n<h2>Updates<\/h2>\n<p>January 2015 &#8211; updated scratch dir advice.<\/p>\n<p>March 2011 &#8211; g09b01 installed.<\/p>\n<p>April 2011 &#8211; g03d01 installed.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Overview Gaussian is a general purpose suite of electronic structure programs. Two versions are currently available on the system: g09d01 &#8211; installed 25\/09\/15 g03d01 &#8211; this version is subject to review and may not always be available. Please consider moving to g09.We do not automatically grant access to this version. Both are binary installs only. The source code is not available on the CSF. Restrictions on use The University of Manchester site license allows access.. <a href=\"https:\/\/ri.itservices.manchester.ac.uk\/csf-apps\/software\/applications\/gaussian\/\">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-181","page","type-page","status-publish","hentry"],"_links":{"self":[{"href":"https:\/\/ri.itservices.manchester.ac.uk\/csf-apps\/wp-json\/wp\/v2\/pages\/181","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=181"}],"version-history":[{"count":20,"href":"https:\/\/ri.itservices.manchester.ac.uk\/csf-apps\/wp-json\/wp\/v2\/pages\/181\/revisions"}],"predecessor-version":[{"id":4663,"href":"https:\/\/ri.itservices.manchester.ac.uk\/csf-apps\/wp-json\/wp\/v2\/pages\/181\/revisions\/4663"}],"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=181"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}