Running a simulation

There are two different ways to call smuthi:

  • From the command line with an input file. No programming skills are required.
  • From a Python script. This option is more flexible regarding how to run and evaluate the simulations.

Run from command line

SMUTHI is executed from the command line together with one argument, specifying the input file that contains all parameters of the configuration to be simulated.

To execute SMUTHI, open a command window (shell or Win Python Command Prompt) and type:

smuthi path/to/input.dat

If smuthi is called without an argument, it uses an example_input.dat. The output should look like this:


The input file

The input file uses the YAML format. Download an example file example_input.dat and play around with its entries to get a quick start.

For a detailed explanation of the specified parameters, see the section on input files.

Running simulations as Python scripts

In the SMUTHI project folder, you find a script called You can also download it from here by clicking on the above filename.

Edit and run that script to get a quick start. For details, see the section on running SMUTHI from scripts.