DEVELOPER : How to run coolfluid-solver

Serial simulation

$> ./coolfluid-solver --scase path/to/a/testcase/example.CFcase

Example: 

$> cd /home/user/workspace/COOLFluiD/debug/
$> cd src/Solver

$> ./coolfluid-solver --scase testcases/Jets2D/jets2D.CFcase --log 400

If you want to run coolfluid-solver from another directory, the best is to use a symbolic link. You will have to link to the coolfluid-solver executable and the coolfluid.xml file that is in the same dir.

Example: 

$> cd /home/user/mytestcases/
$> rm coolfluid-solver coolfluid.xml
$> ln -sf /home/user/workspace/COOLFluiD/debug/src/Solver/coolfluid-solver
$> ln -sf /home/user/workspace/COOLFluiD/debug/src/Solver/coolfluid.xml

$> ./coolfluid-solver --scase testcases/Jets2D/jets2D.CFcase --log 400

Parallel simulation

If you want to run in parallel, you must prepend the previous command with the parallel command. Unfortunately the parallel is dependent on the MPI you are using. Below you will find typical commands. Refer to your MPI documentation for further details ( for instance, on how to select which machines to use ).

  • lam-mpi 
      $> mpirun -np 6 ./coolfluid-solver --scase testcases/Jets2D/jets2D.CFcase

Note: Don't forget to run lamboot first

  • openmpi 
      $> mpirun -np 6 ./coolfluid-solver --scase testcases/Jets2D/jets2D.CFcase
  • mpich2 
      $> mpiexec -n 6 ./coolfluid-solver --scase testcases/Jets2D/jets2D.CFcase

Note: Don't forget to run mpd first

Running on Windows

1. open a console (cmd.exe) in windows and go to the directory where the testcase is. 

cd C:\Work\coolfluid\mytestcases\channel2d

2. set a environmental variable to the place where the libraries of coolfluid where built (inside the build directory) and the boost libraries (wherever they where installed). 

set PATH=%PATH%;C:\Work\coolfluid\builds\vs2008x86\dso;C:\Program Files (x86)\boost\lib

3. call the executable:

  1. write down the full path to the executable
  2. pass the full path to the coolfluid-solver.xml with --conf option
  3. pass the CFcase name witht he --scase option 
C:\Work\coolfluid\builds\vs2008x86\src\Solver\Debug\coolfluid-solver.exe --conf C:\Work\coolfluid\builds\vs2008x86\src\Solver\coolfluid-solver.xml --scase ./channel2d.CFcase