NetworkRouteOsgVisualizer¶

Package: inet.visualizer.osg.networklayer

simple module NetworkRouteOsgVisualizer

Visualizes network routes on a 3D osg scene. It displays a polyline for each active route in the network. See the documentation of the base module for what constitutes an active route. Each polyline fades out over time until the route becomes inactive unless it is reinforced by another packet. The polyline automatically follows the movement of mobile nodes.

Usage diagram¶

Inheritance diagram¶

Used in compound modules¶

Name	Type	Description
NetworkRouteVisualizer	compound module	Integrates canvas and osg network route visualizers into a single module.
IntegratedMultiOsgVisualizer	compound module	Integrates all osg visualizers into a single module. It supports disabling any submodule visualizer by providing an empty string as its type.
IntegratedOsgVisualizer	compound module	Integrates all osg visualizers into a single module. It supports disabling any submodule visualizer by providing an empty string as its type.

Extends¶

Name	Type	Description
PathVisualizerBase	simple module	Base module for path visualizer simple modules. It keeps track of active routes in a network. A route between two nodes is considered active if a packet is sent recently between their corresponding layers. Active routes are not displayed by default, see the module parameters for how to enable the visualization. The actual visualization of active routes is done in derived modules.

Parameters¶

Name	Type	Default value	Description
displayStringTextFormat	string	“”	Determines the text that is written on top of the submodule, supports displaying pars, watches, and module-specific information
visualizationTargetModule	string	“^”	Module path relative to the visualizer which determines where the visualization should appear in the user interface, parent module by default
visualizationSubjectModule	string	“^”	Module path relative to the visualizer which determines what part of the simulation model the visualizer displays in the user interface, parent module by default
tags	string	“”	Tag added to each visualization for disambiguation in the runtime environment
displayRoutes	bool	false	Display polyline arrow for active routes, disabled by default
startPathSignal	string	“packetReceivedFromUpper”
extendPathSignal	string	“packetReceivedFromLower”
endPathSignal	string	“packetSentToUpper”
nodeFilter	string	“*”	Which nodes are considered, matches all nodes by default
packetFilter	object	“*”	Which packets are considered, matches all packets by default
lineColor	string	“dark”	Route color is a list of colors or a color group name (e.g. dark, light), a set of dark colors by default
lineStyle	string	“solid”	Route line style (solid, dashed, dotted)
lineWidth	double	3	Route line width
lineSmooth	bool	false	When true polylines are displayed as curves
lineShift	double	16	Route line shift to avoid overlapping routes
lineShiftMode	string	“normal”	Determines how overlapping lines are shifted, possible values are: normal, x, y, z; optional prefix + or -
lineContactSpacing	double	3	Spacing between arrow end and submodule icon
lineContactMode	string	“rectangular”	Determines how arrows are clipped at the submodules
labelFormat	string	“%n”	Determines what path data is displayed
labelFont	string	“<default>, 8px”	Label font, automatic by default
labelColor	string	“”	Label color, same as line by default
fadeOutMode	string	“realTime”	Specifies how inactive routes fade out
fadeOutTime	double	1s	How quickly inactive routes fade away, 1 second by default
fadeOutAnimationSpeed	double	0	Animation speed while there are active routes, value must be in the range (0, +inf)

Properties¶

Name	Value	Description
class	NetworkRouteOsgVisualizer
display	i=block/app

Source code¶

//
// Visualizes network routes on a 3D osg scene. It displays a
// polyline for each active route in the network. See the documentation of the
// base module for what constitutes an active route. Each polyline fades out
// over time until the route becomes inactive unless it is reinforced by another
// packet. The polyline automatically follows the movement of mobile nodes.
//
// @see ~NetworkRouteCanvasVisualizer, ~NetworkRouteVisualizer, ~PathVisualizerBase, ~INetworkRouteVisualizer
//
simple NetworkRouteOsgVisualizer extends PathVisualizerBase like INetworkRouteVisualizer
{
    parameters:
        @class(NetworkRouteOsgVisualizer);
}

File: src/inet/visualizer/osg/networklayer/NetworkRouteOsgVisualizer.ned