Wattson Command Line Options#

When starting Wattson from the command line via the package entry point (python3 -m wattson), you can provide several command line options to influence Wattson’s behavior and the involved components.

For a full list of all command line options / arguments, run python3 -m wattson -h. The following list describes the most important aspects.

Positional Arguments#

Wattson takes at least one and at most two positional arguments. You always have to specify the path to the simulation scenario as the first positional argument. The second optional positional argument specifies the network emulation segment to start. This argument is reserved for future use and has not yet any effect.

Utility Arguments#

  • –clear, -c: Instead of starting a new simulation, clean up a potential running simulation or its remains. This clears switches, namespaces and Wattson-related processes.

  • –no-cli: Instruct the simulation to not start the Wattson CLI. This is helpful for subprocess and non-interactive session usage.

  • –no-net: Skip network creation altogether. This also skips the creation of the management network!

  • –empty-net: Clear the network. Only the management network exists.

Scenario Arguments#

  • –extensions, -e: Specify the path to the extensions.yml. Defaults to the file in the scenario folder if present.

  • –artifact-directory, -d: The artifact and working directory for the simulation run. Per default, a dedicated folder will be created in the shell’s working directory.

  • –script, -s (multiple occurences possible): Path to script file to run along with the simulation. A dedicated process is started for each script.

Wattson Configuration Options#

Wattson manages an internal configuration store with static and dynamic information. This included the working directory, interfaces along with instructions on how certain processes should behave. For instance, the IEC 104 communication stack respects TLS-related configurations to decide on whether TLS should be used and which certificates are relevant. The power grid simulator looks for configurations on measurement noise, simulation noise and load profiles.

Through the command line options and YAML-based configuration options, these aspects can be influenced on the start of the scenario.

Wattson CLI#

When running Wattson, it drops to the Wattson CLI once the simulation is running. The CLI provides a text-based interface to observe and manipulate the running co-simulation, e.g., by manipulating links, nodes and services. Type help in the CLI to get a list of all available options.