Versions Compared

Old Version 9

changes.mady.by.user Mohsin Ali

Saved on

compared with

New Version Current

changes.mady.by.user Mohsin Ali

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Panel
borderColor#21618C
bgColor#F6F7F7
titleColor#17202A
borderWidth1
titleBGColor#FFB96A
borderStyleridge
titleOverview

LAMMPS stands for Large-scale Atomic/Molecular Massively Parallel Simulator.

LAMMPS has potentials for soft materials (biomolecules, polymers) and solid-state materials (metals, semiconductors) and coarse-grain systems.

It can be used to model atoms or, more generically, as a parallel particle simulator at the mesoscale or continuum levels.

For more information see the LAMMPS homepage.

How to use

First you need to decide on the version of the software you want to use. Use 

Code Block
themeFadeToGrey
 $ module avail lammps

to check what versions are available. We normally recommend using the latest version available. For example, to load the version 15Sep2022 of lammps use 

Code Block
themeFadeToGrey
$ module load lammps/15Sep2022c

For more details on using modules see our software applications guide.

Lammps runs under the PBS batch system using a job script similar to the following file jobscript:

Code Block
themeFadeToGrey
#!/bin/bash
 
#PBS -l ncpus=4
#PBS -l mem=4GB
#PBS -l jobfs=1GB
#PBS -l walltime=10:00:00
#PBS -l software=lammps
#PBS -l wd
 
# Load module, always specify version number.
module load lammps/15Sep2022
 
# Must include `#PBS -l storage=scratch/ab12+gdata/yz98` if the job
# needs access to `/scratch/ab12/` and `/g/data/yz98/`
 
mpirun lmp_openmpi -i input_filename > output

To submit the job to PBS run the following command 

Code Block
themeFadeToGrey
$ qsub jobscript

Using Lammps OMP

Our lammps build includes user-omp package. This is designed to allow usage of multi-threading. Our tests shows that this may lead to 10% speed up (possibly more, this is system and method depending) of pure MPI calculations. A typical PBS script for this, looks like the following:

Code Block
themeFadeToGrey
#!/bin/bash
 
#PBS -l ncpus=96
#PBS -l mem=100GB
#PBS -l jobfs=1GB
#PBS -l walltime=10:00:00
#PBS -l software=lammps
#PBS -l wd
 
# Load module, always specify version number.
module load lammps/15Sep2022
 
# Must include `#PBS -l storage=scratch/ab12+gdata/yz98` if the job
# needs access to `/scratch/ab12/` and `/g/data/yz98/`
 
n=12
mpirun -map-by ppr:$((12/$n)):numa:PE=$n lmp_openmpi -sf omp -pk omp $n > output

This will run 12 threads on each CPU. Our small tests indicates that n=8 or n=4 give the best performance. However, we encourage you to run your own tests.

Using the GPUVOLTA queue

Our lammps build includes GPU support. An example script that uses 2 GPUs is below:

Code Block
themeFadeToGrey
#!/bin/bash
 
#PBS -P a99
#PBS -q gpuvolta
#PBS -l ncpus=24
#PBS -l ngpus=2
#PBS -l walltime=1:00:00
#PBS -l mem=32GB
#PBS -l jobfs=1GB
#PBS -l wd
 
# Load module, always specify version number.
module load lammps/15Sep2022
 
# Must include `#PBS -l storage=scratch/ab12+gdata/yz98` if the job
# needs access to `/scratch/ab12/` and `/g/data/yz98/`
 
ngpus=$(( PBS_NGPUS<4?PBS_NGPUS:4 ))
 
mpirun -np $PBS_NCPUS lmp_openmpi -sf gpu -pk gpu $ngpus -i input_filename > output


Authors: Yue Sun, Andrey Bliznyuk, Mohsin Ali