StatisticVisualizerBase¶

simple module StatisticVisualizerBase

Base module for statistic visualizer simple modules. It keeps track of the last value of a statistic for multiple network nodes. The actual visualization of statistic values is done in derived modules. It subscribes for the signal determined by the signalName parameter at the module specified by the visualizationSubjectModule parameter. If the visualizer receives such a signal, it checks if the source matches the sourceFilter parameter. If the signal passes the check, it determines the last value of the statistic specified by the statisticName parameter.

The format string can contain the following directives:

%s: signal name
%n: statistic name
%v: statistic value
%u: statistic unit

Inheritance diagram¶

Known subclasses¶

Name	Type	Description
StatisticCanvasVisualizer	simple module	Visualizes statistics on a 2D canvas. See the base module for how to configure which statistic is displayed. If configured properly, then it displays the last value of the statistic to the right of the visualization of the corresponding network node. The value and the unit are wrapped in a filled white rectangle.
StatisticOsgVisualizer	simple module	Visualizes a statistic on a 3D osg scene. See the base module for how to configure which statistic is displayed. If configured properly, then it displays the last value of the statistic just above the visualization of the corresponding network node. The value and the unit are wrapped in a filled rectangle.

Extends¶

Name	Type	Description
VisualizerBase	simple module	Base module for visualizer simple modules. It simply provides the visualization target module for 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
networkNodeVisualizerModule	string	“^.networkNodeVisualizer”	The network node visualizer module, refers to a sibling submodule by default
displayStatistics	bool	false
signalName	string	“”	Signal name to subscribe, no signal name by default
statisticName	string	signalName	Statistic name to get the value, signal name by default
statisticUnit	string	“”	Statistic unit, undefined by default
statisticExpression	string	“”	Statistic expression, received value by default
sourceFilter	string	“**”	Pattern that must match the signal source, no source filter by default
format	string	“%n: %v %u”	Determines what is displayed, info by default
unit	string	“”	Display the value in one of the specified units, statistic unit by default
font	string	“<default>”	Statistic value font, automatic by default
textColor	string	“black”	Statistic value font color, black by default
backgroundColor	string	“white”	Statistic value background color, white by default
opacity	double	1.0	Opacity of the visualization
placementHint	string	“top”	Annotation placement hint, space separated list of any, top, bottom, left, right, topLeft, topCenter, topRight, etc.
placementPriority	double	0	Determines the order of annotation positioning

Properties¶

Name	Value	Description
class	StatisticVisualizerBase
display	i=block/app

Source code¶

//
// Base module for statistic visualizer simple modules. It keeps track
// of the last value of a statistic for multiple network nodes. The actual
// visualization of statistic values is done in derived modules. It subscribes
// for the signal determined by the `signalName` parameter at the module specified
// by the `visualizationSubjectModule` parameter. If the visualizer receives such a signal,
// it checks if the source matches the `sourceFilter` parameter. If the signal
// passes the check, it determines the last value of the statistic specified by
// the `statisticName` parameter.
//
// The format string can contain the following directives:
//  - %s: signal name
//  - %n: statistic name
//  - %v: statistic value
//  - %u: statistic unit
//
// @see ~StatisticCanvasVisualizer, ~StatisticOsgVisualizer, ~IStatisticVisualizer, ~VisualizerBase
//
simple StatisticVisualizerBase extends VisualizerBase
{
    parameters:
        string networkNodeVisualizerModule = default("^.networkNodeVisualizer"); // The network node visualizer module, refers to a sibling submodule by default

        bool displayStatistics = default(false);

        string signalName = default(""); // Signal name to subscribe, no signal name by default
        string statisticName = default(signalName); // Statistic name to get the value, signal name by default
        string statisticUnit = default(""); // Statistic unit, undefined by default
        string statisticExpression = default(""); // Statistic expression, received value by default
        string sourceFilter @mutable = default("**"); // Pattern that must match the signal source, no source filter by default

        string format @mutable = default("%n: %v %u"); // Determines what is displayed, info by default
        string unit = default(""); // Display the value in one of the specified units, statistic unit by default

        string font = default("<default>"); // Statistic value font, automatic by default
        string textColor = default("black"); // Statistic value font color, black by default
        string backgroundColor = default("white"); // Statistic value background color, white by default
        double opacity = default(1.0); // Opacity of the visualization
        string placementHint = default("top"); // Annotation placement hint, space separated list of any, top, bottom, left, right, topLeft, topCenter, topRight, etc.
        double placementPriority = default(0); // Determines the order of annotation positioning

        @class(StatisticVisualizerBase);
}

File: src/inet/visualizer/base/StatisticVisualizerBase.ned