Examples

In chombo-discharge, applications are set up so that they use the chombo-discharge source code and one chombo-discharge physics module. These are normally set up through Python interfaces accompanying each module. Several example applications are given in $DISCHARGE_HOME/Exec/Examples, which are organized by example type (e.g., plasma simulation, electrostatics, radiative transfer, etc). If chombo-discharge built successfully, it will usually be sufficient to compile the example by navigating to the folder containing the program file (program.cpp) and compiling it:

make -s -j4 program

To see how these programs are run, see Controlling chombo-discharge.

Positive streamer in air

To run one of the applications that use a particular chombo-discharge physics module, we will run a simulation of a positive streamer (in air).

The application code is located in $DISCHARGE_HOME/Exec/Examples/CdrPlasma/DeterministicAir and it uses the convection-diffusion-reaction plasma module (located in $DISCHARGE_HOME/Physics/CdrPlasma).

First, compile the application by

cd $DISCHARGE_HOME/Exec/Examples/CdrPlasma/DeterministicAir
make -s -j4 DIM=2 program

This will provide an executable named program2d.<bunch_of_options>.ex. If one compiles for 3D, i.e. DIM=3, the executable will be named program3d.<bunch_of_options>.ex.

To run the application do:

Serial build

./program2d.<bunch_of_options>.ex positive2d.inputs

Parallel build

mpirun -np 8 program2d.<bunch_of_options>.ex positive2d.inputs

If the user also compiled with HDF5, plot files will appear in the subfolder plt.

Tip

One can track the simulation progress through the pout.* files, see Parallel processor verbosity.