Execution

Executing TOSCA is pretty straightforward. Once the code has been compiled (see Installation), you should see two executables in the build directory: tosca and tosca2PV.

The first executable is the TOSCA solver, while the second allows to convert TOSCA output binary files to .xmf files that can be read by ParaView.

In order to run TOSCA, copy the two executables to the directory where your input files are located. If running test cases, we suggest to copy the tests directory to a directory of your choiche, in order to maintain your TOSCA repository clean.

Running in serial

To run in serial, simply run the following command in a terminal:

./tosca

And to post process the output, run:

./tosca2PV

Finally, open the xmf files contained inside the XMF directory using ParaView.

Running in parallel

To run in parallel with all available processors (e.g. when submitting jobs on a cluster through SLURM or PBS), simply insert the following command in the submission script:

mpirun ./tosca

or with a specific number of processors:

mpirun -np 2000 ./tosca

where 2000 is the number of processors you want to use. To post process the output in serial (this will also convert 3D fields to .xmf format), run the following command in a terminal:

./tosca2PV

If you want to post process the output in parallel (this will only process the flow sections, usually for large cases where 3D fields are only saved for potential restart), run the following command in a terminal:

mpirun -np 4 ./tosca2PV

where 4 is the number of processors you want to use.

Finally, open the xmf files contained inside the XMF directory with ParaView.