There are 3 steps to performing simulations with LEAP.
To get started, we will use the lid-driven cavity flow example provided with LEAP for the lid-driven cavity flow.
Start by making the examples
cd /path/to/leap
make examples
make install-examples
This will create binaries for the lid-driven cavity example and sample input and run.sh files under /path/to/leap/install/folder/examples/cdifs/lid_driven_cavity. The other provided examples will also be installed in the same manner.
Next, we are going to run this example with the provided input file. The input file contains various parameters for this case and can be modified to vary things like density, viscosity, lid velocity, grid, etc. Note that the input file calls for 2x2x1 domain partition (this can be changed too). Thus, this run requires 4 cores by default.
To run this example, follow these instructions:
# Create a simulation folder somewhere
mkdir simulation_folder
cd simulation_folder
# Copy the input file to the simulation folder
cp /path/to/leap/install/folder/examples/cdifs/lid_driven_cavity/input .
# Run the initialization with 4 cores
mpiexec -n 4 /path/to/leap/install/folder/examples/cdifs/lid_driven_cavity -i input
# Run LEAP to integrate solution forward in time
mpiexec -n 4 /path/to/leap/install/folder/bin/leap -i input
These commands are also included in the run.sh file under /path/to/leap/install/folder/examples/cdifs/lid_driven_cavity/.
Note that there are additional examples users can get started with for the CDIFS and GRANS solvers:
CDIFS examples/
├── Homogeneous isotropic turbulence
├── Lid-driven cavity flow
├── Laminar and turbulent channel flow
├── Sphere rebound on a wall
├── Settling sphere in an unbounded domain
├── Flow Past a Cylinder
├── Lamb-Oseen vortex tubes
├── Taylor Green vortex
├── Vortex dipole
└── Vortex-wall Impingement
GRANS examples/
├── Homogeneous cooling
├── Dry collisions between spheres and sphere-walls
└── Granular channel flow