Simulation Configuration

This page describes how experiments are configured in NRP-core.

The details of the configuration of any given experiment are stored in a single JSON file, hereafter referred to as the “simulation configuration file”. This file (very originally named “simulation_configuration.json” in most of the examples) contains all the necessary configuration parameters to initialize and run an experiment, including details such as the engines involved in the experiment, active TransceiverFunctions, and engine timesteps. Below is an example taken from examples/tf_exchange experiment:

{
    "SimulationName": "tf_exchange",
    "SimulationDescription": "Launch two python engines. Engine1 will offer the current time as a datapack. tf_1 will request said datapack and send it to Engine2. Engine2 will receive the time and display it",
    "SimulationTimeout": 1,
    "EngineConfigs":
    [
        {
            "EngineType": "python_json",
            "EngineName": "python_1",
            "PythonFileName": "engine_1.py"
        },
        {
            "EngineType": "python_json",
            "EngineName": "python_2",
            "PythonFileName": "engine_2.py"
        }
    ],
    "DataPackProcessingFunctions":
    [
        {
            "Name": "tf_1",
            "FileName": "tf_1.py"
        }
    ]
}

In order to configure entirely all aspects of a given simulation, the NRP users only need to modify the configuration file. Inside it, the sections that should receive most attention from the users are: EngineConfigs, where the configuration of all the engines participating in the experiment is specified; and DataPackProcessingFunctions, where transceiver functions are specified.

For the definition of the configuration structure, we rely on json-schema.

The sections linked hereafter first detail how JSON-schema is used for managing experiment configuration, then go into the details of the main schemas and parameters that users may have to tinker with. These are (mainly) simulation, engine, and transceiver function schemas. NRP users who do not intend to integrate a new simulation engine may focus their attention on the Parameters section available in the pages linked below. The rest of the contents made available hereafter is intended either for developers wishing to integrate new engines & modify existing ones, or for users interested in implementation details.

• General notes about the use of JSON schema

• Simulation schema

• Event Loop schema

• Engine schema

• Transceiver function schema

• Process Launcher schema

• NRP Connectors schema

Related Pages:

EngineBase Schema

Event Loop Schema

General notes about the use of JSON schema

NRP Connectors Schema

Process Launcher Schema

Simulation Configuration Schema

Transceiver Function Schema