This page has instructions to install the source code for simulating ions in nanoconfinement on high-perfomance computing clusters (here we show specific steps for installation on IU's BigRed2)
Installing from Source and Building on IU BigRed2
The nanoconfinement code is open source and can optionally be built from source and used locally or on computer clusters. The following cluster build instructions should serve as a reference.
- By default BR2 cluster environment has Cray programming environment module (PrgEnv-cray) loaded
- Nanoconfinement code has dependency to Boost libraries which requires GNU programming environment
- Switch modules to GNU -
module swap PrgEnv-cray PrgEnv-gnu
- Switch modules to GNU -
- Load latest boost libraries
module load boost/1.65.0
- Load GSL libraries
module load gsl
- Copy or git clone nanoconfinement-md project in to a directory.
- Go to nanoconfinement-md directory and (cd nanoconfinement-md)
- You should provide the following make command to make the project. This will create the executable and Install the executable (md_simulation_confined_ions) into bin directory (That is nanoconfinement-md/bin)
- make cluster-install
- Now you are ready to run the executable with aprun command using any of the following methods:
Using a debug gpu queue.
- Request a debug GPU using the following command. This will provide you 64 processing nodes with 1 hour wall time.
- qsub -I -l nodes=4:ppn=16,walltime=01:00:00 -q debug_gpu
- Change you directory to the place where your executable was :
- cd nanoconfinement-md/bin
- Load the modules using following command :
- module swap PrgEnv-cray PrgEnv-gnu && module load boost/1.65.0 && module load gsl
- execute the program using following command :
- time aprun -n 4 -d 16 ./md_simulation_confined_ions -Z 3 -p 1 -n -1 -c 0.5 -d 0.714 -a 0.714 -S 1000000
Using a jobscript
- If you need to change the computational parameter or the physical parameters, you may edit the jobscript file.
- Next, submit a test job:
- Then, clean the datafiles from the test job:
- Fianlly, submit the job:
- All outputs from the simulation will be stored in the bin folder when the simulation is completed.
- Check and compare files (ex: energy.out) inside the
- If you want to clean everything and create a new build, use:
- You can check the status of the job by typing the following command.
- qstat -u “IU_username”
- Once the simulation has finished, data and outflies folders will contain the simulation results. You may check final density profile form data folder against the example desity profile provided in nanoconfinement-md/examples folder.