Changes

Glossary of EM.Cube's Sources & Devices

18,432 bytes removed, 14:11, 17 February 2021
[[Image:SOURCE MAN2.png|thumb|left|480px|The distributed source dialog.]]
</td>
</tr>
</table>
 
== Embedded PEC Via Set ==
 
ICON: [[File:pec_group_icon.png]]
 
MODULE: [[EM.Picasso]]
 
FUNCTION: Defines an embedded PEC via object set group
 
TO DEFINE A PEC VIA SET:
 
# Right-click on the '''Embedded Object Sets''' item in the navigation tree.
# Select '''Insert New PEC Via Set...''' to open up the New PEC Vias Set Dialog.
# From the drop-down list labeled '''Host Layer''', select the substrate layer to embed the new via set.
# Change the color or texture of the via set if desired.
# Click the <b>OK</b> button of the dialog to return to the project workspace.
 
 
PYTHON COMMAND:
 
pec_via_group(label,host_layer)
 
 
EMBEDDED PEC VIA SET PARAMETERS
{| class="wikitable"
|-
! scope="col"| Parameter Name
! scope="col"| Value Type
! scope="col"| Units
! scope="col"| Default Value
! scope="col"| Notes
|-
! scope="row" | Locked mesh density
| Real Numeric
| cells/effective wavelength
| 30
| Only if "Lock Mesh" enabled
|}
 
<table>
<tr>
<td> [[Image:MATER MAN20.png|thumb|left|480px|The PEC via set dialog.]] </td>
</tr>
</table>
 
== Fixed-Potential PEC ==
 
ICON: [[File:pec_group_icon.png]]
 
MODULE: [[EM.Ferma]]
 
FUNCTION: Defines an equi-potential perfect electric conductor object group with a specified voltage
 
TO DEFINE A FIXED-POTENTIAL PEC GROUP:
 
# Right-click on the '''Fixed-Potential PEC Objects''' item in the navigation tree.
# Select '''Insert New Fixed-Potential PEC...''' to open up the Fixed-Potential PEC dialog.
# Besides the color and texture properties, you have to enter a value for the fixed '''Voltage''' in Volts. The default voltage is 0V.
# Click the <b>OK</b> button of the dialog to return to the project workspace.
 
 
PYTHON COMMAND: pec_voltage_group(label,voltage)
 
 
FIXED-POTENTIAL PEC PARAMETERS
{| class="wikitable"
|-
! scope="col"| Parameter Name
! scope="col"| Value Type
! scope="col"| Units
! scope="col"| Default Value
! scope="col"| Notes
|-
! scope="row" | voltage
| Real Numeric
| Volts
| 0
| -
|-
! scope="row" | Locked mesh density
| Real Numeric
| cells/effective wavelength
| 30
| Only if "Lock Mesh" enabled
|}
 
<table>
<tr>
<td> [[Image:MATER MAN22.png|thumb|left|480px|The fixed-potential PEC dialog.]] </td>
</tr>
</table>
 
== Fixed-Temperature PTC ==
 
ICON: [[File:pec_group_icon.png]]
 
MODULE: [[EM.Ferma]]
 
FUNCTION: Defines an iso-thermal perfect thermal conductor object group with a specified temperature
 
TO DEFINE A FIXED-TEMPERATURE PTC GROUP:
 
# Right-click on the '''Fixed-Temperature PTC Objects''' item in the navigation tree.
# Select '''Insert New Fixed-Potential PEC/PTC...''' to open up the Fixed-Temperature PTC dialog.
# Besides the color and texture properties, you have to enter a value for the fixed '''Temperature''' in degrees C. The default voltage is 0&deg;C.
# Click the <b>OK</b> button of the dialog to return to the project workspace.
 
 
PYTHON COMMAND: pec_voltage_group(label,voltage)
 
 
FIXED-TEMPERATURE PTC PARAMETERS
{| class="wikitable"
|-
! scope="col"| Parameter Name
! scope="col"| Value Type
! scope="col"| Units
! scope="col"| Default Value
! scope="col"| Notes
|-
! scope="row" | temperature
| Real Numeric
| Deg C
| 0
| -
|-
! scope="row" | Locked mesh density
| Real Numeric
| cells/effective wavelength
| 30
| Only if "Lock Mesh" enabled
|}
 
<table>
<tr>
<td> [[Image:MATER MAN22.png|thumb|left|480px|The fixed-temperature PTC dialog.]] </td>
</tr>
</table>
[[Image:SOURCE MAN7.png|thumb|left|480px|The Hertzian short dipole source dialog.]]
</td>
</tr>
</table>
 
== Impedance Surface ==
 
ICON: [[File:voxel_group_icon.png]]
 
MODULE: [[EM.Illumina]]
 
FUNCTION: Defines an impedance surface object group
 
TO DEFINE AN IMPEDANCE SURFACE GROUP:
 
# Right-click on the '''Impedance Surfaces''' item in the navigation tree.
# Select '''Insert New Impedance Surface...''' to open up the impedance Surface dialog.
# Besides the color and texture properties, you have to enter values for the real and imaginary parts of '''Surface Impedance'''. The default values are 0 + j0 &Omega;, representing a PEC surface.
# Click the <b>OK</b> button of the dialog to return to the project workspace.
 
NOTES, SPECIAL CASES OR EXCEPTIONS: An impedance surface is a surface on which the tangential electric and magnetic fields are governed by the surface impedance boundary condition (SIBC):
 
:<math> \mathbf{\hat{n}} \times \mathbf{\hat{n}} \times \mathbf{E} = -Z_s \mathbf{J_s} = -Z_s \mathbf{\hat{n}} \times \mathbf{H} </math>
 
where <math>Z_s</math> is the surface impedance in Ohms and <math>\mathbf{\hat{n}}</math> is the unit outward normal on the given surface.
 
 
PYTHON COMMAND: impedance_surface_group(label,z_real,z_imag)
 
 
IMPEDANCE SURFACE PARAMETERS
{| class="wikitable"
|-
! scope="col"| Parameter Name
! scope="col"| Value Type
! scope="col"| Units
! scope="col"| Default Value
! scope="col"| Notes
|-
! scope="row" | resistance
| Real Numeric
| Ohm
| 0.0
| real part of surface impedance
|-
! scope="row" | reactance
| Real Numeric
| Ohm
| 0.0
| imaginary part of surface impedance
|-
! scope="row" | Locked mesh density
| Real Numeric
| cells/effective wavelength
| 30
| Only if "Lock Mesh" enabled
|}
 
<table>
<tr>
<td> [[Image:MATER MAN17.png|thumb|left|720px|The impedance surface dialog.]] </td>
</tr>
</table>
 
== Impenetrable Surface ==
 
ICON: [[File:impenet_group_icon.png]]
 
MODULE: [[EM.Terrano]]
 
FUNCTION: Defines an impenetrable surface block group
 
TO DEFINE AN IMPENETRABLE SURFACE GROUP:
 
# Right-click on the '''Impenetrable Surfaces''' item in the navigation tree.
# Select '''Insert New Block...''' to open up the Impenetrable Surface dialog.
# In the material table, the default setting shows '''Brick''' with a relative permittivity of &epsilon;<sub>r</sub> = 4.44 and an electric conductivity of &sigma; = 0.001S/m.
# You can change the default material composition by selecting and highlighting it in the table and clicking the {{key|Add/Edit}} button of the dialog.
# In the Material Layer Properties dialog, either enter new values for &epsilon;<sub>r</sub> and &sigma; or click the {{key|Material}} button of this dialog to open [[EM.Cube]]'s Materials List and select one of its entries.
# You can add several layers to your impenetrable surface composition. In that case, you need to define a thickness for each layer. The bottommost layer always has an infinite thickness representing an unbounded half-space medium as seen by an incident ray.
# After you complete the definition of all layers, click the <b>OK</b> button of the dialog to return to the project workspace.
 
 
PYTHON COMMAND: impenetrable_surface_group(label,epsilon,sigma[,rr,gg,bb])
 
 
IMPENETRABLE SURFACE PARAMETERS
{| class="wikitable"
|-
! scope="col"| Parameter Name
! scope="col"| Value Type
! scope="col"| Units
! scope="col"| Default Value
! scope="col"| Notes
|-
! scope="row" | epsilon
| Real Numeric
| -
| 4.44
| relative permittivity
|-
! scope="row" | sigma
| Real Numeric
| S/m
| 1e-3
| electric conductivity
|-
! scope="row" | Locked mesh density
| Real Numeric
| cells/effective wavelength
| 30
| Only if "Lock Mesh" enabled
|}
 
<table>
<tr>
<td> [[Image:MATER MAN23.png|thumb|left|480px|The impenetrable surface dialog.]] </td>
</tr>
</table>
[[Image:Lumped Par_RC.png|thumb|left|480px|The lumped device dialog with the Parallel RC device type selected.]]
</td>
</tr>
</table>
 
== Point Radiator Set ==
 
ICON: [[File:base_group_icon.png]]
 
MODULE: [[EM.Terrano]]
 
FUNCTION: Defines a base location set group to be associated with a transmitter or receiver set
 
TO DEFINE A BASE LOCATION SET GROUP:
 
# Right-click on the '''Base Locataions''' item in the navigation tree.
# Select '''Insert New Point Set...''' to open up the base Location Set dialog.
# The only property of a base location set is its color, which you can change from this dialog.
# Click the <b>OK</b> button of the dialog to return to the project workspace.
# By default, the transmitter set is assumed to be made up of vertical half-wave radiators.
# You may also force the transmitters 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 transmitter set.
# You can open the property dialog of the transmitter 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.
# An imported radiation pattern file typically contains a total radiated power parameter at its file header. By default, this value is overridden and the '''Custom Power''' check box is checked. A default total power of 1W is assigned to each transmitter, which you can change to any arbitrary value. Or you may uncheck '''Custom Power''' to use the imported value of the total radiated power.
 
 
PYTHON COMMAND radiator_custom_group(label,pattern_file,rot_x,rot_y,rot_z,rr,gg,bb)
 
 
POINT RADIATOR SET PARAMETERS:
 
{| class="wikitable"
|-
! scope="col"| Parameter Name
! scope="col"| Value Type
! scope="col"| Units
! scope="col"| Default Value
! scope="col"| Notes
|-
! scope="row" | radiator type
| options: vertical half-wave dipole, user define antenna
| -
| vertical half-wave dipole
| -
|-
! scope="row" | 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 antenna
|-
! scope="row" | rot_x
| real numeric
| degrees
| 0
| additional rotation angle of the imported radiation pattern about the local X-axis
|-
! scope="row" | rot_y
| real numeric
| degrees
| 0
| additional rotation angle of the imported radiation pattern about the local Y-axis
|-
! scope="row" | rot_z
| real numeric
| degrees
| 0
| additional rotation angle of the imported radiation pattern about the local Z-axis
|}
 
 
<table>
<tr>
<td> [[Image:MATER MAN27.png|thumb|left|480px|The base location set dialog.]] </td>
</tr>
</table>
 
== Point Scatterer Set ==
 
ICON: [[File:scatterer_group_icon.png]]
 
MODULE: [[EM.Terrano]]
 
FUNCTION: Defines a point scatterer set group to be used as one or more targets in a radar simulation
 
TO DEFINE A POINT SCATTERER SET GROUP:
 
# Right-click on the '''Point Scatterers''' item in the navigation tree.
# Select '''Insert New Scatterer Set...''' to open up the Point Scatterer Set dialog.
# You can change the color of the scatterer set from this dialog.
# In the section titled "Polarimetric Scattering Matrix Data File", use the {{key|Import...}} button to browse the folder on your computer. Clicking the {{key|Import...}} button opens the Windows Explorer window. Select a file with a ".DAT" file extension, whose name ends in '''polar_scat'''.
# Click the <b>OK</b> button of the dialog to return to the project workspace.
 
 
PYTHON COMMAND: scatterer_group(label,polar_scat_file[,rr,gg,bb])
 
 
POINT SCATTERER SET PARAMETERS:
{| class="wikitable"
|-
! scope="col"| Parameter Name
! scope="col"| Value Type
! scope="col"| Units
! scope="col"| Default Value
! scope="col"| Notes
|-
! scope="row" | scattering matrix file
| file path
| -
| Models\POLAR_SCAT.DAT
| imported polarimetric scattering matrix data file with a ".DAT" file extension and a name ending in "polar_scat"
|}
 
<table>
<tr>
<td> [[Image:MATER MAN27A.png|thumb|left|480px|The point scatterer set dialog.]] </td>
</tr>
</table>
[[Image:SOURCE MAN8.png|thumb|left|480px|The strip gap circuit source dialog.]]
</td>
</tr>
</table>
 
== Thin Wire ==
 
ICON: [[File:thin_group_icon.png]]
 
MODULE: [[EM.Tempo]], [[EM.Libera]]
 
FUNCTION: Defines a thin wire object group with a specified wire radius
 
TO DEFINE A THIN WIRE GROUP:
 
# Right-click on the '''Thin Wires''' item in the navigation tree.
# Select '''Insert New Thin Wire...''' to open up the Thin Wire dialog.
# Enter a value for the '''Wire Radius'''.
# Click the <b>OK</b> button of the dialog to return to the project workspace.
 
 
PYTHON COMMAND: thinwire_group(label,radius)
 
 
THIN WIRE PARAMETERS
{| class="wikitable"
|-
! scope="col"| Parameter Name
! scope="col"| Value Type
! scope="col"| Units
! scope="col"| Default Value
! scope="col"| Notes
|-
! scope="row" | Wire radius
| Real Numeric
| project units
| 0.3
| -
|-
! scope="row" | Locked mesh density
| Real Numeric
| cells/effective wavelength
| 50
| "Lock Mesh" enabled by default
|}
 
<table>
<tr>
<td> [[Image:MATER MAN2.png|thumb|left|480px|The thin wire dialog.]] </td>
</tr>
</table>
 
== Volume Charge ==
 
ICON: [[File:aniso_group_icon.png]]
 
MODULE: [[EM.Ferma]]
 
FUNCTION: Defines a volume charge source group with a specified charge density
 
TO DEFINE A VOLUME CHARGE GROUP:
 
# Right-click on the '''Volume Charges''' item in the navigation tree.
# Select '''Insert New Volume Charge...''' to open up the Volume Charge Source dialog.
# You have two options to choose from: '''Uniform''' and '''Inhomogeneous'''.
# If you choose the uniform option, you have to enter a numeric value for '''Charge Density''' in C/m^3.
# If you choose the inhomogeneous option, you have to enter an expression for '''Charge Density''' in the global (x,y,z) coordinates.
# Click the <b>OK</b> button of the dialog to return to the project workspace.
 
 
PYTHON COMMAND: charge_group(label,density)
 
 
VOLUME CHARGE PARAMETERS
{| class="wikitable"
|-
! scope="col"| Parameter Name
! scope="col"| Value Type
! scope="col"| Units
! scope="col"| Default Value
! scope="col"| Notes
|-
! scope="row" | density
| Real Numeric
| C/m^3
| -1e-5
| volume charge density with a positive or negative sign
|}
 
<table>
<tr>
<td> [[Image:MATER MAN13.png|thumb|left|480px|The volume charge source dialog.]] </td>
</tr>
</table>
 
== Volume Current ==
 
ICON: [[File:voxel_group_icon.png]]
 
MODULE: [[EM.Ferma]]
 
FUNCTION: Defines a volume current source group with a specified current density vector
 
TO DEFINE A VOLUME CURRENT GROUP:
 
# Right-click on the '''Volume Currents''' item in the navigation tree.
# Select '''Insert New Volume Current...''' to open up the Volume Current Source dialog.
# You have two options to choose from: '''Uniform''' and '''Inhomogeneous'''.
# If you choose the uniform option, you have to enter three numeric values for the three components of volume current density '''Jx''', '''Jy''' and '''Jz''' in A/m^2.
# If you choose the inhomogeneous option, you have to enter three expressions for the three components of volume current density '''Jx''', '''Jy''' and '''Jz''' in the global (x,y,z) coordinates.
# Click the <b>OK</b> button of the dialog to return to the project workspace.
 
 
PYTHON COMMAND: volume_current_group(label,Jx,Jy,Jz)
 
 
VOLUME CURRENT PARAMETERS
{| class="wikitable"
|-
! scope="col"| Parameter Name
! scope="col"| Value Type
! scope="col"| Units
! scope="col"| Default Value
! scope="col"| Notes
|-
! scope="row" | Jx
| Real Numeric
| A/m^2
| 0.0
| X-component of volume current density vector
|-
! scope="row" | Jy
| Real Numeric
| A/m^2
| 0.0
| Y-component of volume current density vector
|-
! scope="row" | Jz
| Real Numeric
| A/m^2
| 1.0
| Z-component of volume current density vector
|}
 
<table>
<tr>
<td> [[Image:MATER MAN14.png|thumb|left|480px|The volume current source dialog.]] </td>
</tr>
</table>
 
== Volume Heat Source ==
 
ICON: [[File:aniso_group_icon.png]]
 
MODULE: [[EM.Ferma]]
 
FUNCTION: Defines a volume heat source group with a specified heat density
 
TO DEFINE A VOLUME HEAT SOURCE GROUP:
 
# Right-click on the '''Volume Heat Sources''' item in the navigation tree.
# Select '''Insert New Volume Heat Source...''' to open up the Volume Heat Source dialog.
# You have two options to choose from: '''Uniform''' and '''Inhomogeneous'''.
# If you choose the uniform option, you have to enter a numeric value for '''Heat Density''' in W/m^3.
# If you choose the inhomogeneous option, you have to enter an expression for '''Heat Density''' in the global (x,y,z) coordinates.
# Click the <b>OK</b> button of the dialog to return to the project workspace.
 
 
PYTHON COMMAND: charge_group(label,density)
 
 
VOLUME HEAT SOURCE PARAMETERS
{| class="wikitable"
|-
! scope="col"| Parameter Name
! scope="col"| Value Type
! scope="col"| Units
! scope="col"| Default Value
! scope="col"| Notes
|-
! scope="row" | density
| Real Numeric
| W/m^3
| -1e-5
| volume heat density with a positive or negative sign
|}
 
<table>
<tr>
<td> [[Image:MATER MAN13.png|thumb|left|480px|The volume heat source dialog.]] </td>
</tr>
</table>
[[Image:SOURCE MAN6.png|thumb|left|480px|The waveguide port source dialog.]]
</td>
</tr>
</table>
 
== Wire Current ==
 
ICON: [[File:thin_group_icon.png]]
 
MODULE: [[EM.Ferma]]
 
FUNCTION: Defines a wire current source group with a specified current and wire radius
 
TO DEFINE A WIRE CURRENT GROUP:
 
# Right-click on the '''Wire Current''' item in the navigation tree.
# Select '''Insert New Wire Current...''' to open up the Wire Current dialog.
# Enter a value for the total '''Current''' flowing in the wire in Amperes as well as a value for '''Wire Radius''' in the project units.
# You may assume that the wire current consists of multiple turns or multiple bundled wires. The default number of turns is 1, but you can change it.
# The current flowing in the wire is directional. You may need to check the box labeled '''Reverse Current''' if you prefer the opposite direction.
# Click the <b>OK</b> button of the dialog to return to the project workspace.
 
NOTES, SPECIAL CASES OR EXCEPTIONS: [[EM.Ferma]] allows you to define idealized wire current sources. You can use this source type to model filament currents or coils. Wire currents are defined using only line and polyline objects. You also need to define a current value I in Amperes and a wire radius r in the project units. The line or polyline object is then approximated as a volume current with a current density of J = I/(&pi;r<sup>2</sup>) flowing along the line or polyline side's direction.
 
{{Note| If you draw curve CAD objects under a wire current group, they will be permanently converted to polyline objects before running the simulation engine.}}
 
 
PYTHON COMMAND: wire_current_group(label,current,wire_radius)
 
 
WIRE CURRENT PARAMETERS
{| class="wikitable"
|-
! scope="col"| Parameter Name
! scope="col"| Value Type
! scope="col"| Units
! scope="col"| Default Value
! scope="col"| Notes
|-
! scope="row" | current
| Real Numeric
| A
| 1.0
| total current flowing through the wire
|-
! scope="row" | wire_radius
| Real Numeric
| project units
| 0.5
| -
|-
! scope="row" | wire_count
| Integer Numeric
| -
| 1
| number of collocated wires or loop turns
|}
 
<table>
<tr>
<td> [[Image:MATER MAN16.png|thumb|left|480px|The wire current source dialog.]] </td>
</tr>
</table>
4,622
edits