All these features related to particles are supported only in the particle branch
ESYS-Particle is a Discrete Element Method (DEM) code, which can be used to simulate particle dynamics. It can be coupled with TCLB with the use od Remote Force Interface (RFI).
The best way to install the ESYS-Particle version that supports RFI it to download the source code and compile it. The ESYS code is stored kept in a Bazaar repository (similar to git), on launchpad. You can clone the apropriate branch using:
bzr clone lp:~llaniewski/esys-particle/remote-force
The main branch is at
lp:esys-particle but it doesn't support RFI yet.
After you cloned the repository, you can configure, compile and install the
Configuration and installation
First we need to generate the
As in most cases we will want to install the code without root privilages,
we need to specify the installation directory somewhere in our home
./configure --prefix=$HOME/esys_inst/ CC=mpicc CXX=mpic++
After configuration, we can compile and install:
make -j 4 make install
To be able to run ESYS from our special installation directory, we need to set apropriate envirnment variables:
ESPATH=$HOME/esys_inst export PATH=$ESPATH/bin:$PATH export LD_LIBRARY_PATH=$ESPATH/lib:$LD_LIBRARY_PATH export PYTHONPATH=$ESPATH/lib/python2.7/site-packages:$PYTHONPATH
This can be placed in
.bashrc file if we want it to persist. We can check in the right version of ESYS is executed with
ls -l $(which esysparticle).
The simulations can be executed with:
mpirun -np 2 esysparticle script.py
To learn ESYS-Particle, we recommend their tutorial
To learn how to post-process results from ESYS-Particle please refer to another section of this manual