Glossary of EM.Cube's Simulation Observables & Graph Types
Contents
- 1 3D Cartesian Data Observable
- 2 Bar Chart
- 3 Cartesian Graph
- 4 Colorgrid Plot
- 5 Complex Data Graph
- 6 Contour Plot
- 7 Current Distribution Observable
- 8 Custom Output Parameters
- 9 Energy-Power Observable
- 10 Far-Field Radiation Pattern Observable
- 11 Huygens Surface Observable
- 12 Near-Field Sensor Observable
- 13 Periodic Characteristics
- 14 Point Receiver Set
- 15 Polar Graph
- 16 Polar Stem Chart
- 17 Port Definition Observable
- 18 Radar Cross Section (RCS) Observable
- 19 Smith Chart
- 20 Spherical Data Plot
- 21 Standard Output Data
- 22 Static Field Integral Observable
- 23 Surface Plot
- 24 Temporal Field Probe Observable
3D Cartesian Data Observable
MODULE: CubeCAD, EM.Tempo, EM.Ferma
FUNCTION: Used to import a 3D Cartesian spatial data file with a ".CAR" file extension and visualize its content overlaid on the project workspace
TO DEFINE A 3D CARTESIAN DATA:
- Right-click on the Cartesian Data item in the navigation tree.
- Select Insert New Observable... to open up the Cartesian Data Visualization Dialog.
- Accept the default settings or modify them. You can select the visualization type from two options: Cube (Intensity) and Vector.
- Click the OK button of this dialog to open up the standard Windows Open dialog. The file type is set to .CAR. Browse your folders to select the .CAR file you want to import.
- After importing the Cartesian data file, new items are added under the observable's name in the navigation tree.
PYTHON COMMAND: cartesian_data(file_name,vis_type)
CARTESIAN DATA PARAMETERS:
Parameter Name | Value Type | Units | Default Value | Notes |
---|---|---|---|---|
max_size | real numeric | project units | 2 | orientation of field sensor plane |
cone_length_ratio | real numeric | project units | 0.5 | ratio of the vector's cone height to the total arrow length |
cone_radius_ratio | real numeric | project units | 0.25 | ratio of the vector's cone radius to the total arrow length |
CARTESIAN DATA OUTPUT DATA FILES
Data File Name | Data Type | Description | Notes & Restrictions |
---|---|---|---|
FileName.CAR | 3D real or complex, scalar or vector data | generic spatial data | CubeCAD, EM.Tempo & EM.Ferma |
Bar Chart
ICON: None
MODULE: EM.Terrano
FUNCTION: Displays the values of a dependent variable as vertical bars of proportional heights versus a discrete set of values of an independent variable
TO PLOT A BAR CHART:
- The delay profile of the rays received by a specified receiver can be plotted on a bar chart.
- Open EM.Terrano's Data Manager, select a delay profile data file with name similar to "SBR_ReceiverSet_1_DELAY.DAT", and click the Plot button.
PYTHON COMMAND(S): None
Cartesian Graph
ICON: None
MODULE: EM.Tempo, EM.Terrano, EM.Illumina, EM.Ferma, EM.Picasso, EM.Libera
FUNCTION: Displays the variation of a real-valued scalar data set
TO PLOT A CARTESIAN GRAPH:
- Select one or more data files with a .DAT file extension in the Data Manager and click the Plot button.
- Cartesian data are plotted in linear scale by default. You can change the scale to dB-Field or dB-Power. To do so, while the data file is selected in the Data Manager, click the Graph Settings button. In the graph settings dialog, choose the one of the Linear, dB_Field or dB_Power options from the drop-down list labeled Data Format. Close the graph settings dialog and return to the data manager. Plot the selected data file once again.
- Alternatively, you can define two NumPy vectors X and Y in the Python Interpreter and use the emag_plot_cartesian(...) function.
- Or you can define a NumPy matrix or load it into the Python Interpreter and use the emag_plot_multi(...) function.
PYTHON COMMAND(S): emag_plot_dat(file_name,auto_scale=True,title="",xlabel="Default",ylabel="Default",FRColor=(1,1,1),BKColor=(1,1,1),PLColor=(1,0,0),linewidth=1,linestyle="solid",marker="None",margins=(0.15,0.1,0.1,0.1,0.2,0.2,0.8,0.9,0.5,0.5),show_major_grid=True,show_minor_grid=False,MAJColor=(0.25,0.25,0.25),MINColor=(0.5,0.5,0.5),major_grid_linewidth=1,minor_grid_linewidth=1,major_grid_linestyle="dotted",minor_grid_linestyle="dotted",axis_param=(0,0,5,5,0,0,5,5),show_legend=True,legend_label1="Default",legend_label2="Default",show_textbox=False,annot_text="",font_size=10,TXColor=(0,0,0),*args,**kwargs)
emag_plot_two_dat(file_name1,file_name2,auto_scale=True,title="",xlabel="Default",ylabel="Default",FRColor=(1,1,1),BKColor=(1,1,1),PLColor1=(1,0,0),linewidth1=1,linestyle1="solid",marker1="None",PLColor2=(1,0,0),linewidth2=1,linestyle2="solid",marker2="None",margins=(0.15,0.1,0.1,0.1,0.2,0.2,0.8,0.9,0.5,0.5),show_major_grid=True,show_minor_grid=False,MAJColor=(0.25,0.25,0.25),MINColor=(0.5,0.5,0.5),major_grid_linewidth=1,minor_grid_linewidth=1,major_grid_linestyle="dotted",minor_grid_linestyle="dotted",axis_param=(0,0,5,5,0,0,5,5),show_legend=True,legend_label1="Default",legend_label2="Default",show_textbox=False,annot_text="",font_size=10,TXColor=(0,0,0),*args,**kwargs)
emag_plot_cartesian(x,y,title="New Graph",x_label="x",y_label="y",*args,**kwargs)
emag_plot_multi(a_matrix,x_col,y_col_list,title="New Graph",x_label="x",y_label="cols",*args,**kwargs)
Colorgrid Plot
ICON: None
MODULE: EM.Tempo, EM.Terrano, EM.Illumina, EM.Ferma, EM.Picasso, EM.Libera
FUNCTION: Displays the color-coded intensity plot of a Cartesian spatial data set of the form z = f(x,y) on a specified principal plane
TO PLOT A CARTESIAN GRAPH:
- You can visualize 3D Cartesian data, receiver power coverage maps or electric and magnetic field distributions as colorgrid plots.
- Select a 3D Cartesian data file with a .CAR file extension or a coverage data file with a .COV file extension or a field sensor data file with a .SEN file extension in the Data Manager's "3D Data Files" tab and click the Graph Settings button.
- From the drop-down list labeled Graph Type, choose the Surface option. Close the graph settings dialog and return to the Data Manager. With the 3D data file selected, click the Plot button of Data Manager.
- Alternatively, you can define two NumPy vectors X and Y and a matrix Z in the Python Interpreter and use the emag_plot_surface(...) function.
PYTHON COMMAND(S): emag_plot_colorgrid(x,y,z_matrix,title="New Graph",x_label="x",y_label="y",*args,**kwargs)
emag_plot_car_grid(file_name,title="",FRColor=(1,1,1),BKColor=(1,1,1),margins=(0.15,0.1,0.1,0.1,0.2,0.2,0.8,0.9,0.5,0.5),*args,**kwargs)
emag_plot_cov(file_name,title="",FRColor=(1,1,1),BKColor=(1,1,1),margins=(0.15,0.1,0.1,0.1,0.2,0.2,0.8,0.9,0.5,0.5),*args,**kwargs)
emag_plot_sen_grid(file_name,title="",FRColor=(1,1,1),BKColor=(1,1,1),margins=(0.15,0.1,0.1,0.1,0.2,0.2,0.8,0.9,0.5,0.5),*args,**kwargs)
emag_plot_sen_tempo_grid(file_name,input_name,grid_name,title="",FRColor=(1,1,1),BKColor=(1,1,1),margins=(0.15,0.1,0.1,0.1,0.2,0.2,0.8,0.9,0.5,0.5),*args,**kwargs)
emag_plot_sen_ferma_grid(file_name,title="",FRColor=(1,1,1),BKColor=(1,1,1),margins=(0.15,0.1,0.1,0.1,0.2,0.2,0.8,0.9,0.5,0.5),*args,**kwargs)
Complex Data Graph
ICON: None
MODULE: EM.Tempo, EM.Picasso, EM.Libera
FUNCTION: Displays the variation of a complex-valued scalar data set
TO PLOT A COMPLEX DATA GRAPH:
- Select one or more data files with a .CPX file extension in the Data Manager and click the Plot button.
- Alternatively, you can define a real-valued NumPy vector X and a complex-valued NumbPy vector Z in the Python Interpreter and use the emag_plot_cartesian(...) function.
- Complex data graph can be plotted in two different formats: "Mag + Phase" or "Real + Imag". The former plots the magnitude and phase of the complex-valued dependent variable on two separate graphs. The latter plots the
real and imaginary parts of the complex-valued dependent variable on same graph.
PYTHON COMMAND(S): emag_plot_cpx(file_name,auto_scale=True,title="",xlabel="Default",ylabel="Default",FRColor=(1,1,1),BKColor=(1,1,1),PLColor1=(1,0,0),linewidth1=1,linestyle1="solid",marker1="None",PLColor2=(1,0,0),linewidth2=1,linestyle2="solid",marker2="None",margins=(0.15,0.1,0.1,0.1,0.2,0.2,0.8,0.9,0.5,0.5),show_major_grid=True,show_minor_grid=False,MAJColor=(0.25,0.25,0.25),MINColor=(0.5,0.5,0.5),major_grid_linewidth=1,minor_grid_linewidth=1,major_grid_linestyle="dotted",minor_grid_linestyle="dotted",axis_param=(0,0,5,5,0,0,5,5),show_legend=True,legend_label1="Default",legend_label2="Default",show_textbox=False,annot_text="",font_size=10,TXColor=(0,0,0),*args,**kwargs)
emag_plot_two_cpx(file_name1,file_name2,auto_scale=True,title="",xlabel="Default",ylabel="Default",FRColor=(1,1,1),BKColor=(1,1,1),PLColor1=(1,0,0),linewidth1=1,linestyle1="solid",marker1="None",PLColor2=(1,0,0),linewidth2=1,linestyle2="solid",marker2="None",margins=(0.15,0.1,0.1,0.1,0.2,0.2,0.8,0.9,0.5,0.5),show_major_grid=True,show_minor_grid=False,MAJColor=(0.25,0.25,0.25),MINColor=(0.5,0.5,0.5),major_grid_linewidth=1,minor_grid_linewidth=1,major_grid_linestyle="dotted",minor_grid_linestyle="dotted",axis_param=(0,0,5,5,0,0,5,5),show_legend=True,legend_label1="Default",legend_label2="Default",show_textbox=False,annot_text="",font_size=10,TXColor=(0,0,0),*args,**kwargs)
emag_plot_complex(x,z_complex,plot_type="mag+phase",title="New Graph",x_label="x",*args,**kwargs)
Contour Plot
ICON: None
MODULE: EM.Tempo, EM.Terrano, EM.Illumina, EM.Ferma, EM.Picasso, EM.Libera
FUNCTION: Displays the contour plot of a Cartesian spatial data set of the form z = f(x,y) on a specified principal plane
TO PLOT A CARTESIAN GRAPH:
- You can visualize 3D Cartesian data, receiver power coverage maps or electric and magnetic field distributions as contour plots.
- EM.Cube offers two types of contour plots: regular contour plots and filled contour plots.
- Select a 3D Cartesian data file with a .CAR file extension or a coverage data file with a .COV file extension or a field sensor data file with a .SEN file extension in the Data Manager's "3D Data Files" tab and click the Graph Settings button.
- From the drop-down list labeled Graph Type, choose either of the Contour or Filled Contour options. Close the graph settings dialog and return to the Data Manager. With the 3D data file selected, click the Plot button of Data Manager.
- Alternatively, you can define two NumPy vectors X and Y and a matrix Z in the Python Interpreter and use the emag_plot_surface(...) function.
PYTHON COMMAND(S): emag_plot_contour(x,y,z_matrix,filled=False,title="New Graph",x_label="x",y_label="y",*args,**kwargs)
emag_plot_car_contour(file_name,filled=False,title="",FRColor=(1,1,1),BKColor=(1,1,1),margins=(0.15,0.1,0.1,0.1,0.2,0.2,0.8,0.9,0.5,0.5),*args,**kwargs)
emag_plot_cov_contour(file_name,filled=False,title="",FRColor=(1,1,1),BKColor=(1,1,1),margins=(0.15,0.1,0.1,0.1,0.2,0.2,0.8,0.9,0.5,0.5),*args,**kwargs)
emag_plot_sen_contour(file_name,filled=False,title="",FRColor=(1,1,1),BKColor=(1,1,1),margins=(0.15,0.1,0.1,0.1,0.2,0.2,0.8,0.9,0.5,0.5),*args,**kwargs)
emag_plot_sen_tempo_contour(file_name,input_name,grid_name,filled=False,title="",FRColor=(1,1,1),BKColor=(1,1,1),margins=(0.15,0.1,0.1,0.1,0.2,0.2,0.8,0.9,0.5,0.5),*args,**kwargs)
emag_plot_sen_ferma_contour(file_name,filled=False,title="",FRColor=(1,1,1),BKColor=(1,1,1),margins=(0.15,0.1,0.1,0.1,0.2,0.2,0.8,0.9,0.5,0.5),*args,**kwargs)
Current Distribution Observable
MODULE: EM.Illumina, EM.Picasso, EM.Libera
FUNCTION: Computes either frequency-domain electric and magnetic current components on the mesh
TO DEFINE A CURRENT DISTRIBUTION:
- Right-click on the Current Distributions item in the navigation tree.
- Select Insert New Observable... to open up the Current Distribution Dialog.
- This observable doesn't have any parameters to set.
- Click the OK button of the dialog to return to the project workspace.
In EM.Picasso, you need to define a current distribution observable for each individual trace or embedded object set. You select the desired trace from a drop-down list. In EM.Libera and EM.Illumina, a single current distribution observable is defined for the entire physical structure.
PYTHON COMMAND: current_dist(label)
CURRENT DISTRIBUTION PARAMETERS: None
CURRENT DISTRIBUTION'S OUTPUT DATA FILES
Data File Name | Data Type | Description | Notes & Restrictions |
---|---|---|---|
ObservableName.CUR | 3D complex vector data | frequency-domain Jx, Jy, Jz, Mx, My, Mz current data | EM.Illumina & EM.Libera |
TraceName.CUR | 3D complex vector data | frequency-domain Jx, Jy, Jz, Mx, My, Mz current data | EM.Picasso |
Custom Output Parameters
You can use the "standard output parameters" to define new "custom output parameters". In many cases, the standard output may not be what you are looking for. For example, the directivity D0 of a radiating structure is stored in linear scale. If you are rather interested in dB-scaled directivity values, you can define a new output parameter for that purpose and store the results in an ASCII data file. Custom output parameters are written into ASCII data files that bear the name of the parameter with a .DAT file extension. At the end of a simulation, you can see a list of all the custom output data files in Data Manager. Just like other standard output, you can plot these files or perform data operations on them.
To define a new custom output parameter, follow the procedure below:
- Click the Custom Output button of the Simulate Toolbar or select menu → Simulate → Custom Output or use the keyboard shortcut Ctrl+K. This opens up the Custom Output dialog, which is initially empty. You need to define your new custom output parameters one by one and add them to this list.
- To define a new parameters, click the Add button of the dialog.
- A new dialog opens up, which offers a list of all the available standard output parameters for your information. You need to choose a name or Label for your custom output and enter an Expression for its definition. This can be any mathematical expression that involves the standard output parameters, arithmetic operations, and one ore more EM.Cube's functions. Double-clicking on the name of a standard output parameter in the dialog's table will copy its name to the expression box.
- Once you are done with the definition of your new custom output parameter, click the OK button to add it to the Custom Output list.
The button labeled f(x) at the bottom of this dialog can be used to open EM.Cube's Function List to review the format or syntax of these functions.
Energy-Power Observable
MODULE: EM.Tempo
FUNCTION: Instructs EM.Tempo to compute the energy and power quantities for the entire computational domain in the time domain as well as energy and power density quantities on all field sensor planes in the frequency domain
TO DEFINE A ENERGY-POWER OBSERVABLE:
- Right-click on the Domain Energy item in the navigation tree of EM.Tempo.
- Select Compute Domain Energy from the contextual menu.
- A check mark is placed before the energy item which sets the observable.
PYTHON COMMAND: set_energy_power(enable)
ENERGY OUTPUT DATA FILES
Data File Name | Data Type | Description | Notes & Restrictions |
---|---|---|---|
Domain_Energy_E.DAT | 2D real scalar data | the electric energy of the FDTD domain as a function of time | none |
Domain_Energy_H.DAT | 2D real scalar data | the magnetic energy of the FDTD domain as a function of time | none |
Domain_Total_Energy.DAT | 2D real scalar data | the total energy of the FDTD domain as a function of time | none |
Domain_Dissipated_Power.DAT | 2D real scalar data | the total energy of the FDTD domain as a function of time | none |
SensorName_Electric_Energy_Density.CAR | 3D Cartesian real scalar data | the electric energy density on SensorName plane | none |
SensorName_Magnetic_Energy_Density.CAR | 3D Cartesian real scalar data | the magnetic energy density on SensorName plane | none |
SensorName_Total_Energy_Density.CAR | 3D Cartesian real scalar data | the total energy density on SensorName plane | none |
SensorName_Dissipated_Power_Density.CAR | 3D Cartesian real scalar data | the dissipated power density on SensorName plane | none |
SensorName_SAR_Density.CAR | 3D Cartesian real scalar data | the specific absorption rate density on SensorName plane | none |
SensorName_Poynting.CAR | 3D Cartesian complex vector data | the complex Poynting vector on SensorName plane | none |
Far-Field Radiation Pattern Observable
MODULE: EM.Tempo, EM.Terrano, EM.Illumina, EM.Picasso, EM.Libera
FUNCTION: Computes the far-zone electric fields in the spherical coordinate system
TO DEFINE A FAR-FIELD RADIATION PATTERN:
- Right-click on the Far-Field Radiation Patterns item in the navigation tree.
- Select Insert New Radiation Pattern... to open up the Radiation Pattern Dialog.
- By default, the field probe is place at the origin of coordinates. Enter new (X,Y,Z) coordinates for the desired location.
- Click the OK button of the dialog to return to the project workspace.
NOTES, SPECIAL CASES OR EXCEPTIONS: The far-zone fields are the asymptotic form of the near-zone fields when r → ∞ or k_{0}r >> 1. Under this assumption, the fields propagate outward as transverse electromagnetic (TEM) waves:
[math] \mathbf{H^{ff}(r)} = \frac{1}{\eta_0} \mathbf{ \hat{k} \times E^{ff}(r)} [/math]
Far fields are typically computed in the spherical coordinate system as functions of the elevation and azimuth observation angles θ and φ. Only the far-zone electric fields are typically considered as the far-zone magnetic fields are orthogonal and proportional to the electric fields. When your physical structure is excited using one of the many types of lumped sources, distributed sources, gap sources and their variations or using a short dipole source, the far fields represent the radiation pattern of your source(s) in the far zone. When your physical structure is illuminated by a plane wave source or a Gaussian beam source, the far fields represent the scattered fields or scattering patterns. In the case of a plane source, the radar cross section (RCS) of your structure is often more impotent than its radiation/scattering pattern.
PYTHON COMMAND: farfield(label,theta_incr,phi_incr)
RADIATION PATTERN PARAMETERS
Parameter Name | Value Type | Units | Default Value | Notes |
---|---|---|---|---|
phi angle increment | real numeric | degrees | 5 | resolution of computed radiation pattern along phi |
theta angle increment | real numeric | degrees | 5 | resolution of computed radiation pattern along theta |
non-principal phi plane | real numeric | degrees | 45 | additional plane cut |
custom azimuth | real numeric | degrees | 0 | phi angle for computation of additional radiation characteristics |
custom elevation | real numeric | degrees | 0 | theta angle for computation of additional radiation characteristics |
Nx | integer numeric | - | 1 | array factor element count along X |
Ny | integer numeric | - | 1 | array factor element count along Y |
Nz | integer numeric | - | 1 | array factor element count along Z |
spacing_x | real numeric | project units | 0 | array factor element spacing along X |
spacing_y | real numeric | project units | 0 | array factor element spacing along Y |
spacing_z | real numeric | project units | 0 | array factor element spacing along Z |
FAR FIELD OUTPUT DATA FILES
Data File Name | Data Type | Description | Notes & Restrictions |
---|---|---|---|
FarFieldName.RAD | spherical complex data | frequency-domain E_{θ} and E_{φ} field data | none |
FarFieldName_PATTERN_Cart_XY.DAT | 2D real scalar data | frequency-domain 2D Cartesian radiation pattern in the XY plane | none |
FarFieldName_PATTERN_Cart_YZ.DAT | 2D real scalar data | frequency-domain 2D Cartesian radiation pattern in the YZ plane | none |
FarFieldName_PATTERN_Cart_ZX.DAT | 2D real scalar data | frequency-domain 2D Cartesian radiation pattern in the ZX plane | none |
FarFieldName_PATTERN_Cart_Custom.DAT | 2D real scalar data | frequency-domain 2D Cartesian radiation pattern in the custom phi-plane | custom phi is 45° by default |
FarFieldName_PATTERN_Polar_XY.ANG | 2D real angular data | frequency-domain 2D Polar radiation pattern in the XY plane | none |
FarFieldName_PATTERN_Polar_YZ.ANG | 2D real angular data | frequency-domain 2D Polar radiation pattern in the YZ plane | none |
FarFieldName_PATTERN_Polar_ZX.ANG | 2D real angular data | frequency-domain 2D Polar radiation pattern in the ZX plane | none |
FarFieldName_PATTERN_Polar_Custom.ANG | 2D real angular data | frequency-domain 2D Polar radiation pattern in the custom phi-plane | custom phi is 45° by default |
Axial_Ratio.SPH | spherical complex data | axial ratio as a function of θ and φ | axial ratio must be checked |
EL.SPH | spherical complex data | LCP field components E_{L} as a function of θ and φ | axial ratio must be checked |
ER.SPH | spherical complex data | RCP field components E_{R} as a function of θ and φ | axial ratio must be checked |
Axial_Ratio_XY.DAT | 2D real scalar data | axial ratio and LCP & RCP field components (E_{L}, E_{R}) in the XY plane | axial ratio must be checked |
Axial_Ratio_YZ.DAT | 2D real scalar data | axial ratio and LCP & RCP field components (E_{L}, E_{R}) in the YZ plane | axial ratio must be checked |
Axial_Ratio_ZX.DAT | 2D real scalar data | axial ratio and LCP & RCP field components (E_{L}, E_{R}) in the ZX plane | axial ratio must be checked |
Axial_Ratio_Custom.DAT | 2D real scalar data | axial ratio and LCP & RCP field components (E_{L}, E_{R}) in the custom Phi-plane | custom phi is 45° by default |
DG.SPH | spherical complex data | directive gain as a function of θ and φ | DG must be checked |
DG_XY.DAT | 2D real scalar data | directive gain in the XY plane | DG must be checked |
DG_YZ.DAT | 2D real scalar data | directive gain in the YZ plane | DG must be checked |
DG_ZX.DAT | 2D real scalar data | directive gain in the ZX plane | DG must be checked |
DG_Custom.DAT | 2D real scalar data | directive gain in the custom Phi-plane | custom phi is 45° by default |
HPBW_XY.DAT | 2D real scalar data | half-power beam width in the XY plane | HPBW must be checked |
HPBW_YZ.DAT | 2D real scalar data | half-power beam width in the YZ plane | HPBW must be checked |
HPBW_ZX.DAT | 2D real scalar data | half-power beam width in the ZX plane | HPBW must be checked |
HPBW_Custom.DAT | 2D real scalar data | half-power beam width in the custom Phi-plane | custom phi is 45° by default |
MAX_SLL_XY.DAT | 2D real scalar data | maximum side lobe level in the XY plane | MAX SLL must be checked |
MAX_SLL_YZ.DAT | 2D real scalar data | maximum side lobe level in the YZ plane | MAX SLL must be checked |
MAX_SLL_ZX.DAT | 2D real scalar data | maximum side lobe level in the ZX plane | MAX SLL must be checked |
MAX_SLL_Custom.DAT | 2D real scalar data | maximum side lobe level in the custom Phi-plane | custom phi is 45° by default |
FNL_XY.DAT | 2D real scalar data | first null level in the XY plane | first null parameters must be checked |
FNL_YZ.DAT | 2D real scalar data | first null level in the YZ plane | first null parameters must be checked |
FNL_ZX.DAT | 2D real scalar data | first null level in the ZX plane | first null parameters must be checked |
FNL_Custom.DAT | 2D real scalar data | first null level in the custom Phi-plane | custom phi is 45° by default |
FNB_XY.DAT | 2D real scalar data | first null beam width in the XY plane | first null parameters must be checked |
FNB_YZ.DAT | 2D real scalar data | first null beam width in the YZ plane | first null parameters must be checked |
FNB_ZX.DAT | 2D real scalar data | first null beam width in the ZX plane | first null parameters must be checked |
FNB_Custom.DAT | 2D real scalar data | first null beam width in the custom Phi-plane | custom phi is 45° by default |
D0.DAT | 2D real scalar data | directivity | none |
PRAD.DAT | 2D real scalar data | total radiated power in Watts | none |
MainBeam.DAT | 2D real scalar data | the elevation and azimuth angles of the main beam | none |
ARU.DAT | 2D real scalar data | axial ratio along the user defined azimuth and elevation direction | axial ratio must be checked |
DGU.DAT | 2D real scalar data | directive gain along the user defined azimuth and elevation direction | DG must be checked |
FBR.DAT | 2D real scalar data | front-to-back ratio measured as |E_{tot}(θ = 0°)| / |E_{tot}(θ = 180°)| | FBR must be checked |
REFF.DAT | 2D real scalar data | radiation efficiency | requires a port definition |
G0.DAT | 2D real scalar data | antenna gain | requires a port definition |
Huygens Surface Observable
MODULE: EM.Tempo, EM.Terrano, EM.Illumina, EM.Picasso, EM.Libera
FUNCTION: Computes the tangential components of equivalent electric and magnetic surface currents on the surface of a specified Huygens box
TO DEFINE A HUYGENS SURFACE:
- Right-click on the Huygens Surfaces item in the navigation tree.
- Select Insert New Observable... to open up the Huygens Surface Dialog.
- By default, the field probe is place at the origin of coordinates with a Z-orientation. Select a new orientation or enter (X,Y,Z) coordinates for the desired location.
- Click the OK button of the dialog to return to the project workspace.
PYTHON COMMAND:
huygens_surface(label,x1,y1,z1,x2,y2,z2,xSamples,ySamples,zSamples)
huygens_surface_grid(label,x1,y1,z1,x2,y2,z2)
HUYGENS SURFACE PARAMETERS
Parameter Name | Value Type | Units | Default Value | Notes |
---|---|---|---|---|
x1 | real numeric | project units | 0 | X-coordinate of the lower front left corner of Huygens box |
y1 | real numeric | project units | 0 | Y-coordinate of the lower front left corner of Huygens box |
z1 | real numeric | project units | 0 | Z-coordinate of the lower front left corner of Huygens box |
x2 | real numeric | project units | 0 | X-coordinate of the upper back right corner of Huygens box |
y2 | real numeric | project units | 0 | Y-coordinate of the upper back right corner of Huygens box |
z2 | real numeric | project units | 0 | Z-coordinate of the upper back right corner of Huygens box |
Nx | integer numeric | - | 10 | sample count along X |
Ny | integer numeric | - | 1 | sample count along Y |
Nz | integer numeric | - | 1 | sample count along Z |
near-field frequency | real numeric | Hz | fc | frequency of computation of near-field data |
HUYGENS SURFACE'S OUTPUT DATA FILES
Data File Name | Data Type | Description |
---|---|---|
ObservableName.HUY | 3D complex vector data | frequency-domain Jx, Jy, Jz, Mx, My, Mz current data on the surface of the Huygens box |
Near-Field Sensor Observable
MODULE: EM.Tempo, EM.Terrano, EM.Illumina, EM.Ferma, EM.Picasso, EM.Libera
FUNCTION: Computes either time-domain or frequency-domain electric and magnetic field components on a principal plane
TO DEFINE A FIELD SENSOR:
- Right-click on the Field Sensors item in the navigation tree.
- Select Insert New Observable... to open up the Field Sensor Dialog.
- By default, the field sensor plane is horizontal (having a Z-orientation) and is placed at the origin of coordinates.
- Change the orientation of the sensor plane, if necessary, or enter the (x,y,z) coordinates for a new location.
- In EM.Tempo and EM.Ferma, the field sensor plane extends to the entire cross section of the computational domain and its resolution is driven by the mesh density.
- In EM.Terrano, EM.Illumina, EM.Picasso or EM.Libera, you have to additionally specify the dimensions of the sensor plane as well as the number of samples along the two principal directions of the sensor plane.
- The center coordinate that is identical to the sensor's direction determines the position of the sensor plane in the 3D space. The other two coordinates can be used to set the crosshairs of the sensor plane. These are used to compute the 2D field variations along the specified lines.
- For the 3D visualization of the field sensor data, you have to choose one of the two plot type options: Intensity or Vector. In the case of an intensity plot (which is the default choice), you can additionally apply a data interpolation scheme to smooth out the plot. In the case of a vector plot, you can control the maximum size of the vector arrows as well as the cone ratio (ratio of the size of the conical tip to the arrow's stem).
- If the field sensor is to be used in a sweep simulation, only the total E-field or total H-field will be recorded at each instance of the simulation. The default choice is the E-field.
- Click the OK button of the dialog to return to the project workspace.
NOTES, SPECIAL CASES OR EXCEPTIONS: Field sensors are primarily used for the 3D visualization of electric and magnetic field distributions either in the frequency or time domain. In EM.Tempo, you can use a field sensor to record the evolution of the fields as a function of time. You can also record the field sensor data during a sweep simulation (either a frequency sweep or a parametric sweep). You can animate a collection of field sensor data belonging to the same observable node in the navigation tree. You can also use the sensor plane's crosshairs to plot the field variations on 2D Cartesian graphs in EM.Grid.
PYTHON COMMAND:
field_sensor_grid(label,dir_coordinate,x0,y0,z0)
field_sensor(label,dir_coordinate,x0,y0,z0,xSize,ySize,zSize,xSamples,ySamples,zSamples)
FIELD SENSOR PARAMETERS
Parameter Name | Value Type | Units | Default Value | Notes |
---|---|---|---|---|
direction | List: X, Y, Z | - | Z | orientation of field sensor plane |
x0 | real numeric | project units | 0 | X-coordinate of the origin of field sensor plane |
y0 | real numeric | project units | 0 | Y-coordinate of the origin of field sensor plane |
z0 | real numeric | project units | 0 | Z-coordinate of the origin of field sensor plane |
near-field frequency | real numeric | Hz | fc | frequency of computation of near-field data |
FIELD SENSOR'S OUTPUT DATA FILES
Data File Name | Data Type | Description |
---|---|---|
SensorName.SEN | 3D complex vector data | frequency-domain Ex, Ey, Ez, Hx, Hy, Hz field data |
SensorName_X_ETotal.DAT | 2D real scalar data | frequency-domain total electric field data along X crosshair |
SensorName_Y_ETotal.DAT | 2D real scalar data | frequency-domain total electric field data along Y crosshair |
SensorName_Z_ETotal.DAT | 2D real scalar data | frequency-domain total electric field data along Z crosshair |
SensorName_X_HTotal.DAT | 2D real scalar data | frequency-domain total magnetic field data along X crosshair |
SensorName_Y_HTotal.DAT | 2D real scalar data | frequency-domain total magnetic field data along Y crosshair |
SensorName_Z_HTotal.DAT | 2D real scalar data | frequency-domain total magnetic field data along Z crosshair |
Periodic Characteristics
MODULE: EM.Tempo, EM.Picasso
FUNCTION: Treats a periodic structure illuminated by a plane wave source as a periodic surface for computation of reflection and transmission coefficients
NOTE: If your physical structure has periodic domain settings along with a plane wave source, the reflection and transmission coefficients of the periodic surface are computed automatically at the end of the simulation. You don't need to explicitly define any observable for this purpose.
PERIODIC OUTPUT DATA FILES
Data File Name | Data Type | Description | Notes & Restrictions |
---|---|---|---|
reflection_coefficient.CPX | 2D complex scalar data | real and imaginary parts of the reflection coefficient | requires a plane wave source |
transmission_coefficient.CPX | 2D complex scalar data | real and imaginary parts of the transmission coefficient | requires a plane wave source |
Point Receiver Set
MODULE: EM.Terrano
FUNCTION: Defines a receiver set associated with an existing base location set
TO DEFINE A POINT RECEIVER SET:
- Right-click on the Receivers item in the navigation tree of EM.Terrano.
- Select Insert New Receiver Set... to open up the Receiver Set Dialog.
- From the drop-down list labeled Select Base Point Set, choose the desired base location set, which can be a single point object or a point array.
- By default, the receiver set is assumed to be made up of isotropic radiators.
- You may also force the receivers to adjust their Z-coordinates based on the underlying terrain surface.
- Click the OK button of the dialog to return to the project workspace. The new round symbols appear representing the receiver set.
- You can open the property dialog of the receiver set and change the radiator type to User Defined Antenna. In that case, click the Import Pattern button of the dialog to set the file path for a far-field radiation pattern data file of ".RAD" type. You can also additionally rotate the imported radiation pattern about its local X-, Y- and Z-axes.
PYTHON COMMAND: receiver_set(label,base_point_set[,pattern_file,x_rot,y_rot,z_rot])
POINT RECEIVER SET PARAMETERS
Parameter Name | Value Type | Units | Default Value | Notes |
---|---|---|---|---|
radiator type | options: isotropic, user define antenna | - | isotropic | - |
pattern file | file path | - | Models\DPL_STD.RAD | imported far-field radiation pattern data file with a ".RAD" file extension for the case of user defined receiver antenna |
rot_x | real numeric | degrees | 0 | additional rotation angle of the imported radiation pattern about the local X-axis |
rot_y | real numeric | degrees | 0 | additional rotation angle of the imported radiation pattern about the local Y-axis |
rot_z | real numeric | degrees | 0 | additional rotation angle of the imported radiation pattern about the local Z-axis |
POINT RECEIVER SET'S OUTPUT DATA FILES
Data File Name | Data Type | Description |
---|---|---|
SBR_Results.RTOUT | special output data file written by the SBR simulation engine | individual ray data of each receiver |
SBR_RecevierSetName_PATHLOSS.DAT | 2D real scalar data | the path loss between the transmitter and individual receivers of the receiver set as a function of receiver index |
SBR_RecevierSetName_DELAY.DAT | 2D real scalar data | power of individual rays received by the selected receiver normalized by the power threshold |
SBR_RecevierSetName_ThetaARRIVAL.DAT | 2D real angular data | the elevation angles of arrival of individual rays received by the selected receiver |
SBR_RecevierSetName_PhiARRIVAL.DAT | 2D real angular data | the azimuth angles of arrival of individual rays received by the selected receiver |
SBR_RecevierSetName_ThetaDEPARTURE.DAT | 2D real angular data | the elevation angles of departure of individual rays received by the selected receiver |
SBR_RecevierSetName_PhiDEPARTURE.DAT | 2D real angular data | the azimuth angles of departure of individual rays received by the selected receiver |
PREC_1.DAT | 2D real scalar data | the total received power by the selected receiver |
PL_1.DAT | 2D real | 2D real scalar data | the path loss between the transmitter and the selected receiver |
SBR_RecevierSetName.PRI | special polarimetric ray information file | represents the individual rays received by the selected receiver as plane wave sources |
Polar Graph
ICON: None
MODULE: EM.Tempo, EM.Illumina, EM.Picasso, EM.Libera
FUNCTION: Displays an angular data set where the independent and dependent variables are represented respectively by the angle measured counter-clockwise from the positive X-axis and radius
TO PLOT A POLAR GRAPH:
- Select one or more data files with a .ANG file extension in the Data Manager and click the Plot button.
- Alternatively, you can define two NumPy vectors ang and rad in the Python Interpreter and use the emag_plot_polarn(...) function.
PYTHON COMMAND(S): emag_plot_ang(file_name,title="",FRColor=(1,1,1),BKColor=(1,1,1),PLColor=(1,0,0),linewidth=1,linestyle="solid",marker="None",margins=(0.15,0.1,0.1,0.1,0.2,0.2,0.8,0.9,0.5,0.5),show_legend=True,*args,**kwargs)
emag_plot_two_ang(file_name1,file_name2,title="",FRColor=(1,1,1),BKColor=(1,1,1),PLColor1=(1,0,0),linewidth1=1,linestyle1="solid",marker1="None",PLColor2=(1,0,0),linewidth2=1,linestyle2="solid",marker2="None",margins=(0.15,0.1,0.1,0.1,0.2,0.2,0.8,0.9,0.5,0.5),show_legend=True,legend_label1="Default",legend_label2="Default",*args,**kwargs)
emag_plot_polar(ang,rad,title="New Graph",*args,**kwargs)
Polar Stem Chart
ICON: None
MODULE: EM.Terrano
FUNCTION: Displays the radius values of an angular data set with a few discrete angle values
TO PLOT A POLAR STEM CHART:
- The theta and phi angles of arrival and theta and phi angles of departure of the rays received by a specified receiver can be plotted on a polar stem chart.
- Open EM.Terrano's Data Manager, select a delay profile data file with name similar to "SBR_ReceiverSet_1_PhiARRIVAL.ANG" or "SBR_ReceiverSet_1_ThetaDEPARTURE.ANG", and click the Plot button.
PYTHON COMMAND(S): None
Port Definition Observable
MODULE: EM.Tempo, EM.Picasso, EM.Libera
FUNCTION: Designates ports to the available sources for computation of S/Z/Y parameters
TO INITIATE A PORT DEFINITION:
- Right-click on the Port Definitions item in the navigation tree.
- Select Insert New Observable... to open up the Port Definition Dialog.
- By default, one port is designated to each legitimate source.
- By default, all the port have a reference impedance of 50 Ohms. You can change this value by editing the properties of each individual port.
- Click the OK button of the dialog to return to the project workspace.
PYTHON COMMAND:
port_definition_default(label)
port_definition_custom(label,(port_1_src_1, port_1_src_2,...,port_1_impedance),(port_2_src_1, port_2_src_2,...,port_2_impedance),...)
PORT DEFINITION PARAMETERS
Parameter Name | Value Type | Units | Default Value | Notes |
---|---|---|---|---|
impedance | real numeric | Ohms | 50 | reference impedance for S-parameter computation |
start frequency | real numeric | Hz | fc-bw/2 | lower end of frequency range for Fourier transform computation |
end frequency | real numeric | Hz | fc+bw/2 | higher end of frequency range for Fourier transform computation |
PORT OUTPUT DATA FILES
Data File Name | Data Type | Description | Notes & Restrictions |
---|---|---|---|
Sij.CPX | 2D complex scalar data | real and imaginary parts of scattering parameter S_{ij} | EM.Picasso & EM.Libera |
Zij.CPX | 2D complex scalar data | real and imaginary parts of impedance parameter Z_{ij} | EM.Picasso & EM.Libera |
Yij.CPX | 2D complex scalar data | real and imaginary parts of admittance parameter Y_{ij} | EM.Picasso & EM.Libera |
VSWR.DAT | 2D real scalar data | voltage standing wave ratio | none |
s_param_rfspice.TXT | 2D real scalar data | writes the S-parameters in Touchstone format for device generation in RF.Spice A/D | none |
DP_Sij.CPX | 2D complex scalar data | real and imaginary parts of scattering parameter S_{ij} | EM.Tempo |
DP_Zij.CPX | 2D complex scalar data | real and imaginary parts of impedance parameter Z_{ij} | EM.Tempo |
DP_Yij.CPX | 2D complex scalar data | real and imaginary parts of admittance parameter Y_{ij} | EM.Tempo |
Current_Time_ij.DAT | 2D real scalar data | the current in port i due to the excitation of port j as a function of time | EM.Tempo |
Voltage_Time_ij.DAT | 2D real scalar data | the voltage across port i due to the excitation of port j as a function of time | EM.Tempo |
Current_Freq_ij.CPX | 2D complex scalar data | the real and imaginary parts of the current in port i due to the excitation of port j as a function of frequency | EM.Tempo |
Voltage_Freq_ij.CPX | 2D complex scalar data | the real and imaginary parts of the voltage across port i due to the excitation of port j as a function of frequency | EM.Tempo |
Power_Freq_ij.CPX | 2D complex scalar data | the real and imaginary parts of the power at port i due to the excitation of port j as a function of frequency | EM.Tempo |
Radar Cross Section (RCS) Observable
MODULE: EM.Tempo, EM.Illumina, EM.Picasso, EM.Libera
FUNCTION: Computes the radar cross section in the spherical coordinate system
TO DEFINE AN RCS:
- Right-click on the Radar Cross Sections item in the navigation tree.
- Select Insert New RCS... to open up the RCS Dialog.
- By default, the field probe is place at the origin of coordinates. Enter new (X,Y,Z) coordinates for the desired location.
- Click the OK button of the dialog to return to the project workspace.
PYTHON COMMAND: rcs_bistatic(label,theta_incr,phi_incr)
RCS PARAMETERS
Parameter Name | Value Type | Units | Default Value | Notes |
---|---|---|---|---|
phi angle increment | real numeric | degrees | 5 | resolution of computed radiation pattern along phi |
theta angle increment | real numeric | degrees | 5 | resolution of computed radiation pattern along theta |
non-principal phi plane | real numeric | degrees | 45 | additional plane cut |
custom azimuth | real numeric | degrees | 0 | phi angle for computation of additional radiation characteristics |
custom elevation | real numeric | degrees | 0 | theta angle for computation of additional radiation characteristics |
RCS OUTPUT DATA FILES
Data File Name | Data Type | Description | Notes & Restrictions |
---|---|---|---|
RCSName.RCS | Spherical complex data | frequency-domain σ_{θ} and σ_{φ} RCS data | none |
RCSName_RCS_Cart_XY.DAT | 2D real scalar data | frequency-domain 2D Cartesian RCS pattern in the XY plane | none |
RCSName_RCS_Cart_YZ.DAT | 2D real scalar data | frequency-domain 2D Cartesian RCS pattern in the YZ plane | none |
RCSName_RCS_Cart_ZX.DAT | 2D real scalar data | frequency-domain 2D Cartesian RCS pattern in the ZX plane | none |
RCSName_RCS_Cart_Custom.DAT | 2D real scalar data | frequency-domain 2D Cartesian RCS pattern in the custom phi-plane | custom phi is 45° by default |
RCSName_RCS_Polar_XY.ANG | 2D real angular data | frequency-domain 2D Polar RCS pattern in the XY plane | none |
RCSName_RCS_Polar_YZ.ANG | 2D real angular data | frequency-domain 2D Polar RCS pattern in the YZ plane | none |
RCSName_RCS_Polar_ZX.ANG | 2D real angular data | frequency-domain 2D Polar RCS pattern in the ZX plane | none |
RCSName_RCS_Polar_Custom.ANG | 2D real angular data | frequency-domain 2D Polar RCS pattern in the custom phi-plane | custom phi is 45° by default |
BRCS.DAT | 2D real scalar data | back-scatter RCS for the given plane wave incidence | none |
FRCS.DAT | 2D real scalar data | forward-scatter RCS for the given plane wave incidence | none |
MRCS.DAT | 2D real scalar data | maximum RCS for the given plane wave incidence | none |
MainBeam.DAT | 2D real scalar data | the elevation and azimuth angles of the main beam | none |
Smith Chart
ICON: None
MODULE: EM.Tempo, EM.Picasso, EM.Libera
FUNCTION: Displays a complex-valued scalar data set on a Smith chart
TO PLOT A SMITH CHART:
- First, select a data file with a .CPX file extension in the Data Manager.
- Next, click the Graph Settings button to open the graph settings dialog. From the drop-down list labeled Graph Type, choose the Smith option.
- Close the graph settings dialog and return to the Data Manager. With the complex data file selected, click the Plot button of Data Manager.
- Alternatively, you can define a complex-valued NumbPy vector Z in the Python Interpreter and use the emag_plot_smith(...) function.
PYTHON COMMAND(S): emag_plot_cpx(file_name,auto_scale=True,title="",xlabel="Default",ylabel="Default",FRColor=(1,1,1),BKColor=(1,1,1),PLColor1=(1,0,0),linewidth1=1,linestyle1="solid",marker1="None",PLColor2=(1,0,0),linewidth2=1,linestyle2="solid",marker2="None",margins=(0.15,0.1,0.1,0.1,0.2,0.2,0.8,0.9,0.5,0.5),show_major_grid=True,show_minor_grid=False,MAJColor=(0.25,0.25,0.25),MINColor=(0.5,0.5,0.5),major_grid_linewidth=1,minor_grid_linewidth=1,major_grid_linestyle="dotted",minor_grid_linestyle="dotted",axis_param=(0,0,5,5,0,0,5,5),show_legend=True,legend_label1="Default",legend_label2="Default",show_textbox=False,annot_text="",font_size=10,TXColor=(0,0,0),*args,**kwargs)
emag_plot_smith(z_complex,title="New Graph",*args,**kwargs)
Spherical Data Plot
ICON: None
MODULE: EM.Tempo, EM.Terrano, EM.Illumina, EM.Ferma, EM.Picasso, EM.Libera
FUNCTION: Displays the variation of a 3D spherical data set of the form r = f(θ,φ)
TO PLOT A CARTESIAN GRAPH:
- You can visualize 3D far-field radiation pattern data or 3D radar cross section (RCS) data as spherical data plots.
- Select a radiation pattern data file with a .RAD file extension or a 3D RCS data file with a .RCS file extension in the Data Manager's "3D Data Files" tab and click the Plot button of Data Manager.
- The auto-scale features of the spherical data plots is enabled by default. In some cases, you may want to disable this feature by clicking the Graph Settings of Data Manager and unchecking the check box labeled Use Auto-Scale in the graph settings dialog.
PYTHON COMMAND(S): emag_plot_rad(file_name,auto_scale=True,title="",FRColor=(1,1,1),BKColor=(1,1,1),margins=(0.15,0.1,0.1,0.1,0.2,0.2,0.8,0.9,0.5,0.5),*args,**kwargs)
emag_plot_rcs(file_name,auto_scale=True,title="",FRColor=(1,1,1),BKColor=(1,1,1),margins=(0.15,0.1,0.1,0.1,0.2,0.2,0.8,0.9,0.5,0.5),*args,**kwargs)
Standard Output Data
At the end of an EM.Cube simulation, a number of computed quantities are designated as "Standard Output" parameters and can be used for various post-processing data operations. For example, you can define design objectives based on them, which you need for optimization.
The table below gives a list of all the currently available standard output parameters in EM.Cube along with the relevant computational modules:
Standard Output Name / Syntax | Description | Computational Modules |
---|---|---|
SijM | Magnitude of (i,j)-th Scattering Parameter | EM.Tempo, EM.Picasso, EM.Libera |
SijP | Phase of (i,j)-th Scattering Parameter (in radians) | EM.Tempo, EM.Picasso, EM.Libera |
SijR | Real Part of (i,j)-th Scattering Parameter | EM.Tempo, EM.Picasso, EM.Libera |
SijI | Imaginary Part of (i,j)-th Scattering Parameter | EM.Tempo, EM.Picasso, EM.Libera |
ZijM | Magnitude of (i,j)-th Impedance Parameter | EM.Tempo, EM.Picasso, EM.Libera |
ZijP | Phase of (i,j)-th Impedance Parameter (in radians) | EM.Tempo, EM.Picasso, EM.Libera |
ZijR | Real Part of (i,j)-th Impedance Parameter | EM.Tempo, EM.Picasso, EM.Libera |
ZijI | Imaginary Part of (i,j)-th Impedance Parameter | EM.Tempo, EM.Picasso, EM.Libera |
YijM | Magnitude of (i,j)-th Admittance Parameter | EM.Tempo, EM.Picasso, EM.Libera |
YijP | Phase of (i,j)-th Admittance Parameter (in radians) | EM.Tempo, EM.Picasso, EM.Libera |
YijR | Real Part of (i,j)-th Admittance Parameter | EM.Tempo, EM.Picasso, EM.Libera |
YijI | Imaginary Part of (i,j)-th Admittance Parameter | EM.Tempo, EM.Picasso, EM.Libera |
VSWR | Voltage Standing Wave Ratio | EM.Tempo, EM.Picasso, EM.Libera |
D0 | Directivity | EM.Tempo, EM.Picasso, EM.Libera, EM.Illumina, EM.Terrano |
PRAD | Total Radiated Power | EM.Tempo, EM.Picasso, EM.Libera, EM.Illumina, EM.Terrano |
REFF | Radiation Efficiency | EM.Tempo, EM.Picasso, EM.Libera |
G0 | Antenna Gain | EM.Tempo, EM.Picasso, EM.Libera |
THM | Main Beam Theta | EM.Tempo, EM.Picasso, EM.Libera, EM.Illumina, EM.Terrano |
PHM | Main Beam Phi | EM.Tempo, EM.Picasso, EM.Libera, EM.Illumina, EM.Terrano |
DGU | Directive Gain along User Defined Direction | EM.Tempo, EM.Picasso, EM.Libera, EM.Illumina, EM.Terrano |
ARU | Axial Ratio along User Defined Direction | EM.Tempo, EM.Picasso, EM.Libera, EM.Illumina, EM.Terrano |
FBR | Front-to-Back Ratio | EM.Tempo, EM.Picasso, EM.Libera, EM.Illumina, EM.Terrano |
HPBWXY | Half Power Beam Width in XY Plane | EM.Tempo, EM.Picasso, EM.Libera, EM.Illumina, EM.Terrano |
HPBWYZ | Half Power Beam Width in YZ Plane | EM.Tempo, EM.Picasso, EM.Libera, EM.Illumina, EM.Terrano |
HPBWZX | Half Power Beam Width in ZX Plane | EM.Tempo, EM.Picasso, EM.Libera, EM.Illumina, EM.Terrano |
HPBWU | Half Power Beam Width in User Defined Plane | EM.Tempo, EM.Picasso, EM.Libera, EM.Illumina, EM.Terrano |
SLLXY | Maximum Side Lobe Level in XY Plane | EM.Tempo, EM.Picasso, EM.Libera, EM.Illumina, EM.Terrano |
SLLYZ | Maximum Side Lobe Level in YZ Plane | EM.Tempo, EM.Picasso, EM.Libera, EM.Illumina, EM.Terrano |
SLLZX | Maximum Side Lobe Level in ZX Plane | EM.Tempo, EM.Picasso, EM.Libera, EM.Illumina, EM.Terrano |
SLLU | Maximum Side Lobe Level in User Defined Plane | EM.Tempo, EM.Picasso, EM.Libera, EM.Illumina, EM.Terrano |
FNBXY | First Null Beam Width in XY Plane | EM.Tempo, EM.Picasso, EM.Libera, EM.Illumina, EM.Terrano |
FNBYZ | First Null Beam Width in YZ Plane | EM.Tempo, EM.Picasso, EM.Libera, EM.Illumina, EM.Terrano |
FNBZX | First Null Beam Width in ZX Plane | EM.Tempo, EM.Picasso, EM.Libera, EM.Illumina, EM.Terrano |
FNBU | First Null Beam Width in User Defined Plane | EM.Tempo, EM.Picasso, EM.Libera, EM.Illumina, EM.Terrano |
FNLXY | First Null Level in XY Plane | EM.Tempo, EM.Picasso, EM.Libera, EM.Illumina, EM.Terrano |
FNLYZ | First Null Level in YZ Plane | EM.Tempo, EM.Picasso, EM.Libera, EM.Illumina, EM.Terrano |
FNLZX | First Null Level in ZX Plane | EM.Tempo, EM.Picasso, EM.Libera, EM.Illumina, EM.Terrano |
FNLU | First Null Level in User Defined Plane | EM.Tempo, EM.Picasso, EM.Libera, EM.Illumina, EM.Terrano |
BRCS | Back-Scatter RCS | EM.Tempo, EM.Picasso, EM.Libera, EM.Illumina |
FRCS | Forward-Scatter RCS along User Defined Incident Direction | EM.Tempo, EM.Picasso, EM.Libera, EM.Illumina |
MRCS | Maximum Bi-static RCS | EM.Tempo, EM.Picasso, EM.Libera, EM.Illumina |
RCM | Magnitude of Reflection Coefficient | EM.Tempo, EM.Picasso |
RCP | Phase of Reflection Coefficient (in radians) | EM.Tempo, EM.Picasso |
RCR | Real Part of Reflection Coefficient | EM.Tempo, EM.Picasso |
RCI | Imaginary Part of Reflection Coefficient | EM.Tempo, EM.Picasso |
TCM | Magnitude of Transmission Coefficient | EM.Tempo, EM.Picasso |
TCP | Phase of Transmission Coefficient (in radians) | EM.Tempo, EM.Picasso |
TCR | Real Part of Transmission Coefficient | EM.Tempo, EM.Picasso |
TCI | Imaginary Part of Transmission Coefficient | EM.Tempo, EM.Picasso |
PREC_i | Received Power at the User-Specified Receiver in Receiver Set i | EM.Terrano |
SNR_i | Signal-to-Noise Ratio Path at the User-Specified Receiver in Receiver Set i | EM.Terrano |
PL_i | Path Loss from the Transmitter to the User-Specified Receiver in Receiver Set i | EM.Terrano |
name_Z0 | Characteristic Impedance of a 2D Transmission Line defined by the Solution Plane "name" | EM.Ferma |
name_EEFF | Effective Permittivity of a 2D Transmission Line defined by the Solution Plane "name" | EM.Ferma |
name_voltage | Voltage Calculated by the Field Integral Observable "name" | EM.Ferma |
name_current | Loop Current Calculated by the Field Integral Observable "name" | EM.Ferma |
name_EFlux | Electric Flux Calculated by the Field Integral Observable "name" | EM.Ferma |
name_HFlux | Magnetic Flux Calculated by the Field Integral Observable "name" | EM.Ferma |
name_EEnergy | Electric Energy Calculated by the Field Integral Observable "name" | EM.Ferma |
name_HEnergy | Magnetic Energy Calculated by the Field Integral Observable "name" | EM.Ferma |
name_conduction | Conduction Current Calculated by the Field Integral Observable "name" | EM.Ferma |
name_ohmic | Ohmic Power Loss Calculated by the Field Integral Observable "name" | EM.Ferma |
name_Cap | Capacitance Calculated by the Field Integral Observable "name" | EM.Ferma |
name_Ind | Inductance Calculated by the Field Integral Observable "name" | EM.Ferma |
name_Res | Resistance Calculated by the Field Integral Observable "name" | EM.Ferma |
All the port characteristics involving S/Z/Y parameters are available only if your project has a port definition. SijM, etc. means the scattering parameter observed at port i due to a source excited at port j. Similar definitions apply to all the S, Z and Y parameters. If your structure has N ports, there will be a total of N^{2} scattering parameters, a total of N^{2} impedance parameters, and a total of N^{2} admittance parameters. Additionally, there are four standard output parameters associated with each of the individual S/Z/Y parameters: magnitude, phase (in radians), real part and imaginary part. The same is true for the reflection and transmission coefficients of a periodic structure. Each coefficient has four associated standard output parameters. The reflection and transmission coefficient parameters, of course, are available only if your structure has a periodic domain and is excited by a plane wave source.
All the radiation- and scattering-related standard outputs are available only if you have defined a radiation pattern far field observable or an RCS far field observable, respectively. The standard output parameters DGU and ARU are the directive gain and axial ratio calculated at the user-specified direction with spherical observation angles (θ, φ). These angles are specified in degrees as Custom Azimuth & Elevation Angles in the "Output Settings" section of the Radiation Pattern Dialog. The standard output parameters HPBWU, SLLU, FNBU and FNLU are determined at a user defined phi-plane cut. This azimuth angle is specified in degrees as Non-Principal Phi Plane in the "Output Settings" section of the Radiation Pattern Dialog, and its default value is 45°. The standard output parameters BRCS and MRCS are the total back-scatter RCS and the maximum total RCS of your target structure when it is excited by an incident plane wave source at the specified θ_{s} and φ_{s} source angles. FRCS, on the other hand, is the total forward-scatter RCS measured at the predetermined θ_{o} and φ_{o} observation angles. These angles are specified in degrees as Custom Azimuth & Elevation Angles in the "Output Settings" section of the Radar Cross Section Dialog.
Static Field Integral Observable
MODULE: EM.Ferma
FUNCTION: Computes a number of different static quantities involving electric and magnetic field integrals
TO DEFINE A FIELD INTEGRAL:
- Right-click on the Static Field Integrals item in the navigation tree of EM.Ferma.
- Select Insert New Observable... to open up the Field Integral Dialog.
- From Field Integral Type drop-down list, choose one of the eleven type options.
- Most options involve a single field integral. Capacitance, Self-Inductance, Mutual Inductance and Resistance involve two field integrals.
- Each field integral might be a line, closed loop, open surface, closed surface or volume integral depending the selected type option. The domain of all of these integrals are defined by two opposite corner points. You need to enter the coordinated of these two opposite corners.
- Click the OK button of the dialog to return to the project workspace.
NOTES, SPECIAL CASES OR EXCEPTIONS: Box domains are specified by the coordinates of two opposite corners. Voltage Path requires a line; therefore, two of the coordinates of the two corners must be identical. Otherwise, an error message will pop up. For example, (0, 0, 0) for Corner 1 and (10, 0, 0) for Corner 2 define a Z-directed line segment. Current Loop requires a rectangle; therefore, one of the coordinates of the two corners must be identical. For example, (0, 0, 0) for Corner 1 and (10, 10, 0) for Corner 2 define a rectangle in the XY plane.
PYTHON COMMAND:
voltage_integral(label,x1,y1,z1,x2,y2,z2)
current_integral(label,x1,y1,z1,x2,y2,z2)
conduction_current_integral(label,x1,y1,z1,x2,y2,z2)
flux_electric(label,x1,y1,z1,x2,y2,z2)
flux_magnetic(label,x1,y1,z1,x2,y2,z2)
energy_electric(label,x1,y1,z1,x2,y2,z2)
energy_magnetic(label,x1,y1,z1,x2,y2,z2)
ohmic_loss(label,x1,y1,z1,x2,y2,z2)
capacitance(label,x1,y1,z1,x2,y2,z2,x3,y3,z3,x4,y4,z4)
capacitance_energy(label,x1,y1,z1,x2,y2,z2,x3,y3,z3,x4,y4,z4)
inductance(label,x1,y1,z1,x2,y2,z2,x3,y3,z3,x4,y4,z4)
inductance_energy(label,x1,y1,z1,x2,y2,z2,x3,y3,z3,x4,y4,z4)
inductance_mutual(label,x1,y1,z1,x2,y2,z2,x3,y3,z3,x4,y4,z4)
resistance(label,x1,y1,z1,x2,y2,z2,x3,y3,z3,x4,y4,z4)
resistance_power_voltage(label,x1,y1,z1,x2,y2,z2,x3,y3,z3,x4,y4,z4)
resistance_power_current(label,x1,y1,z1,x2,y2,z2,x3,y3,z3,x4,y4,z4)
flux_thermal(label,x1,y1,z1,x2,y2,z2)
energy_thermal(label,x1,y1,z1,x2,y2,z2)
FIELD INTEGRAL PARAMETERS
Parameter Name | Value Type | Units | Default Value | Notes |
---|---|---|---|---|
field integral type | option: voltage, current, conduction current, electric flux, magnetic flux, electric energy, magnetic energy, ohmic power loss, capacitance, inductance, resistance | - | voltage | - |
x1 | real numeric | project units | -10.0 | X-coordinate of Corner 1 of the first field integral |
y1 | real numeric | project units | -10.0 | Y-coordinate of Corner 1 of the first field integral |
z1 | real numeric | project units | -10.0 | Z-coordinate of Corner 1 of the first field integral |
x2 | real numeric | project units | 10.0 | X-coordinate of Corner 2 of the first field integral |
y2 | real numeric | project units | 10.0 | Y-coordinate of Corner 2 of the first field integral |
z2 | real numeric | project units | 10.0 | Z-coordinate of Corner 2 of the first field integral |
x3 | real numeric | project units | 0 | X-coordinate of Corner 1 of the second field integral |
y3 | real numeric | project units | 0 | Y-coordinate of Corner 1 of the second field integral |
z3 | real numeric | project units | 0 | Z-coordinate of Corner 1 of the second field integral |
x4 | real numeric | project units | 0 | X-coordinate of Corner 2 of the second field integral |
y4 | real numeric | project units | 0 | Y-coordinate of Corner 2 of the second field integral |
z4 | real numeric | project units | 0 | Z-coordinate of Corner 2 of the second field integral |
FIELD INTEGRAL DEFINITIONS
Field Integral | Definition | Notes |
---|---|---|
Voltage | [math] V = - \int_C \mathbf{E(r)} . \mathbf{dl} [/math] | C represents an open curve (path) |
Current | [math] I = \oint_{C_o} \mathbf{H(r)} . \mathbf{dl} [/math] | C_{o} represents a closed curve (loop) |
Conduction Current | [math] I_{cond} = \int\int_S \mathbf{J(r)} . \mathbf{ds} = \int\int_S \sigma \mathbf{E(r)} . \mathbf{ds} [/math] | S represents an open surface like a plane |
Electric Flux | [math] \Phi_E = \int\int_{S_o} \mathbf{D(r)} . \mathbf{ds} = \int\int_{S_o} \epsilon \mathbf{E(r)} . \mathbf{ds} [/math] | S_{o} represents a closed surface like a box |
Magnetic Flux | [math] \Phi_H = \int\int_S \mathbf{B(r)} . \mathbf{ds} = \int\int_S \mu \mathbf{H(r)} . \mathbf{ds} [/math] | S represents an open surface like a plane |
Electric Energy | [math] W_E = \frac{1}{2} \int \int \int_V \epsilon \vert \mathbf{E(r)} \vert ^2 dv [/math] | V represents a volume like a box |
Magnetic Energy | [math] W_H = \frac{1}{2} \int\int\int_V \mu \vert \mathbf{H(r)} \vert ^2 dv [/math] | V represents a volume like a box |
Ohmic Power Loss | [math] P_{ohmic} = \int\int\int_V \sigma \vert \mathbf{E(r)} \vert ^2 dv [/math] | V represents a volume like a box |
Capacitance | [math] C = \Phi_E/V = \int\int_{S_o} \epsilon \mathbf{E(r)} . \mathbf{ds} / \int_C \mathbf{E(r)} . \mathbf{dl} [/math] | Ratio of two field integrals |
Capacitance (Alternative) | [math] C = 2W_E/V^2 = 2 \int \int \int_V \epsilon \vert \mathbf{E(r)} \vert ^2 dv / \left( \int_C \mathbf{E(r)} . \mathbf{dl} \right)^2[/math] | Energy-based definition |
Self-Inductance | [math] L = \Phi_H/I = \int\int_S \mu \mathbf{H(r)} . \mathbf{ds} / \oint_{C_o} \mathbf{H(r)} . \mathbf{dl} [/math] | Ratio of two field integrals |
Self-Inductance (Alternative) | [math] L = 2W_M/I^2 = 2 \int \int \int_V \mu \vert \mathbf{H(r)} \vert ^2 dv / \left( \oint_{C_o} \mathbf{H(r)} . \mathbf{dl} \right)^2[/math] | Energy-based definition |
Mutual Inductance | [math] M = \Phi_H^{\prime}/I = \int\int_{S^{\prime}} \mu \mathbf{H(r)} . \mathbf{ds} / \oint_{C_o} \mathbf{H(r)} . \mathbf{dl} [/math] | S' represents an open surface or plane passing through the second (coupled) inductor and Φ'_{H} represents the magnetic flux linkage due to the magnetic field of the first inductor passing through the second inductor |
Resistance | [math] R = V/I_{cond} = - \int_C \mathbf{E(r)} . \mathbf{dl} / \int\int_S \sigma \mathbf{E(r)} . \mathbf{ds} [/math] | Ratio of two field integrals |
Resistance (Alternative 1) | [math] R = V^2/P_{ohmic} = \left( \int_C \mathbf{E(r)} . \mathbf{dl} \right)^2 / \int\int\int_V \sigma \vert \mathbf{E(r)} \vert ^2 dv [/math] | Power-based definition |
Resistance (Alternative 2) | [math] R = P_{ohmic}/I_{cond}^2 = \int\int\int_V \sigma \vert \mathbf{E(r)} \vert ^2 dv / \left( \int\int_S \sigma \mathbf{E(r)} . \mathbf{ds} \right)^2[/math] | Power-based definition |
Thermal Flux | [math] \Phi_T = \int\int_{S_o} \mathbf{q(r)} . \mathbf{ds} [/math] | S_{o} represents a closed surface like a box |
Thermal Energy | [math] W_T = Q = \int \int \int_V \rho_V c_p \left( T\mathbf{(r)} - T_{env} \right) dv [/math] | V represents a volume like a box |
FIELD INTEGRAL OUTPUT DATA FILES
Data File Name | Data Type | Description |
---|---|---|
Voltage.DAT | 2D real scalar data | voltage computed from the integral of E-field |
Current.DAT | 2D real scalar data | current computed from Ampere's loop integral of H-field |
Conduction_Current.DAT | 2D real scalar data | total current computed from the surface integral of volume current density J = σE |
flux_E.DAT | 2D real scalar data | the total electric flux passing through a specified box |
flux_H.DAT | 2D real scalar data | the total magnetic flux passing through a specified rectangular plane |
energy_E.DAT | 2D real scalar data | the total electric energy stored in a specified box |
energy_H.DAT | 2D real scalar data | the total magnetic energy stored in a specified box |
ohmic.DAT | 2D real scalar data | the total Ohmic power dissipated in a specified box |
capacitance.DAT | 2D real scalar data | capacitance computed from the electric flux and voltage |
inductance.DAT | 2D real scalar data | self-inductance computed from the magnetic flux and current |
mutual_inductance.DAT | 2D real scalar data | mutual inductance between two objects computed from the magnetic flux and current |
resistance.DAT | 2D real scalar data | resistance computed from the voltage and conduction current |
flux_T.DAT | 2D real scalar data | the total thermal flux passing through a specified box |
energy_T.DAT | 2D real scalar data | the total thermal energy stored in a specified box |
Surface Plot
ICON: None
MODULE: EM.Tempo, EM.Illumina, EM.Ferma, EM.Picasso, EM.Libera
FUNCTION: Displays the variation of a 3D Cartesian data set of the form z = f(x,y) on a specified principal plane
TO PLOT A CARTESIAN GRAPH:
- You can visualize 3D Cartesian data or electric and magnetic field distributions as 3D surface plots.
- Select a 3D Cartesian data file iwth a .CAR file extension or a field sensor data file with a .SEN file extension in the Data Manager's "3D Data Files" tab and click the Graph Settings button.
- From the drop-down list labeled Graph Type, choose the Surface option. Close the graph settings dialog and return to the Data Manager. With the 3D data file selected, click the Plot button of Data Manager.
- Alternatively, you can define two NumPy vectors X and Y and a matrix Z in the Python Interpreter and use the emag_plot_surface(...) function.
PYTHON COMMAND(S): emag_plot_surface(x,y,z_matrix,title="New Graph",x_label="x",y_label="y",*args,**kwargs)
emag_plot_car_surf(file_name,title="",FRColor=(1,1,1),BKColor=(1,1,1),margins=(0.15,0.1,0.1,0.1,0.2,0.2,0.8,0.9,0.5,0.5),*args,**kwargs)
emag_plot_sen_surf(file_name,title="",FRColor=(1,1,1),BKColor=(1,1,1),margins=(0.15,0.1,0.1,0.1,0.2,0.2,0.8,0.9,0.5,0.5),*args,**kwargs)
emag_plot_sen_tempo_surf(file_name,input_name,grid_name,title="",FRColor=(1,1,1),BKColor=(1,1,1),margins=(0.15,0.1,0.1,0.1,0.2,0.2,0.8,0.9,0.5,0.5),*args,**kwargs)
emag_plot_sen_ferma_surf(file_name,title="",FRColor=(1,1,1),BKColor=(1,1,1),margins=(0.15,0.1,0.1,0.1,0.2,0.2,0.8,0.9,0.5,0.5),*args,**kwargs)
Temporal Field Probe Observable
MODULE: EM.Tempo
FUNCTION: Monitors time-domain and frequency-domain electric and magnetic field components at a specified point in space
TO DEFINE A FIELD PROBE:
- Right-click on the Temporal Field Probes item in the navigation tree of EM.Tempo.
- Select Insert New Observable... to open up the Field Probe Dialog.
- By default, the field probe is placed at the origin of coordinates. Enter new (X,Y,Z) coordinates for the desired location.
- Click the OK button of the dialog to return to the project workspace.
NOTES, SPECIAL CASES OR EXCEPTIONS: By default, all the six electric and magnetic field components are computed at the center of the Yee cell. This involves interpolation and averaging among neighboring cells. If you uncheck the box labeled "Compute Fields at the Center of Yee Cell", then the probe field components will reflect those of the original Yee cell locations.
PYTHON COMMAND: field_probe(label,x0,y0,z0)
FIELD PROBE PARAMETERS
Parameter Name | Value Type | Units | Default Value | Notes |
---|---|---|---|---|
x0 | real numeric | project units | 0 | X-coordinates of probe location |
y0 | real numeric | project units | 0 | Y-coordinate of probe location |
z0 | real numeric | project units | 0 | Z-coordinate of probe location |
start frequency | real numeric | Hz | fc-bw/2 | lower end of frequency range for Fourier transform computation |
end frequency | real numeric | Hz | fc+bw/2 | higher end of frequency range for Fourier transform computation |
FIELD PROBE'S OUTPUT DATA FILES
Data File Name | Data Type | Description |
---|---|---|
ProbeName_X_E_Time.DAT | 2D real scalar data | time-domain Ex electric field data |
ProbeName_Y_E_Time.DAT | 2D real scalar data | time-domain Ey electric field data |
ProbeName_Z_E_Time.DAT | 2D real scalar data | time-domain Ez electric field data |
ProbeName_X_H_Time.DAT | 2D real scalar data | time-domain Hx magnetic field data |
ProbeName_Y_H_Time.DAT | 2D real scalar data | time-domain Hy magnetic field data |
ProbeName_Z_H_Time.DAT | 2D real scalar data | time-domain Hz magnetic field data |
ProbeName_X_E_Fre.CPX | 2D complex scalar data | frequency-domain Ex electric field data |
ProbeName_Y_E_Fre.CPX | 2D complex scalar data | frequency-domain Ey electric field data |
ProbeName_Z_E_Fre.CPX | 2D complex scalar data | frequency-domain Ez electric field data |
ProbeName_X_H_Fre.CPX | 2D complex scalar data | frequency-domain Hx magnetic field data |
ProbeName_Y_H_Fre.CPX | 2D complex scalar data | frequency-domain Hy magnetic field data |
ProbeName_Z_H_Fre.CPX | 2D complex scalar data | frequency-domain Hz magnetic field data |