PhysicalLinkOsgVisualizer¶

Package: inet.visualizer.osg.physicallayer

simple module PhysicalLinkOsgVisualizer

Visualizes physical layer links on a 3D osg scene. It displays an arrow for each active link in the network. See the documentation of the base module for what constitutes an active link. The arrow points from the source towards the destination. If a link is used in both directions, then there are separate arrows for them. Each arrow fades out over time as the link becomes inactive unless it is reinforced by another packet. The arrow automatically follows the movement of mobile nodes.

Usage diagram¶

Inheritance diagram¶

Used in compound modules¶

Name	Type	Description
PhysicalLinkVisualizer	compound module	Integrates canvas and osg data link 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
PhysicalLinkVisualizerBase	simple module	Base module for physical layer link visualizer simple modules. It keeps track of active links in a network. A link between two network nodes is considered active if a packet is sent recently between their physical layers. Active links are not displayed by default, see the module parameters for how to enable the visualization. The actual visualization of active links 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
displayLinks	bool	false	Display arrows for active links, disabled by default
activityLevel	string	“service”	Determines what level of activity is displayed, service level by default
nodeFilter	string	“*”	Which nodes are considered, matches all nodes by default
interfaceFilter	string	“*”	Which interfaces are considered, matches all interfaces by default
packetFilter	object	“*”	Which packets are considered, matches all packets by default
lineColor	string	“olive”	Link arrow color, black by default
lineStyle	string	“dotted”	Link arrow style (solid, dashed, dotted)
lineWidth	double	3	Link arrow width
lineShift	double	16	Line shift to avoid overlapping arrows
lineShiftMode	string	“normal”	Determines how overlapping arrows are shifted, possible values are: none, 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 link data is displayed
labelFont	string	“<default>, 8px”	Label font, automatic by default
labelColor	string	“olive”	Label color, black by default
fadeOutMode	string	“realTime”	Specifies how inactive links fade out
fadeOutTime	double	1s	How quickly inactive links fade away, 1 second by default
fadeOutAnimationSpeed	double	0	Animation speed while there are active links, value must be in the range (0, +inf)
holdAnimationTime	double	0s	Hold simulation (no progress) for the specified amount of animation time when the link is activated

Properties¶

Name	Value	Description
class	PhysicalLinkOsgVisualizer
display	i=block/app

Source code¶

//
// Visualizes physical layer links on a 3D osg scene. It displays an
// arrow for each active link in the network. See the documentation of the base
// module for what constitutes an active link. The arrow points from the source
// towards the destination. If a link is used in both directions, then there are
// separate arrows for them. Each arrow fades out over time as the link becomes
// inactive unless it is reinforced by another packet. The arrow automatically
// follows the movement of mobile nodes.
//
// @see ~PhysicalLinkCanvasVisualizer, ~PhysicalLinkVisualizer, ~PhysicalLinkVisualizerBase, ~IPhysicalLinkVisualizer
//
simple PhysicalLinkOsgVisualizer extends PhysicalLinkVisualizerBase like IPhysicalLinkVisualizer
{
    parameters:
        @class(PhysicalLinkOsgVisualizer);
}

File: src/inet/visualizer/osg/physicallayer/PhysicalLinkOsgVisualizer.ned