HOWTO run a testcase

When the compilation is finished, the executable coolfluid-solver is created inside:

basebuild_dir/BUILD_MODE/apps/Solver

In order to run, you also need to have the file:

basebuild_dir/BUILD_MODE/apps/Solver/coolfluid-solver.xml

Before running a testcase from a generic TESTDIR folder, outside your COOLFluiD folder, you can create soft links to both files coolfluid-solver*:

cd TESTDIR

ln -sf basebuild_dir/BUILD_MODE/apps/Solver/coolfluid-solver* .

and then make sure that the .CFcase files you are trying to run specifies the following working path:

Simulator.Paths.WorkingDir = ./

---

NOTE: if you are a VKI end-user and not a developer you can use a preinstalled version of coolfluid-solver. For doing this, you first need to type:

module load cf2-2014.11/solver-mpich2 (on artesla2, arlin*, aglin* machines)

or

module load cf2-2014.11/rocks5/solver-mpich2 (on rocks5 cluster)

or

module load vki/coolfluid/openmpi/1.6.5-solver (on cvlogin cluster)

and then run cflink.sh inside the folder where your testcase is.

---

In order to run a testcase named file.CFcase, located in TESTPATH (full path or relative to coolfluid_dir), you must do:

./coolfluid-solver --scase TESTPATH/file.CFcase (serial)

mpirun -np NP ./coolfluid-solver --scase TESTPATH/file.CFcase (parallel).

Note: TESTPATH must be "./" if the case file is in the current directory, for example:

./coolfluid-solver --scase ./file.CFcase

---

NOTE: if you are a VKI end-user and not a developer and you are running the preinstalled version of COOLFluiD, you have to use "coolfluid-solver" instead of "./coolfluid-solver".

---

Newcomers to the project can start by looking at and running some existing cases from the regression test-suite, for example the following inviscid (Euler) cases taken from plugins/NavierStokes/testcases:

• Jets2D/jets2DFluctSplit.CFcase (2D, RDS, explicit)
• Jets2D/jets2DFluctSplitImpl.CFcase (2D, RDS, implicit)
• Jets2D/jets2DFVMImpl.CFcase (2D, FVM, implicit)
• Jets3D/jets3DFVMImpl.CFcase (3D, FVM, implicit)
• Wedge/wedgeFluctSplitHOCRD_Bx_imp.CFcase (2D, 3rd-order CRD, implicit)
• Wedge/wedgeFVM_MeFiAlgo.CFcase (2D, FVM, shock-mesh fitting algorithm)
• Wedge/wedgeFS_SpaceTime.CFcase (2D, space-time RDS, implicit).

---

NOTE: if you are using Ubuntu, all testcases may fail. If this happens, in order to make a testcase run, you have to manually modify the corresponding .CFcase file by adding:

libShapeFunctions to the module list at the beginning, right after Simulator.Modules.Libs =

Sorry for the inconvenience, this will be fixed soon...