Gaussian is computational chemistry software application.
Log into Strelka (see Strelka page for info on how to obtain an account and log in).
Verify you are in the Gaussian Group
Check to see if you are in the "gaussian" group. This is required to be able to use Gaussian. To check, type the command "groups" on Strelka.
The output should look something like this:
The command lists all the groups you are in. You should see (at least) your username and the gaussian group. If you don't see the gaussian group listed, email email@example.com with a request to be added to the gaussian group on Strelka.
Transfer files to Strelka
Use the scp command to copy files from your computer to Strelka. Replace the file, directory, and usernames (highlighted in red) with your actual values.
Run this command on your computer to copy files to Strelka. If you are logged into Strelka already, open a new Terminal window or tab and run the command below.
scp gaussian_input.com firstname.lastname@example.org:/home/username/TargetDirectory
To run Gaussian calculations on Strelka, submit a job or use an interactive session. Do not run more than trivial jobs on the login node.
Submitting Gaussian Jobs
Here is an example of a Gaussian Slurm job submission file that runs on 8 cores on a single node using 50GB of memory for up to 1 hour. By default, Gaussian will only use a single core. The benefits of parallelism depend on the type of Gaussian job. Specifying more cores than needed may actually slow down a job.
This example is adapted from Gaussian documentation from Research Computing at the University of Colorado Boulder.
Submit the job as you would normally using sbatch.
Job submission script
Professor Paul Rablen created a program to generate a Gaussian Slurm submission script.
Gaussian Submission Script File
Download the submission script to Strelka and unzip.
Running the Gaussian Submission Script
Update the submission script file to allow execution (only needs to be done once)
Run the script as follows where filename.com is the Gaussian input file
The script will send email on job start, end, or fail. It assumes your email is your username + "@swarthmore.edu". If not, edit the script to change the line containing "--mail-user".
The script will then prompt for a number of cores to use, and a maximum number of hours. The former defaults to 8, and the latter to 10, if you just hit return.
You can also enter the number of cores and hours directly on the command line when running the script:
The memory defaults to 8GB per core.
Clean Up Script
Professor Paul Rablen created a script to clean up extraneous Gaussian files after a run has been completed.
Download the script to Strelka and unzip.
Transferring Gaussian Checkpoint Files
Procedure for transferring checkpoint files from Strelka to a local computer:
The formchk utility makes a new file,
filename.fchk, that is a text file.
Log out of Strelka, and copy the .fchk file back to your own computer:
unfchk utility to convert the file back:
That will create a new binary version of the file,
To clean up, you may want to delete the
.fchk files, both on Strelka and on your own computer because they can take up a lot of space.
GaussView has a graphical user interface so cannot be run through a standard terminal. Follow the instructions below to connect to Strelka based on your operating system then load the Gaussian modulefile and start GaussView.
Connect with X11
macOS and Linux Users
Connect to Strelka using additional SSH flags:
On a Mac, you may need to install XQuartz if it isn't already on your system: https://www.xquartz.org/
To run GaussView on Strelka via Windows, follow the instructions for setting up PuTTY for X11 forwarding on the Connect to Strelka from Windows page.
On Strelka, run the following commands
Because performance can be slow, it can be easier to use keyboard shortcuts to access menus. On a Windows computer, use the Alt key combined with the underlined letter in the title to open a menu. In the example below, typing Alt-E on a Windows computer will open the "Edit" menu. See the macOS section below to set up keyboard shortcuts on a Mac.
macOS Tips for GaussView
macOS Keyboard Shortcuts
Keyboard shortcuts can make it faster to navigate an X11 application. The following code maps the macOS "Option" key for use in navigating menu items. Press "Option"+underlined letter of the GaussView menu to open the menu. You can also use the arrow keys to navigate once a menu is open.
To set up the option key, connect to Strelka as specified above. Copy and paste the following commands into the terminal and hit enter.
Then launch GaussView.
After the initial setup is complete, just execute the following line before starting GaussView:
Information from Ewen McNeill, OS X X11 Alt Key
If you see an error in the Strelka terminal that looks like:
Quit XQuartz and run the following command on your computer (not Strelka):
Info from the Greenplanet Cluster at UCI documentation. Additional info: https://ps.uci.edu/greenplanet/Gaussian%20OSX%20error
If you see an error in the Strelka terminal that looks like this:
Try running GaussView using this command:
Info from IT-Bereich des Instituts für Chemie.
X11 to Strelka to run GaussView can be slow, especially over VPN. It is a little faster to reduce the number of colors in the XQuartz preferences. Adjust the color preferences below and restart XQuartz and re-connect to Strelka. Reducing to 256 will cause rendering problems, so don't go below "Thousands".