6
4 Predefined Scenarios
In Section 2 we described how to run a simulation. To define a simulation
we use so called scenario files. The desired parameters for a specific scenario
are set in these files. Undefined parameters will be initialized with their
default values. This way all options are concentrated in one spot and are not
distributed in hidden configuration files. To keep simulations reproducible,
we recommend saving (a copy of) the scenario file for each simulation that
might be needed later on.
By opening a scenario file one can see that they contain a function.
This function expects one parameter of the class
parameters.Parameter
and
returns the same object filled with all the required settings. To start the simula-
tion a function handle to the intended scenario e.g.:
@scenarios.basicScenario
needs to be passed to the simulate function in the simulator’s root folder.
4.1 Customization
For defining new scenarios we recommend to start from the existing scenario
that is most similar to the intended simulation and modify a copy of it.
One benefit of the configuration through functions is its flexibility. The
only constraints are that the function has to take a
parameters.Parameter
object as input and returns this object with the properties set are required.
Besides this, one can execute arbitrary MATLAB code in these functions. For
example one can use calculations to find the right parameter values, call other
functions or simply load data from configuration/data files. This flexibility
allows to customize the scenario to a large degree.
4.2 Predefined Launchers and Scenario files
In the package
+launchersFiles
several launchers for simulating predefined
scenarios can be found. The corresponding scenario files are defined in
+scenarios
. In the following, the specifics of these scenarios is explained,
including the most important parameters and how they have to be defined.
4.2.1 Hexagonal grid with interference ring
The launcher file
launcherFiles.launcherHexRingInterferers.m
provides
an example of how to simulate a hexagonal grid network of three-sector
BS
s with a defined number of rings of
BS
s and rings of interfering
BS
s.
The launcher file starts by calling the corresponding scenario file located in
