Scenario Configuration

You can use a Readable Unit anywhere where you have the option of:

• number or string

• integer or string

📃 Corresponding configuration file: scenario_config.json

Scenario

Schema describing the JSON file structure for the main scenario configuration.

Properties

Type Description Required Boundaries Default
simulation simulation Basic properties of the simulation scenario. ✓ Yes None None
federates object Defines the list of ambassadors/simulators which are used by the simulation. For each simulator (referenced by its id) a boolean value must be given, which enables or disables the simulator. ✓ Yes None None

Further property restrictions:

Scenario.federates

• Type of each property: boolean

simulation

Basic properties of the simulation scenario.

Properties

Type Description Required Boundaries Default
id string The id or name of the simulation scenario. ✓ Yes None None
duration string
number
The duration of the simulation. If defined as a number, then the unit to be applied is ns. Alternatively this can be defined as a string to include the unit of measurement (e.g. ‘300 s’) ✓ Yes None None
randomSeed integer The random seed to apply. This influences the application mapping, the communication models, and any use of randomness inside of applications. If not set, the random number generator will be initialized without a seed resulting in different results for each run. Note that several other simulators (e.g. SUMO) come with their own random number generators which are not affected by this property. No None None
projection projection Configures the projection used to transform geographical coordinates (WGS84) to local cartesian coordinates used by various simulators (e.g. SUMO, or OMNeT++). The projection is based on UTM and must be adapted to the used traffic network. ✓ Yes None None
network network Defines the subnets (e.g. 10.0.0.0) used for generating IP addresses for each unit in the simulation. Each type of unit is configured with its own subnet. A default configuration is used, when left out from the configuration. No None default network

Projection

Configures the projection used to transform geographical coordinates (WGS84) to local cartesian coordinates used by various simulators (e.g. SUMO, or OMNeT++). The projection is based on UTM and must be adapted to the used traffic network.

Properties

Type Description Required Boundaries Default
centerCoordinates geoPoint Geographic coordinates of the rough center of the map / playground used in this scenario. This is just used to determine the UTM zone used for any further projection. ✓ Yes None None
cartesianOffset cartesianOffset A cartesian offset which is added to the UTM transformation. In most cases, this must be the exact offset which can be found in the location.netOffset of the *.net.xml of the scenario. ✓ Yes None None

GeoPoint

Geographic coordinates of the rough center of the map / playground used in this scenario. This is just used to determine the UTM zone used for any further projection.

Properties

Type Description Required Boundaries Default
longitude number East-west position of a point on earth. ✓ Yes [-180, 180] None
latitude number North-south position of a point on earth. ✓ Yes [-90, 90] None

CartesianOffset

A cartesian offset which is added to the UTM transformation. In most cases, this must be the exact offset which can be found in the location.netOffset of the *.net.xml of the scenario.

Properties

Type Description Required Boundaries Default
x number The value to add to the X coordinate after UTM transformation ✓ Yes None None
y number The value to add to the Y coordinate after UTM transformation ✓ Yes None None

netMask string The net mask used for IP generation. No None 255.0.0.0
vehicleNet string The subnet used for assigning IPs to vehicles. No None 10.0.0.0
rsuNet string The subnet used for assigning IPs to road side units. No None 11.0.0.0
tlNet string The subnet used for assigning IPs to traffic lights. No None 12.0.0.0
csNet string The subnet used for assigning IPs to charging stations. No None 13.0.0.0
serverNet string The subnet used for assigning IPs to servers. No None 14.0.0.0
tmcNet string The subnet used for assigning IPs to traffic management centers. No None 15.0.0.0