[ < ] [ > ]   [ << ] [ Up ] [ >> ]         [Top] [Contents] [Index] [ ? ]

6.14 Multiple Simulation Runs

A number of consecutive Angora simulations can be set up in a single configuration file.

Global variable: integer number_of_runs (default: 1)

The number of simulation runs is specified by the number_of_runs variable. The simulation runs (or runs for short) are indexed from 0 to number_of_runs-1. You can refer to these indices later in the configuration file for enabling or disabling certain configuration variables for certain runs (see enabled_for_runs).

Global variable: integer-array disabled_runs (default: none)

This array of integers (see Arrays) lists the run indices for simulations that will be skipped.

Example:

 
disabled_runs = [1,2,3,4,5];

If number_of_runs was 7, the above variable will cause only the simulations with indices 0 and 6 to be run.

Global variable: integer-array disabled_run_range (default: none)

If you would like to disable simulations that correspond to a range of run indices, you can use this variable. This has to be an array of integers with only two elements (see section Arrays). Simulations with run indices between (and including) these two integers will be skipped.

The following variable assignment has the same effect as the one in the previous example:

 
disabled_run_range = [1,5];

Sub-variable of any group: integer-array enabled_for_runs (default: all)

Sub-variable of any group: integer-array enabled_for_run_range (default: all)

Certain variables can be enabled or disabled for any of the simulation runs using the enabled_for_runs or enabled_for_run_range arrays. These arrays can be used inside any group structure (see Groups) to specify the run indices for which that group is enabled.

The enabled_for_runs array simply lists the run indices for which the specific group is enabled. For example,

 
number_of_runs = 4;
PointSources:
(
    {
        //point source #1
        enabled_for_runs = [0,1,2];
        coord_x_in_cells = 0;
        coord_y_in_cells = 0;
        coord_z_in_cells = 0;
        source_orientation = "x_directed";
        waveform_tag = "waveform1";
    },
    {
        //point source #2
        enabled_for_runs = [3];
        coord_x_in_cells = 0;
        coord_y_in_cells = 0;
        coord_z_in_cells = 0;
        source_orientation = "x_directed";
        waveform_tag = "waveform2";
    }
);

In this example, each group represents a collection of variable assignments that characterize an individual point source. With the enabled_for_runs variables set as shown, simulations 0, 1, and 2 will be run with the first point source; whereas simulation 3 will be run with the second point source.

Alternatively, the enabled_for_run_range array can be used to specify a range of run indices for which the group is enabled. This should be an integer array of length two. It specifies the lower and upper limits of the range of run indices for the specific group. For example,

 
number_of_runs = 10;
PointSources:
(
    {
        enabled_for_run_range = [0,5];
        coord_x_in_cells = 0;
        coord_y_in_cells = 0;
        coord_z_in_cells = 0;
        source_orientation = "x_directed";
        waveform_tag = "waveform1";
    }
);

This point source will only be enabled for run indices 0, 1, 2, 3, 4, and 5.


[ < ] [ > ]   [ << ] [ Up ] [ >> ]

This document was generated by Ilker Rafet Capoglu on December 12, 2012 using texi2html 1.82.