Scripts, Input Examples and Utility Programs

This page contains links to exaple running scripts and inputs for ADF and PAW on a number of different platforms and types of calculation. Also available here are a number of small programs that various members of the Ziegler group have found useful for creating inputs, analyzing outputs and general scientific work. Thanks goes out to all the group members who provided examples and programs/scripts.

ADF Stuff

ADF Run Scripts

At present we run ADF on several computers including (in order of age) rhodium (rhodium1.chem.ucalgary.ca), the cluster of Westgrid computers at U of A (nexus.westgrid.ca), lattice (lattice.westgrid.ca), glacier (glacier.westgrid.ca) and terminus. Example scripts for each computer can be accessed via the links below. In each case, it is assumed that the input file is called "input.in" and the output file is called "output.log". You will of course substitute your own names for these files. It is also assumed that you want to use the 2004.01 version of ADF except terminus where it is ADF 2009. Substituting the year of the version that you are interested for the 2004 and the version number for the 01 wherever they appear should be sufficient. It may not be sufficient for versions of ADF older than 2002 but you probably shouldn't be using these versions anyway. On some computers other parts of a script will need to be customized, e.g. a directory name. When this occurs, it will be indicated by comments in the script.

ADF Example Inputs

Also listed below are links to some example inputs for ADF calculations. The first few are relatively simple while the later files show some more complicated cases such as QM/MM inputs and COSMO inputs. Some explanation of the inputs will be included in the files themselves but more details will be found in the ADF manual. Note that SCM provides a graphical interface for producing ADF inputs (adfinput) and that the molecule program available on many Macs can also spit out ADF input. Neither program has been found to be particularly satisfactory for more complicated inputs so far. These input examples are far from exhaustive and there are many more options that those presented here.

Utilities for Use with ADF

As well as inputs and scripts, we have a number of useful programs/shell scripts for use with ADF. Their style, size, complexity, scope of application and ease of use vary wildly from production and checking of inputs, extraction of numbers from outputs to extensive analysis of results. Links to those included in the current collection can be found below. Since these utilities are so varied, each includes instructions on how to run them and a short description of what it does. These descriptions can be found as comments in the source code of an executable or a script. If a program does need to be compiled only source code will be included to make this catalogue as portable as possible. Since the range of utilities is so wide, they have been grouped according to the use of a given utility. Some utilities could appear in more than one group. They have been put in both. ADF comes with a few utilities itself including ADFview, ADFmovie, ADFspectra, bob and more. They are listed here in the appropriate spots but no link to them is given. Look at your favourite ADF distribution.

ADF Files

Run ScriptsExample Inputs Utility Programs
Terminus Serial Geom. Opt. in Cart. Coord. Input Preparation-Geometry Specification
Terminus Parallel Geom. Opt. with Z-matrix and LT coord (awk script)
Rhodium Serial Trans. State Search with QM/MM on a frozen Solid Surface zcoord (awk script)
Rhodium Parallel Linear Combination Constraint with Lin. Trans. and Solvations rewrite (awk script)
Nexus Parallel zrewrite (awk script)
Lattice Serial transxmol3 (sed script)
Lattice Parallel adfinput (ADF package)
Glacier Serial Input Preparation-QM/MM
Glacier Parallel xmol2qmmm (ADF package)
Output Analysis-Geometries
Matrix Parallel mkxyz (awk script)
Orcinus or Checkers Serial mkxyzqmmm (awk script)
Orcinus or Checkers Parallel Output Analysis-Frequencies
freq (awk script)
Vibent (awk script)
adfspectra (ADF package)
General Output Manipulation
bob (ADF package)
Orbital Viewing
adfview (ADF package)
adfplt (ADF package)
adfnbo (ADF package)
Spectral Analysis
adfspectra (ADF package)

PAW Stuff

PAW Run Scripts

The PAW program runs on all the computers that ADF runs on. However, it is unlikely that you will want to run on cobalt or in parallel on rhodium though serial jobs on this computer are a reasonable prospect. A PAW run is often a series of calculations though this generally doesn't introduce significant complications into the runscript. One exception is preparing the restart files for a pointwise thermodynamic integration calculation. An example of such a script is included.

PAW Example Inputs

PAW requires at least two input files, the structure file (suffix .strc) and a control file (can have any name but generally has .cntl somewhere near the end). Unless starting from scratch, you will also have a restart file (suffix .rstrt). If you are running a QM/MM calculation then further files containing the MM parameters and the QM/MM definition will also be necessary. An IRC calculation also requires further files as will a solvated calculation. "A PAW caclulation" often involves a series of runs beginning with a run to obtain an optimized wave function, then a second run to optimize a starting geometry, the a run to warm the system to the desired temperature, then a run to equilibrate the system at that temperature until finally results are aquired in further runs. Between each run, options on the control file are changed and sometimes options in the structure file are changed. Examples of each type of run (wave function optimization, geometry optimization, warmup, QM/MM etc) are accessible from the table below. In each case, the example will be made up several files tarred into one. Included will be at least three files: the example .strc file, the .cntl and a README file giving information about each example. Some cases (such as QM/MM) will have more than three files ion the example.

PAW Files

Run ScriptsExample Inputs Utility Programs
Rhodium Serial Wave Function Opt.
Lattice Serial Geometry Optimization
Lattice_Parallel Warm up
Nexus Parallel Equilibrate
Glacier Serial Slow Growth
Glacier Parallel Substitution
Pointwise T.I. Setup Solvation
QM/MM