Table Of Contents
Table Of Contents

Visualizing the Physical Environment


The physical environment has a profound effect on the communication of wireless devices. For example, physical objects like walls inside buildings constraint mobility. They also obstruct radio signals, often resulting in packet loss. It is difficult to make sense of the simulation without actually seeing where physical objects are. INET provides the visualization of these objects to help understanding the simulation better. This feature is available both in 2D and 3D visualization.

This showcase demonstrates the visualization of physical objects through displaying the floorplan and walls of an apartment.

INET version: 4.0

About the visualizer

The PhysicalEnvironmentVisualizer (also part of IntegratedVisualizer) is responsible for displaying the physical objects. The objects themselves are provided by the PhysicalEnvironment module; their geometry, physical and visual properties are defined in the XML configuration of the PhysicalEnvironment module.


For more information about the XML format in which the physical environment (geometry, materials, etc.) can be defined, see the NED documentation of the PhysicalEnvironment module.

The two-dimensional projection of physical objects is determined by the SceneCanvasVisualizer module. (This is because the projection is also needed by other visualizers, for example, MobilityVisualizer.) The default view is top view (z-axis), but you can also configure side view (x and y axes), or isometric or orthographic projection.

The default view

This example configuration (DefaultView in the ini file) demonstrates the default visualization of objects. The objects are defined in the indoor.xml file, which depicts an apartment with three rooms. The network contains just two modules, a PhysicalEnvironment and an IntegratedVisualizer module. When the simulation is run, the network looks like this:


The isometric view

In this example configuration (IsometricView in the ini file), the view is set to isometric projection, by setting the viewAngle parameter in SceneVisualizer:

*.visualizer.canvasVisualizer.sceneVisualizer.viewAngle = "isometric"

When the simulation is run, the network looks like the following.


3D visualization

The visualizer also supports OpenGL-based 3D rendering using the OpenSceneGraph (OSG) library. If your OMNeT++ installation has been compiled with OSG support, you can switch to 3D view using the toolbar. The result will look like the following. Note that the SceneVisualizer view settings have no effect on the 3D view; you can use the mouse to move the camera and change the view angle.


Sources: omnetpp.ini, PhysicalEnvironmentVisualizationShowcase.ned

Further information

For more information, refer to the NED documentation of PhysicalEnvironmentVisualizer and SceneCanvasVisualizer.


Use this page in the GitHub issue tracker for commenting on this showcase.