Changes

{{Note|We strongly recommend that you read through the first few tutorials and study them carefully before setting up your own projects.}}
 
[[Image:Back_icon.png|30px]] '''[[EM.Libera | Back to EM.Libera Manual]]'''
 
[[Image:Back_icon.png|30px]] '''[[EM.Cube#EM.Libera_Documentation | Back to EM.Libera Tutorial Gateway]]'''
 
[[Image:Download2x.png|30px]] '''[http://www.emagtech.com/downloads/ProjectRepo/EMLibera_Lesson1.zip Download projects related to this tutorial lesson]'''
== Getting Started ==
Open the [[EM.Cube]] application by double-clicking on its icon on your desktop. By default, [[EM.Cube]] opens a blank project with the name “UntitledProj1” “UntitledProj0” in its [[Building_Geometrical_Constructions_in_CubeCAD | CubeCAD]] Module. You can start drawing objects and build up your physical structure right away. Or you can initiate a new project by selecting the <b>New</b> [[Image:fdtd_newb.png]] button of the System Toolbar or using the keyboard shortcut {{key|Ctrl+N}}. This opens up the '''New Project Dialog''', where you can enter a title for your new project and set its path on your hard drive. From the same dialog, you can also set the project’s length units, frequency units, center frequency and bandwidth.
<table>
== Constructing the Wire Dipole Antenna Geometry ==
Click on the <b>Wire Dipole Wizard</b> [[Image:WireDipoleIconx.png]] button of the Wizard Toolbar or select the menu item '''Tools &rarr; Antenna Wizards &rarr; Wire Dipole Antenna'''.
<table>
<table>
<tr>
<td> [[Image:Libera_L1_Fig5a.png|thumb|left|480px|Viewing the properties of the group "WIRE_DIPOLE".]] </td>
</tr>
<tr>
<td> [[Image:Libera L1 Fig5.png|thumb|left|480px|The thin wire dialog.]] </td>
</table>
The wizard also initiated a far-field radiation pattern observable. Right-click on the item "FF_1" under '''Far-Field Radiation Patterns''' in the navigation tree and select '''Properties...''' from the contextual menu. The Radiation Pattern dialog opens up. The values of the "Angle IncrementIncrements (deg)" parameter for both Theta and Phi has have been set equal to 1&deg;.
<table>
<tr>
<td>
[[Image:Libera L1 Fig10.png|thumb|left|480px720px|The far-field radiation pattern dialog.]]
</td>
</tr>
== Examining the Mesh of the Wire Structure ==
The quality of the simulation results in a method of moments (MoM) simulation greatly depends on the quality and resolution of its mesh. The mesh of a line object consists of a number of linear cells along its length. The resolution of [[EM.Libera]]'s mesh is controlled by a parameter called <b>Mesh Density</b>, which has a default value of 120 10 Cells/&lambda;<sub>eff</sub>. For resonant structures, a higher mesh density is recommended. A low mesh density may fail to provide an adequate level of numerical accuracy. Extremely high mesh densities, on the other hand, may lead to numerical instability.
The mesh properties can be accessed by clicking the <b>Mesh Settings</b> [[Image:fdtd_meshsettings.png]] button of the Simulate Toolbar or using the keyboard shortcut {{key|Ctrl+G}} or via the menu item <b>Simulate &rarr; Discretization &rarr; Mesh Settings</b>. Since a wire dipole antenna is a resonant structure, the wizard automatically set the value of mesh density to 30 Cells/&lambda;<sub>eff</sub>.
</table>
To view the mesh, click the <b>Show/Generate Mesh</b> [[Image:fdtd_meshshow.png]] button of the Simulate Toolbar or alternatively use the keyboard shortcut {{key|Ctrl+M}}. To exit the mesh view mode and return to the normal view mode, use the keyboard’s {{key|Esc}} key or click the <b>Show/Generate Mesh</b> [[Image:fdtd_meshshow.png]] button of the Simulate Toolbar one more time.
== A Note on EM.Libera's Simulation Engines ==
Z11: 79.712742 +42.738593j
 
<table>
<tr>
<td>
[[Image:Libera_L1_FigValues.png|thumb|left|600px|The calculated S, Z and Y parameters in the output window.]]
</td>
</tr>
</table>
== Visualizing the Simulation Results ==
Once the simulation is completed, the navigation tree is populated with simulation results under the current distributions and radiation patterns nodes. [[EM.Cube]]’s computational modules usually generate two types of data: 2D and 3D. Examples of 2D data are Cartesian and polar radiation patterns. 2D data are graphed in <b>EM.Grid</b>. Examples of 3D data are near-field and current distributions and 3D radiation patterns. 3D data are visualized in [[EM.Cube]]’s project workspace, and the plots are usually overlaid on the physical structure.
First, you will visualize the current distribution on the dipole antenna. The "Current Distribution" section of the navigation tree plots both electric currents (J) and magnetic currents (M). Each current distribution observable contains a list of twelve amplitude and phase plots for all the six current components: J<sub>x</sub>, J<sub>y</sub>, J<sub>z</sub>, and M<sub>x</sub>, M<sub>y</sub>, M<sub>z</sub>. There are also two additional plots for the magnitude of total electric current and total magnetic current. In the case of your project, since you have only a metal wire, <b>M</b> = 0. From the figure below, you can see the familiar sinusoidal current distribution on the wire with its peak at the center and zero current at the two ends.
<tr>
<td>
[[Image:Libera L1 Fig15Libera_L1_Fig15_new.png|thumb|left|720px|The total current distribution on the wire dipole.]]
</td>
</tr>
</table>
Next, visualize the 3D radiation pattern of the dipole antenna. You will see the familiar donut shape with a directivity of 1.64643.
<table>
</table>
A list of all the 2D output data files generated at the end of a simulation can be viewed in [[EM.PicassoLibera]]’s Data Manager. To open this dialog, click the <b>Data Manager</b> [[Image:fdtd_datamanagerb.png]] button of Simulate Toolbar, or use the keyboard shortcut {{key|Ctrl+D}}, or access the menu item <b>Simulate &rarr; Data Manager</b>, or right-click on the Data Manager item in the “Observables” section of the navigation tree and select <b>Open Data Manager…</b> The S/Z/Y parameters are written into complex data files with a “.CPX” file extension. These ASCII data files are called “S11.CPX”, “Z11.CPX” and “Y11.CPX”, respectively. You can view the contents of the these files using the {{key|View}} button of data manager.
<table>
</table>
Besides the 3D visualization of the radiation patterns, you can plot 2D graphs of the patterns at certain plane cuts. The 2D radiation patterns can be plotted as both Cartesian and polar graphs. In the data manager dialog, spot Cartesian pattern data files with a “.DAT” file extension as well as the polar (angular) data files with a “.ANG” file extension. The figure below shows the Cartesian and polar radiation pattern plots in the YZ plane cut. These are the data files called "FF_1_PATTERN_Cart_YZ.DAT" and "FF_1_PATTERN_Polar_YZ.ANG", respectively. To plot them, select their name or row in the Data Manager's list and highlight them and then click the {{key|Plot}} button. Note that you can make multiple file selections for plotting using the {{key|Ctrl}} or {{key|Shift}} keys. Besides the three principal XY, YZ and ZX plane cuts, there are also data files for one additional user defined Phi-plane cut, which by default is calculated at &phi; = 45°.
<table>
|}
To change the definition of a variable, select and highlight its name in the variables list and click the {{key|Edit}} button of the dialog to open the "Edit Variable" dialog. In this dialog, replace the definition of the selected variable with a numeric value or any other expression. Click on the {{key|OK}} button to accept the changes.
<table>
<tr>
<td> [[Image:Libera_L1_Fig22a.png|thumb|left|550px|The variables dialog.]] </td>
</tr>
<tr>
<td> [[Image:Libera L1 Fig22.png|thumb|left|480px|Changing the definition of variable "dipole_len".]] </td>
</table>
Close this dialog to return to the run dialog and click the {{key|Run}} key to start the frequency sweep. After the completion of the sweep simulation, open the data manager and plot the data files "S11_Sweep.CPX" and "Z11_Sweep_CPX" in EM.Grid.
<table>
</table>
With [[EM.Libera]], you can also perform an adaptive frequency sweep of your physical structure. This sweep starts with a few frequency samples in the beginning and then inserts more frequency samples in between and uses a rational function interpolation to achieve a smooth frequency response. Open the frequency sweep settings dialog again and this time choose the radio button '''Adaptive''' for the sweep type. Accept the default values of the adaptive sweep parameters and run and new adaptive frequency sweep simulation of your planar structure. The program may give a warning that during the adaptive sweep, current distribution and far-field radiation pattern data will not be produced. Ignore the warning and continue. Also, after a number of sweep iterations, the program may pop up a message saying the convergence criterion hasn't been met and will ask you whether to continue the sweep process. <u>In that case, reply "No" and stop the sweep</u>. Too many adaptive sweep iterations may sometime lead to spurious spikes in the frequency response.
<table>
</table>
<table><tr><td> [[Image:Libera_L1_FigConv.png|thumb|left|480px|The convergence criterion message window.]] </td></tr></table> At the end of the sweep simulation, open the data manager and plot the data files "S11_RationalFit.CPX" and "Z11_RationalFit.CPX" in EM.Grid. From the figures below you can see that the dipole antenna's return loss |S11| reaches a minimum of -31.3dB at 957MHz. Also, the imaginary part of the input impedance of the dipole antenna Im(Z11) vanishes at about 955MHz, where its real part (input resistance) is about 71&Omega; at this frequency. In other words, the dipole antenna resonates at about 955MHz.
<table>
<p>&nbsp;</p>
[[Image:Top_icon.png|30px]] '''[[#What_You_Will_Learn | Back to the Top of the Page]]''' [[Image:Back_icon.png|40px30px]] '''[[EM.Cube#EM.Libera_Tutorial_Lessons Libera_Documentation | Back to EM.Libera Tutorial Gateway]]'''
4,612
edits