Wireless Functionality Preferences
The Wireless functionality adds preferences to Modeler and op_runsim to configure the wireless modeling environment.
modeler Preferences
The following preferences are added to the modeler program.
antenna.spherical_model
Specifies which Greek letters are used to represent polar and azimuth angles. In the mathematical representation, the polar angle is named “phi” and the azimuth angle is “theta”. The convention in physics (EM) is reversed: polar is “theta” and azimuth is “phi”.
Note: This preference affects only how angles are named in the GUI and ODB; it has no effect on calculations.
- Data Type: enum
- Default Value: Mathematical
- Constraints: Mathematical, EM
antenna.show_3d_viewer_on_open
When TRUE, specifies that a 3D pattern viewer should be displayed when a new Antenna Pattern Editor is opened.
- Data Type: boolean
- Default Value: TRUE
antenna.show_radial_viewer_on_open
When TRUE, specifies that a radial pattern viewer (showing polar plots) should be displayed when a new Antenna Pattern Editor is opened.
- Data Type: boolean
- Default Value: FALSE
network_palette.mobile_subnet_icon
Specifies the icon used for mobile subnet objects. This icon must reside in one of the standard icon databases. If this attribute is an empty string, the mobile subnet object will not appear in the Object Palette.
- Data Type: string list
- Default Value: subnet (mobile)
- Constraints: see description
network_palette.satellite_subnet_icon
Specifies the icon used for satellite subnet objects. This icon must reside in one of the standard icon databases. If this attribute is an empty string, the satellite subnet object will not appear in the Object Palette.
- Data Type: string list
- Default Value: subnet (satellite)
- Constraints: see description
node_editor.physical.axis_color
Specifies the default color used to display axis lines in the Node Editor’s physical layout pane.
- Data Type: Color
- Default Value: blue
node_editor.physical.axis_style
Specifies the default line style for axis lines in the Node Editor’s physical layout pane.
- Data Type: enum
- Default Value: solid
- Constraints: solid, dashed, none
node_editor.physical.grid_color
Specifies the default color used to display grid lines in the Node Editor’s physical layout pane.
- Data Type: Color
- Default Value: black
node_editor.physical.grid_step
Specifies the default distance (in meters) between grid lines in the Node Editor’s physical layout pane. A zero or negative value means that the distance should be autocomputed.
- Data Type: double
- Default Value: 0.0
node_editor.physical.grid_style
Specifies the default line style for grid lines in the Node Editor’s physical layout pane.
- Data Type: enum
- Default Value: dashed
- Constraints: solid, dashed, none
node_editor.physical.initial_width
Specifies the initial width of the physical layout pane when a Node Editor is opened. A value of 0 means that the Node Editor will open with the physical layout pane collapsed.
- Data Type: integer
- Default Value: 0
node_editor.physical.target_color
Specifies the default color used to display lines between antenna modules and targets in the Node Editor’s physical layout pane.
- Data Type: Color
- Default Value: red
node_editor.physical.target_style
Specifies the default line style used to display lines between antenna modules and targets in the Node Editor’s physical layout pane.
- Data Type: enum
- Default Value: dashed
- Constraints: solid, dashed, none
node_editor.physical.show_xy_over_xz
Specifies whether the x-y (azimuth) projection should be displayed above or below the x-z (polar) projection in the Node Editor’s physical layout pane. When TRUE, the x-y projection is above.
Changes to this preference take effect when the application is restarted.
- Data Type: boolean
- Default Value: TRUE
parallel_sim.num_processors
Specifies the number of processors to use during simulation execution, assuming a multiprocessor computer. If the number of processors is set to 0, the application uses as many processors as are available.
- Data Type: integer
- Default Value: 1
- Units: none
- Constraints: none
op_runsim Preferences
The following preferences are added to the op_runsim program.
default_site_position_cache_time_granularity
Specifies a default time window within which the position of a mobile site is assumed to be unchanged and will not be recalculated. This value is the initial value assigned to the “position cache time granularity” attribute of each mobile site in a simulation. See “Reducing the Number of Position Calculations” on page 13 for more details.
This preference can be set from the op_runsim command line or from the Execution > Advanced > Kernel Preferences page of the Configure/Run DES dialog box.
- Data Type: double
- Default Value: 0.0
- Units: seconds
- Constraints: none
parallel_sim.num_processors
Specifies the number of processors to use during simulation execution, assuming a multiprocessor computer. If the number of processors is set to 0, the application uses as many processors as are available.
- Data Type: integer
- Default Value: 1
- Units: none
- Constraints: none
parallel_sim.rank_mutex_ignore
Specifies whether or not the ranks of mutexes are ignored during simulation execution.
- Data Type: boolean
- Default Value: FALSE
radio_transmission_defer_packet_duplication
Specifies whether to postpone duplication of packets until after the closure pipeline stage is passed and the channel match pipeline stage has determined that a match exists for each potential receiver. This makes a wireless simulation more efficient by duplicating only those packets that will be sent to receivers. When FALSE, packets are duplicated after the transmission delay pipeline stage.
Note: Deferred packet duplication is disabled when 3DNV is being used.
This preference can be used only in sequential simulations, and the split_start_radio_transmission preference must be set to FALSE.
- Type: boolean
- Default Value: TRUE
split_start_radio_transmission
Specifies whether to split the start of a radio transmission into separate events for each potential receiver. This is used to obtain parallel processing of packets in wireless simulations. See “Parallel Simulation” on page 67 for details.
- Type: boolean
- Default Value: FALSE for sequential kernels; TRUE for parallel kernels