The CSF2 has been replaced by the CSF3 - please use that system! This documentation may be out of date. Please read the CSF3 documentation instead. To display this old CSF2 page click here. |
GULP
Overview
GULP is a program for performing a variety of types of simulation on materials using boundary conditions of 0-D (molecules and clusters), 1-D (polymers), 2-D (surfaces, slabs and grain boundaries), or 3-D (periodic solids). The focus of the code is on analytical solutions, through the use of lattice dynamics, where possible, rather than on molecular dynamics. A variety of force fields can be used within GULP spanning the shell model for ionic materials, molecular mechanics for organic systems, the embedded atom model for metals and the reactive REBO potential for hydrocarbons. Analytic derivatives are included up to at least second order for most force fields, and to third order for many.
Version 4.2 is installed on the CSF. It was compiled with Intel Compilers 14.0.3 and openmpi 1.6 (optimisation flags -O3 -msse4.2 and -axAVX
were used). This installation will only work on Intel nodes (due to some flags used in the openmpi compilation).
Restrictions on use
GULP is available only for Staff and Students of the University to use (no visitor access permitted). It must not be used for commercial purposes or research. Use of the software must be cited in publications. All users must agree to abide by these conditions before being added to the relevant software group.
There is no access to source code on the CSF.
Set up procedure
To access the software you must first load the appropriate modulefile:
To run on a single node (1 core jobs and multi-core jobs up to 16 cores)
module load module apps/intel-14.0/gulp/4.2
To run on more than one node (24 cores or more in multiples of 12)
module load module apps/intel-14.0/gulp/4.2-ib
The GULP utilities (arc2his
, mc2arc
, mdb2a
and reaxff2lib
) have been compiled without MPI or optimisation and must be run as serial jobs.
Running the application
Please do not run GULP on the login node. Jobs should be submitted to the compute nodes via batch.
Serial batch job submission
Make sure you have the modulefile loaded then create a batch submission script, for example:
#!/bin/bash #$ -S /bin/bash #$ -cwd # Job will run from the current directory #$ -V # Job will inherit current environment settings gulp < input.gin
Submit the jobscript using:
qsub scriptname
where scriptname is the name of your jobscript.
Parallel batch job submission - 2 to 24 cores
Make sure you have the appropriate modulefile loaded then create a batch submission script, for example:
#!/bin/bash #$ -S /bin/bash #$ -cwd # Job will run from the current directory #$ -V # Job will inherit current environment settings #$ -pe smp.pe 12 mpirun -np $NSLOTS gulp < input.gin
Submit the jobscript using:
qsub scriptname
where scriptname is the name of your jobscript.
Parallel batch job submission - 48 cores or more in multiples of 24
Make sure you have the appropriate modulefile loaded then create a batch submission script, for example:
#!/bin/bash #$ -S /bin/bash #$ -cwd # Job will run from the current directory #$ -V #$ -pe orte-24-ib.pe 48 mpirun -np $NSLOTS gulp < input.gin
Submit the jobscript using:
qsub scriptname
where scriptname is the name of your jobscript.
Further info
- The GULP website includes examples and a manual.
- Documentation also available on the CSF using the command:
evince $GULP_DOC/gulp4.2_manual.pdf &
- Examples available on the CSF in
$GULP_HOME/Examples
.
Updates
None.