Software
Software
The software listed on this page was developed during my PhD and used during my studies.
Measuring of Network Characteristics using Mobile Cellular Networks
The first version of the Rate Measurement Framework (RMF) was developed by Sebastian Wilken during his master thesis. It was further enhanced by
Christian Lange and
Tobias Krauthoff during their master theses and Franz Kary during his project phase. Lately large parts were modified by me to fullfill all requirements for the currently used self-induced congestion aware implementation of our measurement algorithm.
The RMF itself is publisehd under the MIT License, the version used for the paper can be found in the source tarball.
All later versions of the sources are also available through the github repository https://github.com/hhucn/rmf.
The RMF makes use of STLSoft and Pantheios (using the BSD-form license) librariers. As Pantheois needs to be patched for gcc>4.6, the patched sources are included in our tarball and in the dependencies directory on github (including the corresponding licenses).
Please read the INSTALL file in the tarball for detailed installation instructions.
Trace-based UMTS Simulation (TBUS) for OMNeT++ and VSimRTI
Last changed: March 1st 2016Copyright Notice
This Website provides an overview of the developed software and resources for the paper Coupled Simulation of Mobile Cellular Networks, Road Traffic and V2X applications using Traces.
The copyright of each resource used remains at the resource's author(s).
Our own contributions are marked as such and do not claim the copyright of original authors.
The corresponding licenses are included in the given projects. While the simulations for the paper were conducted using VSimRTI 0.14.0 we describe the installation on the more advanced VSimRTI 0.15.0.
Licensing Notice
In addition to the published licenses, VSimRTI requires a valid license to be run.
This license can be obtained from Fraunhofer FOKUS as described in the Introduction chapter of the VSimRTI manual available from www.dcaiti.tu-berlin.de/research/simulation/download/.
Software Requirements
These instructions have been tested for VSimRTI 0.15.0, SUMO 0.21.0 and OMNeT++ 4.4.1 on multiple linux systems.
Other versions may work, but have not been tested.
Installation instructions
We wrote a small installation script that eases the compilation and installation of our OMNeT++ module and example scenarios in VSimRTI. Nevertheless some manual steps are needed during the installation.
The installation script should only alter content or create ~/omnetpp-4.4.1 and ~/vsimrti-allinonce and append omnetpp-4.4.1 to your PATH variable.
Before starting the installation please make sure that:
We are not responsible for data loss by our script or software!
For an easier installation of required libraries and programs, please have a look at this list. If you are working on a debian-based system, the following command can install all necessary packages:
sudo apt-get update && sudo apt-get install libicu-dev mpi-default-dev libpcap-dev libproj-dev tk-dev tcl-dev libxerces-c-dev libtool libgdal-dev libfox-1.6-dev libxml2-dev zlib1g-dev default-jre bison flex build-essential gcc g++
- Get copys of the following downloads and store them at a location you can type easily. In the remainder of these instuctions we assume you stored the files in /tmp.
- vsimrti-bin-0.15.0.zip and omnetpp-ambassador-1.1.2b.jar from www.dcaiti.tu-berlin.de/research/simulation/download/
- omnetpp 4.4.1 sources from https://omnetpp.org/component/jdownloads/download/32-release-older-versions/2272-omnet-4-4-1-source-ide-tgz
- tbus-installer.sh from https://wwwcn.cs.uni-duesseldorf.de/software/tbus/tbus-installer.sh
- Install VSimRTI by unzipping vsimrti-bin-0.15.0.zip according to their manual Section 1.2.
- Install SUMO >=0.21.0 and SUMO <=0.24.0 according to Section 6.5.2 of the VSimRTI manaul.
On ubuntu system often apt-get install sumo suffices. - Use our installation script tbus-installer.sh:
/tmp/tbus-installer.sh -t /tmp/omnetpp-4.4.1-src.tgz -p ~/vsimrti-allinone/vsimrti/
assuming that you downloaded the files to /tmp and unzipped vsimrti-0.15.0.zip to ~/vsimrti-allinone.
The script will automatically- download omnetpp-patch-0.15.0.zip and omnetpp-ambassador-1.1.2b.jar from Fraunhofer
- configure, compile and install OMNeT++ 4.4.1 with Fraunhofers patch and our libtbus to ~/omnetpp-4.4.1
- disable automatic starting of omnetpp in vsimrti default.xml
- add omnetpp-4.4.1 to your path
- install the example scenarios for tbus Taubental-large and Taubental-large-etsi including all necessary files to start a libtbus based simulation.
Starting a simulation
We provide two example scenarios using the same simulation area but different implementations of the emergency vehicle warning V2X-application:
- Taubental-large-etsi: A simulation using etsi conform CAM and DEMN intervals for emergency vehichle warning messages.
- Taubental-large: An enhanced version of the V2X application, that is optimized for cellular network usage.
- ./start-omnet-federate.sh -c scenarios/Taubental-large
- ./vsimrti.sh -u USERNAME -c scenarios/Taubental-large/vsimrti/vsimrti_config.xml
Resources
VSimRTI can be downloaded from the Fraunhofer FOKUS and Daimler DCAITI: www.dcaiti.tu-berlin.de/research/simulation/download/.
The closed-source OMNeT++ ambassador, which we were kindly allowed to modify, is also available on the previously mentioned website as a closed-source JAR.
In total the following files from Fraunhofer FOKUs are needed: vsimrti-bin-0.15.0.zip, omnetpp-patch-0.15.0.zip, omnetpp-ambassador-1.1.2b.jar
The remaining software needed for the simulation is available as sources in git repositories on github:
- Patched version of the INETMANET project for OMNeT++: github.com/hhucn/inetmanet
- Patched version of the VSimRTI federate: github.com/hhucn/omnetpp-federate
- TBUS for VSimRTI: github.com/hhucn/tbus-vsimrti
- TBUS applications for VSimRTI: github.com/hhucn/tbus-applications
Scenarios and Logs used in the ICC 2016 Paper:
The simulation scenarios used for the ICC 2016 paper (which was using VSimRTI 0.14.0) are available at ETSI conform EWA simulation (VSimRTI 0.14.0) and Enhanced, cellular network optimized EWA simulation (VSimRTI 0.14.0)
The complete simulation logs used in evaluation section of the paper are available here: Logs for ETSI conform EWA simulation (VSimRTI 0.14.0) and Los for enhanced, cellular network optimized EWA simulation (VSimRTI 0.14.0)