OSM allows to OMNeT++ users to quickly and easily execute large-scale network simulations. This is an automation tool for OMNeT++ large-scale simulations and data analysis. Based on OMNeT++ structure, this tool reads .ini file and build simulation campaign. Users' manual an code documentation is available at readthedocs.

If you use SMO for your OMNeT++ experiment analysis, we would appreciate a citation of our work:

• P. Bautista, L. F. Urquiza-Aguiar, L. L. Cárdenas and M. A. Igartua, “Large-Scale Simulations Manager Tool for OMNeT++: Expediting Simulations and Post-Processing Analysis,” in IEEE Access, vol. 8, pp. 159291-159306, 2020, doi: 10.1109/ACCESS.2020.3020745.

• Supports Python >= 3.5;
• Fine grane control of the simulation campaign;
• Customizable/interactive plotting
• Runs parallelized simulations and post-processing for large number of files (common in large-scale simulations);

OSM includes the following tool:

  - Launcher: build simulation campaign and execute parallel simulations in batches.
  - Parser:   Automatically try to detect output results files from simulation campaign (.vec,.sca, custom format) and convert those to an unique output file. 
  - Analyzer: Reads parsed files and plot results from template or launch an interactive plot in a web browser (pyvot tables). 

  # Build and lauch the simulation campaign
  $osm launcher [OPTIONS] INIFILE MAKEFILE

  # Summarize result files located in output folder
  $osm summarizer [OPTIONS] 

  # Analyze summarized file 
  $osm analyzer [OPTIONS] 

The osm package is developed using a pipenv. TO install osm on a virtual environment:

pip3 install pipenv

To clone the osm repository, on the command line, enter:

git clone https://github.com/Pbarbecho/osm.git

On the new venv, install osm project in an editable mode:

pipenv install -e osm/

Then, for use the new virtual environment instantiate a sub-shell as follows:

pipenv shell

At this time, you can interact with the osm modules, customize you analysis and use osm utilities.

Install osm using pip:

pip3 install --user -U https://github.com/Pbarbecho/osm/archive/master.zip

Depending on the operating system, you may need to add ~/.local/bin to your path. During the installation you will be warned about this.

In case you want to uninstall osm package:

pip3 uninstall osm

Pablo Barbecho