Atomic Global Minimum Locator: Getting Started


Menu Next

This project can now be found at GitHub.

Related Projects:

     Atomic Simulation Environment (ASE): tools for setting up, manipulating, running, visualizing and analyzing atomistic simulations
     Ab Initio Utils: xml based batch calculator

Helpful Links:

     Transfer files between Linux and Windows: http://winscp.net/
     Log into Linux from Windows: http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html
     Learn Unix/Linux: http://mally.stanford.edu/~sr/computing/basic-unix.html
     Edit Linux files: http://www.oregonwebradio.net/backup_fedora/tutorials/vim_li/quickstart.html

While this program does not have a graphical user interface, it has a command line interface that is very simple to use with some instruction. You will need to compile the C++ source code on a Linux computer or cluster. While Windows is not supported, you may easily transfer results to and from your Windows computer. Steps for installing this program are below:

1. Download the program file: pso1.5.2.tar.gz
2. Install g++ and MPI compilers
3. Compile the program

Step 1: Download the pso1.5.2.tar.gz file which is most stable. There is also a pso1.6.2-Intl-beta.tar.gz beta version which has support for multiple languages (see Section G). If you want to run the program on a remote Linux cluster, first download the program onto your local computer and then transfer the program to the Linux cluster. If you use Windows, you can transfer the program to the Linux cluster using the WinSCP program (see above link). If you are using Ubuntu or a Mac, open a terminal. To open a terminal on Ubuntu, click on 'Applications', 'Accessories', 'Terminal'. On a mac, navigate to your Applications folder, open Utilities, and double click on Terminal. Then, type these commands, pressing 'Enter' or 'Return' after each command:

     cd /directory/where/you/put/pso1.5.2.tar.gz
     scp pso1.5.2.tar.gz your_user_name@your.linux.cluster:pso1.5.2.tar.gz

Step 2: If using a University Linux cluster, the g++ and MPI compilers should already be installed, so you can likely skip this step. If using a local Linux box, g++ should already be installed, but you will have to install the MPI compiler. On Ubuntu Linux, you may install this by clicking on 'System' and 'Administration', then 'Synaptic Package Manager' and searching for mpi. I installed the mpi-default-bin and mpi-default-dev packages.

Step 3: If you are running the program on a remote Linux cluster, you will need to log into the cluster with ssh. To do this on Windows, use the putty program (see the above link). To log in at the command line on Ubuntu or a Mac, type the following at the command line:

     ssh your_user_name@your.linux.cluster

Once logged in, navigate to the directory where you placed the program. Change directories by typing: 'cd some_directory'. To get out of the current directory type: 'cd ..' . To list files and directories in the current directory, type 'ls' or 'ls -al' (the later is a long list format). When you have navigated to your program directory, type the following to decompress the program:

     gunzip pso1.5.2.tar.gz
     tar -xf pso1.5.2.tar

Then, navigate into the directory:

     cd pso

Then compile the program by typing:

     make

You may see warning messages. If so, this is OK. If you see error messages, this is NOT OK, and it likely means you do not have the right compilers installed (see step 2).

When you have successfully compiled the program, two executables will be created: pso and helper. The pso executable is an MPI application, while helper is not. The helper application contains additional utilities. A list of the options available with the pso and helper executables can be obtained by typing "./pso" or "./helper" respectively.

If using the program with ADF, GAMESS, GAMESS-UK, Firefly, Jaguar, Molpro, or ORCA, please see configuration instructions in section F.

Menu Next