Changes

=== Running A SBR Frequency Sweep With SBR ===

You can also select the '''Frequency Sweep''' option in the '''Simulation Mode''' drop-down list of the '''Run Dialog'''. Click the '''Settings...''' button on the right side of this dropdown list to open up the Frequency Settings Dialog. Based on the original values of the project center frequency and bandwidth, the '''Start Frequency''' and '''End Frequency''' have default values. You can also change the '''Number of Samples'''. Once you click the '''Run''' button, [[EM.Cube|EM.CUBE]] performs a frequency sweep by assigning each of the frequency samples as the current operational frequency and running the SBR simulation engine at that frequency. All the simulation data at all frequency samples are saved into the output data files including "SBR_results.RTOUT". After the completion of a frequency sweep simulation, as many coverage maps as the number of frequency samples are generated and added to the Navigation Tree under the Receiver Set's entry. You can click on each of the coverage maps corresponding to each of the frequency samples and visualize it in the project workspace. You can also animate the coverage maps. To do so, right click on the receiver set's name in the Navigation Tree and select '''[[Animation]]''' from the contextual menu. The coverage maps start to animate by their order on the Navigation Tree. Once the entire list is displayed sequentially, it starts all over again from the beginning of the list. During the [[animation]], the '''[[Animation]] Controls''' dialog appears at the lower right corner of the screen. This dialog has a number of buttons for pause/resume, step forward/backward, and step to the end/start. The title of each coverage map is shown in the box labeled '''Sample''' as it is displayed in the main window. You can also change the speed of [[animation]]. The default frame duration has a value of 300 (3x100) milliseconds. To stop the [[animation]], simply press the keyboard's '''Esc Key'''. [[File:prop_run13.png]] [[File:prop_run14.png]] Multiple coverage maps on the Navigation Tree at the end of a frequency sweep and starting an [[animation]] from the contextual menu. [[File:prop_run15_tn.png]] [[Animation]] controls dialog in the project workspace.

In [[EM.Cube|EM.CUBE]], all the CAD object properties as well as certain source, material and mesh [[parameters]] can be assigned as [[variables]]. [[Variables]] are defined to control and vary the values of such [[parameters]] either for editing purposes or to run parametric sweep or [[optimization]]. Variable are defined using the '''[[Variables]] Dialog''', which can be accessed in the three ways: # By clicking the '''[[Variables]]''' [[File:variable_icon.png]] button of the '''Compute Toolbar'''.# By selecting '''Compute''' [[File:larrow_tn.png]] '''[[Variables]]...''' from the Menu Bar.# Using the keyboard shortcut '''Ctrl+B'''. The [[variables]] dialog is initially empty. To add a new variable, click the '''Add''' button to open up the '''Add Variable/Syntax Dialog'''. In this dialog you have to type in a name for the new variable and choose a type. The default type is '''Uniformly Spaced Samples'''. You also need to specify the '''Start''', '''Stop''' and '''Step''' values for the variable. In the figure below, a variable called "Tx_Height" is defined that varies between 2 and 10 with equal steps of 2. This means the sample set {2,4,6,8,10}. When you return to the [[variables]] dialog, the syntax of the new variable is shown as 2:10:2. The last number in this syntax is always the variable step. In this example, this variable is going to be used to control the height of the transmitter in a propagation scene. Next, you have to attach the variable to the CAD object. In this case, the CAD object is the point object that represents the transmitter's radiator. To attach a variable to a CAD object, open the object's property dialog and type in the name of the variable as the value of a property or parameter. In this case, the variable Tx_Height is going to control the Z-Coordinate of the point object. Once the value of the object parameter is replaced by the name of an already defined variable, it is updated with the current value of that variable. In the case of a variable of "Uniformly Spaced Samples" type, the current value is the start value. This value will be incrementally varied during a parametric sweep simulation process. Note that a variable can take a fixed value or a discrete set of values, too. You can always open the [[variables]] dialog and change the value or syntax of any variable. To make a new or modified value effective, click the '''Apply''' button of the [[variables]] dialog. You can test the values by performing a '''Dry Run''' of the selected variable. This runs an [[animation]] of the project workspace as the value of the variable changes and all the related CAD objects are updated accordingly. Note that you can attach the same variable to more than one CAD object property or to the properties of different objects. You can also define multiple values or syntaxes to the same variable. To do so, open the '''Add Variable/Syntax Dialog''', and instead of typing in a new variable name, choose an existing variable name from the '''Name''' dropdown list. This will add a new value or syntax to the existing syntax(es) of the selected variable. When you return to the [[variables]] dialog, [[variables]] with more than one value or syntax will have a dropdown list in the '''Syntax''' column. You can choose any of these values or syntaxed at any time and make the change effective by clicking the '''Apply''' button. [[File:prop_run25.png]] Replacing the value of a CAD object parameter with a variable name. To run a parametric sweep, open the '''Run Dialog''' and select the '''Parametric Sweep''' option in the '''Simulation Mode''' drop-down list. If you have not defined any [[variables]] in the project, the box in the '''[[Variables]]''' row before the '''View''' will be red. You have to turn it into green before you can run a simulation. By clicking the '''View''' button, you can open up the [[variables]] dialog from here. Once you click the '''Run''' button, [[EM.Cube|EM.CUBE]] performs a parametric sweep by incrementally varying the values of all the defined [[variables]] from their start to stop values at the specified steps and updating all the related CAD objects. After the completion of a parametric sweep simulation, as many coverage maps as the total number of variable samples are generated and added to the Navigation Tree under the receiver set's entry. You can click on each of the coverage maps and visualize it in the project workspace. You can also animate the coverage maps sequentially. To do so, right click on the receiver set's name in the Navigation Tree and select '''[[Animation]]''' from the contextual menu. To stop the [[animation]], simply press the keyboard's '''Esc Key'''. [[File:prop_run26.png]] Choosing parametric sweep as the simulation mode in the run dialog. Note that one variable has been defined and [[EM.Cube|EM.CUBE]] is ready to run the simulation. [[File:prop_run27_tn.png|800px]] The coverage map of the scene at the end of a parametric sweep where the sweep variable is the transmitter height.

[[EM.Cube|EM.CUBE]]Terrano's coverage maps display the received power at the location of all the receivers. The receivers together from a set/ensemble, which might be uniformly spaced or distributed across the propagation scene or may consist of randomly scattered radiators. Every coverage map shows the '''Mean''' and '''Standard Deviation''' of the received power for all the receivers involved. These information are displayed at the bottom of the coverage map's legend box and are expressed in dB.

In the [[Propagation Module]], when you ran a sweep simulation (frequency, transmitter or parametric), you also have the option to generate two additional coverage maps: one for the mean of all the individual sample coverage maps and another for their standard deviation. To do so, in the '''Run Dialog''', check the box labeled '''"Create Mean and Standard Deviation Coverage Maps"'''. Note that the mean and standard deviation values displayed on the individual coverage maps correspond to the spatial statistics of the receivers in the scene, while the mean and standard deviation coverage maps correspond to frequency, transmitter or variable sets defined for the sweep simulation. Also, note that both of the mean and standard deviation coverage maps have their own spatial mean and standard deviation values expressed in dB at the bottom of their legend box.