RadioVisualizerBase

Package: inet.visualizer.base

simple module RadioVisualizerBase

Base module for radio visualizer simple modules.

See also: RadioCanvasVisualizer, RadioOsgVisualizer, IRadioVisualizer, VisualizerBase

inet.visualizer.base.RadioVisualizerBaseRadioVisualizerBasesimple

Inheritance diagram

Known subclasses

Name

Type

Description

RadioCanvasVisualizer

simple module

Visualizes radios on a 2D canvas.

RadioOsgVisualizer

simple module

Visualizes radios on a 3D osg scene.

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”

Module path to the network node visualizer module, refers to a sibling submodule by default

displayRadios

bool

false

displayRadioMode

bool

true

displayReceptionState

bool

true

displayTransmissionState

bool

true

displayAntennaLobes

bool

false

radioFilter

string

“**”

Which radios are considered, matches all radios by default

radioModeImages

string

“block/process_vs block/timer_vs block/wrx_vs block/wtx_vs block/wrxtx_vs block/cogwheel_vs”

receptionStateImages

string

“- - misc/receiving misc/receiving”

transmissionStateImages

string

“- - misc/transmitting”

width

double

16

height

double

16

placementHint

string

“bottomRight”

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

antennaLobeNormalize

bool

false

True means maximum gain, false means 0dB is displayed at the given antennaLobeRadius

antennaLobeRelativeLabels

bool

false

Determines whether gain labels are relative or absolute (if true, maximum gain label is 0dB)

antennaLobePlaneGlobal

bool

true

Compute antenna lobe relative to the global or antenna local coordinate systems, global by default

antennaLobePlane

string

“view”

Compute antenna lobe in this plane, view by default

antennaLobeMode

string

“logarithmic”

antennaLobeLogarithmicBase

double

10

antennaLobeLogarithmicScale

double

100

Distance change in pixels for 10dB

antennaLobeRadius

double

100

Distance in pixels for 0dB (1 gain) or maximum gain depending on antennaLobeNormalize parameter

antennaLobeStep

double

10deg

antennaLobeOpacity

double

0.25

Opacity of the antenna lobe

antennaLobeLineSmooth

bool

true

antennaLobeLineColor

string

“black”

Antenna lobe line color, black by default

antennaLobeLineStyle

string

“solid”

Antenna lobe line style (solid, dashed, dotted)

antennaLobeLineWidth

double

1

Antenna lobe line width

antennaLobeFillColor

string

“white”

Antenna lobe fill color, white by default

Properties

Name

Value

Description

class

RadioVisualizerBase

display

i=block/app

Source code

//
// Base module for radio visualizer simple modules.
//
// @see ~RadioCanvasVisualizer, ~RadioOsgVisualizer, ~IRadioVisualizer, ~VisualizerBase
//
simple RadioVisualizerBase extends VisualizerBase
{
    parameters:
        string networkNodeVisualizerModule = default("^.networkNodeVisualizer"); // Module path to the network node visualizer module, refers to a sibling submodule by default

        bool displayRadios = default(false);
        bool displayRadioMode = default(true);
        bool displayReceptionState = default(true);
        bool displayTransmissionState = default(true);
        bool displayAntennaLobes = default(false);

        string radioFilter @mutable = default("**"); // Which radios are considered, matches all radios by default

        string radioModeImages = default("block/process_vs block/timer_vs block/wrx_vs block/wtx_vs block/wrxtx_vs block/cogwheel_vs");
        string receptionStateImages = default("- - misc/receiving misc/receiving");
        string transmissionStateImages = default("- - misc/transmitting");
        double width = default(16);
        double height = default(16);
        string placementHint = default("bottomRight"); // 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

        bool antennaLobeNormalize = default(false); // True means maximum gain, false means 0dB is displayed at the given antennaLobeRadius
        bool antennaLobeRelativeLabels = default(false); // Determines whether gain labels are relative or absolute (if true, maximum gain label is 0dB)
        bool antennaLobePlaneGlobal = default(true); // Compute antenna lobe relative to the global or antenna local coordinate systems, global by default
        string antennaLobePlane @enum("view", "xy", "xz", "yz") = default("view"); // Compute antenna lobe in this plane, view by default
        string antennaLobeMode @enum("logarithmic", "linear") = default("logarithmic");
        double antennaLobeLogarithmicBase = default(10);
        double antennaLobeLogarithmicScale = default(100); // Distance change in pixels for 10dB
        double antennaLobeRadius = default(100); // Distance in pixels for 0dB (1 gain) or maximum gain depending on antennaLobeNormalize parameter
        double antennaLobeStep @unit(deg) = default(10deg);
        double antennaLobeOpacity = default(0.25); // Opacity of the antenna lobe
        bool antennaLobeLineSmooth = default(true);
        string antennaLobeLineColor = default("black"); // Antenna lobe line color, black by default
        string antennaLobeLineStyle = default("solid"); // Antenna lobe line style (solid, dashed, dotted)
        double antennaLobeLineWidth = default(1); // Antenna lobe line width
        string antennaLobeFillColor = default("white"); // Antenna lobe fill color, white by default

        @class(RadioVisualizerBase);
}

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