Ellipsoidal particles in spherical solvent (LAMMPS): Difference between revisions
m (Bgo moved page User:Bgo/sandbox ellipse to LAMMPS example: Ellipsoidal particles in spherical solvent without leaving a redirect: Initial public release) |
(Moved initial setup message to after the TOC) |
||
(12 intermediate revisions by the same user not shown) | |||
Line 1: | Line 1: | ||
Ellipsoidal particles in spherical solvent, 2d system. The example used here is identical to the version released with LAMMPS, with the following exceptions: | Ellipsoidal particles in spherical solvent, 2d system. The example used here is identical to the version released with LAMMPS, with the following exceptions: | ||
* Time-step is halved. | * Time-step is halved. | ||
* Run times increased to 1,000,000. | * Run times increased to 1,000,000. | ||
* | * Creates a movie. | ||
==Prepare Example Directory | = Initial Setup = | ||
We need to complete the [[Initial Setup|initial setup tutorial]] first, to be sure that the [//gcc.gnu.org GNU Compiler Collection], and [//www.open-mpi.org Open MPI] will be used for our simulations. | |||
{{HPC-InitialSetupMsg}} | |||
=Prepare Example Directory= | |||
First, make sure we are at the root of our home directory | First, make sure we are at the root of our home directory | ||
Line 15: | Line 19: | ||
Now, make an {{Path|example}} directory, and copy the ellipse example directory into it. | Now, make an {{Path|example}} directory, and copy the ellipse example directory into it. | ||
{{Cmd|mkdir examples|cp -r {{HPC-Examples-Dir}}/lammps/ellipse examples/|cd examples/ellipse|ls|output=<pre>ellipse.gayberne.lmp</pre>}} | {{Cmd|mkdir examples|cp -r {{HPC-Examples-Dir|flory}}/lammps/ellipse examples/|cd examples/ellipse|ls|output=<pre>ellipse.gayberne.lmp</pre>}} | ||
We also need a script to submit the job to the cluster. Lets start with the sample script in {{Path|{{HPC-Samples-Dir}}}} by copying it to our new ellipse example directory. | We also need a script to submit the job to the cluster. Lets start with the sample script in {{Path|{{HPC-Samples-Dir|flory}}}} by copying it to our new ellipse example directory. | ||
{{Cmd|cp {{HPC-Samples-Dir}}/torque-lmp.sh .|ls|output=<pre> | {{Cmd|cp {{HPC-Samples-Dir|flory}}/torque-lmp.sh .|ls|output=<pre> | ||
ellipse.gayberne.lmp torque-lmp.sh | ellipse.gayberne.lmp torque-lmp.sh | ||
</pre>}} | </pre>}} | ||
Line 25: | Line 29: | ||
The {{Path|torque-lmp.sh}} script should look something like this: | The {{Path|torque-lmp.sh}} script should look something like this: | ||
{{ | {{HPC-torque-lmp|lang=bash|title=(original)}} | ||
=Modify Queue Submission Script= | |||
The submission script we just copied has default settings that have to be modified for this simulation. Lucky, most of the defaults work for the ellipse simulation (1 node, 16 processes per node, etc.) and all we have to change is the name of the job and the lammps input file. Changing the job name to {{C|ellipse-lmp}} and the input file to {{C|ellipse.gayberne}} results in a submission script that looks like this: | The submission script we just copied has default settings that have to be modified for this simulation. Lucky, most of the defaults work for the ellipse simulation (1 node, 16 processes per node, etc.) and all we have to change is the name of the job and the lammps input file. Changing the job name to {{C|ellipse-lmp}} and the input file to {{C|ellipse.gayberne}} results in a submission script that looks like this: | ||
{{ | {{HPC-torque-lmp|lang=bash|title=(edited)|jobname=ellipse-lmp|inputfile=ellipse.gayberne}} | ||
}} | |||
=Submit Job= | |||
The job is now ready to be sent to the cluster. | The job is now ready to be sent to the cluster. | ||
Line 75: | Line 49: | ||
The job should take about 4 minutes. Check the job status with {{C|qstat}} to see when it is finished; when the job is no longer listed it has finished. | The job should take about 4 minutes. Check the job status with {{C|qstat}} to see when it is finished; when the job is no longer listed it has finished. | ||
=Check Results= | |||
When the job completes you should find the following files: | When the job completes you should find the following files: | ||
Line 117: | Line 91: | ||
To watch the movie, copy it to your computer. It should be about 1 minute 23 seconds long. During the first half of movie the box is shrinking (NPT ensemble), but the movie is also zooming in, making it look like the particles are getting larger. | To watch the movie, copy it to your computer. It should be about 1 minute 23 seconds long. During the first half of movie the box is shrinking (NPT ensemble), but the movie is also zooming in, making it look like the particles are getting larger. | ||
[[Category: | [[Category:LAMMPS Examples]] |
Latest revision as of 15:56, 9 January 2017
Ellipsoidal particles in spherical solvent, 2d system. The example used here is identical to the version released with LAMMPS, with the following exceptions:
- Time-step is halved.
- Run times increased to 1,000,000.
- Creates a movie.
Initial Setup
We need to complete the initial setup tutorial first, to be sure that the GNU Compiler Collection, and Open MPI will be used for our simulations.
The initial setup must be completed before continuing.
Prepare Example Directory
First, make sure we are at the root of our home directory
user $
cd
Now, make an example directory, and copy the ellipse example directory into it.
user $
mkdir examples
user $
cp -r /home/bgo/shared/examples/lammps/ellipse examples/
user $
cd examples/ellipse
user $
ls
ellipse.gayberne.lmp
We also need a script to submit the job to the cluster. Lets start with the sample script in /home/bgo/shared/samples by copying it to our new ellipse example directory.
user $
cp /home/bgo/shared/samples/torque-lmp.sh .
user $
ls
ellipse.gayberne.lmp torque-lmp.sh
The torque-lmp.sh script should look something like this:
#PBS -l walltime=10:00:00,mem=15gb,nodes=1:ppn=16 ##PBS -M EmailAddress ##PBS -m bae #PBS -q default #PBS -N Jobname #PBS -o myoutput.txt #PBS -j oe . $(which lmp-config) # The LAMMPS input file must have a '.lmp' extension (e.g., mysimulation.lmp). INPUTFILE=mysimulation doLAMMPS
Modify Queue Submission Script
The submission script we just copied has default settings that have to be modified for this simulation. Lucky, most of the defaults work for the ellipse simulation (1 node, 16 processes per node, etc.) and all we have to change is the name of the job and the lammps input file. Changing the job name to ellipse-lmp and the input file to ellipse.gayberne results in a submission script that looks like this:
#PBS -l walltime=10:00:00,mem=15gb,nodes=1:ppn=16 ##PBS -M EmailAddress ##PBS -m bae #PBS -q default #PBS -N ellipse-lmp #PBS -o myoutput.txt #PBS -j oe . $(which lmp-config) # The LAMMPS input file must have a '.lmp' extension (e.g., mysimulation.lmp). INPUTFILE=ellipse.gayberne doLAMMPS
Submit Job
The job is now ready to be sent to the cluster.
user $
qsub torque-lmp.sh
user $
qstat
Job ID Name User Time Use S Queue ------------------------- ---------------- --------------- -------- - ----- 14222.flory ellipse-lmp user 00:00:35 R default
The job should take about 4 minutes. Check the job status with qstat to see when it is finished; when the job is no longer listed it has finished.
Check Results
When the job completes you should find the following files:
user $
ls -lh
total 22M -rw-r--r-- 1 user user 1.8K Dec 20 17:25 ellipse.gayberne.lmp -rw-rw-r-- 1 user user 1.5M Dec 20 17:29 ellipse.gayberne.out -rw-rw-r-- 1 user user 398 Dec 20 17:26 log.cite -rw-rw-r-- 1 user user 20M Dec 20 17:29 movie.mkv -rw------- 1 user user 730 Dec 20 17:29 myoutput.txt -rwxr-xr-x 1 user user 293 Dec 20 16:14 torque-lmp.sh
General information about the job can be found in myoutout.txt, if any errors occurred they should be listed in this file. A successful run will look like this:
user $
cat myoutput.txt
-------------- lmp-config (BEGIN) -------------- Start time : Tue Dec 20 17:25:51 EST 2016 PBS_JOBID : 14222.flory.usm.edu Working Directory: /home/user/examples/ellipse MPI command : /home/user/shared/gnu-openmpi/bin/mpirun LAMMPS command : /home/user/shared/gnu-openmpi/bin/lmp LAMMPS script : /home/user/examples/ellipse/ellipse.gayberne.lmp Processes : 16 Controlling Node : n005.cluster.com Nodes : n005.cluster.com (16) Command: mpirun lmp -in "ellipse.gayberne.lmp" -log "ellipse.gayberne.out" -screen "none" Stop time : Tue Dec 20 17:29:39 EST 2016 Elapsed time : 0 days 00h 03m 48s -------------- lmp-config ( END ) --------------
The results from the LAMMPS simulation can be found in ellipse.gayberne.out, and movie.mkv is the movie.
To watch the movie, copy it to your computer. It should be about 1 minute 23 seconds long. During the first half of movie the box is shrinking (NPT ensemble), but the movie is also zooming in, making it look like the particles are getting larger.