Wireless Domain Object

Wireless domain objects define an area within which the results of certain pipeline stage calculations can be cached and reused for transmitters and receivers in that area. The calculations typically cached are channel match, closure, propagation delay, and path loss.

Wireless domain objects are instances of wireless domain models. The default representation of a wireless domain differs in the object palette and workspace, as shown in the following figure.

Figure 61: Default Wireless Domain Icons

Default Wireless Domain Icons

For more information about wireless domains, refer to “Wireless Domains” on page 11.

Wireless Domain Object Attributes

The built-in attributes of the wireless domain object are listed below, in alphabetical order.

Table 21: Wireless Domain Object Built-In Attributes

Name Editing Data Type
chanmatch model typed file
closure model typed file
creation data string
creation source string
creation timestamp date
doc file string
icon name icon
model typed file
name string
outline color color
propdel model typed file
tooltip string
x position double
x span double
y position double
y span double

chanmatch model

This attribute specifies the name of a compiled pipeline procedure to be used for the channel match pipeline stage of channels assigned to this wireless domain object. If NONE, the normal model is used (that is, the model specified by the “chanmatch model” attribute of the corresponding transmitter).

Refer to Chapter 10 “Radio Transceiver Pipeline” on page 263 for more information about this pipeline stage.

Editing Simulation
Data Type typed file string
Access read / write read
Default Value “NONE”
Units
Constraints

closure model

This attribute specifies the name of a compiled pipeline procedure to be used for the closure pipeline stage of channels assigned to this wireless domain object. If NONE, the normal model is used (that is, the model specified by the “closure model” attribute of the corresponding transmitter).

Refer to Chapter 10 “Radio Transceiver Pipeline” on page 263 for more information about this pipeline stage.

Editing Simulation
Data Type typed file string
Access read / write read
Default Value “NONE”
Units
Constraints

creation data

This attribute specifies additional information about the creation of the object.

Editing Simulation
Data Type string not applicable
Access read/write not applicable
Default Value “”
Units
Constraints

creation source

This attribute specifies how the object was created.

Editing Simulation
Data Type string not applicable
Access read/write not applicable
Default Value “Object Palette”
Units
Constraints

creation timestamp

This attribute specifies when the object was created.

Editing Simulation
Data Type date not applicable
Access read/write not applicable
Default Value
Units
Constraints

doc file

This attribute specifies the name of the documentation file (help card) that is displayed when a user invokes help for this object via the Help > What’s This menu item. The value of this attribute has no impact on simulation behavior.

Editing Simulation
Data Type string N/A
Access read / write N/A
Default Value wdomain
Units
Constraints

icon name

This attribute specifies the bitmap used to represent the wireless domain in the object palette. (In the Project Editor workspace, wireless domains are represented by an outline representing their extent.) The value of this attribute has no impact on simulation behavior.

Editing Simulation
Data Type icon N/A
Access read / write N/A
Default Value wdomain
Units
Constraints

model

This attribute specifies the name of a wireless domain model developed with the Wireless Domain Editor. The wireless domain model represents the organization and behavior of the wireless domain.

Editing Simulation
Data Type typed file string
Access read / write read
Default Value
Units
Constraints

name

This attribute specifies a string used for identification purposes. It is useful for identifying a wireless domain in the workspace. It is also used during simulation to obtain the node’s object ID, via the KP op_id_from_name(). The object ID, in turn, is useful for obtaining attribute values. The Simulation Kernel makes no use of this attribute.

Editing Simulation
Data Type string string
Access read / write read
Default Value wdomain_n, n >= 0
Units
Constraints unique name, no dots, not “top”

outline color

This attribute specifies the color of the wireless domain when drawn in the Project Editor. This attribute has no effect on simulation. The outline color attribute can have values ranging from RGB000 to RGB333, where each digit is an integer between 0 and 3 inclusive. The higher the first digit, the more red; the higher the second digit, the more green; and the higher the third digit, the more blue. Thus RGB000 corresponds to black, RGB333 corresponds to white, RGB300 corresponds to red, and so on.

Editing Simulation
Data Type color N/A
Access read / write N/A
Default Value RGB003
Units
Constraints See description

propdel model

This attribute specifies the name of a compiled pipeline procedure to be used for the propagation delay pipeline stage of channels assigned to this wireless domain object. If NONE, the normal model is used (that is, the model specified by the “propdel model” attribute of the corresponding transmitter).

Refer to Chapter 10 “Radio Transceiver Pipeline” on page 263 for more information about this pipeline stage.

Editing Simulation
Data Type typed file string
Access read / write read
Default Value “NONE”
Units
Constraints

tooltip

This attribute specifies the tooltip text that is displayed when a user holds the cursor over the wireless domain object. The value of this attribute has no impact on simulation behavior.

Editing Simulation
Data Type string N/A
Access read / write N/A
Default Value “Wireless Domain”
Units
Constraints

x position

This attribute specifies the x-coordinate of the center of the wireless domain extent. Its value is specified in degrees and corresponds to the longitude of the center point. A positive value refers to degrees East longitude and a negative value refers to degrees West longitude.

Editing Simulation
Data Type double double
Access read / write read
Default Value N/A
Units degrees
Constraints

x span

This attribute specifies the width of the wireless domain. The value represents a total extent about the horizontal center (as given by the x position attribute). Its value is specified in degrees. For example, if a wireless domain has an x span of 2 degrees and a y span of 3 degrees centered on point (a,b), objects within that wireless domain can have positions between (a-1, b-1.5) and (a+1, b+1.5).

Editing Simulation
Data Type double double
Access read / write read
Default Value N/A
Units degrees
Constraints >= 0.0

y position

This attribute specifies the y-coordinate of the center of the wireless domain extent. Its value is specified in degrees and corresponds to the latitude of the center point. A positive value refers to degrees North latitude and a negative value refers to degrees South latitude.

Editing Simulation
Data Type double double
Access read / write read
Default Value N/A
Units degrees
Constraints

y span

This attribute specifies the length of the wireless domain. The value represents a total extent about the vertical center (as given by the y position attribute). Its value is specified in degrees. For example, if a wireless domain has an x span of 2 degrees and a y span of 3 degrees centered on point (a,b), objects within that wireless domain can have positions between (a-1, b-1.5) and (a+1, b+1.5)

Editing Simulation
Data Type double double
Access read / write read
Default Value N/A
Units degrees
Constraints >= 0.0

本站文档由 北京智网畅联科技有限公司 整理、翻译并提供 · Documentation compiled and provided by Beijing ZNetLink Technology Co., Ltd.

交流群 · QQ Group:OPNET/智网妙算网络仿真交流群(群号 486383494)

原文档 © 2017 Riverbed Technology · 本站为公益翻译,由 AI 辅助完成,请仔细甄别

Original documentation © 2017 Riverbed Technology. Community translation, AI-assisted. Contact: jiazequn@znetlink.com