CST Studio Suite - FEST3D User Manual
CST Studio Suite - FEST3D User Manual
1 Table of Contents
1. Table of Contents 1-4
2. FEST3D Online Help 5
Terms and Concepts Terms and concepts widely used in FEST3D and in this documentation.
Features
FEST3D is an efficient software tool for the accurate analysis of passive components based on waveguide technology.
FEST3D is the first commercial software capable to integrate high power effects in the design process.
Analysis
FEST3D is able to efficiently analyse different type of passive microwave structures in waveguide technology. Basically,
FEST3D is based on an integral equation technique combined with the Method of Moments. Additionally, the
Boundary Integral-Resonant Mode Expansion (BI-RME) method is employed for extracting the modal chart of
waveguides with non-canonical shapes. These methods ensure a high degree of accuracy as well as reduced
computational resources (in terms of CPU time and memory).
On this basis, FEST3D is capable to simulate complex microwave devices in extremely short times (of the order of
seconds or few minutes) whereas general purpose software (based on segmentation techniques such as finite
elements or finite differences) can spend hours for the same calculation.
Furthermore, unlike mode-matching techniques, the electromagnetic algorithms employed in FEST3D minimize the
problems of relative convergence leading to more confident results. Moreover, the integral equation technique
extracts part of the frequency dependent computations, allowing a faster computational time per frequency point
when compared to mode-matching techniques. This benefit is more evident when many modes are required for an
accurate analysis of the component.
Based on these methods, the user can analyze a wide range of passive components with FEST3D:
Filters (dual-mode, evanescent, bandstop, interdigital, waffle-iron...)
Multiplexers
Dual-mode filters
Couplers
Polarizers
Waffle-iron filters
Synthesis
FEST3D includes the possibility to automatically design several types of components from the user specifications
making use of the so-called Synthesis Tools. Up to now, the user can easily design band-pass filters, low-pass filters,
rectangular tapers, dual-mode filters in circular wavwguide.
The synthesis stage performs full-wave simulations to consider higher waveguide modes. Thanks to this and to
particular algorithms employed in each case, the synthesis process provides very good responses with respect to the
user specifications. In particular, bandpass filters can be designed with up to 25-230 % of BW without the need of
post-optimization, as well as dual-mode filters in circular waveguide with different order and making use of different
resonant modes.
Once the synthesis process is finished, the full structure is simulated and the full-wave result is shown.
Optimization
FEST3D has an optimization tool (OPT) for the refinement of the component geometrical parameters to get the
desired response. The OPT supports multiple optimisation algorithms such as:
The OPT also supports weighted constraints in the form of equalities or inequalities between a left and a right
expression of the parameters being optimised. This allows, for instance, controlling the maximum length of a filter or
to ensure that an element length is larger than a particular value.
The OPT progress can be monitored in real time, as well as stopped, reconfigured and resumed from the Graphical
User Interface (GUI) at any time. Moreover, the results from the previous optimization iteration and the current one
are shown, which allows identifying the source of the improvement in the response.
Tolerances
FEST3D also allows performing tolerace analysis in the components by varying their dimensions according to a
gaussian deviation. The different tries are shown altogether and the user can control the whole process.
High Power
FEST3D can be easily used to analyse high-power breakdown phenomena in several type of components. In particular,
multipactor and corona (arcing) modules are fully integrated into FEST3D which is capable to determine the
breakdown level in complex passive components.
Export 3D geometry
FEST3D can export the 3D geometry to SAT format. This allows an easy interaction with other EM tools and using
FEST3D exported file in, e. g., milling machines.
Circuit The kind of circuit currently supported by FEST3D: passive, linear millimeter-wave or microwave
circuit composed on cascaded discontinuities based on rectangular and circular waveguides (and
perturbed variants of them). The full list of the supported waveguides and discontinuities is
available in the Elements Database.
Element The term element is very generic. In FEST3D it indicates each elementary building block of a
passive, linear millimeter-wave or microwave circuit. A synonym also used in FEST3D is
component. The elements, or components, supported by FEST3D are divided in two classes:
waveguides and discontinuities. See also the Elements Database.
Waveguide A classic microwave waveguide, optionally open-ended (I/O port) or closed on a load, and
attached to something else (one or two discontinuities). A whole section of this manual is
dedicated to the various waveguides supported by FEST3D.
Discontinuity A component connecting two or more waveguides. Discontinuities often have a non-uniform
cross-section and may have non-trivial 3D geometry. In FEST3D you can only connect a
waveguide to a discontinuity, and vice-versa. A whole section of this manual is dedicated to the
various discontinuities supported by FEST3D.
Port Ports are used to connect elements together. Each element has a number of ports equal to the
number of elements it is connected to. Each port of an element is connected to a port of another
element. The connections between elements are represented as black lines in the GUI.
GUI Graphical User Interface. The part of a program devoted to interaction with the user. The FEST3D
GUI activates the other parts of FEST3D on user demand, by launching external executables.
EMCE ElectroMagnetic Computational Engine. The part of FEST3D that actually performs the simulation
of millimeter-wave and microwave circuits.
OPT OPTimization service. The part of FEST3D devoted to optimization. In order to optimize a circuit,
the OPT repeatedly invokes the EMCE. See the Optimizer section in this manual.
Synthesis Additional programs integrated in FEST3D, capable of performing microwave circuits synthesis
Tools from user specifications. See the Synthesis Tools section in this manual.
Engineering Additional programs integrated in FEST3D, used to perform unit conversions and small
Tools computations. See the Engineering Tools section in this manual.
Convergence Convergence Study is an essential technique to reasonably ensure the accuracy of EMCE results.
Study A brief, but incomplete, summary is that the simulation must always start with low numeric
accuracy parameters, continuously increasing them until the response converges. A single
simulation with high numeric accuracy parameters is definitely not enough to ensure accuracy of
the results. In FEST3D, numeric precision parameters include all the number of modes and also
element-specific parameters.
See also the tutorial section Accuracy or Speed?
MoM Method of Moments. A mathematical model of microwave propagation physics, used in FEST3D.
BI-RME Boundary Integral - Resonant Mode Expansion. A very efficient electromagnetic model of
microwave propagation physics, used in FEST3D.
1. The First Circuit is a step by step guide to the creation of a simple microwave circuit.
2. Running the Simulation shows you how to configure and execute the analysis (simulation) of a microwave
circuit.
3. Accuracy or Speed? introduces you in the world of numeric methods, where high accuracy often means long
computation time.
4. The Arbitrary Shape Editor shows you how to create and edit the arbitrary shapes used by some elements.
5. Optimizer is a group of tutorials describing how use the FEST3D Optimizer:
5.1 Optimizer: setup describes how to prepare a circuit for optimization and how to configure FEST3D
Optimizer.
5.2 Optimizer: run shows how to start an interactive optimization and what you can do during it.
6. EM field analysis is a step-by-step guide on how to use the EM field analysis module
7. Multipactor analysis is a step-by-step guide on how to use the Multipactor analysis module for single and
multi-carrier signals.
8. Corona analysis is a step-by-step guide on how to use the Corona analysis module
In order to interactively view the 3D geometry of the circuit, click on the icon: the 3D Viewer window will open.
In this example, the circuit is composed by five rectangular waveguides ( ) and four steps ( ). The black lines
represent the connections among them.
As you can see, FEST3D main window is divided in three parts:
The menubar lets you access most FEST3D features, including the usual File Load and Save, cut-and-paste and
FEST3D specific features. The complete description of menubar contents is in the Main Window Menubar section in
this manual.
The toolbar duplicates the most used features of the menubar for faster access.
The canvas in the center contains the current circuit and lets you edit it.
The canvas on the bottom is used to show the output information of a simulation.
In the right side there is a bar containing the FEST3D elements (elements bar). This bar is used to select the element
to be created in the main canvas. The elements bar can be hidden and pop-up by means of the rectangular icon in
the toolbar.
Creating elements
In FEST3D, creating an element consists in two steps:
1. click on the icon of the element type you want from the elements bar. The icon will stay pressed.
2. click on the canvas. An element of that type will be added where you clicked.
If you click again on the canvas background (not on an element or a connection) further elements of the same type
will be added.
Let's say you want to create the asymmetric one-pole filter seen above. For this purpose, create five rectangular
waveguides and four steps. You should obtain something like the left figure:
Now click on the menubar command structure | show icons. The elements should change to something like the right
figure. If the numbers are ordered differently, you can move the element around as explained below. This is not
needed in general (there is no requirement that the elements you connect have any particular ordering), but you
would better know how to perform such basic operations on elements.
You can move elements on the icon button at the top of the elements bar, then press mouse left
button on an element in the canvas and drag it.
You can select more than one element by pressing mouse left button on the canvas background, then dragging the
mouse. A rectangular selection area will be created, and all elements inside it will be selected.
You can now move all selected elements at once by dragging them with the mouse.
You can also cut, copy or delete all selected elements at once using the corresponding commands in the menubar or
in the toolbar.
After a cut or copy, you can undo the operation or you can paste the contents of the clipboard using the
corresponding commands in the menubar or in the toolbar.
Now that you have learned how to do it, order all the elements as shown in the right picture above and proceed with
the next part of this tutorial.
Editing elements
This part of the tutorial explains how to view and edit the properties of the created elements.
Click with the right mouse button on the rectangular waveguide [1] you created in the canvas. The following
Now you can enter the values for the geometric parameters A, B and L (in millimeters) of the rectangular waveguide.
In this tutorial you are building the one-pole cavity seen above, so enter the following values then click on the OK
button:
A 22.86
B 10.16
L 10.0
Since these dimensions correspond to a standard waveguide, you could have clicked on the standard waveguide
box, and select the WR-90. Doing this, the A and B dimensions (22.86, 10.16) are automatically obtained.
The rectangular waveguide [2] of the circuit has different geometric parameters: A 8.0, B 10.16, L 2.0.
The rectangular waveguide [3] has geometric parameters: A 22.86, B 10.16, L 15.0.
The rectangular waveguide [4] has the same geometric parameters as [2]: A 8.0, B 10.16, L 2.0.
The rectangular waveguide [5] has the same geometric parameters as [1]: A 22.86, B 10.16, L 10.0.
In general you may also want to edit the waveguides Common Properties, but in this case you can leave them to the
default values.
You need instead to change the SubType of rectangular waveguides [1] and [5] to Input/Output Port, in order to
inform FEST3D that they will be the external interfaces of the circuit. Set rectangular waveguide [1] to have I/O Port
The step [2] is identical to step [1] but of opposite sign, edit it too and enter the values: X -4.0, Y 0.0, Rot 0.0.
The step [3] and step [4], have instead the following values: X 5.0, Y 0.0, Rot 0.0. and X -5.0, Y 0.0, Rot 0.0.,
respectively,
That's all. In the next part of this tutorial you will connect the elements together.
Connecting elements
This part of the tutorial explains how to create and edit the connections among elements.
Click on the connect ( ) button at the top of the elements bar. The mouse pointer shape will change to a
pencil.
Press and hold the left mouse button on the first rectangular waveguide. Drag the mouse to the first step: a black
line connecting the two elements will appear. Release the left mouse button.
Repeat the same procedure until you completed all the connections as in the left figure:
Click again on the menubar structure -> show icons command, you will obtain the right figure.
You can delete connections by clicking on the arrow ( ) button at the top of the elements bar, then
press mouse left button on a connection in the canvas to select it, finally click on the menubar edit -> delete
command or hit the delete key on the keyboard.
In FEST3D there is a subtlety in definition of the connections. The reason is that for some discontinuities (Step, N-Step,
T-Junction, Constant width/height arbitrary shape, Y-Junction) the various ports where you can connect waveguides
are not equivalent. But when you connect two elements, you have no way to specify the ports to use... a simple first-
free first-used algorithm is used. In other words, the first element you connect is considered as port 1, the second
element as port 2, and so on.
In particular, you saw that a step has two ports but you can specify X offset, Y offset and Rotation only for the second
port.
The Edit Connections dialog exists for changing the port definition. Click on the move ( ) button at the
top of the elements bar, then click with the right mouse button on one of the connections (the black lines) of the
discontinuity. The Edit Connections dialog will appear.
This dialogs allows the user to specify the ports of a discontinuity where each connected waveguide should be
attached. For each connected element, a row of radio-buttons is available to specify which port it should use.
Attaching more than one waveguide on the same port is not allowed.
Configuring explains how to configure the frequency/angle sweeps and the global circuit parameters. These
windows are explained in detail in the sections Frequency specifications and General Specifications.
Running shows how to compute S parameters or multi-mode S, Z or Y matrices of a FEST3D circuit.
Configuring
Once you have created a millimeter-wave or microwave circuit, there are two main things that must be configured
before you run a simulation on it:
For this purpose, click on the Frequency Specifications command in the execute menu bar, or click on the
Frequency Specifications ( ) button in the toolbar. A dialog box, typically looking as the following figure, will
appear:
This window lets you edit the frequency range and points where the circuit should be simulated as well as the
method (discrete/adaptive) to be used. In case your circuit contains Radiating Array elements, you can also perform an
angle sweep (theta or phi) instead of a frequency sweep.
The frequency (or angle) sweep is specified by its start and end frequencies in GHz (or degrees for angles), and by the
sampling.
FEST3D supports three different sampling modes:
1. step lets you specify the distance between consecutive points to be sampled.
2. number of points lets you specify the total number of points to sample, including start and end points.
3. manual selection of points lets you manually edit each and every point you want to simulate. Only the last
sampling mode allows non-uniformly distributed points.
For further details, see the General Specifications section in this manual.
In our case (the asymmetric one-pole cavity) you should enter the following values:
General specifications
For this purpose, click on the General Specifications command in the execute menu bar, or click on the General
specifications button ( )
For a detailed explanation of the meaning of the various global symmetries and default waveguides parameters, see
again the General Specifications section in this manual.
The asymmetric one-pole cavity example you created, in particular, has constant height and is invariant under
translations along the Y axis. So the Constant height (H plane) symmetry can be applied. Click on it. In this case no
other symmetry is applicable.
Since you are using symmetries, you can (and should) lower the various number of modes used in waveguides. Enter
Running
Computing the S parameters is really simple: click on the Analyze ( ) button in the toolbar and watch the
progress messages produced by the Electromagnetic Engine (EMCE) integrated in FEST3D.
If the Autoplot option in the graphics menu is active, or if you execute the Plot command (still in the graphics
menu) at the end of the simulation, the S parameters graphical plot will be displayed.
With FEST3D you can also compute the multi-mode S, Z or Y matrix of a circuit, to reuse it later as a single block in a
bigger circuit.
You can stop a running simulation at any moment by clicking on the stop ( ) button.
The following figures show FEST3D main window during the simulation and the produced plot:
1. Accuracy Parameters explains which parameters control numeric accuracy in FEST3D, their meaning and the
effect of changing them.
2. Balancing shows how to choose a trade-off between accuracy and speed in FEST3D.
Accuracy Parameters
In FEST3D, each element (waveguide or discontinuity) can be configured independently from the others.
Several elements also contain numeric accuracy parameters.
To simplify the task of configuring manually the numeric accuracy (and other) parameters common to all waveguides,
by default their Common page is set to Use General Specifications, i.e. to use the default values stored in the
General Specifications dialog box you used in Tutorial 2.
This allows configuring the parameters common to all waveguides at once, unless you manually set some waveguides
not to use the default values.
For simple circuits, starting with Low Accuracy (i.e. 10 accessible modes, 30 MoM basis functions and 300 Green
function terms) is usually enough to deliver satisfactory results.
Of course, this is true if no symmetries are considered. If symmetries are taken into account, the circuit parameters can
be dramatically reduced, keeping accuracy but increasing speed. This is particularly important if the circuit is going to
be optimized.
Anyway, there is no guarantee that certain fixed values for numeric accuracy parameters will yield satisfactory results
for your particular circuit. It is thus of critical importance to always perform a Convergence Study.
Some elements contain also other numeric accuracy parameters, as explained in the following paragraphs.
Arbitrary Rectangular
The Arbitrary Rectangular waveguide, which is also used as base for all waveguides in the RECT-CONTOUR BASED WG
section in the palette of elements, contains the Number of reference box modes parameter:
The Number of reference box modes is the number of modes to be used in the rectangular cavity to compute the
modes of the arbitrary rectangular waveguide.
The required value for this parameter depends a lot on both the role of the arbitrary waveguide and the ratio between
the reference box area and the arbitrary waveguide area. If the arbitrary rectangular waveguide is smaller than the
surrounding waveguides to which it is connected, i.e. it is playing the role of an iris, the number of generated modes
must be slightly higher than the number of the MoM basis functions of such an arbitrary waveguide. Therefore, the
number of reference box modes has to be adjusted to reach this condition.
If it is set to zero by the user, FEST3D will automatically calculate its value.
On the other hand, if the arbitrary waveguide is larger than one of the waveguides to which it is connected, the
number of generated modes has to be slightly larger than the number of Green function terms of the arbitrary
waveguide. Therefore, the number of reference box modes has to be modified to accomplish such a rule.
In order to get enough generated modes, this number of reference box modes will need to be increased if the area of
the arbitrary waveguide is much smaller than the area of the reference box. By default, the number of reference box
modes is set to the double of the number of Green function terms.
The Number of reference box modes is also important for another reason: FEST3D can directly connect to each
other two Arbitrary Rectangular waveguides or derivatives using a Step or N-Step. In this case, the coupling integrals
between the two sets of modes are computed by convoluting two coupling integrals matrices. Since the matrices are
only known numerically, in order to obtain accurate results Number of reference box modes and Number of terms in
Green's function should be high enough.
In case you have Arbitrary Rectangular waveguides with TEM modes (the cross section must be non-simply
connected), which propagate even at zero frequency, the two numbers above become more and more important at
frequencies much lower than the cutoff of the first non-TEM mode, since the circuit behaviour strongly depends on
the exact couplings between TEM modes.
With so low frequencies, the Number of accessible modes and Number of MoM basis function will have very little
effect on the overall accuracy, since only the TEM modes will be accessible.
Known accuracy limitations exist in FEST3D if you try to analyze a circuit with TEM modes at extremely low frequencies
(< 0.2 GHz): due to the TEM-TEM couplings being computed numerically and not with analytical exactness, the results
produced by FEST3D will be less and less accurate as frequency decreases.
To solve this problem, you need to progressively increase the Number of reference box modes and Number of
Green's function terms until you get convergence (see Convergence Study above) in the frequency range you are
using.
Arbitrary Circular
The Arbitrary Circular waveguide, which is also used as base for all waveguides in the CIRC-CONTOUR BASED WG
section in the palette of elements, contains two basic precision parameters: the number of box modes and the
Distance between points.
The number of box modes (in this case, the box is a circle!) has the same meaning as for the ARW case, so the same
can be said.
Balancing
This section gives basic guidelines to the art of finding a compromise between accurate simulations and fast
simulations. Due to the sheer size an complexity of the topic, only a brief explanation of high-level strategies can be
summarized here.
First of all you should understand which of your goals and needs are immediate, and which can be postponed.
Accuracy issues can be usually postponed, while fatal errors reported by the EMCE should be addressed immediately.
1. Split large circuits and use the User Defined element to import generalized Z matrices generated from sub-
circuits. Apply the rest of this section on each subcircuit if appropriate (i.e. you often cannot optimize a sub-
circuit since you only know the results you want from the complete circuit). This divide-and-conquer strategy
costs some time to set up, but can really make life easier when tackling very large circuits.
2. Once you have created a circuit in FEST3D, the next step should be to complete its simulation without errors.
At this early stage accuracy has no importance at all, but rather can be an obstacle by slowing down each
simulation you perform and halting the simulation due to accuracy errors. For this reason, you should usually
stick down to the "Low Accuracy" values listed above in Accuracy Parameters section.
Now continue retrying to simulate your circuit until you have solved all geometry and numerical errors that the
EMCE may report. Depending on the errors you get, finding a solution may be tricky. It is possible that you
tried to do something not supported by FEST3D, or maybe you made some mistakes and the geometry you
created is not what you think it is. The 3D Viewer section may help you.
3. Ok, now the simulation completes successfully and produces a result. You can be confident that many times
this result will be, at least, inaccurate.
It's now time to think about the next step: Global Symmetries. Enable all the symmetries that apply to your
each simulated frequency point costs time. Consider using the Adaptive Frequency Sampling to solve
the frequency sweep, or in case of using the discrete solution, reduce the number of frequency points to
the minimum you can live with. Consider editing manually the list of sampled frequencies.
you don't need a complete Convergence Study, but a quick check that your results are not too far from
convergence is necessary. At this point is very useful to employ the Comparing results tool available in
FEST3D to compare the record of simulation results.
If you use FEST3D optimizer:
do not use too many parameters simultaneously, they slow down optimization and make more difficult
for the algorithm to reach the target (your goal functions).
remember that at any time you can stop the optimizer, manually change some parameters, then
perform one-shot analysis and/or resume optimization.
if possible, use formulas instead of constraints: formulas reduce the effective number of free parameters,
speeding up the optimization.
if a certain optimization algorithm does not reach the goal functions you want, try alternating among
different algorithms and/or slightly change the parameters values manually.
Introduction
Some elements supported by FEST3D (Arbitrary Rectangular, Arbitrary Circular and Constant width/height arbitrary
shape discontinuity) do not have a predefined 3D geometry. They allow the user to arbitrarily define their shape or
cross section in a 2D plane, and they are invariant under translations in the direction orthogonal to that plane.
The Arbitrary Shape Editor is a 2D shape editor, allowing to view and edit the arbitrary shape of such elements.
The different kinds of elements allowing arbitrary shapes have slightly different features and limitations. For this
reason, the Arbitrary Shape Editor offers similar, but not identical, functionalities when editing the different arbitrary
Contour A planar, continuous, non self-intersecting and possibly closed curve composed by
Segments, Arcs and Elliptic Arcs. An arbitrary shape is made of one or more contours
(possibly enclosing one another, but not intersecting) plus some prescriptions to decide
which connected area contains the electromagnetic fields.
Region of Interest A user-specified Point which must be inside the area intended to contain the
electromagnetic fields.
Point The start or end point of a segment, arc or elliptic arc. If two Segments, Arcs and Elliptic
Arcs arcs have a Point in common, they are consecutive and belong to the same contour.
The user can modify the coordinates of a Point only if it is the start or end point of
segments, not arcs or elliptic arcs.
Segment A normal, straight segment. In the Constant width/height arbitrary shape it is also possible
to change a Segment into a Port.
Port A Segment used to connect the arbitrary shape with other elements. Only supported by
Constant width/height arbitrary Shape element. Drawn in pink.
The shape of the example defines the areas S,S1,S2 or S3 but only one of them can be simulated at once. The user
needs a way to resolve this ambiguity, or at least know which area will be used by FEST3D to simulate the
electromagnetic fields propagation. To do so, the user has to specify the coordinates of a Point (the Region of
Interest): the area containing the Region of Interest will be the one used for the simulation. The Region of Interest
is drawn as a blue cross (
).
You can only create Contours with a standard shape (rectangular, circular, elliptical) but you are free to modify the
Contours as you want after you created them.
To delete a Contour, click on a part of it (Point, Segment, Arc, Elliptical Arc), then execute the Delete Contour
command in the Contour menu.
If you deleted something by mistake, use the Undo command in the Edit menu.
Select the Point, Arc or Elliptical Arc you want to edit by clicking on it with the mouse left button. It will
become red.
Choose the command you want to perform from the menu bar, or from the popup menu that appear by
pressing the mouse right button.
Editing Points
By selecting a Point, the following Point menu will be accessible, either from the menu bar or pressing the mouse
right button:
Delete Point: deletes the selected Point. The two adjacent Segments, Arcs or Elliptical Arcs are deleted and
replaced by a single segment.
Change corner to arc: changes the Point and the two adjacent Segments, Arcs or Elliptical Arcs into a single
Arc.
Smooth corner: smoothes the corner having the Point as vertex. The user has to define the Radius (value
greater than zero). NOTE: the point must be adjacent to Segments (Arcs or Elliptical Arcs not allowed).
Edit Point: opens a dialog showing Point X,Y coordinates and allowing the user to modify them. NOTE: the
Editing Segments
By selecting a Segment, the following Segment menu will be accessible, either from the menubar or pressing the
mouse right button:
Delete Segment: deletes the selected Segment and extends the adjacent Segments until they converge.
Split Segment: splits the selected Segment in 2 new Segment whose dimensions are defined by means the
‘Split percentage (%)’ value (specified by the user).
Multi-split Segment: splits the selected Segment in N equal segments. The number N is specified by the user.
Change to Arc: allows to change the Segment into an Arc. The user has to define the Radius. Using the
default value the generated Arc will be 90° wide.
Change to Port: allows to change the Segment into a Port. Available only for the Constant width/height
arbitrary shape element.
Toggle Invisible: makes the selected Segment Invisible allowing to create an Open Contour.
Segment Properties: opens a dialog showing Segment properties: extrema coordinates and segment length.
In the following paragraph, the term Arc means both circular Arcs and Elliptical Arcs, unless explicitly stated
otherwise.
By selecting an Arc or Elliptical Arc, the following Arc menu will be accessible, either from the menubar or pressing
the mouse right button:
Delete Arc: deletes the selected Arc and extends the adjacent segments until they converge.
Split Arc: splits the selected Arc in 2 new arcs whose dimensions are defined by means the ‘Split percentage
(%)’ value (specified by the user).
Multi-split Arc: splits the selected Arc in N homogeneous Arcs. The number N is specified by the user.
Polygonize Arc: approximates the selected Arc by N homogeneous Segments. The number N is specified by
the user.
Change to Segment: changes the Arc into a Segment.
Reverse Arc: changes the Arc orientation.
In case the selected Arc is circular, both the Arc and Elliptical Arc pages are active. You can modify the Radius
Otherwise if the selected Arc is elliptical, only the Elliptical Arc page is active. To transform an Elliptical Arc
back into a circular Arc, set both Major Axis and Minor Axis parameters to the same value and click on the ‘OK’
button. It is also possible to apply a Rotation to an Elliptical Arc.
Constant width/height discontinuity has no Reference Cavity, the other elements have it and implicitly define it.
Constant width/height discontinuity editor is the only one allowing ports.
Concepts
In FEST3D, optimization is performed by varying some (user-specified) parameters following an (user-specified)
algorithm in order to minimize the difference between the circuit output and the target (user-specified) output.
The rest of this tutorial explains how to specify the parameters, target and algorithm in FEST3D Optimizer, how to start
and control the optimization, and finally some advanced techniques.
Index
Tutorial 5 is divided in two parts:
5.1 Optimizer: setup describes how to prepare a circuit for optimization and how to configure FEST3D
Optimizer.
5.2 Optimizer: run shows how to start an interactive optimization and what you can do during it.
1. Choose which parameters to optimize explains how to prepare FEST3D to optimize the circuit parameters
Activate the Show Optimizable Parameters option from the Execute menu in the Menubar. In the Element
Properties there is a small button close to the name of each optimizable parameter. Clicking on the button, it
will change indicating that the parameter will be optimized. It is possible to optimize geometrical,
electromagnetic and, in some cases, numerical parameters.
In our case, you should enable optimization for the following parameters:
rectangular 2: A, L
rectangular 3: L
rectangular 4: A, L
step 1: X offset
step 2: X offset
step 3: X offset
step 4: X offset
Open the Optimization Window from the Execute menu or from the corresponding button ( ) in the
Toolbar. The following window should appear:
constraints are intended to keep the circuit total length (l2+l3+l4) small, as well as to keep the irises (a2, a4)
narrow. The weights are determined empirically.
Create Goal Functions with the Add Goal Functions button. In general, for each Goal Function you can either
choose an existing goal file or enter a non-existing file name and create/edit its contents. In this case you are
not expected to already have useful goal files available, so instructions will be given below to create them with
the Goal Functions Editor. A common technique for circuits with only two I/O Ports is to create two Goal
Functions, one to tune circuit's S11 and the other for S12. This is what you will be instructed to do.
It's time to create the goal files. Click on the Edit button of the first Goal Function (near "goal11.out"). The Goal
Functions Editor window will appear, as shown in the following left figure:
Set the number of columns to 2 and click on Apply: column 1 will be frequency, column 2 will be the goal for
S11.
Set the number of rows to 21 and click on Apply: 21 frequency points will be used. The window will change to
the right figure above.
Enter the frequency points. As you have seen in Tutorial 2 this circuit has a resonance at about 11.1 GHz. We
are interested in the frequencies near it, so enter 11.0 in row 1 of the value column and enter 11.5 in the row
21 of the same column.
Entering all the intermediate frequency values would be tedious and error-prone, so FEST3D is designed to
help you here. Select with the mouse (pressing the left button) all the cells in the value column. Those cells
should now be hilighted (usually in blue) as shown in the following left figure:
Click on the Linearize button. All the intermediate values will be created automatically, as shown in the right
figure above.
Enter the goal S11, in dB. Experiment with Linearize on the S11 dB column selecting only a subset of the rows
to find the easiest way to obtain the following:
Click on the Algorithm button on the bottom to select the algorithm among the allowed ones and configure
it. Currently supported algorithms are Simplex, Powell, and Gradient.
For this tutorial, you will use the Simplex algorithm. Click on the corresponding Simplex button, then click on
OK:
The default values for the algorithms configuration are good in most cases, no need to modify them here.
1. Just Run and Watch explains how to start FEST3D Optimizer and observe its progress in real time.
2. Stop, Edit and Resume shows how to interact with setup the target output you would want your circuit to
produce.
Ensure the Auto Plot button ( ) in the Toolbar is pressed and the corresponding Plot Window is visible. This
will let you watch the circuit output (S parameters) as they evolve.
Click on the Optimize button ( ) in the Optimization Window to start optimization. Beware that an
identical button is present in the Main Window Toolbar, but has a completeley different function (runs an S-
parameter simulation).
See the progress. You should see something analogous to the following figures:
If the optimization succeeded (and it always should in this simple example), you now have a circuit whose
resonance is approximately at 11.25 GHz, instead of the original 11.1 GHz. You can Stop the optimization when
you think the result is good enough, or you can wait for it to stop either because the maximum number of
iterations was reached or because a possible minimum was found.
Click on "Apply Parameter changes" to save your tuned parameters into the file, or click on "Discard
Parameter changes" if you are not satisfied with the results.
Note that if you close the Optimization Window, the Parameters labels and expressions, Goal Functions, Constraints
and Algorithm configurations are not lost. Open again the Optimization Window and you will get them back.
While using the optimizer you can discard, save or backup your current optimization status, these are the main
diferences:
Discard all optimization steps: This will replace all the current values with the initial values since the last time
you saved your project. If you have not saved it, it will revert to the original status.
Apply opt changes and save project. This will save your current optimization status to the current .fest3
project file.
Save status into a backup file: This option lets you creating a clone of the current optimization status for
future use. So you can keep optimizing and experimenting with new goals/constraints/algorithms and you will
be always capable to revert to the status you had when you created the backup file. The backup file is just a
Change the value of one or more parameters, then restart optimization. Watch whether the
algorithm is able to restore the parameters values to the ones before you modified them or not.
Modify the goal functions to be centered at 11.35 GHz, then restart the optimization. With a little
patience, by repeating this procedure you can move the resonating frequency even by large
frequency intervals.
Goal files. Learn by experiments that using goal files whose dB values are very far from circuit
output can create local minima in the error function and prevent optimization from succeeding.
You will recognize this case by observing that the optimizer is tuning the circuit to have
maximums or minimums of the output exactly at one of the sampled frequencies, instead of
moving them around.
Change the expressions. Learn that the optimization algorithms do not touch or even know
about parameters having an associated expression: they are simply set to whatever value their
expression dictates, independently from the algorithm being used.
Change the constraints. Learn that constraints are only used as additional terms to the error
function, so they are soft constraints and they are not guaranteed to be exactly
satisfied/respected. However, to mitigate this, one can set a very large weight to the constraint
when a hard constraint is needed.
Study the difference between constraints and expressions:
1. Preliminaries. We open an example and see what considerations should be taken prior to the EM field
Preliminaries
First we need a circuit for EM field analysis. In the tutorial 1 the main steps to create your own circuit are given. In this
example we will open one of the circuits in the examples folder.
In order to increase the resolution of the simulations, increase the number of accessible modes and green functions.
Click on the Global Specification window ( ) and change the global parameters to:
Click on the Specification button, then click again on the frequency button and set 9.5 GHz in the text box.
Click on the resolution button on the Specification window. The number inserted in this text box is the default
characteristic length, in millimeters or inches, used to generate the mesh where the EM field will be evaluated. Set this
value to 1.
Click on the resolution button on the electromagnetic field analysis window to perform the analysis.
It is also possible to override the spatial resolution of an element by clicking on the EM Field folder on the element
properties window. In the next figure is shown how to change the resolution
Once, the specifications and the resolution have been set press "Run" button, and the EM field analysis starts.
With the left, right and center button of your mouse you can rotate, zoom and translate the camera view. In the menu
bar there is a display list where the different fields (electric, magnetic, Poynting vector) can be selected.
FEST3D also includes predefined 2D cuts that allow visualizing the fields inside the structure. On the left side of the
Paraview's window, the main object and the 2D cuts are shown in a tree-like distribution. You can show or hide any of
them by simply clicking on their corresponding "eye" icons.
V=V1W√P
Be careful because the voltage computed this way depends on the selected path in the mesh. In order to have
meaningful results, the device geometry and fields, should be similar to a parallel-plate case.
The process is as follows:
In this particular case we will compute the voltage in the center of the centre iris, where the maximum field is located.
In order to do so, one has to select the "Plot Over Line" filter in Filters->Alphabetical->Plot Over Line menu.
Select the line for displaying the data by either moving the start and end points with the mouse, or by inserting
coordinates manually. In this case, just press "y axis" button to automatically orient the line properly. Then press
"Apply" button.
A 2D plot with the fields displayed along the selected line appears. Now, apply another filter called "Integrate
Variables" in Filters->Alphabetical->Integrate Variables. This filter will integrate all quantities displayed in the 2D plot.
In this case, we obtain a voltage at 1W of V1W= 17.8 V as shown below.
Note: Line start and end points must be adjusted to be inside a valid data region. If any of the line nodes lies
outside, NaN integration values may appear.
1. Preliminaries. We open an example and see what considerations should be taken prior to the multipactor
analysis.
2. Launching the simulation. The main parameters are set and the simulation is launched.
3. Interpreting the results It gives an overview of the simulation output.
See the next part of the tutorial for a multi-carrier case example.
Preliminaries
First we need a circuit for multipactor analysis. In the tutorial 1 the main steps to create your own circuit are given. In
this example we will open one of the circuits in the examples folder.
In order to increase the resolution of the simulations, increase the number of accessible modes and green functions.
Click on the Global Specification window ( ) and change the global parameters to:
For realistic results, the simulation should be done for frequencies in the transmission band of the circuit. Therefore,
we will run first a circuit analysis to determine the right frequencies for the multipactor simulation.
Press the analyze button ( ) in the menu bar, the frequency response of the circuit is plotted.
The frequency range depends also on the application, but for this particular example, we will analyze multipactor in
the range from 8 to 11 GHz. We will then set 3 frequencies for simulation, the lowest the highest and the centre one.
Multipactor analysis is done independently for each element in the circuit. Therefore, the elements can be selected or
deselected for simulation. Remember that multipactor analysis is restricted to some kind of components (see
Multipactor Analysis). Of course, if we do not know anything about the circuit, we could select all elements for the
analysis, but this is a rather slow approach since an individual simulation would be launched for each element.
A wiser approach consists on first calculating the fields along the whole circuit using the EM field analysis (see tutorial
6).
The EM field analysis shows the field strength along the whole circuit, which is very helpful to identify the "hot spots"
for multipactor. The elements with short gaps and high field strengths are those with highest probability of
multipactor. In the figure below we see that elements 4, 6 and 8 are the main candidates for multipactor simulation.
In order to compute the voltage at the critical gap, see corresponding section in EM field Tutorial.
We are now ready to launch the simulation.
1. Material: Silver
2. Initial number of electrons: 500
3. Mesh size (mm): 0.3
Press the "Run" button button . The simulation starts now. Once the simulation starts, an individual simulation is
carried out for each element at each different frequency. The info console shows the current status of the simulation:
the element, frequency, input power and the existence of multipactor or not. When the multipactor breakdown is
found with the desired precision, the next simulation starts.
a table located in the left-side of the window, which shows the analyzed power levels in the process of
searching the threshold breakdown power. For each power, depending on whether multipactor occurs or not,
it appears either the order of multipactor or the message "No break", respectively.
a graph, where for each analyzed power the electron population evolution is represented versus time.
Multipactor output data also includes a table situated on the top of the window, where it is shown the threshold
breakdown power for the elements under study. By clicking on a cell corresponding to a particular element both the
graph and the left-side table update their values to the current element. Right-clicking on a cell will display a context
menu in which a "show 3d statistics" button appears. This opens a Paraview window with 3D statistical information of
the simulation for that specific element and frequency (see Output section in the manual).
By clicking on the cell corresponding to the frequency value, a bar diagram appears in the graph comparing the
threshold breakdown power for all regions. With this information it is easy to recognize which is the most critical
element in the device for multipactor onset and the limiting power.
In this example, the multipactor analysis shows that the element with lowest multipactor breakdown (critical element)
is the element number 6, located in the center of the circuit and that it has a multipactor breakdown of 7250 W at the
lowest frequency of the transmission band. That is, the maximum allowed power for this device is 7250 W.
Now, press the record video button . The following window will appear:
Select:
The remaining parameters, such as SEY properties, number of initial electrons, multipactor criterion, etc. are defined in
the Configuration tab. Press Ok button and choose output file (*.v3d format).
After that, video generation will start. Note that video is saved outside the project and will not erase previous
simulation results.
When the video simulation is finished, you can choose to immediately visualize it, or open it later by pressing the play
Video can be exported using File -> Save Animation... The video size, duration and format can be chosen.
1. Preliminaries. We open an example and see what considerations should be taken prior to the multipactor
analysis.
2. Single-carrier analysis. We run first a single-carrier analysis to have an estimation of the breakdown in the
multi-carrier case.
3. Multi-carrier analysis. The main parameters are set and the simulation is launched.
4. Interpreting the results It gives an overview of the simulation output.
For this example, we propose a multi-carrier signal composed of 4 carriers with the following parameters:
1 11.5 0
2 11.55 0
3 11.6 0
4 11.65 0
Preliminaries
First, we need a circuit for multipactor analysis. In the tutorial 1 the main steps to create your own circuit are given. In
this example we will open one of the circuits in the examples folder.
In order to change the resolution of the simulations, set the number of accessible modes and green functions. Click
on the Global Specification window ( ) and change the global parameters to:
For realistic results, the carrier frequencies should be within the transmission band of the circuit. In order to check it,
we will run first a circuit analysis.
Press the analyze button ( ) in the menu bar, the frequency response of the circuit is plotted.
In this case, all carriers lie inside the pass band of the circuit.
Multipactor analysis is done independently for each element in the circuit. Therefore, the elements can be selected or
deselected for simulation. Remember that multipactor analysis is restricted to some kind of components (see
Multipactor Analysis). Of course, if we do not know anything about the circuit, we could select all elements for the
analysis, but this is a rather slow approach since an individual simulation would be launched for each element.
A wiser approach consists on first calculating the fields along the whole circuit using the EM field analysis and
selecting the elements with higher fields and shorter gaps (see tutorial 6 and tutorial 7 (single carrier)).
In this case we will perform the analysis on the central element of the transformer (element number 5), since it has the
lowest gap and the highest voltage.
Right-click on element 5 and select the multipactor analysis box.
Single-carrier analysis
It is advisable to run a single-carrier simulation before the multi-carrier one. This is because, for a faster multi-carrier
simulation, it is better to have a good initial guess of the breakdown power per carrier. One way to obtain it, is from
the calculated single-carrier breakdown power.
According to the multipactor theory, the breakdown power per carrier of a multicarrier signal composed of N carriers
is expected to be greater than the single-carrier breakdown power at the lowest frequency divided by N squared.
In other words, in order to estimate the breakdown power per carrier, we proceed as follows:
1. Run a single carrier simulation for the lowest frequency of all carriers (11.5 GHz).
2. Obtain the single carrier breakdown power, Psc.
3. In the multi-carrier simulation, set the initial power per carrier to Psc / 16 (4 carriers in this example).
Alternatively, Psc can be obtained with other methods, such as the ECSS Multipactor tool, or with the classical
multipactor theory.
The steps to analyze the circuit with a single-carrier signal are similar to those given in the first part of this tutorial.
Click on Execute -> High power analysis in the menu bar to open the multipactor analysis window. See Multipactor
Analysis for a description of all the available options. For this particular example, we will analyze multipactor for the
lowest frequency of the multi-carrier signal carriers, which is 11.5 GHz.
Press the "Run" button. The simulation starts now. The results for all selected elements and frequencies can be seen
directly in the output console.
In this example, the multipactor analysis shows that the multipactor breakdown for the element number 5 at 11.5 GHz
is 1164 W.
Therefore, and according to the multipactor theory, the expected breakdown power per carrier for the multi-carrier
signal must be greater or equal to 1164/16 W / carrier, which is approximately 73 W / carrier.
A slightly lower number, for example 69 W / carrier, is a good starting point for the multi-carrier analysis.
Multi-carrier analysis
Click again on Execute -> High power analysis in the menu bar to open the multipactor analysis window. Select
multi-carrier mode and enter the signal parameters of this example
1. multicarrier mode
2. Number of carriers: 4
3. Fill the table with the signal parameters (see figure)
4. Material: Silver
5. Initial number of electrons: 500
6. Precision (dB): 0.1
7. Maximum power per carrier (W): 100000
8. Mesh size (mm): 0.5
While the simulation runs, a folder is created with the label "multipactor" and the mean frequency (average of all
carriers) of the current simulation. Inside, the output files for each of the selected elements are stored, with
information about the breakdown power and the charge growth with time for each of the tested input powers. Visit
Multipactor Analysis for more information on output files.
Finally, the results for all selected elements and frequencies can be seen directly in the output console.
In this example, the multipactor analysis shows that the maximum allowed power per carrier for this device is 263 W /
carrier. This result is highly dependent on the frequency scheme and the phase distribution of the carriers. Notice that
this simulation does not give necessarily the lowest breakdown power for the circuit, because a different phase
distribution could lead to a worse case. In order to determine which is such worst case, please refer to the ECSS
standards or use specialized tools such as the ECSS Multipactor Tool.
1. Preliminaries. We open an example and discuss which considerations should be taken prior to Corona
analysis.
2. Launching the simulation. The main parameters are set and the simulation is launched.
3. Understanding the results. An overview of the simulation output is given.
Preliminaries
First, the circuit where Corona is being analyzed must be created. In the tutorial 1 the main steps for creating your
own circuit are given. In this tutorial we will open one of the circuits in the examples folder.
Click on the examples icon and open HP-> Corona ->lowpass_air-> corona_lowpass.fest3 file.
In order to enhance the resolution of the simulations, increase the number of accessible modes and green functions.
Click on the Global Specification window ( ) and change the global parameters to:
Then, we have to choose the frequencies for the simulation in the RF range. For realistic results, they should be in the
transmission band of the circuit.
Press the analyze button ( ) in the menu bar, the frequency response of the circuit is plotted.
The frequency range depends also on the application, but for this particular example, we will analyze Corona in the
range from 8 to 11 GHz. We then choose 3 frequencies for simulation, the lowest, the highest and the centre ones.
Corona analysis is independently done in each element of the circuit. Therefore, the elements can be selected or not
for simulation. Remember that Corona analysis is restricted to some kind of components (see Corona Analysis
Limitations) and that the simulation will involve not only the selected element but also its adjacent ones, whenever
they are of a permitted type. Of course, if we do not know anything about the circuit, we could select all elements for
the analysis, but this is a rather slow approach since an individual simulation would be launched for each element.
A wiser approach consists on first calculating the fields along the whole circuit using the EM field analysis (see tutorial
6).
The EM field analysis shows the field strength along the whole circuit, which is very helpful to identify the "hot spots"
for Corona, as a first approach. The elements with high field strengths are those with highest probability of Corona,
although it is important to notice that Corona breakdown power highly depends on the range of pressures analyzed
and on the geometry of the device. In the figure below we see that elements 4, 6 and 8 are the main candidates for
Corona simulation.
For each analyzed element and frequency, the Paschen curve, that is, the breakdown threshold versus pressure, is
represented and its points are given in the table situated on the left side of the results window.
Besides, the minimum breakdown power in whole pressure sweep is given in the table located on the top of the
window. By left-clicking on a cell corresponding to a particular element and frequency, both the Paschen curve and its
data table are updated to the current element-frequency pair.
By left-clicking on the cell corresponding to a certain frequency, the graph shows together the Paschen curves of all
the elements analyzed.
It is also possible to compare the results obtained for the analyzed frequencies in a certain element. By left-clicking in
the cell's name of an element the graph shows the Paschen curves of all the frequencies analyzed.
With all this information, it is easy to compare the results for the selected elements and determine the critical pressure
and minimum power supported by the device. In this example, the Corona analysis shows that at the center frequency
of the transmission band the element with lowest Corona breakdown (critical element) is the element number 6 in the
chosen range of pressures, located in the center of the circuit and that it has a Corona breakdown of 257.818 W at 12
mBars.
Now, press the record video button . The following window will appear:
Select:
The remaining parameters, such as gas and temperature, are defined in the Configuration tab. Press Ok button and
choose the output file (*.v3d format).
After that, the video generation will start. Note that the video is saved outside the project and will not erase previous
simulation results.
When the video simulation is finished, you can choose to immediately visualize it, or open it later by pressing the play
In the tree located on the left of the 3D CAD viewer Paraview window, there are different visualizations of the electron
density evolution:
Electron density: it corresponds to the electron density in the volume of the device at different video frames.
Animation clip: it is a clip made on the electron density volume in order to visualize the discharge inside the
device in a proper way. You can change the plane of the clip to center it in the proper place where the
maximum of the discharge occurs by using the "Properties" tab or by dragging the plane on the visualization
panel.
ElectronDensity last frame: it corresponds to the last frame of the volume electron density.
You can enable/disable each one by clicking on the eye located in their left side.
The video can be exported in Paraview using File -> Save Animation... The video size, duration and format can be
chosen as shown in the following pictures.
Requirements The minimum hardware and software requirements needed to run FEST3D.
Graphical User Interface Description of the Graphical User Interface, its features and how to use it
(GUI)
E.M. Engine (EMCE) Description of the E.M. Engine, its features, and how to activate/control it from the GUI
Optimizer (OPT) Description of the Optimizer, its features, and how to activate/control it from the GUI
Tolerance Analysis (TOL) Description of the Tolerance Analysis, its features, and how to activate/control it from
the GUI
Synthesis: The Synthesis Description of the Synthesis Tools and how to use them to create full filters with a few
Tools mouse clicks
Engineering Tools Small tools to perform unit conversions and simple computations
Compare Results tool Tool for easily comparing FEST3D output results.
Convergence Study This section explains in detail the procedure to be followed in performing convergence
studies.
Architecture
FEST3D is a CAD tool for linear, passive millimeter-wave and microwave components, based on cascaded
discontinuities in waveguides. It allows the user to design waveguide structures, activate E.M. analysis, optimization
and synthesis and perform the result visualization using an intuitive, user-friendly graphical interface. The list of
elements supported by FEST3D is described in the Elements Database.
At the top-level, FEST3D is composed of three subsystems:
Furthermore, the publicly available Gnuplot program integrates the functionalities of the GUI by providing plotting
capabilities.
The GUI is a Java application. It is the part of FEST3D program in charge of interacting with the user and also executes
and coordinates the other subsystems at user's demand.
The EMCE implements the electromagnetic capabilities of FEST3D (except for some parts provided by the Synthesis
Tools and Engineering Tools). The EMCE is designed and tuned for performance and exploits state-of-the-art
techniques both in the electromagnetic and information technology research fields.
The OPT provides the optimization capabilities of FEST3D. It implements a loosely coupled architecture, where the
OPT is a standalone executable and exchanges data with the EMCE and reports status and progress to the GUI and
thus to the user. It uses general-purpose optimization techniques, usually irrespective of the model physics, to
perform variation of the parameters being optimized. Integrated with the other subsystems, the OPT aims at being an
interactive and extensible optimization framework, where the user can view and interact in real-time with the
optimization.
Millimeter-wave and microwave circuits composed of supported elements can be analyzed, obtaining insertion and
transmission losses, as well as the phase and the group delay, versus frequency. The results of the computation are
displayed in graphic form and can also be printed.
The multi-mode S, Z or Y matrix of such circuits can also be computed, effectively reducing a whole circuit to a single
block which can be then reused as a User Defined element in a more complex circuit or system, or exported to other
E.M. simulation tools.
Finally, circuits can be interactively tuned by using the optimizer to reach the desired output.
2.3.1 Requirements
The FEST3D requires at least the following:
Hardware: Dual core with 4GB of RAM and 3GB free disk space.
Operating System: Windows 7, Windows 8, Windows 8.1, Windows 10. Special requests for Linux or other
Windows versions.
It is necessary to have 3D acceleration (nvidia,ati,intel) working in the computer.
Requirements The minimum hardware and software requirements needed to run FEST3D GUI.
The Main Window How to use the GUI to design and edit circuits, execute the E.M. Engine (EMCE) and
Optimizer (OPT).
The Elements bar Contains all the buttons of the currently supported FEST3D Elements.
The General Specifications The dialog to view and edit circuit specifications such as symmetries and global
Window numeric parameters.
Menubar The top menu bar with standard commands: Load, Save, Quit, Copy, Paste ... and also FEST3D
specific commands.
Toolbar The toolbar on the top, containing buttons for frequently used Menu commands.
Canvas The drawing canvas, where circuit can be created and edited.
From the Main Window it is also possible to access to the following dialogs or functionalities:
Menubar
The menubar at the top of the Main Window gives access to all the GUI functions. The user can select any of them by
using the mouse or by pressing ALT + the underlined letter of the menu item. The following figure shows the
menubar as it typically appears on the screen
1. File
New is used to begin a new project, the old structure is discarded after a confirmation request.
Open a browsing dialog box for file selection appears. By default, the user can choose among *.fest3
files.
Open Examples a browsing dialog box for example file selection appears.
Merge allows to load several FEST3D structures in the same canvas.
Save stores the structure with the name defined before (written at the top of the window) or acts as
Save As if a name was never defined.
Save as stores the structure with a new name, this name becomes the new current name.
A list of the last 5 opened files.
Quit ends the program (closing all windows) asking the user to save modifications if not previously
saved.
2. Edit
Copy copies the selected elements and connections in the clipboard, you can Paste them later.
Paste places in the editing area the elements and connections stored in the clipboard, near the original
ones; the pasted element are automatically selected so that they can be moved. Warning: pasted
Toolbar
The toolbar is the horizontal row of buttons at the top of the window, it duplicates the most frequently used menu
commands, allowing to perform the basic functions: new, open, save, print circuit, undo, copy, paste, cut,
specifications, analyze, stop computation, optimization window, plot, help, 3D viewer... The following figure shows the
toolbar as it typically appears on the screen
Canvas
The wide area in the middle of the main window contains the block diagram representation of the current structure.
Pressing the New button in the toolbar or selecting New from the File menu erases the existing structure and
starts a new one.
To add an element to the structure, press the left button of the mouse on an element of the Elements bar,
move the mouse in the editing area where the element must be located, and press again the left button.
Element Properties
To see and modify the element properties press the right button on the element in the editing area. A dialog box,
allowing the user to view and edit the element properties will appear. The exact content of the dialog box depends on
the element you are editing, see the Elements Database for details. The following figure shows a typical element
properties dialogs as they appear on the screen.
Edit Connections
The order of the connections is relevant for some elements. To modify it, the user just needs to click with the right
mouse button on the connection. The Edit Connections dialog will appear, typically looking as the following figure:
This dialogs allows the user to specify the ports of an element where each connected element should be attached. For
each connected element, a row of radio-buttons is available to specify which port it should use. Attaching more than
one element on the same port is not allowed.
The elements bar gives access to all the elements supported by FEST3D, as well as to the Select and
Connect menu commands. The figure on the left shows the elements bar as it typically appears on the
screen.
The first button (select) executes the Select command: the user can now select, move, copy, delete
elements or edit properties. Use the left mouse button to select and move elements, the right one to
edit properties. The middle button (if it exists) can be used to move (pan) rapidly the editing area.
The second button (connect) executes Connect command, used to connect elements together. Press
the left mouse button on an element, move the mouse on another element and release the left
button. The order of the connections is relevant for some elements, to modify it select the arrow
button and click with the left mouse button on the connection. The Edit Connections dialog will
appear. Connections are always between a waveguide and a discontinuity.
The other icons are used to place the corresponding elements to the Canvas.
or click on the Frequency Specifications ( ) button in the toolbar. The frequency specifications window (see next
image), will pop up:
- Section 1: Selection of the type of sweep for this project. FEST3D allows selecting between frequency, theta
and phi sweeps.
- Section 2: Add sweep: With this button, new sweeps can be added. FEST3D allows simulating multiple
sweeps.
- Section 3: This is a list of all sweeps created for this project. Modification of all parameters can be done per
sweep.
- Section 4: This is the list of the sweeps used by the optimizer. This is a read-only list to have an easy way to
see the sweeps defined in the optimizer. Optimizer sweeps can be only changed in the optimizer window.
Discrete algorithm: This is the typical sweep where all the points defined are simulated. So, for
instance, if the user defines 100 frequency points, FEST3D will solve the problem in ALL 100 points.
Adaptive sampling: This method is used to reduce the number of simulated points. This method is
explained in detail in the section Adaptive Frequency Sampling method.
The window that appears to configure the parameters for adaptive sampling is the following:
These parameters are available after pushing the button "Advanced" in each adaptive sweep in the window Sweeps. In
addition, each sweep is configured separately.
Target error: The method stops when the current error is below this value during 3 consecutive
iterations. The default value, 0.001, guarantees the convergence of the response in a wide range of
circuits and cases.
Parameter relevance: The internal calculations will be done only using the parameters selected by the
user. In addition, in the case that two or more parameters are used, the relevance of those parameters
can be selected with the "weights" column.
Note 2: Regardless of what parameters are used in the internal calculations, the final response will contain all
parameters of the circuit.
Note 3: Internally, the weight of the selected parameters is normalized to one.
Global Waveguide Settings Default values for parameters common to all waveguides.
Global Symmetries
Global symmetries and global circuit parameters can be configured from the general specifications window right tab.
The following global symmetries are available, even though most elements only support a subset of them (see below):
All-Inductive (H plane, constant height) The circuit has a fixed height and is invariant under vertical (Y)
translations. All components must have the same height. In all discontinuities, Y offsets and Rotation must be
zero. With this symmetry the Rectangular waveguides use only the TEz(m,0) modes.
All-Capacitive (E plane, constant width) The circuit has a fixed width and is invariant under horizontal (X)
translations. All components must have the same width. In all discontinuities, X offsets and Rotation must be
zero. With this symmetry the Rectangular waveguides use only the TEz(1,n) and TMz(1,n) modes.
X symmetric (symmetric under horizontal reflection) The left half and right half of the circuit are symmetric:
reflecting the circuit across the plane X = 0 does not change it. In all discontinuities, X offsets and Rotation
must be zero. With this symmetry the Rectangular waveguides use only the TEz(2m+1,n) and TMz(2m+1,n)
modes.
Y symmetric (symmetric under vertical reflection) The upper half and lower half of the circuit are symmetric:
reflecting the circuit across the plane Y = 0 does not change it. In all discontinuities, Y offsets and Rotation
must be zero. With this symmetry the Rectangular waveguides use only the TEz(m,2n) and TMz(m,2n) modes.
All-Cylindrical (All-Centered Circular waveguides) The circuit is invariant under rotations around the Z axis. The
circuit can only contain Circular waveguides and Steps. In all Steps, X and Y offsets must be zero. With this
symmetry the Circular waveguides use only the TEz(1,n) and TMz(1,n) modes.
Only one symmetry can be specified for a circuit, except for the following cases:
Symmetries are used to discard unnecessary waveguide modes, so they allow using fewer modes which in turn results
in lower computational time.
If symmetries are added to a circuit, the following numeric parameters related to number of waveguide modes
should be reduced accordingly. In the following section aproximate rules are explained to easily modify the numeric
parameters.
Number of accessible Modes, Number of MoM basis functions, Number of green function terms.
If instead symmetries are removed from a circuit, the same numeric parameters should be increased accordingly.
The exact amount to increase or decrease these numeric parameters depends on the circuit and there is no general
formula. The following approximate rule can be used, but users are recommended to perform Convergence Study on
each circuit:
All-Inductive allows replacing all the number of modes with their square root
All-Capacitive allows replacing all the number of modes with the double of their square root
X symmetry allows dividing all the number of modes by 2 (exact rule)
Y symmetry allows dividing all the number of modes by 2 (exact rule)
All-Cylindrical allows replacing all the number of modes with the double of their square root
TEM allows replacing all the number of modes with the half of their square root
In order to specify a certain symmetry in a circuit, all elements in the circuit must allow such a symmetry. The
symmetries that are allowed by each element, can be found in Allowed Symmetries section
Global Parameters
Global symmetries and global circuit parameters can be configured from the general specifications window right tab.
The following global parameters are available. They are used as default values for parameters common to all
waveguides.
Dielectric Permittivity Relative permittivty constant of the homogeneous dielectric medium that fills the
waveguide (default: 1.0 i.e. vacuum).
Dielectric Permeability Relative permeability constant of the homogeneous dielectric medium that fills the
waveguide (default: 1.0 i.e. vacuum).
Dielectric Conductivity Intrinsic conductivity of the homogeneous dielectric medium that fills the waveguide,
in S/m (default: 0.0).
Metal Resistivity Intrinsic resistivity of the metallic walls of the waveguide, in Ohm · m (default: 0.0).
2.3.2.5 3D Viewer
This section describes the 3D Viewer integrated with FEST3D, documents its features and how to use it.
Features
The 3D Viewer window can be opened from the FEST3D GUI Main Window by clicking on the icon:
3D Viewer
The 3D Viewer is a tool that allows the user to visualize a graphical 3D model of the circuit that is currently opened in
the FEST3D GUI. This 3D model is created as a SAT file that contains the different elements of the circuit, classified in 3
main groups:
Ports: A list of the intput/output surface ports of the circuit, sorted by ascending number.
Waveguides: A list of the waveguides of the circuit with the same names that appear in the canvas, sorted by
ascending number.
Discontinuities: A list of the discontinuities of the circuit with the same names that appear in the canvas,
sorted by ascending number. In addition, the internal details of discontinuities that belong to the coaxial library
and the helical resonators groups are also shown as independent geometries.
The user must also bear in mind that waveguides and discontinuities in the circuit whose geometry is not drawn
as a volume (for example Step discontintuities, or waveguides with length equal to zero) will be ommited from
the 3D model and therefore will not appear in the corresponding list.
Holding the left mouse button down allows changing the perspective of the view. Depending on the currently
selected Mouse Mode , the view can be rotated, panned, or zoomed.
Clicking the right mouse button shows a context menu, which allows invoking the actions listed in the table
below.
Action Description
Hide Only appears if the mouse is placed on an element of the 3D model. Allows hiding that specific
Element element.
Mouse Sub menu to change the mouse interaction mode of the 3D view.
Mode
Resize To Sub menu to allow resizing the 3D view. Available resolutions are: 1920x1440 , 1200x900 , 1024x768 ,
800x600 , 640x480 , and 400x300 .
Keyboard shortcuts:
Space : Fits the entire 3D model into the view.
0 : Change to perspective view.
1 : Change to perspective view.
2 , 3 , 4 , 5 , 6 , 8 : Change view to Bottom , Back , Left , Front , Right , Top
Toolbar Actions
The toolbar allows the user to quickly access the following actions:
Action Description
Navigation Show / hide the navigation pane.
Cutplane If enabled, allows setting the cutplane through the 3D model along the x, y, and
z axes. The position of the cutplane can be set through either the edit field, or
the slider.
Help Popup menu to access this documentation as well as the about dialog.
Create compare files if active, all the simulation results are saved also in the folder Compare inside the
installation directory of FEST3D. This allows comparing several results of the same or different circuits.
Enable cache system. This option is activated by default. When the cache system is activated, FEST3D will
store, in disk , data that can be reused later on in the computations of next simulations. FEST3D automatically
identifies if there were elements analysed in previous simulations that are equal to elements in the current
simualtion, and loads their data from cache files avoiding to repeat certain computations. This may result on a
great CPU time saving. The files containing cache data are stored in the project folder, which is located in the
same folder as the input file with its same name. Thus, each FEST3D project will store and have access only to
When there is a large number of waveguides or discontinuities with the same value and you want to
change the value of all of them.
When you are going to optimize a circuit with elements whose properties are related between them,
defining them as parameters and setting up expressions to relate parameters leading to a fast
definition in the optimization window.
When you are trying to perform a tolerance analysis with elements whose properties are related
between them, defining them as parameters and setting up expressions to relate parameters
leading to a fast definition in the tolerance window.
How to set parameters Describes how to set/unset parameters in your circuit properties
Using the parameters Details the parameter window where the user can use expressions and set as
window optimizable every parameter
Dummy parameters for general purpose, which are listed on the top of the window (the list is empty by
default). New dummy parameters can be added by pressing the Add Parameter button. Besides, any existing
dummy parameter can be removed by clicking the corresponding delete button placed on the right.
Element parameters, which are listed below the dummy parameters. These parameters have been previously
selected by the user at each Element Properties window of the circuit (see How to set parameters section
above).
Description contains the element to which it belongs and the parameter description as reported in the
Element Properties. In the case of dummy parameters, the description can be edited according to the user
needs.
opt allows temporarily disabling the parameter for the optimizer by clicking on the box. The color will be
turned to red, indicating that the parameter will not be changed: its value will remain fixed. Clicking again re-
enables the parameter and the color will turn back to green. On the other hand, in cases in which a parameter
is not defined as a numerical value, opt will be marked as crossed out, meaning that such parameter will not be
considered for direct modification by the optimizer tool (but the parameter value may be modified indirectly in
optimization steps if its expression depends on other parameters which are optimized).
Name the name uniquely identifying the parameter. You can edit it.
Expression allows setting direct values or mathematical expressions which define the parameter value or its
relationship with other parameters. For example, a parameter can be defined as follows:
x2+5
(x5+x6)/x2
sin(x5) + cos(x7)
abs(x1-x2)
sqrt(x2)
Using expressions
Once you have set any expression, the value will be automatically updated by pressing the Enter or Tab key.
LIMITATIONS
An expression of a parameter can contain any other parameter(s) defined above or below it. However,
the parameter(s) in the expression must already exist in the window.
In this case, we chose to run a file called six_pole_triple_mode_w_losess.fest3. FEST3D has saved both simulations by
adding to the output file the date and time of the simulation. Now you can select both input files (for instance,
keeping pressed the "control" key) and press "open". The compare window will appear:
It is seen that both results are compared. By defult, the comparison will show the Module (in dB) of the Scattering
Parameters of the all the ports of the circuit. The type of result (Phase, Group Delay, Module) and the number of
scattering parameters which are compared can be modified at any moment, as in the normal results window. Please,
notice that you can compare more than two results. Moreover, the FEST3D input file is also saved each time, so you
can recover the input file of a particular simulation. This is very useful while performing a convergence analysis.
2.3.3 Analysis
This section describes all the analysis capabilities that are present in FEST3D:
Adaptive Frequency Explanation of the Adaptive Frequency Sampling algorithm that allows speeding up
Sampling Method performance in frequency sweeps.
Engineering tools Explanation of Engineering tools, a set of tools that helps you in the creation of your
project.
This section describes the structure of FEST3D E.M. Engine (EMCE), documents its features and how it can be activated
from the User Interface and from the command prompt.
The EMCE section contains the following topics:
Requirements The minimum hardware and software requirements needed to run FEST3D EMCE.
Using the How the EMCE can be activated and controlled from the User Interface or, in case you need, from
EMCE the command prompt.
Requirements
The EMCE requires at least the following:
Hardware: Dual core with 4GB of RAM and 3GB free disk space.
Operating System: Windows 7, Windows 8, Windows 8.1, Windows 10. Special requests for Linux or other
Windows versions.
Features
The EMCE supports passive, linear millimeter-wave and microwave devices, composed on cascaded waveguides and
discontinuities. The full list of the supported elements is available in the Elements Database.
Millimeter-wave and microwave circuits can be analyzed, obtaining insertion and transmission losses, as well as the
insertion phase, versus frequency. The results of the computation are displayed in graphic form and can also be
printed.
The multi-mode S, Z or Y matrix of such circuits can also be computed, effectively reducing a whole circuit to a single
block which can be then reused as a User Defined element in a more complex circuit or system, or imported from or
exported to other E.M. simulation tools.
Note 1: The adaptive sweep only works for sweeps with more than 5 points.
In a particular computer, the resolution of the 100 frequency points takes (only the simulation time in the frequency
loop is considered):
The S parameters perfectly match in both cases, as shown in the following figure, where one can verify that the results
are virtually the same.
Step 1: The method starts by developing two rational approximations of each scattering parameter, one
with 2 support points and one with 3 support points. The approximation with 2 support points uses the
start point and the end point of the sweep. The approximation with 3 support points add a new point in
the middle of the sweep to the previous ones.
Step 2: An error curve between approximations is calculated using the approximations with 2 and 3
support points of each scattering parameter.
Step 3: An error value is calculated from the error curve. This error term tends to cero when the
difference between approximations decreases. In other words, when the approximation converges to a
final response.
Step 4: A new point is selected in the maximum of the error curve. By using this point and the previous
points, a new approximation is done. The error curve is updated, and the new error is also determined.
Step 5: The step 4 is repeated until the error value is lower than a threshold value selected by the user
during three consecutive steps.
Figure 1: Evolution of the cost of the rational approximation with respect to the points of the sweep (1 S-parameter
and 1 thread).
Figure 2: Evolution of the cost of the rational approximation with respect to the number of scattering parameters
(sweep with 500 points and 1 thread).
Figure 3: Evolution of the the cost of the rational approximation with respect to the number of threads (sweep with
500 points and 1 S-parameter).
Next, the different Engineering Tools are described. As will be seen, they are easy to use, giving a nearly instantaneous
output.
Fig. 2. GUI for the (M,N) Modes Propagation in RectWG Engineering Tool
Once all the parameters are specified, the output (Fig. 3) sorts the propagating modes in the waveguide together with
the propagation constant and losses in dB. Alpha is given as a negative number and Beta as positive.
Fig 3. Results given by the (3,3) Modes Propagation in RectWG Engineering Tool
Its output sorts the modes in the cylindrical resonator according to its frequency, together with its unloaded and
reduced / practical Quality Factor (Fig. 5).
Fig. 5. Results given by the (3,3,3) Resonances in Cylindrical Resonator Engineering Tool
The selection between the resonance frequency or the length of the rectangular resonator is up to the user (Fig. 6). If
the resonance frequency is selected, the different modes with the required length are shown (Fig. 7); on the other
hand, by filling in the length of the rectangular resonator, the different modes are sorted as seen in Fig. 5.
Fig. 7. Lengths given by the (3,3,3) Resonances in Rectangular Resonator Tool (geometry fixed)
Fig. 8. Input Parameters for the Q values at 3dB Bandwidth in Resonators tool
Please note that, as specified in the output (Fig. 9), a symmetric coupling input-output is assumed for the calculations.
The formulas to calculate all the Quality Factors are also described in order to avoid the user's confusion.
Losses in CoaxWg
The Input parameters are:
Dielectric Permittivity
Operating Frequency [GHz]
Conductivity for inner conductor [Siemens/m]
Conductivity for outer conductor [Siemens/m]
Tan delta of permittivity * Dimensions of the outer conductor [mm]
Diameter of the inner conductor [mm]
It is possible to choose the outer conductor between a squared or coaxial waveguide as seen in Fig. 10. The tan of
delta is used for the losses calculation.
As seen in the output (Fig. 11), not only the losses but also the Impedance and the 1st higher order mode are
calculated, all of them with their corresponding units.
Losses in RectWg
This Engineering Tool calculates the losses in a Rectangular Waveguide. The user has to fill in the following
parameters (Fig. 12) :
Dielectric Permittivity
Losses in CircWg
Similarly to the previous Engineering Tool, the input (Fig. 14) requested is:
Dielectric Permittivity
Operating Frequency [GHz]
Diameter of the Circular Waveguide [mm]
Length of the Circular Waveguide [mm]
Tan delta of permittivity
Conductivity [Siemens/m]-->Introduced by the user or selected by default
The produced output is similaro to the one for the Losses in RectWg Tool (Fig. 13).
Insertion Loss
This Engineering Tool calculates the Insertion Loss for a band pass filter given the following specifications:
The GUI for the input parameters and its output are shown in Fig. 17 and 18, respectively:
When the user changes one of the parameters and presses Enter, the rest of values are automatically updated
according to the new specification provided. Fig. 19 shows an example, where VSWR, Reflect. Coef. and S21/Ripple
have been changed automatically once the user has introduced the new value for S11/Return Loss (i.e. S11 = 30 dB).
dB Transformation
This Engineering Tool, like the previously seen WG Dimensions Tool in the GUI of FEST3D (Fig. 1), is composed of two
submenus: W<>dBm<>dBW<>dBc and dB<>Np<>Abs tools.
W<>dBm<>dBW<>dBc
As in the VSWR<>S11<>RefCoef<>Ripple tool, this tool gives the relationship among the following
parameters seen in Fig. 20:
Watts [W]
dBm
dBW
dBc and carrier [W]
WG Dimensions
These tool gives the waveguide dimensions for either a rectangular or circular waveguide according the established
standard waveguides. As the dB transformation Tool, it is composed of two submenus depending on the type of
waveguide.
RectWG standard dimensions As seen in Fig. 22, the user selects the type of waveguide among all the list of
standard waveguides. Once this action is performed, the fields corresponding to the dimensions and frequency
range are updated.
CircWG standard dimensions It follows the same approach seen in the last point, but in this case for a circular
waveguide (Fig. 23):
Errors The possible errors produced when computing the EM fields, and solutions or
workarounds to them.
Using the EM field How to use this feature in FEST3D from the User Interface or, in case you need, from
computation the command prompt.
Definition
The EM field analysis computes the electromagnetic fields inside components. The structure is always excited with an
average input power of 1 W. The fields are given in peak values.
Limitations
The EM field analysis can be used in components based on rectangular, circular, coaxial, rectangular-arbitrary and
circular-arbitrary waveguide elements. Most of the discontinuity elements which have 3D volume can perform EM
field computations as well. If a particular circuit contains elements which are not supported, the EM fields will not be
calculated on those specific elements, but only on the supported ones.
In the case that the circuit contains lumped elements, the EM field can not be computed.
Errors
No errors are reported for this feature.
Usage
Clicking on the entry EM Field Analysis opens the following menu:
Specifications allows you to change the computational parameters that control the precision of the
electromagnetic field computation.
Cancel: Nothing will be done. However, parameters that have been changed keep their values.
Specifications
Frequency allows you to specify for which frequency the field should be computed.
Mesh size
This parameter allows you to control the resolution of the electromagnetic field. Values are greater than 0. The
default value is 1.
This value represents the mesh size in mm or inches used to generate a second order element mesh.
Remark: Care should be taken when increasing the resolution. As a rule of thumb: doubling the resolution increases,
in general, the number of sampling points in each direction by a factor of 2. For a 3D representation the number of
sampling points thus increases approximately by a factor of 23=8.
Frequency
In this menu you can define for which frequency the electromagnetic field should be computed.
Output Data
The calculation provides the following vectorial quantities in the complete volume of all elements:
Mag(Max_E) (V/m) In time domain, the maximum value of the magnitude of the electric field in a period,
which is useful for high power applications, such as corona or multipactor analysis.
Mag(Max_H) (A/m) In time domain, the maximum value of the magnitude of the magnetic field in a period.
Max_E (V/m) In time domain, the maximum value of electric field in a period.
Max_H (A/m) In time domain, the maximum value of magnetic field in a period.
E_re (V/m) In frequency domain, the real part of the electric field.
E_im (V/m) In frequency domain, the imaginary part of the electric field.
H_re (A/m) In frequency domain, the real part of the magnetic field.
H_im (A/m) In frequency domain, the imaginary part of the magnetic field.
The possibility to launch FEST3D from command line allows to use it in combination with external programs. This way,
scripts to launch several executables sequentially can be generated or it can be combined with a synthesis or
optmization tool.
Visualization
The 3D quantities can be visualized by means of Paraview. To visualize the data, open paraview in your system and
then go to "file: open data", and open the file "volume_vectorfield_FrequencyGHz_average.pvd", where "Frequency"
represents the value of the frequency at which you have simulated. The structure appears in the main canvas (you can
rotate it with the left mouse button). In order to visualize the fields, select the quantity you wish( Max_E, Max_H,...) in
the top left side combobox. The scalar bar is activated pressing the button situated in the left side of the previous
combobox.
Paraview allows you to perform many operations on the data you are plotting.
See the EM field tutorial for more information about visualization.
Hints
Set the frequency to one single value in each simulation. Otherwise, many calculations (memory waste) are
done.
1. Number of accessible modes. To fix the optimum value of this parameter, we must start our study with a very
reduced number of accessible modes (i.e. 5), and moderate values for the remaining parameters (i.e. 200 basis
functions, 1000 Green function terms). To proceed, we must increase the number of accessible modes and see
the evolution of the simulated response. If such response does not change, it means that the initial value for
the number of accessible modes already provides convergent results, and then we must move to the next step,
tuning the Number MoM basis functions. On the contrary, if the simulated response changes, it means the
convergence has not been reached, and it will be required to increase the number of accessible modes (in
steps of 5 to 10 additional accessible modes) until the response is fixed (i.e. no longer changes).
2. Number of MoM basis functions. To fix this parameter value, the user must always employ the number of
accessible modes determined before, and fix the number of Green function terms to 1000. With regard to the
initial number of MoM basis functions to be considered, it will be set to the previously selected number of
accessible modes plus 1, with a minimum of 20. Then, we will run the software to obtain an initial response.
Since the initial number of MoM basis functions is very low, this number will have to be increased (for instance
in steps of 10 to 20 each time) and the new response will be computed. If no changes between both responses
is observed, we can fix the number of basis functions and proceed to the next step (Number of Green
function terms). If the responses are different, we must continue increasing the number of MoM basis
functions until convergence is reached. It can happen that convergence is never reached even when the
maximum number of basis functions allowed is used (the maximum is number of Green function terms minus
one). In such a case, the number of Green function terms must be increased and the whole procedure for fixing
the optimum number of MoM basis functions must be repeated.
3. Number of Green function terms (also named Number of kernel terms). The third parameter to be fixed is
the number of Green function terms. To proceed, the number of accessible modes and MoM basis functions
will be fixed to the optimum values already determined, and the initial value for the number of Green function
terms will be the same employed in the previous step (i.e. 1000). In this case, the convergence analysis is
performed in the following way: starting from the initial value for the number of Green function terms, it will be
reduced (in steps of 100 to 200 terms each time) until the simulated response starts to change. The optimum
value for this parameter is the previous one before the response has moved. It can happen that the response is
moved with the first reduction of the number of Green function terms. In such a case, the initial number of
Green function terms considered must be increased, and the convergence study must return to the step 2
(adjustment of the Number of MoM basis functions).
Once these convergence studies are finished, it is recommended to compare the responses provided by FEST3D using
the optimum values just determined and employing extremely high values each parameter (much higher than the
optimum values found). If both results are very similar, it is guaranteed that the convergence study has provided
optimum values that can be used in the next simulations of the structure under consideration.
Nested parallelism Elements which can use more than one thread.
How it works
Switching on the multicore option can be done in the combo box located at the top-right corner of the Main Window
(see figure below), selecting the number of the threads wanted between one and the maximum of physical cores. By
default, the number of cores for simulations will be chosen as the maximum value between one and the total number
of cores detected in the machine minus one.
Nested parallelism
In FEST3D, all computations are divided in a static part (frequency independent) and in a dynamic part (frequency
dependent). The parallelization applies to both parts in a different way.
Static part
FEST3D without parallelism computes each element separately one after another. The total time taken to finish this
part is the addition of the time needed to compute each element. When more of one core is selected, each waveguide
or discontinuity is assigned to a core if idle. Therefore, each thread solves the associated element it and waits for a
new element to be solved. If there are no more elements, it will wait (suspended) to the frequency dependent part.
There are some dependencies between elements in FEST3D. For example, a discontinuity cannot be computed until its
attached waveguides are solved, or if an element is equal to another (from network), the original one has to be
computed first.
Time estimations here are difficult. On an hypothetical circuit in which all elements take a similar amount of time and
the number of elements is multiple of the cores used, the computational time will be approximately the time needed
in sequential mode divided by the number of threads. This is, of course, the optimum case. However, if an element is
Dynamic part
In this part, for each frequency, the generalized impedance (Z) matrices of each element are computed in
parallel, similarly as done in the static part. But the total number of cores used for this task will not be the one
specified at input. Instead, this number will be fixed to an optimum value depending on the specific circuit.
However, despite this parallelization the solution of the resulting system of equations (which is built by putting
together all Z matrices) is solved in sequential. In some case, it is possible that the Z matrices are solved very fast and
then the multi-threading leads to a small slow down of the simulation. It is also possible that, if the circuit is too big
and/or has many bifurcations, the frequency part is not significantly accelerated since the solution of the system of
equations takes the longest time.
Additionally, in case that a frequency sweep is solved using the Adaptive Frequency Sampling algorithm, the rational
interpolation performed for the parameters not selected for optimization is also computed in parallel using all
available cores.
Nested parallelism
These are the elements that can use more than one thread simultaneously during their own solution.
EM Fields
The Field analysis has an additional issue related to parallelism. The use of external tools that are not "thread-safe"
forces FEST3D to run them in sequential, loosing performance. In other words, the mesh generation cannot be done in
parallel. Everything else runs concurrently, just like during an S-parameter analysis.
Known limitations
Computer overload
It is highly recommended not to select the maximum number of cores unless the computer is going to be used mainly
for the FEST3D simulation because it can slow down other actions to be done in the computer. Also, if you are running
heavy simulations with other (or even FEST3D) software tools at the same time, the parallelism can be seriously
RAM use
FEST3D usually requires more RAM in parallel mode than in sequential mode. The same simulation that works in
sequential can fail with several cores if there is not enough memory available. As a consequence, slowdowns in the
computer may occur if the circuit contains several different high memory-consuming elements such as those present
in the coaxial cavity library.
2.3.4 Design
This section describes the optimizer and tolerance analysis that are typically used to design circuits:
Using the How to configure, interactively execute and monitor the OPT from the User Interface or, in case you
OPT need, from the command prompt.
Features
The OPT is completely integrated with the GUI and allows the user to interactively access all functionalities using
mouse, canvas and dialogs:
Simplex
Powell
Gradient
1. Choose which parameters to optimize By default, in the Element Properties dialogs, a small button appears
near the name of each optimizable parameter, which indicates if it is used ( ) or not ( ) in the optimization
process. Click on it to activate or deactivate its corresponding parameter. By default, all optimizable parameters
are deactivated. Besides, the user may define dummy parameters in this window as well.
2. Define expressions, goal functions and constraints Open the Optimization Window from the Execute
menu or from the corresponding button ( ) in the Toolbar. Enter expressions as you need near each
parameter's label. Create and enter constraints as you need in the Constraints tab. Create Goal Functions with
the Add Goal Functions button, choose a goal function file (or enter a non-existing file name) and create or
edit its contents with the Goal Functions Editor. Choose which circuit S parameters to compare with which
goal function S parameters with the Sxy and Compare buttons. Change the Weight as you need.
3. Choose and configure the algorithm Click on the Algorithm button on the bottom to select the algorithm
among the allowed ones and configure it. Currently supported algorithms are Simplex, Powell and Gradient.
4. Start, monitor, stop, resume the optimization algorithm To start the optimization click on the PLAY button
( ). The parameters values, iteration count and error function will be updated in real time. If Auto Plot in the
main window Graphics menu is active, the graphic plot of the circuit analysis results will be updated in real time
too. The optimization stops when the algorithm finds a (possible) minimum, or the error function reaches the
target error, or the maximum number of iterations is reached. You can also stop it in any moment by clicking
on the Stop button ( ). In all cases, clicking on the Apply parameter changes button, you can apply to the
current circuit the values of optimization parameters obtained during the last optimization loop. At any
moment that optimization is not running, you can modify the optimization parameter expressions, constraints,
goal functions and algorithm.
Parameters
The upper part of the window contains the parameters to optimize, which can be configured and edited in the same
way as can be done in the Parameters configuration ( ). Each parameter is defined by the following:
Description contains the element to which it belongs and the parameter description as reported in the
Element Properties. In the case of dummy parameters, the description can be edited according to the user
needs.
opt allows temporarily disabling the parameter for the optimizer by clicking on the box. The color will be
turned to red, indicating that the parameter will not be changed: its value will remain fixed. Clicking again re-
enables the parameter and the color will turn back to green. On the other hand, in cases in which a parameter
is not defined as a numerical value, opt will be marked as crossed out, meaning that such parameter will not be
considered for direct modification by the optimizer tool (but the parameter value may be modified indirectly in
optimization steps if its expression depends on other parameters which are optimized).
Name the name uniquely identifying the parameter. You can edit it.
The current, previous, delta and initial values of the parameter. Delta value is the difference between the
current and the initial value, not between the current and previous value. The current value can be directly
edited by changing the expression tab, provided that optimization is not running
Goal Functions
The lower part of the window contains the goal functions and constraints. The error function is computed by adding
together all the contributions of the goal functions and constraints.
Circuit Sxy parameter to be tuned, taken from circuit S parameters output. The numbers x and y can range
from 1 to the number of I/O ports defined in the circuit. The user can choose which part of the Sxy to consider:
Module (dB), Phase (Radians) or G.D. (Group Delay).
Equality or inequality that circuit Sxy parameter should satisfy with respect to goal Sxy parameters. Available
settings are = (equal), <= (lesser or equal) and >= (greater or equal).
= means the goal is to find a curve equal to the goal function
1. An existing goal file can be used. In this case use the Open button and choose the goal file you want. You can
click on the Edit button to view and modify the contents of the file. Goal files have the same format as EMCE
.out S parameters files.
2. A new goal file can be created. In this case, type a non-existing file name in the goal file and click on the Edit
button.
In both cases, clicking on the Edit button opens the following Goal Functions Editor window:
The Goal Functions Editor window lets you view and edit the contents of a goal file as a spreadsheet table (the first
column is a counter, the second is frequency):
you can add or remove rows and columns and you can manually edit the values in each cell.
you can remove multiple rows and columns at once by selecting them and clicking on the Remove button.
if you add new rows, interpolation or extrapolation on the table values is performed automatically.
modifications are saved to the goal file only when you click on the OK button.
You can easily create linear progressions (or, as particular case, repetitions of a constant value) as follows:
1. type the initial value of the progression in a cell and type the final value in another cell of the same column
2. select with the mouse all the cells between the initial and final value (remember to also select the cells
containing initial and final value)
3. click on the Linearize button
Constraints
The lower part of the window also contains the constraints tab, which typically looks as follows:
Weight is the relative weight of this constraint with respect to the other goals and constraints. It can be any
number greater than zero.
Enable/disable flag allows to temporarily disable the constraint by clicking on the button: it will change to
indicating that the constraint will be ignored by the optimizer. Clicking again re-enables the constraint.
Left expression can refer to all optimization parameters, even the ones whose value is defined by a expression
and disabled ones.
Equality or inequality that left and right expressions should satisfy. Available settings are = (equal), <=
(lesser or equal) and >= (greater or equal).
= means the goal is have left expression equal to right expression
<=means the goal is to have left expression less than or equal to right expression
<=means the goal is to have left expression greater than or equal to right expression
Right expression can refer to all optimization parameters, even the ones whose value is defined by a
expression and disabled ones.
The contribution of each Constraint to the error function is the square of the difference between left and right
expression, multiplied by the weight. Obviously the contribution is taken to be zero if the equality or inequality is
satisfied.
Technically speaking, the Constraints defined here are not the same concept as the ones used in Constrained
Optimization techniques. In that case, the optimization algorithms handle the constraints separately from the error
function and usually guarantee that the constraints will be satisfied in the final solution. The Constraints used in
FEST3D OPT are soft: optimization algorithms do not need to know about them, since they are already taken into
account by the error function, but no guarantee is made that they will be satisfied.
For this reason, if a Constraint can be expressed as a parameter needing to be equal to a function of the others, it is
more efficient and accurate to use a parameter expression instead of a Constraint.
Algorithms
FEST3D Optimization Algorithm window typically looks as follows
1. Simplex is the well-known Downhill Simplex Method often found in literature. It performs very well on the
highly non-quadratic error functions of FEST3D. parameters are:
Initial step size the initial size of the Simplex.
2. Powell is the Powell's Direction Set Method, coupled with Brent's unidimensional minimization. It does not use
gradients. Parameters are:
Initial step size the initial size of steps in Brent's unidimensional minimization.
Allowed Tolerance the relative tolerance of minima found by Brent's unidimensional minimization.
3. Gradient is the well-known first-order iterative optimization algorithm for finding the minimum of a function.
Gradient is used to find the minimum error by minimizing a cost function.
Initial step size the initial size of steps. In order to find a local minimum, one takes steps proportional
to the negative of the gradient of the function at the current point.
Allowed Tolerance the relative termination tolerance for the cost function.
Additional optimization algorithms can be added. If you want to combine your own optimizer with FEST3D, do not
hesitate to contact FEST3D development team for further information and help.
Max Iterations the maximum number of iterations. Algorithms will always stop when this number of iterations
is reached (or little after), even if a minimum was not yet found.
Target Error the error function's threshold value. Algorithms will always stop when the error function becomes
smaller than this value (or little after), even if a minimum was not yet found.
It is also possible to execute the OPT from command prompt. The executable name is opt3d.exe on Windows
platform and opt3d on Unix-like platforms, and is located in the directory where FEST3D is installed (you can
view/edit the installation directory from the Preferences window). Executing the command opt3d -h (prefixed by
FEST3D installation directory if necessary) will show all command-line arguments and options supported by the OPT,
including how to specify EMCE location, input and output files. Please note that progress messages, including the
values of parameters, by default are printed on standard error with priority notice. A typical invocation looks as
follows:
<full-path-to-fest3d/OPT3D_CLI_launcher.bat> --chdir=<full-path-to-working-directory> -
-out-curr=mycircuit.out --out-prev=mycircuit.out.prev --engine=<full-path-to-
fest3d/FEST3D_CLI_launcher.bat> --in=mycircuit.fest3 -- --nthreads=number-of-cores-to-
use
If any of the paths contain spaces, you should add double quotes. IE: --tmp="C:\path with spaces"
Using the How to configure, interactively execute and monitor the TOL from the User Interface or, in case you
TOL need, from the command prompt.
Features
The FEST3D Tolerance Analysis performs an automatic study of the effects that the deviations of the structure
parameters have on the circuit response. This is useful, for example, for taking into account the mechanical tolerances
of the component dimensions in the manufacturing process. The parameters that have been selected for the analysis
are perturbed randomly around its initial value in successive iterations. It uses a Gaussian probability density function
with a user-defined standard deviation. At the same time, the resulting responses of the circuit for the modified circuit
are calculated and plotted consecutively. This way, the effect of the tolerances can be inspected at a simple glance.
The tool, completely integrated in the GUI, allows the user to:
Performing a Tolerance Analysis of a circuit with FEST3D TOL can be divided in three steps:
1. Choose which parameters to analyze. By default, in the Element Properties dialogs, a small button appears
near the name of each parameter, which indicates if it is used ( ) or not ( ) in the tolerance analysis process.
Click on it to activate or deactivate its corresponding parameter. By default, all parameters are deactivated.
2. Define standard deviation for each selected parameter. Open the Tolerance Analysis Window from the
Execute menu or from the corresponding button ( ) in the Toolbar. Enter a standard deviation near each
parameter's label. Please bear in mind that in the Tolerance Analysis Window the existing parameters will be
only listed, but they cannot be edited. In order to modify the definition of parameters (names, expressions,
addition/removal of dummy parameters) you can use the Parameters configuration ( ) or Optimizer ( )
buttons in the Toolbar.
3. Start, monitor, stop, resume the tolerance analysis. To start the analysis click on the PLAY button ( ). The
parameters values, iteration count and error function will be updated in real time. If Auto Plot in the main
window Graphics menu is active, the graphic plot of the circuit analysis results will be updated in real time too
(see example below). The analysis stops when the algorithm finds a (possible) minimum, or the error function
At any moment that tolerance analysis is not running, you can modify the parameters values.
The upper part of the window contains the parameters to analyze. Each parameter is defined by the following:
Description contains the element to which it belongs and the parameter's description as reported in the
Element Properties
Enable/disable flag allows to temporarily disable the parameter by clicking on the button: it will change to
indicating that the parameter will not be analyzed: its value will remain fixed. Clicking again re-enables the
parameter.
Name the name uniquely identifying the parameter.
The current, previous, delta and initial values of the parameter. Delta value is the difference between the
current and the initial value, not between the current and previous value. The current value of a parameter can
only be edited using either the Parameters configuration ( ) or Optimizer ( ) button in the Toolbar.
The standard deviation for that analysis. By default, every parameter has set a standard deviation of 0.01.
This can be changed individually for every parameter or also can be changed globally with the "Set Common
STDDev" button which can be found at the bottom of the window.
Introduction General information, architecture, requirement and integration of the Synthesis Tools.
Introduction
The Synthesis Tools integrated with FEST3D are able to synthesize a variety of millimeter-wave and microwave circuits
from user specifications. A typical use of the Synthesis Tools is to quickly create filters with given band, insertion loss
and number of poles.
Rectangular symmetric and asymmetric corrugated lowpass filters with squared corners.
Rectangular symmetric lowpass filters with rounded corners.
Rectangular symmetric and asymmetric iris-coupled lowpass filters with squared corners.
Coaxial lowpass filters.
For all these components, transformers can be attached. In that case, a post-optimization may be required. FEST3D
automatically launches this post-optimization if it has been required during the specification of the lowpass filter
characteristics.
In Fig. 1, a Corrugated Rectangular lowpass filter in a symmetric configuration is depicted. The filter shown has an odd
number of sections, in this case N=5, so the input and output ports have the same height. On the other hand, even
degree filters have not the same input and output height.
The GUI has been organized to ease the work of the designer in the process of synthesizing, and if required,
optimizing a lowpass filter. The wizard guides the user and in just 7 steps the filter is fully customized.
1. Project properties
When the Lowpass wizard GUI is launched, the user can select among two options: create a new project or to restore a
previous existing one. Fig.2 shows the Project Management Window. The project is stored in a ".syn" file in which all
data are saved.
In this tutorial a rectangular low pass filter will be designed and the proper impedance transformers will be attached
in order to match to standard waveguide ports.
2. Topology
The second step (see Fig. 3) shows all the available structures. They are:
1. Rectangular corrugated.
2. Rectangular with capacitive iris.
3. Coaxial.
In this window some other data are also required. These are:
1. Symmetry
Enable or disable the symmetry in the horizontal plane.
2. Impedance Transformer (TRF)
In case the Impedance Transformer is selected, the Step 5 will be used to fulfill the TRF. If not selected
Step 5 will be skipped.
3. Rounded Corners
Rounded corners will be used. The machining radius will be required in Step 4.
4. Synthesis Model
Starts with inductive element. Given a height for the input port, the next element will have a lower
height.
Starts with capacitive element. Given a height for the input port, the next element will have a larger
height.
3. Electrical Specifications
Just after selecting the topology options, the electrical specifications are required. Fig. 4 shows a window in which two
main areas can be distinguished. The one on the top is related to the In-Band electrical specifications and the second
one to the Out-of-Band electrical specifications.
The In-Band specifications require the highest transmission frequency (GHz) and the return loss (dB).
The Out-of-Band can be given in four different ways, an explanatory graph is shown in every case to emphasize what
is the GUI expecting.
Highest transmission frequency (GHz): marked in the graph as the "A" point.
Return loss (dB): Maximum value for the |S11| parameter in the in-band frequency span.
One out of band frequency, its attenuation and the section length.
Due to the length compensation, the final length of each element shall be different (but close) to the one provided by
the user.
4. Geometrical parameters
Once the electrical specifications have been given, important parameters regarding the final dimensions of the
structure have to be given. Fig. 5 shows the window for the rectangular corrugated configuration.
In this case, since a rectangular filter is being designed, the wizard requests the width of the filter. As the filter is
homogeneous all the elements will have the same width.
Secondly, one height must be given. These parameters can be specified in two ways and some restrictions to these
parameters apply.
As the filters' height increases some higher modes, which are excited in the large height elements, are not attenuated
enough at the low height elements and propagate through the structure. This causes a severe degradation in the final
response. Although the synthesis technique implements some resources to fix these problems, it is better to avoid the
use of very large heights. By very large heights can be understood values close to the standard waveguide height in
the input port of the filters.
By setting the first waveguide height the user can be sure about the filter ports at the end of the synthesis.
Nevertheless, nothing can be known beforehand about the minimum height that the structure will have.
The second option may be interesting when a minimum power handling capability is expected. In this case, it is
useful to set the minimum height in the whole structure.
In case of designing a coaxial filter, the wizard prompts for the external radius (which is constant in the whole filter),
and the internal radius. Analogously to the rectangular filter case, the internal radius can be specified in two ways:
6. Simulation parameters
The final step in the synthesis wizard is shown in Fig. 7. At this stage some parameters to set up the FEST3D engine
must be given. The final simulation frequency span and number of points must be specified.
At the bottom of the window, the user can enable the post-optimization. By doing so, the GUI will suggest to reduce
the number of points used in the optimization. Two parameters can be optimized combined or separately. Although
the length optimization is much more faster, hence recommended when only filters are being designed, when an
impedance transformer is attached it could be required to optimize both filter sections lengths and heights.
The optimization process is launched once the synthesis finishes and will stop once the filter has been successfully
optimized.
Once the design is finished, the structure is automatically opened in the FEST3D canvas and analysed by the
electromagnetic simulator engine.
Pay attention to the presence of the quotation marks which must embrace all the paths which contains spaces.
"C:\Program Files\FEST3D-2018\bin\64\LPF_2018" --adrFEST="C:\Program Files\FEST3D-2018\bin\64\fest3d" --
adrWork="C:\My LPF Tests" --prjName=LPFTest
8. Design tips
In this section some tips are given to help the user to achieve satisfactory results when using the synthesis tool.
Rectangular corrugated
It has been found that an increment in the height of the filter makes the final response to loose its
equiripple properties due to higher modes effects. This can be solved by reducing the initial section
height. As a beginning point, a height around 2/3 of the standard height is recommended.
Given a height, the asymmetrical geometries always have a worst frequency response than symmetrical
ones. This effect takes place because evanescent modes with lower cut-off frequencies are excited.
In short, any asymmetrical filter has an equivalent behaviour to one of the double height in a
symmetrical geometry.
When synthesizing rounded structures some restrictions apply:
The section length must be big enough to fit the machining radius.
The analysis of rounded structures is slower than its squared counterparts. Thus the optimization
process can be much more slower if the height is included as optimization parameter.
If the obtained response is not equiripple try to decrease the structure height by choosing an smaller
input waveguide height.
Capacitive iris
This topology has some useful properties which can be interesting when the filter input height is very
important. Nevertheless the out of band response, despite having a greater selectivity, is not as good as the
corrugated topology due to the proximity of the second replica.
Coaxial
Due to the TEM properties of this technology, the results which are obtained are excellent in every
configuration.
Impedance Transformers
The synthesis program performs the synthesis of the filter and the impedance transformers in a separate way.
That means that some effects cannot be taken into account at the design time. That is the reason why a post
optimization is normally required. To improve the results and obtain shorter filters follow the following tips:
The matching network requires more sections as the lower adaptation frequency approaches the
waveguide cut-off (fc) frequency. Usually the microwave systems do not use all the frequency up to "fc".
So configure your matching network to match your required span.
Set a return loss figure which is, at least, 3-5 dB greater than the one from the filter. If both elements
have the same value a longer optimization will be required and, perhaps, the desired result will not be
achieved.
References
[1] R. Levy, "Tables of Elements Values for the Distributed Low-Pass Prototype Filter", Transactions on Microwave
Theory and Techniques, vol. 13, no. 5. pages 519-535, 1965.
[2] R. Cameron, "Microwave Filters for Communication Systems", Wiley, 2007.
[3] Monerris, O.; Soto, P.; et at., "Accurate Circuit Synthesis of Low-Pass Corrugated Waveguide Filters", EuMW, 2010.
Interestingly, all the filters can be homogeneous or inhomogeneous. In other words, the width of the cavities can be
kept constant along the whole filter or not. Inhomogeneity is normally employed to get a better out-of-band
performance.
Furthermore, one or two obstacles can be used in the metal insert and inductive post configuration.
In this tutorial, the BPF tool shall be explained and some advices will be given.
Fig.1.a Homogeneous iris cavity filter. Fig.1.b Inhomogeneous iris cavity filter.
Fig.1.c One Metal Insert In/homogeneous. Fig.1.d Two Metal Inserts In/homogeneous.
Fig.1.e One Metal Insert In/homogeneous. Fig.1.f Two Metal Inserts In/homogeneous.
1. Project properties
When the BPF wizard GUI is launched, the user can select between two options: to create a new project or to load a
previous existing one. Fig. 2 shows the Project Management Window. All the design files have the extension ".syn". In
this file all the synthesis project data are saved.
2. Topology
Once a project has been selected, the wizard shows the three geometries which can be synthesized.
Fig 3. shows this step and allows the user to configure some parameters which depend on the final geometry of the
structure:
Symmetry: This leads to a symmetric filter in the propagation direction. If selected, all the data retrieved in the
following steps take this into account.
Homogeneity: This sets the filter to have constant width or not. In the second case Step 5 lets the user to set
each section width.
Number of obstacles: In the metal inserts and inductive posts cases, the user can configure whether he/she
wishes to place one or two obstacles in each iris.
3. Port parameters
Once the desired topology has been selected, the input and output ports must be chosen. In Fig. 4 a list of available
standard waveguides is shown. Nevertheless, other dimensions can be set manually in case that non-standard
waveguide ports are wished.
In case that the input and output ports are different, the filter must be asymmetric and inhomogeneous. In any other
case only one port can be customized.
4. Frequency parameters
Next, the frequency specifications are required. As depicted in Fig. 5, little information is needed. The purpose of this
step is to determine the order of the filter in terms of the frequency parameters.
In band parameters
Out-of-band parameters
Filter order
The estimate button uses the information gathered in the fields above to calculate the required filter order in order to
meet the specifications. Given that a Chebyshev response is being used, once the data have been filled, the estimate
button can be used.
5. Resonator parameters
In this step, the resonators width must be filled. This window is only shown if in Step 2 the user has set the filter to be
inhomogeneous. In that case a table has to be filled with the desired widths of each resonator.
Pay attention that, if the symmetry option has also been selected, the values in the table must be symmetric as well.
When wrong values are filled an error message is shown and it will not be possible to advance to the next step.
6. Iris parameters
Once the previous steps have been followed, the iris dimensions can be configured (Figs. 7a-c). As expected, three
different windows are available, each of them for one topology.
Each iris has, at least, two parameters, but only one can be used in the design process. The other one must be set in
this step to its final value.
The fixed parameters are set using a table (see Fig 7.d). As before, the fixed parameters in the different irises must be
symmetric in case that the symmetry option has been selected.
Fig. 7.d: Table in which the iris fixed parameters must be filled.
Although the design parameters do not require any configuration, the user can set the maximum and minimum value
which it can take. Doing so, the program will try to achieve a successful synthesis in which the design parameter exists
in the region defined by the user. Those values are introduced in two tables like the one shown in Fig. 7d.
7. Simulation parameters
The final step in the synthesis wizard is shown in Fig. 8. At this stage some parameters to set up the FEST3D engine
must be given. The final simulation frequency span and number of points must be specified.
At the bottom of the window, the user can enable the post-optimization. The optimization is done over the cavity
length and the iris design parameter.
The optimization process is launched automatically once the synthesis finishes and stops once the filter has been
successfully optimized.
Once the design is finished, the structure is automatically opened in the FEST3D canvas and analysed by the
electromagnetic simulator engine.
9. Design tips
In this section some tips are given to help the user to achieve satisfactory results when using the synthesis tool.
When a filter is being synthesized, the coupling level required in the input iris is always bigger than the level
required in the central sections. Thus, the fixed parameter in the iris must be set wisely in order not to force the
design parameter into very small or very big values.
When fixing the parameter set them in a way that the coupling level is greater for the input and output
sections and smaller for the middle ones. Doing so all the variable parameters will be much more same sized.
Next a list of tips to increase the coupling is presented in terms of the design parameter.
Window width The coupling increases as the window gets wider.
Window thickness The coupling increases as the window gets narrower.
Metal insert offset A metal insert placed in the middle of the cavity blocks the zone in which the field is
maximum. When two metal inserts are used, a bigger offset achieve a greater coupling level.
Metal insert thickness As this parameter increases much more field is blocked so less coupling level is
achieved.
Post radius A bigger radius implies less coupling level. Use the table provided in Step 6 to choose the
radius wisely.
Posts offset A post placed in the middle blocks much more EM field than the same post placed in a
side. So an offset post always achieve a greater coupling level.
References
[1] G. Matthaei, L. Young, y E.M.T. Jones, Microwave Filters, "Impedance-Matching Networks, and Coupling Structures".
Noorwood, MA: Artech House, 1980.
[2] S.B. Cohn, "Generalized design of band-pass and other filters by computer optimization," in 1974 IEEE MTT-S Int.
Microwave Symp. Dig., 1974, pp. 272-274.
[3] J.D. Rhodes, "A low-pass prototype network for microwave linear phase filters," IEEE Trans. Microwave Theory
Tech., vol. 18, no. 6, pp. 290-301, Jun. 1970.
[4] R. Cameron, "Microwave Filters for Communication Systems", Wiley, 2007.
In this tutorial, the use of the DMF tool is explained and some pieces of advice are provided.
The bandwidth is referred to the frequency band where S11 is under the level specified by the parameter "Return
loss".
1. Input/output waveguide ports: There is a list of available standard waveguides. Nevertheless, other dimensions
can be set manually in case that non-standard waveguide ports are wished, by selecting "Non-standard" in the
previous list.
2. Cavity radius.
3. Width, thickness, round corner radius and vertical and horizontal offset of the input/output irises.
4. Width, thickness, external round corner radius and internal round corner radius of the intercavity irises.
If the topology chosen has both cross and slot intercavity irises, width and thickness will be the same in both type of
irises, and round corner radius of the slot irises will be the same as the external round corner radius of the cross irises.
Step 5 - Screws
Now, some parameters related to the screws must be configured. The window will have the appearance shown in Fig.
6. The number of cavities depends on the filter order.
1. Vertical screws can be only located in two different positions: top (90º) and bottom (270º).
2. Horizontal screws can be only located in two different positions: left (0º) and right (180º).
3. Oblique screws can be only located in four different positions: 45º, 135º, 225º and 315º.
4. The position of the oblique screws of different cavities is not independent. When two cavities are
interconnected through a slot iris, positions of their oblique screws must differ in 0º or 180º. Alternatively, if
they are connected through cross irises, the right position will vary depending on whether equalization has
been used and the number of equalization zeros employed. Therefore, the positions of the oblique screws
must be modified accordingly to this rules. Tables 1-a and 1-b shows the difference of position between each
pair of cavities depending on the filter order. A difference of position of 90º in the tables means that this
difference can be of +90º or -90º.
Table 1-a. Relative positions of the oblique screws in each pair of cavities when equalization is not used.
Table 1-b. Relative positions of the oblique screws in each pair of cavities when equalization is used.
Cavities
Cavities 1-2 Cavities 2-3 Cavities 3-4 Cavities 4-5
5-6
Note that in 4- and 10- order filters, the asymmetric topology only is allowed if a singly terminated filter network is
used. It should also be noted that the 5- order filters always have an asymmetric topology.
Finally, everything is ready to start with the design process of the dual-mode filter.
After clicking "Finish", the design process starts. Once the design is finished, the structure is automatically opened in
the FEST3D canvas and analyzed by the electromagnetic simulator engine.
NOTE: The length of the waveguide ports is adjusted so that the theoretical and simulated phases match.
It has been verified that if the filter obtained with the "medium precision" or "high precision" option is synthesized
and then the modes in the "very high precision" option are chosen, the response can be recovered by changing ONLY
the length of the screws. Again, this has been done for some particular designs we have tested. It could be possible
that, in other cases, the response cannot be recovered.
Bandwidth: This design method is focused in dual mode filters with little bandwidth (less than 1% - 1.5%). If a
bandwidth over 1% is specified, it is possible than the results obtained are not good.
Return Loss: Return loss value must be between 5 dB and 40 dB. Otherwise, an error message will appear.
Transmission zeros: Obviously, all transmission zeros must be outside the pass-band. Besides, if the
transmission zero value specified is very high, a warning message will appear since it is possible to obtain a
degraded synthesis result.
Equalization zeros: This tool is only capable to consider symmetric equalization zeros placed in the real axis
of the s plane. For symmetric 8-order filters equalization is only possible with 4 equalization zeros, and for
symmetric 12-order filters equalization is not available.
Input/output waveguide ports: They must be chosen properly. Its cutoff frequency must be under the center
frequency. Apart from this, they cannot be very big, because it could happen that the necessary input/output
coupling is not achieved.
Cavity radius: This is a critical point, since the quality of the results obtained in the design process strongly
depends on this choice. Because of that, an appropriate cavity radius is automatically calculated from the
center frequency specified in the previous step. However, this is only a rough estimation. It does not mean that
with other cavity radius the algorithm does not work. Therefore, the user can modify it manually. Nevertheless,
it is recommended to choose a value close to the one automatically obtained, and if the radius specified is very
small (cutoff frequency over center frequency of the filter) or very big, an error message will appear. Besides, it
could happen that a spurious mode resonance appears near the pass band, and this is difficult to predict.
When the algorithm detects this effect, an error message is shown. An easy way to correct it is changing the
radius value.
Input/output iris offset: The synthesis method used by this tool assumes that only the vertical mode of the
circular cavity is excited by the input/output iris. Therefore, the offset of the input/output iris cannot be very
big. Otherwise, not only the vertical mode is excited, but also the horizontal mode, and the results obtained will
not be accurate enough.
Screws thickness: The right thickness needed to obtain a good design is related to the wavelength. The bigger
the wavelength is, the bigger the thickness of the screws must be. Table 3 shows some examples of right
dimensions of the screws thickness. They are for guidance only, and it is assumed that the recommended
4 35.1 6
6 23.4 4
8 17.5 3
10 14 2.5
12 11.7 2
14 10 1.7
16 8.8 1.5
Iris thickness: In microwaves band, typical thickness used are between 1-2 mm. If thickness specified is too
big, coupling required will not be achieved.
I/O-iris height and cross arm thickness: In this design method, couplings between input/output waveguides
and cavities are carried out by rectangular irises (a cross iris is composed by two orthogonal rectangular irises).
A rectangular iris allows coupling of modes which are orthogonal to it (for example, a horizontal iris allows
coupling of vertical modes). To achieve that, the big dimension of the rectangle must be much bigger than the
small one, to select only the corresponding mode (horizontal or vertical). Therefore, input/output-iris height
and cross-iris arm thickness cannot be too big, to avoid the coupling of the wrong mode. If this happens, an
error message will be shown, and the corresponding dimension will have to be changed.
Pay attention to the presence of the quotation marks which must embrace all the paths which contain blank spaces.
"C:\Program Files\FEST3D-2018\bin\64\DMF_2018" "--C:\Program Files\FEST3D-2018\bin\64\fest3d" "--C:\My DMF
Tests" "--DMFTest" "--C:\Documents and Settings\User\My documents\FEST3D_workspace" "--win" "--nthreads=2" "--
mode=synthesis"
It is also possible to obtain the ideal response given by certain specifications. To do that, the procedure is the same as
for the complete synthesis, but substituting "--mode=synthesis" by "--mode=theo". In this case, the output will not be
The new GUI, available in FEST3D 6.5 and upper, has been organized to ease the work of the designer in the process
1. Project properties
Each time the GUI opens, the user can select to create a new project or restore a previous one. The wizard creates a
.syn file in which all data are stored. Fig. 2 shows the Project Management Window in which a stored project can be
opened or a new one can be created.
In this tutorial the whole process is shown from the very beginning. So a new project option is selected.
2. Topology
The second step (see Fig. 3) shows all the available structures. They are:
1. Rectangular
2. Coaxial
At this step the user can specify whether the structure must be symmetrical or asymmetrical and, if appropriate, set
the steps to be rounded or squared.
4. Simulation parameters
The final step is shown in Fig. 5. At this stage, the wizard allows the user to modify some parameters to setup the
FEST3D engine. It also allows changing the frequency sweep in which the simulation shall be performed.
At the bottom of this step the user can enable the post-optimization. It is possible to optimize the lengths
(recommended), the heights or both at the same time.
Limitations:
Here some limitations of the synthesis tool are described:
Rounded Corners
The synhtesis tool automatically changes the rounded corners to square when the height difference
between the two waveguides is smaller than the radius diameter.
References
New Features Which are the new capabilities of Corona module in the current version of FEST3D.
Errors The possible errors produced when performing the Corona Discharge analysis, and
solutions or workarounds to them.
Using the Corona Discharge How to use this feature in FEST3D from the User Interface or, in case you need, from
module the command prompt.
Definition
The Corona Discharge analysis computes the corona breakdown power threshold for a range of pressures of one or
more particular elements selected by the user from the current device. It is important to point out that Corona onset is
analyzed inside the chosen element together with the ones adjacent to it, whenever they are among the element
types where Corona analysis can be performed (see Limitations below). The breakdown power calculated is the input
power at port 1.
This module is based on the work developed under the ESA/ESTEC contract "Multipactor and Corona Discharge:
Simulation, Prediction and Design in Microwave Components" ESA/ESTEC Contract No. 16827/02/NL/EC. For a
detailed report about corona theory and results see http://tuprints.ulb.tu-darmstadt.de/598/1/diss_vicente.pdf.
Features
Automatic corona threshold determination.
Single-carrier simulations.
Possibility of using: Air, Nitrogen, Helium, Argon, SF6 and CO2 as filling gases.
Computation of Paschen curves for a chosen pressure range.
High pressure breakdown estimate based on empirical rule.
Corona analysis can be carried out in elements in which EM field can be computed.
Limitations
It is only possible to analyse Corona breakdown in elements in which the EM field can be computed.
With respect to precision, on the one hand the results given by the software have limited accuracy if the pressure (in
mBar) is below the pressure at which the breakdown threshold is minimum (critical pressure). The value of such a
minimum (in mBar) is normally very close to the frequency value (in GHz).
On the other hand, depending on the particular geometry of the selected element and its adjacent ones, a too dense
mesh could be necessary in order to achieve a convergent result in the threshold breakdown power. This situation
could then lead to a memory overflow, which ultimately would fix the limit in the results' accuracy.
Errors
Errors can occur when creating the mesh. Considering a too small value of the mesh size parameter could
produce a mesh so dense that there could be a memory overflow in the numerical simulation. When this occur,
a higher value for the aforementioned parameter should be taken.
In rare cases, a particular value of the mesh size can cause a failure in the generated mesh, which will entail the
program interruption. In these situations, it is recommended to slightly change the mesh size.
In linux: when getting the error:
Usage
In order to select the specific elements of the structure to analyze, the option "Corona Analysis" of their respective
dialog boxes must be marked (see for example Using the Rectangular Waveguide).The corona discharge analysis of
the device under simulation is controlled through the GUI, that allows setting the input parameters.
Input tab
First, the frequency of analysis must be selected in the input tab, as is shown in the following screen shot. It is possible
to compute corona discharge either in a frequency sweep or in a single frequency.
Configuration tab
The configuration window permits setting the rest of the simulation parameters as is shown in the next menu:
Gas Several gases can be considered in the simulation: dry air, nitrogen, helium, argon, SF6 and CO2.
Data for helium, argon, SF6 and CO2 were downloaded from LXCat, which is an open-access
website with databases contributed by members of scientific community.
Results obtained for SF6 and CO2 should be considered as rough approximations, due to the
lack of enough breakdown measurements to cross-check with our simulations and ensure their
acuteness.
Temperature Ambient Temperature. The default is taken as the room temperature of 293 K.
(K)
Initial power Power from which the threshold breakdown power is looked for. It must be set for both "Numerical"
(W) and "Numerical & analytical" simulation types. Its value may be set by the user or it may be taken
automatically (enabling the "Automatic" check box) from the high pressure analytical approach.
Precision This parameter sets the desired precision in power level for the corona breakdown onset.
(dB)
Mesh This parameter sets the maximum size of the elements that form the mesh used in the numerical
size (mm) simulation of corona analysis. Considering a small/big value of this parameter relative to the device's
dimensions will produce a dense/coarse mesh.
Video Record
If corona mode is selected videos can be saved by pressing the record button and opened at any time with the
play button
The record video dialog is the following
Video for Here, the region in which the video is going to be recorded is selected
element /
region
Number of Specifies the frame rate of the recording. The higher the smoother the animation, but bigger video
Frames / sizes will be generated.
period
Accuracy Sets the level of accuracy that will be used in the electron density computation. The higher is this
level, the more accurate, time and memory consuming is the computation.
Stop criterion Sets the criterion used in the last frame of the video to stop the computation of the electron
density:
Input Power Sets the input power for this specific video recording.
(W)
Pressure Sets the pressure value for this specific video recording.
(mBar)
Frequency Sets the signal frequency for this specific video recording.
(GHz)
Other parameters are taken from current configuration, such as gas type and temperature.
When the Ok button is pressed, an output file must be selected (*.v3d extension) and the simulation starts. Results
from previous simulations will not be deleted. The video will be stored outside of the project and it is independent of
it (can be opened from other projects, for example).
Once the simulation is finished, the user can select to immediately open the video, or to open it at any time with the
play video button . The videos are opened with the 3D CAD viewer software Paraview, which allows for 3D
rotations, perspective customization and zoom on the saved animations. It also allows for exporting the animation to
popular video formats, such as avi format for instance. See the Video Tutorial for further information.
Change in the mesh used to compute the EM field. If the mesh is not dense enough, the maximum value found
for Emax may not be the absolute maximum and small changes in the mesh may lead to different results.
If any of the paths contain spaces, you should add double quotes. IE: --tmp="C:\path with spaces"
The full path is required since the EMCE will search for the license file in the same directory as the full path specified.
It is also necessary to indicate the directory where cache and the temporary files are stored (by default, cache and
temporal directories are located in FEST3D_WORKSPACE directory, but you can choose a different one). The file
mycircuit.cin keeps all configuration parameters for Corona simulation and must be created before running the
simulation from command prompt. Its format looks as follows:
begin "corona"
configuration_name "config1"
gas "air"
analysis_type "breakdown_threshold"
minimum_pressure 6
maximum_pressure 18
increment_pressure 3
initial_power 100
temperature 293.0
precision 0.1
simulation_type "numeric"
end "corona"
In the command line example given above, this file is stored in the same directory as mycircuit.fest3 file. All these
parameters are described in the Usage of Corona Discharge from User Interface.
The possibility to launch FEST3D from command line allows using it in combination with external programs. This way,
scripts to launch several executables sequentially can be generated or it can be combined with a synthesis or
optimization tool.
Output
Corona module provides the threshold breakdown power of the selected elements of the structure. The simulation
process can be visualized in the info window of the GUI where a sweep in input power is shown as the simulation runs,
indicating how the simulator tries to approach to the corona breakdown threshold level.
The results of the analysis are given both in graphic and tabular form to make their interpretation easier. There are
two tables and one graph, as can be seen in the following figure:
In the left-hand side table the threshold breakdown power for each pressure point corresponding to a certain
element and signal is represented, which is selected by left-clicking on its corresponding cell in the upper
table. If the high pressure analytical rule has been also selected for evaluation, the table will have three
columns instead of two, where the last one corresponds to the empirical rule.
The data of the left-hand side table correspond to the Paschen curve, which is represented in the graph. If the
high pressure analytical rule is enabled, there will be two curves, one corresponding to the numerical analysis
and the other one to the analytical rule.
In the table located on the top of the results window the minimum breakdown power in the whole pressure
sweep is represented for each element analyzed and for each frequency studied. Besides, through this table the
user can handle the results shown both in the left-hand side table and the graph:
By left-clicking on a cell corresponding to a particular region both the graph and the left-side table
update their values to the current element.
By left-clicking on the cell corresponding to the signal value, the whole row is selected and the graph
shows together the Paschen curves of all the regions analyzed. With this information it is easy to
recognize which is the most critical element for Corona discharge and the minimum breakdown power
supported by the device.
By left-clicking on the cell's name of an element, the whole column is selected and the graph shows
together the Paschen curves of all the frequencies analyzed.
The data represented in the graph can be saved into a .png file through the button or into a .csv file through
the button .
Hints
The minimum of corona discharge breakdown occurs at pressure levels (in mBar) close to the frequency value
(in GHz). It is therefore recommended to include such a value in the pressure interval to be given.
It is necessary to carry out a convergence study of the threshold breakdown power as a function of the mesh
used in the description of the EM fields. It is advisable to perform this previous study with a single pressure,
which should be chosen close to the frequency value.
Start the process with a coarse mesh. Increase progressively the number of points in the mesh to obtain denser
meshes and compare the results. Once convergence is achieved, use the coarser mesh that involves
convergence to analyze the entire range of pressures.
It should be pointed out that for certain structures a too dense mesh, that would lead to a memory overflow,
should be required in order to achieve convergent results.
LXCat references:
Argon
Helium
SF6
CO2
Errors The possible errors produced when performing the Multipactor analysis, and solutions
or workarounds to them.
Definition
The Multipactor analysis computes the multipactor breakdown power threshold of one or more particular elements of
the structure. It supports single and multi-carrier operation. The breakdown power for each carrier is calculated at
input port 1.
For a more detailed information about multipactor theory and results see:
C. Vicente, M. Mattes, D. Wolk, H. L. Hartnagel, J. R. Mosig, and D. Raboso, "FEST3D: A simulation tool for multipactor
prediction," in Workshop on Multipactor, RF and DC Corona and Passive Intermodulation in Space RF Hard- ware, pp.
11–17, ESTEC, Noordwijk, The Netherlands, Sept. 12-14 2005.
Features
Single-carrier and multi-carrier simulations with arbitrary number of carriers and phase schemes.
Custom SEY curves. Possibility of using Predefined SEY materials (according to ECSS standards), user defined
parameters or import from text file.
Computation of electron evolution for each applied input power.
Automatic multipactor threshold determination.
Advanced 3D output statistics with average impact energy, average SEY, and emitted electron density for the
different surfaces in the structure.
Possibility to add external uniform DC magnetic field.
Electron path algorithm with adaptive refinement which allows for faster and more accurate simulations. The
electron trajectories are now computed with a certain error introduced by the user.
Different multipactor criteria. The multipactor criteria allows for automatically stop the simulation and
decide whether there is multipactor discharge or not. The election of one or another have implications on the
accuracy and speed of the simulation. This is of special importance in multi-carrier simulations. The user can
easily change the criteria from the configuration window. The available criteria are: charge (automatic), charge
(fixed factor) and charge trend.
Impact angle dependence for SEY curves imported from text files.
Multipactor video recording feature. The user can export videos of electrons moving in a 3D structure and
open them at any time. 3D rotations, perspective customization and zoom are allowed on recorded animations.
Final export to popular video formats (such as .avi) can also be done.
Automatic power loop, in which input power levels are automatically computed to find the multipactor
threshold, and Custom power loop, in which the user can specify as many arbitrary input power levels as
desired
Multipactor analysis can be carried out in elements in which the EM field can be computed.
In addition to the magnetic case, homogeneous electric DC field can be added to the simulation.
List of SEY properties for ECSS standard materials and Aerospace Corporation aluminium (TOR-2014).
Limitations
Due to numerical limitations on the electron path integration, in rare cases and for very high fields, false single-
surface discharges may occur at very low multipactor orders (below 0.05). These are easily identified and must not be
taken as real discharges. If this occurs, please contact technical support for possible solutions to this issue.
Errors
Due to the nature of the phenomenon, the results can slightly differ from simulation to simulation. This deviation can
be considered an intrinsic error caused by the phenomenon itself. However, this error is normally so small that it is not
relevant for practical applications.
Usage
Input tab
In the input tab of the multipactor analysis, the properties of the input signal are configured such as simulation mode
(single or multi-carrier) and frequency of operation.
Single If single carrier mode is selected, the simulation will be done with only one carrier at the specified
carrier frequency
Multicarrier In this mode, an arbitrary number of carriers are combined at the input port. The frequency, power
mode and relative phase of each one can be configured independently.
This section configures the input signal when single carrier mode has been selected.
Frequency Specify a frequency sweep (start, end and number of points) for the simulation.
loop
Automatic If selected, the multipactor module will search automatically for the multipactor threshold, starting
power from the initial power and stopping when the desired precision is reached. Bisection method is
loop employed, and the multipactor criterion (to determine whether there has been a discharge or not) is set
by the Multipactor criterion in the Configuration tab below. The parameters are:
Precision (dB): This parameter sets the precision in power level desired for the multipactor
breakdown onset. The default is 0.1 dB.
Initial power (W): This will be the initial input power used to search the multipactor breakdown
onset. This can be changed to an input power level close to the final breakdown onset if some
information is known a priori.
Maximum power (W): Sets the maximum allowed power for multipactor breakdown
search. The default is 100 kW.
Custom If selected, the input power steps are selected by the user by pressing the edit button, see the figure
power below. A multipactor simulation will be done for each step. The criterion for stopping the simulation
loop can be chosen from:
Stop based on multipactor criterion: The simulation will stop if a discharge (or not discharge)
If Custom power loop is selected, the user can choose the input power steps by pressing the edit button. The
following window appears,
where arbitrary number of power steps with arbitrary power value can be defined.
Multicarrier mode
This section configures the input signal when multicarrier mode has been selected.
In this mode an arbitrary number of carriers is combined at the input port of the device. The frequency, initial power
and relative phase of each carrier can be individually configured. The output of the simulation is the breakdown power
per carrier for the selected element. Notice that the power ratio of each carrier is fixed by the initial power per carrier
set in the simulation parameters (for example if the initial power of the first carrier is twice the others, all the tested
powers per carrier in the simulation will keep this ratio).
Number of Specify the number of rows in the carrier definition table. When apply button is pressed, the table
carriers changes its dimension to the specified value.
Import Imports a carrier table from a file in ECSS Multipactor Tool format.
from
Multipactor
Tool
Carrier It specifies the configuration of each carrier, including frequency, initial power and relative phase. The
table "ON" check in the right side allows for switching on and off each carrier individually. Notice that the
power ratio for all carriers during the simulation is constant and fixed by the initial power per carrier
set in this table.
Apply same When apply button is pressed, the value in this field is applied to all carriers.
power to
all (W)
Maximum Sets the maximum allowed power per carrier for multipactor breakdown search.
power per
carrier (W)
Precision This parameter sets the precision in power level desired for the multipactor breakdown onset. The
(dB) default is 0.1 dB.
Configuration tab
The configuration window permits setting the rest of the simulation parameters as is shown in the next menu:
Material
Allows you to choose metals with well studied Secondary Electron Yield (SEY) properties. It also allows you to create
new materials and save them for future simulations.
Material name Six materials are included with their SEY properties. User defined materials can be
saved and loaded.
Maximum secondary Maximum SEY of the material. Typical values are between 1.5 and 3.
emission coefficient
Lower crossover electron The lowest electron impact energy at which the SEY crosses the value of 1. This is a
energy (eV) typical value between 20 and 45 eV for the materials for space applications.
Electron energy at The electron impact energy at which the SEY is maximum. Typical values are
maximum SEY (eV) between 150 and 300 eV.
It is also possible to use a custom SEY by importing it from an input file. The file must be in CSV (comma-separated-
value) format, which is text file with .csv extension that consists on tabulated data. The SEY file should have 2 columns:
the first one contains the electron impact energy in eV and the second one corresponds to the SEY of the material at
normal incidence. FEST3D will automatically add the angle dependence for each electron impact. For energies outside
the range defined in the input file, the SEY will be set to 0.
Press the button with the icon close to a SEY definition to open a new window with a plot of the selected SEY
curve.
DC fields
By selecting the B fields or the E fields check boxes, uniform external DC fields are added to the simulation. The
uniform B and E DC fields are given in Tesla and V/m respectively.
Simulation preferences
Initial This defines the initial number of electrons launched in a particular component element. This number
number of can vary in order to obtain reliable results. The default value of 100 electrons should be quite accurate
electrons in single-carrier mode and in waveguide elements where the parallel plate approximation holds.
However, if the length of the waveguide element is of the order of its height more electrons could be
necessary. For a complete simulation, the best idea is to start with a low number of electrons in order
to get a fast idea of the approximated breakdown power level. After that, more electrons can be
launched using an input power level close to the one obtained in the simulation with few electrons. In
general, multi-carrier simulations need a higher number of initial electrons to reach convergence. In
this case, an initial number of electrons of 500 is a good starting point.
Mesh This parameter sets the density of the 3D mesh of the element under study. The mesh size sets the
Size (mm) maximum length of the edges of the tetrahedra in the mesh. The smaller the value the denser the
mesh, the higher the precision but the longer the simulation. A good starting point is to set this value
to one tenth of the largest dimension.
Multipactor Multipactor criterion is the mechanism that automatically decides whether there is a discharge or not
criterion at a certain input power and stops the simulation. Then, next power is simulated until the precision is
Charge (automatic), only for single-carrier: This is the default mode. At each RF half-cycle,
the ratio between the current number of electrons and the initial ones is checked. This
criterion establishes a factor depending on the current number of simulated half-cycles. If the
number of electrons is above such a factor, multipactor is detected. Basically, it sets higher
factors for lower number of half-cycles (beginning of the simulation) and more relaxed ones for
larger number of half-cycles (longer simulations). This is done in order to avoid false detection
during the initial stages of the simulation. Additionally, if after a certain number of cycles, the
ratio is below a certain number, the simulation is stopped and no multipactor is detected. This
is done in order to avoid excessively large simulations in which there is not a clear electron
growth.
Charge (fixed factor): It is equivalent to the automatic one, where the factor is not automatic
but set by the user. Gives more control on the simulation but needs of more trim and
knowledge from the user side. It does not have any check for low number of electrons. Only
populations decreasing to zero are considered no discharges. Therefore there is a risk of long
simulations.
Charge trend: It fits the electron evolution to a exponential curve and checks whether there is
positive or negative growth. It detects both discharges and no discharges. In general, this
method detects multipactor much faster than the others. However, it may suffer from higher
variability between consecutive simulations. In such cases, it is advisable to use a high number
of initial electrons.
Multi-carrier operation
Write It writes advanced statistics in paraview mesh format that can be visualized from the results tab (see
3D output section):
stats
Average SEY: It shows the average SEY of the impacting electrons in each surface of the mesh.
Average Impact Energy: It shows the average impact energy of the impacting electrons in each
surface of the mesh.
Impact Density: It shows the electron impact density (impacts/m2) for each surface of the mesh.
Emission Density: It shows the electron emission density (emitted electrons/m2)for each surface of
the mesh. It can be positive (more electrons were emitted than absorbed) or negative (more
electrons were absorbed than emitted).
Restore Gives back to the configuration parameters used in the last simulation.
values
Advanced Dialog
The Advance Dialog allows for setting extra simulation parameters which are not usually needed for typical
simulations but that provides extra control for advanced users.
Relative error for adaptive electron path integration: This parameter specifies the maximum error in the
electron path integration. The FEST3D electron tracker incorporates an automatic step refinement for each
electron at each time step. This implies that the integration step for electrons in high field regions will
be smaller than for those in low field regions, ensuring a maximum error for all of them. This process is
iterative. Large values imply less accurate simulations but less adaptive iterations and thus faster simulations.
Small values imply more accurate but slower simulations. The default value (1%) is normally a good trade-off
for most cases.
Homogeneous initial electron distribution: Normally, initial electrons are located on high electric field
locations on metallic surfaces. If this option is checked, initial electrons will distribute uniformly on all surfaces.
This can be useful in situations where high electrical field is present in reduced areas (metal edges)
and multipactor is known to occur in other places.
Video Record
If multipactor mode is selected videos can be saved by pressing the record button and opened at any time with
Video for element / Here, the region in which the video is going to be recorded is selected
region
Number of Frames / Specifies the frame rate of the recording. The higher the smoother the animation, but bigger
period video sizes will be generated.
Maximum video If different from zero, the video will be cropped when the video file (approximately) exceeds
size (MB) the set size.
Start time (ns) Sets the initial time for video recording.
End time (ns) Sets the maximum time for video recording.
Input Power (W) Sets the input power for this specific video recording.
Frequency (GHz) Sets the signal frequency for this specific video recording.
Other parameters are taken from current configuration, such as SEY definition, number of electrons, multipactor
criterion, single or multi-carrier simulation, etc . Autofill button completes the fields based in the last simulation (using
results such as breakdown power, multipactor order, etc.
When the Ok button is pressed, an output file must be selected (*.v3d extension) and the simulation starts. Results
from previous simulations will not be deleted. The video will be stored outside of the project and it is independent of
it (can be opened from other projects, for example).
Once the simulation is finished, the user can select to immediately open the video, or to open it at any time with the
play video button . The videos are opened with the 3D CAD viewer software Paraview, which allows for 3D
rotations, perspective customization and zoom on the saved animations. It also allows for exporting the animation to
popular video formats, such as avi format for instance. See the Video Tutorial for further information.
If any of the paths contain spaces, you should add double quotes. IE: --tmp="C:\path with spaces"
The full path is required since the EMCE will search for the license file in the same directory as the full path specified.
It is also necessary to indicate the directory where cache and the temporary files are stored (by default, cache and
temporal directories are located in FEST3D_WORKSPACE directory, but you can choose a different one). The file
mycircuit.min keeps all configuration parameters for Multipactor simulation and must be created before running the
simulation from command prompt. Its format looks as follows:
begin "multipactor"
begin "power_steps"
num_steps 1
100.0
end "power_steps"
multipactor_criterion_sc "charge_automatic"
criterion_fixedfactor_sc 100.0
multipactor_criterion_mc "charge_fixed_factor"
criterion_fixedfactor_mc 100.0
material_name "silver"
ext_DC_BField 0
B_DC_x 0.0
B_DC_y 0.0
B_DC_z 0.0
ext_DC_EField 0
E_DC_x 0.0
E_DC_y 0.0
E_DC_z 0.0
write_3D_stats 0
m_pdf_report 0
maximum_secondary_emission_coefficient 2.3
secondary_emission_coefficient_below_lower_crossover 0.5
lower_crossover_electron_energy 35.0
electron_energy_at_maximum_SEY 165.0
initial_number_of_electrons 500
sc_precision 0.1
sc_initial_power 500.0
sc_max_power 1000000.0
iteration_type "bisection"
custom_fixed_time 1
custom_max_time 1.0E-8
mc_precision 0.1
mc_initial_power 0.0
mc_max_power 1000000.0
SEE_statistics "maxwellian_velocity"
path_rel_precision 1.0
homogeneous_emission 0
metallic_contours 0
analysis_type "breakdown"
Output
The multipactor module provides the input power breakdown threshold per carrier of the selected elements of the
structure. The simulation process can be visualized in the info window of the main FEST3D canvas, where a sweep in
input power is shown as the simulation runs, showing how the simulator tries to approach the breakdown threshold.
Multipactor results are given both in tabular and graphic form. They can be seen in run-time through the results
window, which looks as follows:
1. The left-hand side table shows for each analyzed power whether there has been breakdown or not. When
breakdown occurs for a certain input power, the multipactor order is given in the second column of the table
whereas when there is no breakdown the message "No break" appears.
2. In the graph it is represented the electron evolution with time for each power analyzed. This way it is easy to
follow the increase/decrease of the electron population as the simulation runs. When left-clicking on the
cell corresponding to a certain power of the left-side table, its corresponding curve is highlighted on the graph
for a better recognition.
3. The upper table contains the threshold breakdown power for each element under study. Through this table the
user can handle the results shown both in the left-side table and the graph:
By left-clicking on a cell corresponding to a particular element both the graph and the left-side table
The data represented in the graph can be saved into a .png file through the button or into a .csv file through
the button .
3D statistics
As explained in Output section above, when a cell of the general results table (upper table) is right-clicked, a context
menu indicating "Show 3d Stats" appears.
If clicked, a Paraview window opens with the 3D statistics of the multipactor simulation associated to the region and
the signal of the cell. Different datasets are present:
Hints
To speed up the simulation use the multipactor module with the minimum accuracy possible to have a rough
idea about the breakdown level. However, the EM fields do normally need more modes for convergence, so it
is recommended to increase the number of accessible modes in the element where multipactor is going to be
computed.
Set the multipactor criterion to charge-trend. This will speed up the simulations significantly. This is of special
importance in multi-carrier simulations. Only if high variability is found between simulations change back to
charge (automatic), or charge (fixed factor) criteria.
Set the frequency to one single value in each simulation. Otherwise, many calculations are done.
First of all, the SEY of a certain surface depends not only on the material itself but on the microscopic
roughness, impurities, cleanness, and oxidization processes. This means that there are no "universal" SEY
curves for the different materials. For example the SEY of the silver coating of a company may differ from the
SEY of the silver coating of another company.
In addition, there are more caveats. The SEY properties of a material may change with time in which is
known as Ageing process. That means that a certain sample may present important deviations of the SEY
See below an example in Table 1, where the measured SEY properties of silver coatings coming from different
companies are compared (extracted from [3], company names are confidential). A big difference can be observed.
Values measured at different moments are also presented, showing a noticeable variation.
Table 1: Comparison of Silver SEY for different companies and variation with time (Ageing).
With all this in mind, the engineer must interpret the breakdown discharges given by the software with caution,
expecting some margin in experimental measurements. Our recommendation is to do a SEY sensitivity analysis,
simulating the same structure with different SEY curves, to see the impact on the breakdown power, since this
impact will strongly depend on the particular component under analysis.
References
[1] ESA-ESTEC TRP AO/1-4978/05/NL/GLC "SEY Database", Final Report, December 2011.
[2] "Space Engineering: Multipacting Design and Test", volume ECSS-20-01A, edited by ESA-ESTEC. ESA Publication
Division, The Netherlands, May 2003.
[3] AEROSPACE REPORT NO. TOR-2014-02198, "Standard/Handbook for Radio Frequency (RF) Breakdown Prevention
in Spacecraft Components"
[4] A. Woode and J.Petit. "Diagnostic investigations into the multipactor effect, susceptibility zone measurements and
parameters affecting a discharge". Technical report, ESTEC working paper No. 1556, Noordwijk, Nov. 1989.
Export Project to CST MWS® 2019: One may generate a CST Microwave Studio® project from a FEST3D
project. For this purpose, one may:
Go to Export-> Export Project to CST MWS® 2019. The following window will pop up.
You may choose the exportation units, as well as the type of solver to be used in CST MWS®.
Once you click the OK button, the corresponding .cst file will be generated. You may then open it in
CST Studio®.
Export 3D geometry (closed ports): This option allows exporting the complete device as a single block to a
Standard ACIS Text (SAT) file. Additionally, the existing dielectric volumes will be individually included in the
SAT file as well. The geometry generated by FEST3D considers that all input/output ports are closed, as mere
walls of the whole circuit.
Export 3D geometry building blocks (closed ports): This option allows exporting the device to a Standard
ACIS Text (SAT) file. By using this option, the different elements used to build the device in the FEST3D
schematics will be embedded in the SAT file as different ACIS bodies. The geometry generated by FEST3D
considers that all input/output ports are closed, as mere walls of the whole circuit.
No information about dielectric objects is given in this option. Thus, if the user intends to simulate the
exported geometry with another CAD tool, the dielectric parts must be specified manually inside the new
software, as well as the possibility of using them as input/output ports, before performing any analysis.
Export Results to SNP: Converts the FEST3D output file to TOUCHSTONE format. The generated file has the
same name as the original .fest3 file, but with snp extension.
2.3.8 CLI
The executable file to launch FEST3D in command-line mode can be found in the installation directory of FEST3D. The file is different depending on the
platform where it is being used:
The executable can be invoked with different combinations of options. Options can be:
All options are required by default, if not included in brackets "[ ]". However, sometimes options are marked explicitly as required with parens "( )". For
example, when they belong to a group of mutually-exclusive or mutually-dependent options.
Together, these elements form valid usage patterns, each starting with FEST3D executable.
Usage patterns
FEST3D has two patterns for different usages in command-line mode:
[ (-Z | -S | -Y) ]
--chdir=<dir>
--in=<file>
--out=<file>
[--licenseServer=<port@ip_address | port@hostname>]
[--nthreads=n]
Options
The table below collects FEST3D command-line options in both long and short forms together with their description. Options with arguments are followed
by "arg" in the table.
--licenseServer = <port@ip_address | Set the address of the license server, typically 27000@localhost for Node-locked License or
port@hostname> 27000@ip_address for LAN License. If it is not set, FEST3D will search for a valid license.
ANALYSIS OR EXPORT
sparameter (default)
emfield
multipactor
corona
visualization
exportfile
exportfileblocks
exportcst
export_emfield
CHARACTERIZATION
[--nthreads=<value>] set number of threads used in the calculation. Although it is optional, it is heavily recommended
to use it. Default value is 1
EXTRA ARGUMENTS
DEPENDING ON SIMULATION
MODE
EMFIELDS parameters
--override_frequency_mode=<f> Specifies the frequency point in which the electromagnetic fields will be calculated. The value is in
GHz and must be a non-negative
--output_path=<file> path relative to chdir where High Power simulation stores output data
--config_file=<file> path and file name (relative to chdir) where High Power (Corona/Multipactor) input parameters
are defined
EXPORTATION
--efile=<file> path and name of the file where the export will be created
--eunits=<type> set the type of units to which export the circuit. Types can be meters, mm (default), inches
--esatversion=<value> indicates the version of ACIS in which the exported SAT file will be written. By defalt is 28.0
EXTRA MODIFIERS
CACHE MODIFIERS
--disable_init_lastsimpr disable use/creation of cache files
OTHER MODIFIERS
-verbose=<LEVEL> set mildest severity <LEVEL> that is reported (default: info)
S-PARAMETER LAUNCH
FORMAL <installation_path/FEST3D_CLI_launcher.bat>
LAUNCH
--chdir="<folder_containing_fest3d_file>"
--in=<name>.fest3
--licenseServer=27000@localhost
--out=<name>.out
--nthreads=<number>
EM-FIELDS LAUNCH
FORMAL <installation_path/FEST3D_CLI_launcher.bat>
LAUNCH
--chdir="<folder_containing_fest3d_file>"
--in=<name>.fest3
--licenseServer=27000@localhost
--nthreads=<number>
EXPORTATION LAUNCH
FORMAL <installation_path/FEST3D_CLI_launcher.bat>
LAUNCH
--chdir="<folder_containing_fest3d_file>"
--in=<name>.fest3
--licenseServer=27000@localhost
--out=<messages_outputfile>
--mode=exportfile
--esatversion=<sat_version>
--efile=<path\sat_filename>.sat
--eunits=<units>
MULTIPACTOR LAUNCH
FORMAL <installation_path/FEST3D_CLI_launcher.bat>
LAUNCH
--chdir="<folder_containing_fest3d_file>"
--chdirHP=<name>
--in=<name>.fest3
--licenseServer=27000@localhost
--nthreads=<number>
--config_file=<relative_path_to_min_file>
--output_path=<relative_path_hp_output>
--mode=multipactor
CORONA LAUNCH
FORMAL <installation_path/FEST3D_CLI_launcher.bat>
LAUNCH
--chdir="<folder_containing_fest3d_file>"
--chdirHP=<name>
--in=<name>.fest3
--licenseServer=27000@localhost
--nthreads=<number>
--config_file=<relative_path_to_cin_file>
--output_path=<relative_path_hp_output>
--mode=corona
OPTIMIZER LAUNCH
FORMAL <installation_path/OPT3D_CLI_launcher.bat>
LAUNCH
--chdir="<folder_containing_fest3d_file>"
--in=<name>.fest3
--out-curr=<output_current_step>
--out-prev=<output_previous_step>
--engine=<path/FEST3D_CLI_launcher.bat>
--
--licenseServer=27000@localhost
--nthreads=<number>
Symmetries Description of the symmetries, and the list of the available ones for each element.
2.4.1 Waveguides
This section describes all the waveguides supported by FEST3D, and how they can be used as building blocks to
Definition What is exactly a FEST3D waveguide, and how it can be used in a circuit.
Common The common properties to all waveguides, their meaning and the dialog box to view/edit
Properties them.
Definition
In FEST3D, a waveguide is an element with uniform cross-section (with a single exception). Waveguides can be either
normal transmission lines, open-ended (I/O port) or closed on a load.
Waveguides can only be connected to one or two discontinuities.
Coordinate System
The coordinate system in a waveguide port is imposed by the one corresponding to the discontinuity port connected
to it. The coordinate system in the other waveguide port will be parallel to the previous one. The next figure shows
this behavior with a rectangular arbitrary waveguide.
Waveguides List
FEST3D supports a large number of different waveguides. In the following, all these waveguides are described and
grouped by their type:
Basic Waveguides
Rectangular The classic, uniform waveguide with rectangular cross section.
Coaxial The classic, uniform waveguide with an external and an internal circular contours.
Arbitrary A uniform waveguide with arbitrary (i.e. defined by the user) cross-section. Supports inner
Rectangular conductors (and thus TEM modes), strip lines and fin lines. The cross-section contour can be
composed by straight segments, arcs and elliptic arcs. It uses BI-RME method on a Rectangular
reference section.
Coaxial A uniform waveguide with a circular inner conductor and with an external conductor either
Square A uniform waveguide with both rectangular inner and external conductors.
coaxial
Cross A uniform waveguide with two arms of a given width. The extremes of the arms can be rounded.
Draft A uniform rectangular waveguide in which the lateral walls have a triangular shape due to
manufacturing processes.
Truncated A uniform circular waveguide which has been truncated by horizontal and/or vertical rectangular
segments.
Waffle A uniform rectangular waveguide with rectangular metallic insertions in the top and/or the bottom
walls. Also called a multi-ridge waveguide.
Ridge-gap A uniform rectangular waveguide with rectangular metallic insertions symmetrically placed with
respect to the central axis in the top and/or the bottom walls.
Lateral The lateral coupling circular waveguide is a dumbbell-shaped element which allows a lateral
coupling rectangular coupling between two circular cavities.
circular
waveguide
Arbitrary A uniform waveguide with arbitrary (i.e. defined by the user) cross-section. Implemented as a Circular
Circular waveguide with perturbations. Supports fin lines, but not strip lines or inner conductors (and thus no
TEM modes). The cross-section contour can be composed by straight segments and by arcs belonging
to the unperturbed Circular waveguide. Uses BI-RME method on a Circular reference section.
Arbitrary A uniform waveguide with a elliptic section (axes can have any rotation).
Circular
with an
Ellipse
Other Waveguides
Radiating A mathematical representation of an infinite, periodic array of rectangular or circular I/O ports opened
Array in the free space. Can only be used as I/O Port. It is currently the only FEST3D component with
antenna-like characteristics.
Curved A waveguide with rectangular cross-section, constant curvature radius and curved either left or right.
There are also techniques to obtain waveguides curved up or down.
Circular- An optimized elliptical iris that can be connected only to two circular waveguides.
Elliptic
iris
Common Properties
Each waveguide can be used in one of the following three modes (SubType):
Transmission Line. It is the normal type. It has two connections (ports), one at each side, attached to two
discontinuities.
Input/Output port. The waveguide terminates one of its sides with an input/output port. The user has to
define the Port Number, consequently identifying the input/output port, and the order number of the Excited
mode, in the range [1, Number of accessible Modes]. It is also possible to use different order numbers for the
Input mode and Output mode, which must be in the same range.
Termination. The waveguide terminates with an adapted load or short circuit on one of its sides. The user has
to define the reflection coefficient within the range [-1,1]. The waveguide has only one connection, attached to
a discontinuity.
The waveguides have the following common modal parameters which set the accuracy of the computation:
Number of accessible Modes Number of accessible (i.e. connecting, propagating) modes of the waveguide.
Only the accessible modes of a waveguide are assumed to transmit E.M fields (and energy) across the whole
waveguide length. (default: 10)
Number of MoM basis functions Number of modes used in the internal MoM to calculate the discontinuities
attached to the waveguide (default: 30)
Number of Green function terms Number of terms in the frequency-independent (static) part of the Green's
function, which describes the discontinuities attached to the waveguide (default: 300)
By clicking on the Use General Specifications button, each waveguide can be configured to use either the default
values for these properties (stored in the General Specifications window) or the values specified by the user in each
waveguide.
The dialog box of all waveguides contains a Specific tab, where the SubType and some related parameters can be
edited:
FEST3D waveguides have three common sets of properties: Ports, that shows which discontinuities are attached to the
current waveguide, Material, which contains a basic set of physical material properties, and EM Field, which involves
the resolution of the electromagnetic field calculated for the current waveguide. They typically look as follows:
The Ports cannot be edited. To change the connections among elements, see the Elements Bar paragraph in the Main
Window section.
By clicking on the Use General Specifications button in the Material or in the EM Field tab, each waveguide can be
configured to either use the default values for these properties (stored in the General Specifications window) or to
per-waveguide user-specified values.
The material parameters are the following (they are also described in the General Specifications window):
Dielectric Permittivity Relative dielectric constant of the dielectric homogeneously filling the waveguide
(default: 1.0 i.e. vacuum)
Dielectric Permeability Relative dielectric constant of the dielectric homogeneously filling the waveguide
(default: 1.0 i.e vacuum)
Dielectric Conductivity Intrinsic conductivity of the dielectric homogeneously filling the waveguide, in S/m
(default: 0.0)
Metal Resistivity Intrinsic resistivity of the metallic walls of the waveguide, in Ohm · m (default: 0.0)
Errors The possible errors produced by this element, and solutions or workarounds to them.
Using the Rectangular How to create, edit and use this element from FEST3D.
Definition
The Rectangular waveguide is a uniform waveguide with rectangular cross section, as shown in the following figure:
Limitations
The Rectangular waveguide has no limitations.
Errors
The Rectangular waveguide should never produce errors.
The Enabled/Disabled button allows enabling and disabling this element, as described in the Main Window Edit
menu.
The SubType option allows defining the waveguide subtype and related parameters, as described in the Waveguides
Common Properties section.
By clicking on the Use General Specifications button, each waveguide can be configured to use either the default
values for the modal parameters (stored in the General Specifications window) or the values specified by the user in
each waveguide.
The following parameters can be edited:
Additionally, in order to fill the A and B parameters, one can choose between a set of standard rectangular
waveguives by clicking in the box of Use Standard Waveguide.
In order to perform either Multipactor Analysis or Corona Analysis in such a waveguide just click in the
corresponding box.
Material and EM Field tabs allow customizing, respectively, the physical material properties and the electromagnetic
resolution for the current waveguide, as described in the Waveguides Common Properties section.
Ports tab shows the discontinuities connected to this waveguide, as described in the Waveguides Common Properties
section.
Hints
The length of this waveguide can be zero.
Errors The possible errors produced by this element, and solutions or workarounds to them.
Using the Circular How to create, edit and use this element from FEST3D.
Definition
The Circular waveguide is a uniform waveguide with circular cross section, as shown in the following figure:
Limitations
The modes of the Circular waveguides are pre-computed. The maximum number of supported modes is
approximately 160000.
In case that "all-cylindrical" symmetry is used, this basically means that NO more than 795 terms of the green function
can be used. However, this number should be more than enough to reach convergence and it is not a real limitation.
In case that TEM symmetry is used, this basically means that NO more than 200 terms of the green function can be
used. However, this number should be more than enough to reach convergence and it is not a real limitation.
Errors
If the user specifies more than approximately 160000 modes (the maximum supported), an error is produced and the
simulation stops. The Circular waveguide produces no other errors.
The Enabled/Disabled button allows enabling and disabling this element, as described in the Main Window Edit
menu.
The SubType option allows defining the waveguide subtype and related parameters, as described in the Waveguides
Common Properties section.
By clicking on the Use General Specifications button, each waveguide can be configured to use either the default
values for the modal parameters (stored in the General Specifications window) or the values specified by the user in
each waveguide.
The following parameters can be edited:
The user can choose standard circular waveguides by clicking the corresponding box and selecting one of the
waveguide numbers.
In order to perform either Multipactor Analysis or Corona Analysis in such a waveguide just click in the
corresponding box.
The first mode of the circular waveguide is chosen as the one with vertical polarization.
Material and EM Field tabs allow customizing, respectively, the physical material properties and the electromagnetic
resolution for the current waveguide, as described in the Waveguides Common Properties section.
Ports tab shows the discontinuities connected to this waveguide, as described in the Waveguides Common Properties
section.
Hints
The length of this waveguide can be zero. This is sometimes useful if the direct coupling between two
waveguides is not available in FEST3D.
Errors The possible errors produced by this element, and solutions or workarounds to
them.
Using the circular coaxial How to create, edit and use this element from FEST3D.
waveguide
Definition
The coaxial waveguide is a uniform waveguide with circular cross section, as shown in the following figure:
Limitations
The direct coupling of this element to the circular waveguide can be done only in the case that the circuit has TEM
symmetry. Circuits with such a symmetry should begin and finish with coaxial waveguides, no offsets should be
present and the circuit can be only composed by coaxial and circular elements.
Errors
In the case of coaxial-circular connections, only the discontinuities showed in the following picture can be directly
computed with a step.
Other cases should be tackled by using an intermediate zero length circular waveguide of the same radius than the
outer bigger radius of the attached waveguides.
The coaxial waveguide produces no other errors.
The Enabled/Disabled button allows enabling and disabling this element, as described in the Main Window Edit
menu.
The SubType option allows defining the waveguide subtype and related parameters, as described in the Waveguides
TEM symmetry: the number of basis functions is two times Number of Green's function terms. The maximum
number is set to 150 since this provides around 45000 modes.
Without symmetry: the number of basis functions is three times the square root of the Number of Green's
function terms. IMPORTANT: If a large amount of accessible modes is desired, and the number of Green's
funcions is not high enough, a warning message will appear inidicating the recommended number of Green's
functions for computing the high modes with a certain accuracy. If this requirement is not fulfilled, numerical
instabilities may occur in the simulation.
Ports tab shows the discontinuities connected to this waveguide, as described in the Waveguides Common Properties
section.
Material tab allows customizing the physical material properties for the current waveguide, as described in the
Waveguides Common Properties section.
Hints
When the symmetry TEM is active, it is recommended to reduce a lot the number of Green's function terms.
Values around 20 or even below of this number could already provide convergent results.
Errors The possible errors produced by this element, and solutions or workarounds to
them.
Using the Arbitrary How to create, edit and use this element from FEST3D.
Rectangular
Definition
The cross-section to be analyzed can have multiple inner contours, such as the ones shown in the following picture,
which defines the internal areas S,S1,S2,S3. In this case the user must be careful, since there are four regions (or areas)
that the program can use to perform the analysis. Only one region of interest (S1, S2, S3 or S) must be indicated for
modal analysis purposes.
The Arbitrary Rectangular waveguide supports TEM modes when the arbitrary contour has inner conductor(s). The
number of TEM modes present in an Arbitrary Rectangular waveguide is equal to the number of inner conductors.
Important: The hollow section of the arbitrary waveguide is defined by the "X" point present in the mesh editor/file.
Limitations
The Arbitrary Rectangular waveguide has some limitations and caveats you should be aware of.
3D Visualization
If a contour defined by the user is invalid, the program generates a fatal error and stops the simulation.
Tangent contours
Each contour can take any shape, and it can be therefore also tangent or incident to the external box as in the
pictures below. Some precautions should be taken in this case. If a circular or elliptical arc is tangent to the
external rectangular box in points different to the starting and ending points of the arc, this will not be
detected by the program. For this reason, the user must split or rearrange the arcs so that only the starting
and/or ending points of the arc are tangent to the rectangular box. Furthermore, in this case some errors may
happen. Such errors must be adequately treated as discussed in convergence failed paragraph below.
Very big or very small cross-section areas (>95% or <30% of the reference box area)
If the contour of the arbitrary structure nearly coincides with the rectangular surrounding waveguide, the
program may produce the error no points to test E.M. fields explained below.
In the opposite case, if the cross-section defines a very small area (<30%), the method will need a big number
of resonant modes to generate the same number of valid modes for the arbitrarily shaped waveguide. In such a
case, the user should use a smaller reference box, or an extremely high number of modes for the rectangular
box (the latter solution highly increases consumed memory and computational time of simulation.
Low accuracy at extremely low frequencies (<0.1 GHz)
If an Arbitrary Rectangular waveguide with inner conductor(s) and thus TEM modes is used to simulate a circuit
at extremely low frequencies (<0.1 GHz), the results produced will be very probably inaccurate. In such case,
the user should increase only the number of reference box modes and the number of Green function terms.
This problem has two correlated causes:
1. The Integral Equation method shows numeric instabilities at extremely low frequencies and fails at
exactly zero frequency.
2. The coupling integrals corresponding to the possible connections between the Arbitrary Rectangular
modes (in particular the TEM modes) and the connected waveguides modes are computed numerically
and are thus not analitically exact. This numeric error enhances the above numeric instabilities resulting
in low accuracy.
The proposed solution (increase only the number of reference box modes and the number of Green function
terms) produces more accurate coupling integrals and thus solves the problem for the used frequency range.
Be aware that, by going further down in frequency range, the problem will re-appear.
The accuracy vs. speed tradeoffs of this element are also treated in a subsection of Tutorial 3: Accuracy or Speed?
Errors
The Arbitrary Rectangular waveguide can produce the following errors under certain circumstances. For each error, the
possible solutions or workarounds are explained.
The Enabled/Disabled button allows enabling and disabling this element, as described in the Main Window Edit
menu.
Number of box modes: number of modes in the reference box used to generate the modes of the
arbitrary cross-section. By default the number of reference box modes is 0, which means that it will be
autocomputed
The Material and EM Field tabs allow customizing, respectively, the physical material properties and the
electromagnetic resolution for the current waveguide, as described in the Waveguides Common Properties section.
Ports tab shows the discontinuities connected to this waveguide, as described in the Waveguides Common Properties
section.
Hints
It is always recommended to use a reference box of the same size as the surrounding rectangular or
arbitrary waveguides.
When connected to a waveguide with dimensions different from the box ones, some convergence
problems can arise: it is recommended to increase the precision of the computation.
If the number of reference box modes is set to "0", an attempt to calculate the required number of
reference box modes in order to have enough precision is done.
If unexpected results are obtained, verify that the "x" in the arbitrary shape editor is within the region of
interest.
Errors The possible errors produced by this element, and solutions or workarounds to them.
Using the Coaxial How to create, edit and use this element from FEST3D.
Definition
The Coaxial waveguide is a uniform, coaxial waveguide with a circular inner conductor and either a circular or a
rectangular outer conductor.
Limitations
The Coaxial waveguide has the same limitations and caveats as the Arbitrary Rectangular waveguide.
The accuracy vs speed tradeoffs of this element are also treated in a subsection of Tutorial 3: Accuracy or Speed?
Errors
The Coaxial waveguide can produce the same errors as the Arbitrary Rectangular waveguide.
The Enabled/Disabled button allows enabling and disabling this element, as described in the Main Window Edit
menu.
The SubType option allows defining the waveguide subtype and related parameters, as described in the Waveguides
Common Properties section.
By clicking on the Use General Specifications button, each waveguide can be configured to use either the default
values for the modal parameters (stored in the General Specifications window) or the values specified by the user in
each waveguide.
The following parameters can be edited:
Number of box modes: number of modes in the reference box used to generate the modes of the arbitrary
cross-section. By default the number of reference box modes is 0, which means that it will be autocomputed.
A of reference box (mm): reference box width.
B of reference box (mm): reference box height.
Outer Conductor Shape: either rectangular or circular
Inner Radius (mm): radius of the inner circular conductor.
L (mm): waveguide length.
Center X offset (mm): horizontal offset of the inner conductor center, relative to the reference box center.
Center Y offset (mm): vertical offset of the inner conductor center, relative to the reference box center.
Material and EM Field tabs allow customizing, respectively, the physical material properties and the electromagnetic
resolution for the current waveguide, as described in the Waveguides Common Properties section.
Hints
It is always recommended to use a reference box of the same size as the surrounding rectangular or arbitrary
waveguides.
When connected to a waveguide with dimensions different from the box ones, some convergence problems
can arise: it is recommended to increase the precision of the computation.
If the number of reference box modes is set to "0", an attempt to calculate the required number of reference
box modes in order to have enough precision is done.
Errors The possible errors produced by this element, and solutions or workarounds to them.
Using the cross How to create, edit and use this element from FEST3D.
Definition
The Cross waveguide is a uniform waveguide with two arms of a given width. The extremes of the arms can be
rounded. The following figure shows the element:
The Cross waveguide is a special case of the more general element Arbitrary Rectangular, and thus also uses the
concept of reference box: a fictitious rectangular waveguide which must completely include the cross section of the
real waveguide.
Limitations
The Cross waveguide has the same limitations and caveats as the Arbitrary Rectangular waveguide.
The accuracy vs speed tradeoffs of this element are also treated in a subsection of Tutorial 3: Accuracy or Speed?
Errors
The cross waveguide can produce the same errors as the Arbitrary Rectangular waveguide.
The Enabled/Disabled button allows enabling and disabling this element, as described in the Main Window Edit
menu.
The SubType option allows defining the waveguide subtype and related parameters, as described in the Waveguides
Common Properties section.
By clicking on the Use General Specifications button, each waveguide can be configured to use either the default
values for the modal parameters (stored in the General Specifications window) or the values specified by the user in
each waveguide.
The following parameters can be edited:
Number of box modes: number of modes in the reference box used to generate the modes of the arbitrary
cross-section. By default the number of reference box modes is 0, which means that it will be autocomputed.
Abox reference box(mm): reference box width.
Bbox reference box(mm): reference box height.
A (if 0, A=Abox)(mm): length of horizntal arm.
B (if 0, B=Bbox)(mm): length of vertical arm.
Material and EM Field tabs allow customizing, respectively, the physical material properties and the electromagnetic
resolution for the current waveguide, as described in the Waveguides Common Properties section.
Ports tab shows the discontinuities connected to this waveguide, as described in the Waveguides Common Properties
section.
Hints
It is always recommended to use a reference box of the same size as the surrounding rectangular or arbitrary
waveguides.
When connected to a waveguide with dimensions different from the box ones, some convergence problems
can arise: it is recommended to increase the precision of the computation.
If the number of reference box modes is set to "0", an attempt to calculate the required number of reference
box modes in order to have enough precision is done.
Errors The possible errors produced by this element, and solutions or workarounds to them.
Using the draft How to create, edit and use this element from FEST3D.
Definition
The Draft waveguide is a rectangular waveguide in which the lateral walls have a triangular shape due to
manufacturing processes. The following figure shows the element:
The Draft waveguide is a special case of the more general element Arbitrary Rectangular, and thus also uses the
concept of reference box: a fictitious rectangular waveguide which must completely include the draft section of the
real waveguide.
Limitations
The Draft waveguide has the same limitations and caveats as the Arbitrary Rectangular waveguide.
The accuracy vs speed tradeoffs of this element are also treated in a subsection of Tutorial 3: Accuracy or Speed?
Errors
The draft waveguide can produce the same errors as the Arbitrary Rectangular waveguide.
The Enabled/Disabled button allows enabling and disabling this element, as described in the Main Window Edit
menu.
The SubType option allows defining the waveguide subtype and related parameters, as described in the Waveguides
Common Properties section.
By clicking on the Use General Specifications button, each waveguide can be configured to use either the default
values for the modal parameters (stored in the General Specifications window) or the values specified by the user in
each waveguide.
The following parameters can be edited:
Number of box modes: number of modes in the reference box used to generate the modes of the arbitrary
cross-section. By default the number of reference box modes is 0, which means that it will be autocomputed.
Abox reference box(mm): reference box width.
Bbox reference box(mm): reference box height.
A (if 0, A=Abox)(mm): width of draft waveguide.
B (if 0, B=Bbox)(mm): height of draft waveguide.
Material and EM Field tabs allow customizing, respectively, the physical material properties and the electromagnetic
resolution for the current waveguide, as described in the Waveguides Common Properties section.
Ports tab shows the discontinuities connected to this waveguide, as described in the Waveguides Common Properties
section.
Hints
It is always recommended to use a reference box of the same size as the surrounding rectangular or arbitrary
waveguides.
When connected to a waveguide with dimensions different from the box ones, some convergence problems
can arise: it is recommended to increase the precision of the computation.
If the number of reference box modes is set to "0", an attempt to calculate the required number of reference
box modes in order to have enough precision is done.
Errors The possible errors produced by this element, and solutions or workarounds to them.
Using the Elliptic How to create, edit and use this element from FEST3D.
Definition
The Elliptic waveguide is a uniform waveguide with elliptic cross-section as shown in the following legend.
The Elliptic waveguide is a special case of the more general element Arbitrary Rectangular, and thus also uses the
concept of reference box: a fictitious rectangular waveguide which must completely include the cross section of the
real waveguide.
Limitations
The Elliptic waveguide has the same limitations and caveats as the Arbitrary Rectangular waveguide.
The accuracy vs speed tradeoffs of this element are also treated in a subsection of Tutorial 3: Accuracy or Speed?
Errors
The Elliptic waveguide can produce the same errors as the Arbitrary Rectangular waveguide.
The Enabled/Disabled button allows enabling and disabling this element, as described in the Main Window Edit
menu.
The SubType option allows defining the waveguide subtype and related parameters, as described in the Waveguides
Common Properties section.
By clicking on the Use General Specifications button, each waveguide can be configured to use either the default
values for the modal parameters (stored in the General Specifications window) or the values specified by the user in
each waveguide.
The following parameters can be edited:
Number of box modes: number of modes in the reference box used to generate the modes of the arbitrary
cross-section. By default the number of reference box modes is 0, which means that it will be autocomputed.
A of reference box (mm): reference box width.
B of reference box (mm): reference box height.
A, Major Axis (mm): ellipse major (horizontal) axis.
B, Minor Axis (mm): ellipse minor (vertical) axis.
L (mm): waveguide length.
Center X offset (mm): horizontal offset of the ellipse center, relative to the reference box center.
Center Y offset (mm): vertical offset of the ellipse center, relative to the reference box center.
Rotation (degrees): rotation angle of the ellipse, counterclockwise.
Material and EM Field tabs allow customizing, respectively, the physical material properties and the electromagnetic
Hints
It is always recommended to use a reference box of the same size as the surrounding rectangular or arbitrary
waveguides.
When connected to a waveguide with dimensions different from the box ones, some convergence problems
can arise: it is recommended to increase the precision of the computation.
If the number of reference box modes is set to "0", an attempt to calculate the required number of reference
box modes in order to have enough precision is done.
Errors The possible errors produced by this element, and solutions or workarounds to them.
Using the Ridge waveguide How to create, edit and use this element from FEST3D.
Definition
The Ridge waveguide is a uniform rectangular waveguide with one or two (double ridge) rectangular metal insets in
the top and/or in the bottom of the rectangular housing. The following figure shows the element:
The Ridge waveguide is a special case of the more general element Arbitrary Rectangular, and thus also uses the
concept of reference box: a fictitious rectangular waveguide which must completely include the cross section of the
real waveguide.
Limitations
The Ridge waveguide has the same limitations and caveats as the Arbitrary Rectangular waveguide.
The accuracy vs speed tradeoffs of this element are also treated in a subsection of Tutorial 3: Accuracy or Speed?
Errors
The Ridge waveguide can produce the same errors as the Arbitrary Rectangular waveguide.
The Enabled/Disabled button allows enabling and disabling this element, as described in the Main Window Edit
menu.
The SubType option allows defining the waveguide subtype and related parameters, as described in the Waveguides
Common Properties section.
By clicking on the Use General Specifications button, each waveguide can be configured to use either the default
values for the modal parameters (stored in the General Specifications window) or the values specified by the user in
each waveguide.
The following parameters can be edited:
Number of box modes: number of modes in the reference box used to generate the modes of the arbitrary
cross-section. By default the number of reference box modes is 0, which means that it will be autocomputed.
Material and EM Field tabs allow customizing, respectively, the physical material properties and the electromagnetic
resolution for the current waveguide, as described in the Waveguides Common Properties section.
Ports tab shows the discontinuities connected to this waveguide, as described in the Waveguides Common Properties
section.
Hints
It is always recommended to use a reference box of the same size as the surrounding rectangular or arbitrary
waveguides.
When connected to a waveguide with dimensions different from the box ones, some convergence problems
can arise: it is recommended to increase the precision of the computation.
If the number of reference box modes is set to "0", an attempt to calculate the required number of reference
box modes in order to have enough precision is done.
Errors The possible errors produced by this element, and solutions or workarounds to them.
Using the ridge-gap How to create, edit and use this element from FEST3D.
Definition
The lateral coupling circular waveguide is a dumbbell-shaped element which allows a lateral rectangular coupling
between two circular cavities. The following figure shows the element:
The lateral coupling circular waveguide is a special case of the more general element Arbitrary Rectangular, and thus
also uses the concept of reference box: a fictitious rectangular waveguide which must completely include the ridge-
gap section of the real waveguide.
Limitations
The lateral coupling circular waveguide has the same limitations and caveats as the Arbitrary Rectangular waveguide.
The accuracy vs speed tradeoffs of this element are also treated in a subsection of Tutorial 3: Accuracy or Speed?
Errors
The lateral coupling circular waveguide can produce the same errors as the Arbitrary Rectangular waveguide.
The Enabled/Disabled button allows enabling and disabling this element, as described in the Main Window Edit
menu.
The SubType option allows defining the waveguide subtype and related parameters, as described in the Waveguides
Common Properties section.
By clicking on the Use General Specifications button, each waveguide can be configured to use either the default
values for the modal parameters (stored in the General Specifications window) or the values specified by the user in
each waveguide.
The following parameters can be edited:
Number of box modes: number of modes in the reference box used to generate the modes of the arbitrary
cross-section. By default the number of reference box modes is 0, which means that it will be autocomputed.
Abox reference box (mm): reference box width.
Bbox reference box (mm): reference box height.
Radius (mm): radius of the connected cylindrical cavities.
Iris height (mm): Iris width/height.
Thickness (mm): distance between circular cavities (measured as seen in the legend).
Material and EM Field tabs allow customizing, respectively, the physical material properties and the electromagnetic
resolution for the current waveguide, as described in the Waveguides Common Properties section.
Ports tab shows the discontinuities connected to this waveguide, as described in the Waveguides Common Properties
section.
Hints
It is always recommended to use a reference box of the same size as the surrounding rectangular or arbitrary
waveguides.
If the number of reference box modes is set to "0", an attempt to calculate the required number of reference
box modes in order to have enough precision is done.
Errors The possible errors produced by this element, and solutions or workarounds to them.
Using the ridge-gap How to create, edit and use this element from FEST3D.
Definition
The Ridge-gap waveguide is a uniform rectangular waveguide with rectangular metallic insertions in the top and/or
the bottom walls. Also called a multi-ridge waveguide. The following figure shows the element:
The Ridge-gap waveguide is a special case of the more general element Arbitrary Rectangular, and thus also uses the
concept of reference box: a fictitious rectangular waveguide which must completely include the ridge-gap section of
the real waveguide.
Limitations
The Ridge-gap waveguide has the same limitations and caveats as the Arbitrary Rectangular waveguide.
The accuracy vs speed tradeoffs of this element are also treated in a subsection of Tutorial 3: Accuracy or Speed?
Errors
The ridge-gap waveguide can produce the same errors as the Arbitrary Rectangular waveguide.
The Enabled/Disabled button allows enabling and disabling this element, as described in the Main Window Edit
menu.
The SubType option allows defining the waveguide subtype and related parameters, as described in the Waveguides
Common Properties section.
By clicking on the Use General Specifications button, each waveguide can be configured to use either the default
values for the modal parameters (stored in the General Specifications window) or the values specified by the user in
each waveguide.
The following parameters can be edited:
X0 Offset (mm): horizontal offset of the ridge-gap waveguide center, relative to the reference box center.
Y0 Offset (mm): vertical offset of the ridge-gap waveguide center, relative to the reference box center.
Material and EM Field tabs allow customizing, respectively, the physical material properties and the electromagnetic
resolution for the current waveguide, as described in the Waveguides Common Properties section.
Ports tab shows the discontinuities connected to this waveguide, as described in the Waveguides Common Properties
section.
Hints
It is always recommended to use a reference box of the same size as the surrounding rectangular or arbitrary
waveguides.
When connected to a waveguide with dimensions different from the box ones, some convergence problems
can arise: it is recommended to increase the precision of the computation.
If the number of reference box modes is set to "0", an attempt to calculate the required number of reference
box modes in order to have enough precision is done.
Errors The possible errors produced by this element, and solutions or workarounds to them.
Using the Square coaxial How to create, edit and use this element from FEST3D.
Definition
The Coaxial waveguide is a uniform, coaxial waveguide with both rectangular inner and outer conductors.
The Coaxial waveguide is a special case of the more general element Arbitrary Rectangular, and thus also uses the
concept of reference box: a fictitious rectangular waveguide which must completely include the cross section of the
real waveguide.
The Square coaxial waveguide supports TEM modes. Actually, it always has a single TEM mode.
Limitations
The Square coaxial waveguide has the same limitations and caveats as the Arbitrary Rectangular waveguide.
The accuracy vs speed tradeoffs of this element are also treated in a subsection of Tutorial 3: Accuracy or Speed?
Errors
The Square coaxial waveguide can produce the same errors as the Arbitrary Rectangular waveguide.
The Enabled/Disabled button allows enabling and disabling this element, as described in the Main Window Edit
menu.
The SubType option allows defining the waveguide subtype and related parameters, as described in the Waveguides
Common Properties section.
By clicking on the Use General Specifications button, each waveguide can be configured to use either the default
values for the modal parameters (stored in the General Specifications window) or the values specified by the user in
each waveguide.
The following parameters can be edited:
Number of box modes: number of modes in the reference box used to generate the modes of the arbitrary
cross-section. By default the number of reference box modes is 0, which means that it will be autocomputed.
Bar parameters:
Material and EM Field tabs allow customizing, respectively, the physical material properties and the electromagnetic
resolution for the current waveguide, as described in the Waveguides Common Properties section.
Ports tab shows the discontinuities connected to this waveguide, as described in the Waveguides Common Properties
section.
Hints
It is always recommended to use a reference box of the same size as the surrounding rectangular or arbitrary
waveguides.
When connected to a waveguide with dimensions different from the box ones, some convergence problems
can arise: it is recommended to increase the precision of the computation.
If the number of reference box modes is set to "0", an attempt to calculate the required number of reference
box modes in order to have enough precision is done.
Errors The possible errors produced by this element, and solutions or workarounds to them.
Using the slot How to create, edit and use this element from FEST3D.
Definition
The Slot waveguide is a uniform rectangular waveguide with rounded corners. The following figure shows the
element:
The Slot waveguide is a special case of the more general element Arbitrary Rectangular, and thus also uses the
concept of reference box: a fictitious rectangular waveguide which must completely include the cross section of the
real waveguide.
Limitations
The Slot waveguide has the same limitations and caveats as the Arbitrary Rectangular waveguide.
The accuracy vs speed tradeoffs of this element are also treated in a subsection of Tutorial 3: Accuracy or Speed?
Errors
The slot waveguide can produce the same errors as the Arbitrary Rectangular waveguide.
The Enabled/Disabled button allows enabling and disabling this element, as described in the Main Window Edit
menu.
The SubType option allows defining the waveguide subtype and related parameters, as described in the Waveguides
Common Properties section.
By clicking on the Use General Specifications button, each waveguide can be configured to use either the default
values for the modal parameters (stored in the General Specifications window) or the values specified by the user in
each waveguide.
The following parameters can be edited:
Number of box modes: number of modes in the reference box used to generate the modes of the arbitrary
cross-section. By default the number of reference box modes is 0, which means that it will be autocomputed.
Abox reference box(mm): reference box width.
Bbox reference box(mm): reference box height.
A (if 0, A=Abox)(mm): width of the slot waveguide.
B (if 0, B=Bbox)(mm): height of the slot waveguide.
R (mm): radius of the corners.
Material and EM Field tabs allow customizing, respectively, the physical material properties and the electromagnetic
resolution for the current waveguide, as described in the Waveguides Common Properties section.
Ports tab shows the discontinuities connected to this waveguide, as described in the Waveguides Common Properties
section.
Hints
It is always recommended to use a reference box of the same size as the surrounding rectangular or arbitrary
waveguides.
When connected to a waveguide with dimensions different from the box ones, some convergence problems
can arise: it is recommended to increase the precision of the computation.
If the number of reference box modes is set to "0", an attempt to calculate the required number of reference
box modes in order to have enough precision is done.
Errors The possible errors produced by this element, and solutions or workarounds to them.
Using the truncated How to create, edit and use this element from FEST3D.
Definition
The Truncated waveguide is a uniform circular waveguide which has been truncated by an horizontal and/or vertical
rectangular segments. The following figure shows the element:
The Truncated waveguide is a special case of the more general element Arbitrary Rectangular, and thus also uses the
concept of reference box: a fictitious rectangular waveguide which must completely include the cross section of the
real waveguide.
Limitations
The Truncated waveguide has the same limitations and caveats as the Arbitrary Rectangular waveguide.
The accuracy vs speed tradeoffs of this element are also treated in a subsection of Tutorial 3: Accuracy or Speed?
Errors
The truncated waveguide can produce the same errors as the Arbitrary Rectangular waveguide.
The EnableD/DisableD button allows enabling and disabling this element, as described in the Main Window Edit
menu.
The SubType option allows defining the waveguide subtype and related parameters, as described in the Waveguides
Common Properties section.
By clicking on the Use General Specifications button, each waveguide can be configured to use either the default
values for the modal parameters (stored in the General Specifications window) or the values specified by the user in
each waveguide.
The following parameters can be edited:
Number of box modes: number of modes in the reference box used to generate the modes of the arbitrary
cross-section. By default the number of reference box modes is 0, which means that it will be autocomputed.
Abox reference box(mm): reference box width.
Bbox reference box(mm): reference box height.
A (if 0, A=2R)(mm): width of the truncated waveguide.
B (mm): height of the truncated waveguide.
R (mm): radius of the circular waveguide.
Material and EM Field tabs allow customizing, respectively, the physical material properties and the electromagnetic
resolution for the current waveguide, as described in the Waveguides Common Properties section.
Ports tab shows the discontinuities connected to this waveguide, as described in the Waveguides Common Properties
section.
Hints
It is always recommended to use a reference box of the same size as the surrounding rectangular or arbitrary
waveguides.
When connected to a waveguide with dimensions different from the box ones, some convergence problems
can arise: it is recommended to increase the precision of the computation.
If the number of reference box modes is set to "0", an attempt to calculate the required number of reference
box modes in order to have enough precision is done.
Errors The possible errors produced by this element, and solutions or workarounds to them.
Using the waffle How to create, edit and use this element from FEST3D.
Definition
The Waffle waveguide is a uniform rectangular waveguide with rectangular metallic insertions in the top and/or the
bottom walls. Also called a multi-ridge waveguide. The following figure shows the element:
The Waffle waveguide is a special case of the more general element Arbitrary Rectangular, and thus also uses the
concept of reference box: a fictitious rectangular waveguide which must completely include the waffle section of the
real waveguide.
Limitations
The Waffle waveguide has the same limitations and caveats as the Arbitrary Rectangular waveguide.
The accuracy vs speed tradeoffs of this element are also treated in a subsection of Tutorial 3: Accuracy or Speed?
Errors
The waffle waveguide can produce the same errors as the Arbitrary Rectangular waveguide.
The Enabled/Disabled button allows enabling and disabling this element, as described in the Main Window Edit
menu.
The SubType option allows defining the waveguide subtype and related parameters, as described in the Waveguides
Common Properties section.
By clicking on the Use General Specifications button, each waveguide can be configured to use either the default
values for the modal parameters (stored in the General Specifications window) or the values specified by the user in
each waveguide.
The following parameters can be edited:
Number of box modes: number of modes in the reference box used to generate the modes of the arbitrary
cross-section. By default the number of reference box modes is 0, which means that it will be autocomputed.
Abox reference box (mm): reference box width.
X0 Offset (mm): horizontal offset of the waffle waveguide center, relative to the reference box center.
Y0 Offset (mm): vertical offset of the waffle waveguide center, relative to the reference box center.
Material and EM Field tabs allow customizing, respectively, the physical material properties and the electromagnetic
resolution for the current waveguide, as described in the Waveguides Common Properties section.
Ports tab shows the discontinuities connected to this waveguide, as described in the Waveguides Common Properties
section.
Hints
It is always recommended to use a reference box of the same size as the surrounding rectangular or arbitrary
waveguides.
When connected to a waveguide with dimensions different from the box ones, some convergence problems
can arise: it is recommended to increase the precision of the computation.
If the number of reference box modes is set to "0", an attempt to calculate the required number of reference
box modes in order to have enough precision is done.
Errors The possible errors produced by this element, and solutions or workarounds to them.
Using the Arbitrary Circular How to create, edit and use this element from FEST3D.
Definition
The Arbitrary Circular waveguide computes the modal chart of any waveguide with an arbitrary cross section defined
by a combination of linear, circular and elliptical arcs, which must be included in a fictitious, bigger circular waveguide
(reference cavity).
The reference cavity is a fictitious circular waveguide that surrounds the contour of the Arbitary Circular waveguide
and is needed by the mathematical theory used by this element (BI-RME Method).
The cross-section of this element can be composed by one or more contours, which define its geometry. Each
contour can be defined by means of straight, circular and elliptical arcs, as well as of any possible combination
between these three kinds of segments.
The user must define only the portions of the arbitrary contour that do not coincide with the surrounding circular
reference cavity. In the following pictures the contours divide the reference cavity into an internal area S, which is the
cross section of the arbitrary waveguide, and a complementary area. The cross section S is assumed to be embedded
entirely in the circular reference cavity.
The cross-section to be analyzed can have multiple inner contours, such as the ones shown in the following picture,
which defines the internal areas S,S1,S2,S3. In this case the user must be careful, since there are four regions (or areas)
that the program can use to perform the analysis. Only one region of interest (S1, S2, S3 or S) must be indicated for
modal analysis purposes.
Examples of possible geometries are shown below. The contours supported by the Arbitrary Circular waveguide can
be divided into four types:
1. closed over the cavity: a contour with two contact points placed on the external reference cavity, as in the
2. closed: a closed contour not touching the external cavity, as the following figure shows
3. stripline: a stripline consists of a narrow metal strip placed between two metallic ground planes. This element
supports the modal analysis of encapsulated strip lines, as the one included in the following figure
4. finline: a finline is an encapsulated slotline. This element supports the analysis of finlines if the dielectric
substrate of the finline and the dielectric waveguide material are the same, as shown in the following figure
where eight finlines are used
Important: The hollow section of the arbitrary waveguide is defined by the "X" point present in the mesh editor/file.
Limitations
The Arbitrary Circular waveguide has some limitations and caveats you should be aware of:
The accuracy vs speed tradeoffs of this element are also treated in a subsection of Tutorial 3: Accuracy or Speed?
Errors
The Arbitrary Circular waveguide can produce the following errors under certain circumstances. Each error and their
This error can occur if the geometry is tricky, specially when there are tangent contours involved. You can take
several actions in order to solve this problem:
Increase the number of box modes: if the source of the problem is the numerical convergence of the
method, this action might solve it.
Change the dimension of the reference box: this action is specially useful if the structure is touching the
box, for instance, where tangent contours are involved. A slightly bigger box might be able to solve the
structure correctly.
The Enabled/Disabled button allows enabling and disabling this element, as described in the Main Window Edit
menu.
The SubType option allows defining the waveguide subtype and related parameters, as described in the Waveguides
Common Properties section.
By clicking on the Use General Specifications button, each waveguide can be configured to use either the default
values for the modal parameters (stored in the General Specifications window) or the values specified by the user in
each waveguide.
The following parameters can be edited in the Specific page:
Number circular box modes: number of modes in the reference box used to generate the modes of the
arbitrary cross-section. By default the number of reference box modes is 0, which means that it will be
autocomputed.
Rbox (reference box)(mm): reference circular cavity radius.
L (mm): waveguide length.
MESH File: file containing the arbitrary cross-section. The Edit button opens the Arbitrary Shape Editor
allowing the user to view/edit it.
Material and EM Field tabs allow customizing, respectively, the physical material properties and the electromagnetic
resolution for the current waveguide, as described in the Waveguides Common Properties section.
Ports tab shows the discontinuities connected to this waveguide, as described in the Waveguides Common Properties
section.
Hints
The length of this waveguide can be zero.
It is always recommended to use a reference box of the same size as the surrounding circular or arbitrary
waveguides.
When connected to a waveguide with dimensions different from the box ones, some convergence problems
can arise: it is recommended to increase the precision of the computation.
If the number of reference box modes is set to "0", an attempt to calculate the required number of reference
box modes in order to have enough precision is done.
If strange results are obtained, verify that the "x" in the arbitrary shape editor is within the region of interest.
Using the Arbitrary Circular with an How to create, edit and use this element from FEST3D.
Ellipse
Definition
The Arbitrary Circular with an Ellipse element is an elliptic waveguide. It is a special case of the more general element
Arbitrary Circular, where the arbitrary cross section is an ellipse, as shown in the following figure:
The Arbitrary Circular with an Ellipse waveguide can only be connected to Step or N-Step discontinuities and there are
also limitations related to the connection of this element to those Step or N-Step. See the Arbitrary Circular
waveguide for further details.
Limitations
The Arbitrary Circular with an Ellipse waveguide has the same limitations and caveats as the Arbitrary Circular element
it is derived from.
Errors
The Arbitrary Circular with an Ellipse waveguide can produce the same errors as the Arbitrary Circular waveguide. It
can also produce errors if an invalid geometry is specified.
The Enabled/Disabled button allows enabling and disabling this element, as described in the Main Window Edit
menu.
The SubType option allows defining the waveguide subtype and related parameters, as described in the Waveguides
Common Properties section.
By clicking on the Use General Specifications button, each waveguide can be configured to use either the default
values for the modal parameters (stored in the General Specifications window) or the values specified by the user in
each waveguide.
The following parameters can be edited in the Specific page:
Number circular box modes: number of modes in the reference box used to generate the modes of the
Material and EM Field tabs allow customizing, respectively, the physical material properties and the electromagnetic
resolution for the current waveguide, as described in the Waveguides Common Properties section.
Ports tab shows the discontinuities connected to this waveguide, as described in the Waveguides Common Properties
section.
Hints
It is recommended to use this element when the ellipse waveguide is connected to circular waveguides. If
connected to rectangular waveguides, it is better to use the ellipse waveguide done with the arbitrary
rectangular contour.
The length of this waveguide can be zero.
It is always recommended to use a reference box of the same size as the surrounding circular or arbitrary
waveguides.
When connected to a waveguide with dimensions different from the box ones, some convergence problems
can arise: it is recommended to increase the precision of the computation.
If the number of reference box modes is set to "0", an attempt to calculate the required number of reference
box modes in order to have enough precision is done.
If strange results are obtained, verify that the "x" in the arbitrary shape editor is within the region of interest.
Errors The possible errors produced by this element, and solutions or workarounds
to them.
Using the Arbitrary Circular with a How to create, edit and use this element from FEST3D.
Cross
Definition
The Arbitrary Circular with a Cross element is a cross-shaped waveguide. It is a special case of the more general
element Arbitrary Circular, where the arbitrary cross section is always a polygonally approximated cross, as shown in
the following figure:
The Arbitrary Circular with a Cross waveguide can only be connected to Step or N-Step discontinuities and there are
also limitations related to the connection of this element to those Step or N-Step. See the Arbitrary Circular
waveguide for further details.
Limitations
The Arbitrary Circular with a Cross waveguide has the same limitations and caveats as the Arbitrary Circular element it
is derived from.
Errors
The Arbitrary Circular with a Cross waveguide can produce the same errors as the Arbitrary Circular waveguide. It can
also produce errors if an invalid geometry is specified.
The Enabled/Disabled button allows enabling and disabling this element, as described in the Main Window Edit
menu.
The SubType option allows defining the waveguide subtype and related parameters, as described in the Waveguides
Common Properties section.
By clicking on the Use General Specifications button, each waveguide can be configured to use either the default
values for the modal parameters (stored in the General Specifications window) or the values specified by the user in
each waveguide.
The following parameters can be edited in the Specific page:
Number circular box modes: number of modes in the reference box, used to generate the modes of the
arbitrary section. By default the number of reference box modes is 0, which means that it will be
autocomputed.
Rbox (reference box)(mm): reference circular cavity radius.
Material and EM Field tabs allow customizing, respectively, the physical material properties and the electromagnetic
resolution for the current waveguide, as described in the Waveguides Common Properties section.
Ports tab shows the discontinuities connected to this waveguide, as described in the Waveguides Common Properties
section.
Hints
It is recommended to use this element when the cross waveguide is connected to circular waveguides. If
connected to rectangular waveguides, it is better to use the cross waveguide done with the arbitrary
rectangular contour.
The length of this waveguide can be zero.
It is always recommended to use a reference box of the same size as the surrounding circular or arbitrary
waveguides.
When connected to a waveguide with dimensions different from the box ones, some convergence problems
can arise: it is recommended to increase the precision of the computation.
If the number of reference box modes is set to "0", an attempt to calculate the required number of reference
box modes in order to have enough precision is done.
If strange results are obtained, verify that the "x" in the arbitrary shape editor is within the region of interest.
Errors The possible errors produced by this element, and solutions or workarounds
to them.
Using the Arbitrary Circular with How to create, edit and use this element from FEST3D.
Screws
Definition
The Arbitrary Circular with Screws element is a ridged waveguide. It is a special case of the more general element
Arbitrary Circular, where the arbitrary cross section is a ridged waveguide, as shown in the following figure:
The Arbitrary Circular with Screws waveguide can only be connected to Step or N-Step discontinuities and there are
also limitations related to the connection of this element to those Step or N-Step. See the Arbitrary Circular
waveguide for further details.
Limitations
The Arbitrary Circular with Screws waveguide has the same limitations and caveats as the Arbitrary Circular element it
is derived from.
Errors
The Arbitrary Circular with Screws waveguide can produce the same errors as the Arbitrary Circular waveguide. It can
also produce errors if an invalid geometry is specified.
The Enabled/Disabled button allows enabling and disabling this element, as described in the Main Window Edit
menu.
The SubType option allows defining the waveguide subtype and related parameters, as described in the Waveguides
Common Properties section.
By clicking on the Use General Specifications button, each waveguide can be configured to use either the default
values for the modal parameters (stored in the General Specifications window) or the values specified by the user in
each waveguide.
The following parameters can be edited in the Specific page:
Number circular box modes: number of modes in the reference box used to generate the modes of the
arbitrary cross-section. By default the number of reference box modes is 0, which means that it will be
autocomputed.
Rbox (reference box) (mm): reference circular cavity radius.
L (mm): waveguide length. The Arbitrary Circular with Screws waveguide is a ridged waveguide, so L (mm) is
The following parameters can be edited for each screw in the Screws page:
Material and EM Field tabs allow customizing, respectively, the physical material properties and the electromagnetic
resolution for the current waveguide, as described in the Waveguides Common Properties section.
Ports tab shows the discontinuities connected to this waveguide, as described in the Waveguides Common Properties
section.
Hints
The length of this waveguide can be zero.
It is always recommended to use a reference box of the same size as the surrounding circular or arbitrary
waveguides.
When connected to a waveguide with dimensions different from the box ones, some convergence problems
can arise: it is recommended to increase the precision of the computation.
If the number of reference box modes is set to "0", an attempt to calculate the required number of reference
box modes in order to have enough precision is done.
If strange results are obtained, verify that the "x" in the arbitrary shape editor is within the region of interest.
Errors The possible errors produced by this element, and solutions or workarounds to them.
Using the Curved How to create, edit and use this element from FEST3D.
Definition
The Curved waveguide is a non-uniform waveguide with rectangular cross section (in the X-Y plane) and curved either
left or right (in the Z direction), as shown in the following figure:
A (mm): x-dimension of the rectangular transverse section of the curved waveguide (this direction defines the
plane of curvature).
B (mm): y-dimension of the rectangular transverse section of the curved waveguide.
Mean radius (mm): Mean curvature radius of the curved waveguide (range: R > A/2).
Curvature angle (degrees): Curvature angle (range: 0 < PHI < 360).
Curvature direction: Values can be left or right.
Furthermore, the analysis of a Curved waveguide requires the following numeric parameters:
Number of TE basis functions: Maximum value for the y-axis modal index for TE-to-Y modes (Typical value=25)
Number of TM basis functions: Maximum value for the y-axis modal index for TM-to-Y modes (Typical
value=25)
Max TE Y-direction Modal Index: Number of expansion basis functions in the v variable used to solve the TE-to-
Y modes (Typical value=25)
Max TM Y-direction Modal Index: Number of expansion basis functions in the v variable used to solve the TM-
to-Y modes (Typical value=25)
Limitations
The Curved waveguide has some limitations and caveats you should be aware of:
then edit the step [3] and set the rotation (phi) to 90 or -90 degrees.
In this way there is a 90 or -90 degrees rotation between the reference frame of the left half of the circuit and
the reference frame of the right half.
This means the second curved waveguide will become turned up or down in the global reference frame.
Of course, you must be careful with the geometry of the structure, so check that you are satisfying all
constraints.
In particular, A and B of all the waveguides in the left half must be equal to, respectively, B and A of all the
waveguides in the right half:
Aleft = Bright and Bleft = Aright
Errors
The Curved waveguide can produce errors only if invalid parameters are specified.
The Enabled/Disabled button allows enabling and disabling this element, as described in the Main Window Edit
menu.
The SubType option allows defining the waveguide subtype and related parameters, as described in the Waveguides
Common Properties section.
By clicking on the Use General Specifications button, each waveguide can be configured to use either the default
values for the modal parameters (stored in the General Specifications window) or the values specified by the user in
each waveguide.
The following parameters can be edited:
Errors The possible errors produced by this element, and solutions or workarounds to
them.
Using the Circular Elliptic How to create, edit and use this element from FEST3D.
Iris
Definition
The Circular Elliptic Iris waveguide is a uniform waveguide with elliptic cross-section.
Limitations
This element can be only used when inserted between two circular waveguides. The circular waveguides must be
larger than the elliptic iris.
The number of modes must accomplish a relation with respect to the number of green function terms:
Errors
No errors are reported.
The Enabled/Disabled button allows enabling and disabling this element, as described in the Main Window Edit
menu.
The SubType option allows defining the waveguide subtype and related parameters, as described in the Waveguides
Common Properties section.
By clicking on the Use General Specifications button, each waveguide can be configured to use either the default
values for the modal parameters (stored in the General Specifications window) or the values specified by the user in
each waveguide.
The following parameters can be edited:
Elliptical basis functions: Number of basis functions (one dimension) to expand each elliptical mode.
A (mm): Major semiaxis.
B (mm): Minor semiaxis.
L (mm): waveguide length.
Ports tab shows the discontinuities connected to this waveguide, as described in the Waveguides Common Properties
section.
Material tab allow customizing the physical material properties for the current waveguide, as described in the
Waveguides Common Properties section.
Hints
In order to rotate this element, use the rotation property of the steps attached to it.
Normally, a value of 10-20 in the number of Elliptical basis functions should be enough for precision. A value
larger than 25 should be never required for convergence. The computational time of this element strongly
depends on this parameter.
Errors The possible errors produced by this element, and solutions or workarounds to them.
Using the Radiating Array How to create, edit and use this element from FEST3D.
Definition
The Radiating Array waveguide simulates an infinite array of open-ended waveguides arranged in a doubly periodic
grid on a flat surface, as shown in the following figures:
A Radiating Array is an infinite, periodic array of waveguides, i.e. the array elements are placed in a double periodic
lattice and they are fed with the same amplitude, but with a phase constant that will change progressively from one
element to the next one.
This linear phase taper will excite a radiated beam in the direction defined by the angles (θ, φ).
Under these periodic conditions, the original problem can be reduced to the characterization of only one period of
the structure, which is called the Unit Cell (see the figures above).
The Unit Cell consists of the rectangular or circular waveguide and a fictitious waveguide, named Phase Shift Wall
waveguide (PSWW).
The PSWW represents the free space under the periodic conditions dictated by the array.
The modes used in the Phase Shift Wall waveguide are derived using the periodicity of the array and applying
Floquet's theorem [1].
For an exhaustive theoretical discussion of the problem the reader can make reference to [1].
[1] N. Amitay, V. Galindo, C. Wu. Theory and Analysis of Phased Array Antennas. Wiley-Interscience, 1972.
The geometrical parameters shown in the figures above are:
Angle α of the grid (degrees): the waveguides are arranged on a periodic grid to form the infinite array.
Allowed range: 0° < α ≤ 90°.
The grid can be either rectangular (α=90°) or triangular (α < 90°).
Width A of the array periodic cell (mm): the horizontal distance between two consecutive periodic cells.
Height B of the array periodic cell (mm): the vertical distance between two consecutive periodic cells.
The area A · B should be greater or equal than the one of the single waveguides forming the array.
Scanning angle θ (degrees): angle that defines the direction of the main beam radiated by the array.
Allowed range: -90° ≤ θ ≤ 90°.
Scanning angle φ (degrees): angle that defines the direction of the main beam radiated by the array.
Allowed range: 0° ≤ φ ≤ 180°.
Limitations
The Radiating Array waveguide has some limitations and caveats you should be aware of.
Errors
The Radiating Array waveguide can produce errors only in the case that invalid parameters are specified.
The Enabled/Disabled button allows enabling and disabling this element, as described in the Main Window Edit
menu.
The SubType option is disabled in this element, since Radiating Arrays can only be Input/Output Ports.
Ports tab shows the discontinuities connected to this waveguide, as described in the Waveguides Common Properties
section.
Material tab allow customizing the physical material properties for the current waveguide, as described in the
Waveguides Common Properties section.
The following parameters can be edited:
The remaining properties, Scanning angle θ (degrees) and Scanning angle φ (degrees) are global circuit
parameters and can be edited in the General Specification Window.
Hints
No hints
2.4.2 Discontinuities
This section describes all the discontinuities supported by FEST3D, and how they can be used as building blocks to
compose a circuit.
Definition What is exactly a FEST3D discontinuity, and how it can be used in a circuit.
Definition
In FEST3D, a discontinuity is an element describing either a cavity or a surface where one or more waveguides can be
attached. Discontinuities often have non-uniform cross-section and non-trivial 3D geometries.
Discontinuities can be only connected to waveguides.
Coordinate System
In general, the coordinate system in a port of a discontinuity is predefined for each type of discontinuity. The
discontinuities enforce the coordinate systems of the adjacent waveguides. On the other hand, in some elements such
as Step, 2D Iris and so on, the position of the coordinate system in each port has a similar behavior as the one of its
counterpart defined in waveguides, that is, it is imposed by the previous waveguide. For these elements it is important
to distinguish the coordinate system defined to expand the electromagnetic field from the coordinate system used to
define the geometry of the device. This last coordinate system is always defined at port 1 pointing the x unitary vector
to the left when looking towards the element. Read the documentation of each type of discontinuity to recover
specific information.
Discontinuities List
Unless explicitly stated, each discontinuity can be connected to an unlimited number of waveguides.
FEST3D supports the following discontinuities:
BASIC DISCONTINUITIES
N-Port User Defined An element of possibly unknown geometry, solely represented by its multi-
mode S, Z or Y matrix. FEST3D can produce S, Z, or Y matrices suitable to be
used for this element, but they can also be imported from or exported to
other E.M. simulation tools.
1-Port User Defined A monopole, solely represented by its multi-mode S, Z or Y matrix. FEST3D
can produce S, Z, or Y matrices suitable to be used for this element, but they
can also be imported from other E.M. simulation tools. It is used to evaluate
its incoming complex amplitudes (impressed modes)
Lumped element An element of possibly unknown geometry, where the user specifies the
multi-mode Z matrix. Used to create, among others, shunt elements and
transmission lines.
Coupling Matrix element An element of possibly unknown geometry, where the user specifies the
Coupling Matrix. It represents a N-order multicoupled network.
JUNCTIONS
C-Junction A cubic (hence the name) or parallelepiped cavity. Each of the six surfaces can
be connected to zero, one or more Rectangular waveguides. Each connected
waveguide can have different x,y offsets and rotation.
Y-Junction A discontinuity with planar 'Y' shape. It is based on the Arbitrary shape
(constant width/height) and has the same configurations and limitations. It
Y-Junction (60º)
must be connected to three Rectangular waveguides.
2D OMT The 2D OMT, based on the Arbitrary shape , represents an OMT among three
Rectangular waveguides. Additional posts (rectangular metal insertions and
screws) can be considered inside the OMT as well
2D compensated tee A discontinuity with planar 'T' shape with a metal insertion used to
compensation. It is based on the Arbitrary shape (constant width/height) and
has the same configurations and limitations. It must be connected to three
Rectangular waveguides.
BENDS
Stepped bend The Stepped Bend discontinuity is a special derivation of a common bend
shape between two rectangular waveguides, in which the non-shared corner
of the bend is substituted by steps. It is based on the Arbitrary shape
(constant width/height) and has the same configurations and limitations.
Mitered bend The Mitered Bend discontinuity is a special derivation of a common bend
shape between two rectangular waveguides (ports 1 and 2), in which the non-
shared corner of the bend is substituted by a mitered corner. It is based on
the Arbitrary shape (constant width/height) and has the same configurations
and limitations.
CONST WIDTH/HEIGHT
Arbitrary shape (constant A discontinuity with planar arbitrary shape. It can be used in two
width/height) configurations: constant height or constant width.
Waveguide step with N metal A discontinuity with a planar shape which represents a waveguide with N
insets metal inserts. It is based on the Arbitrary shape (constant width/height) and
has the same configurations and limitations. It must be connected to two
Rectangular waveguides.
Waveguide step with N screws A discontinuity with a planar shape that represents a waveguide with N
screws. It is based on the Arbitrary shape (constant width/height) and has the
same configurations and limitations. It must be connected to two Rectangular
waveguides.
Waveguide step with rounded A discontinuity with a planar shape which represents a step between two
Rounded corner iris The Rounded corner iris discontinuity, based on the Arbitrary shape element,
represents an iris in either constant width or height, like the one sketched in
the figure below.
2D Rounded short The 2D Rounded short, based on the Arbitrary shape , represents a one port
short waveguide.
Cavity with posts A cubic or parallelepiped cavity, containing one or more posts.
Straight feed cavity A cubic or parallelepiped cavity with a straight feed. It is based on the Cavity
with posts and has the same configurations and limitations.
Mushroom feed cavity A cubic or parallelepiped cavity with a mushroom feed. It is based on the
Cavity with posts and has the same configurations and limitations.
Straight contact feed cavity A cubic or parallelepiped cavity with a straight contact feed. It is based on the
Cavity with posts and has the same configurations and limitations.
S-Shape contact feed cavity A cubic or parallelepiped cavity with a S-shape contact feed. It is based on the
Cavity with posts and has the same configurations and limitations.
Loop feed cavity A discontinuity with a loop feed. It is based on the Cavity with posts and has
the same configurations and limitations.
Magnetic feed cavity A cubic or parallelepiped cavity with a magnetic feed. It is based on the Cavity
with posts and has the same configurations and limitations.
Top contact feed cavity A cubic or parallelepiped cavity with a top contact feed. It is based on the
Cavity with posts and has the same configurations and limitations.
General cavity A cubic or parallelepiped cavity which allows multiple coaxial and rectangular
excitations. It is based on the Cavity with posts and has the same
configurations and limitations.
HELICAL RESONATORS
Contact feed to helical resonator A cubic or parallelepiped cavity with a straight feed that contacts a helical
resonator. It is based on the Cavity with posts and has the same
configurations and limitations.
Helical resonator A cubic or parallelepiped cavity that contains one or more resonators of
helical shape. It is based on the Cavity with posts and has the same
configurations and limitations.
General rectangular cavity A cubic or parallelepiped cavity which allows multiple coaxial, circular and
rectangular excitations. It can contain different types of posts of PEC or
dielectric material.
General cylindrical cavity A cylindrical cavity which allows multiple coaxial, circular and rectangular
excitations. It can contain different types of posts of PEC or dielectric material.
Lateral couplings to cylindrical A cavity defined by two circular waveguides that is excited by lateral ports,
cavity which can be circular or rectangular.
T-Junction circular to circular A cavity defined by two circular waveguides that is excited by a lateral port
which is also a circular waveguide. It is based on the Lateral couplings to
cylindrical cavity and has the same configurations and limitations.
2.4.2.1.1 Step
This section describes the Step discontinuity and how to use it, as well as its features and limitations.
The Step discontinuity section contains the following topics:
Errors The possible errors produced by this element, and solutions or workarounds to them.
Using the Step How to create, edit and use this element from FEST3D.
Definition
The Step discontinuity is a zero-thickness surface used to attach two waveguides. It has two ports, each one
representing a waveguide. It is a special case of the more general element N-Step.
One of the attached waveguides must be the big one i.e. its cross section must contain the cross section of the other
(small) waveguide. The coordinate system of Step discontinuity is right-handed and is located at port 1 as shown in
the picture below, where the waveguide represented by port 1 is highlighted in red.
The waveguide that is represented by port 2 can be rotated and traslated with respect to the waveguide represented
by port 1, as shown in the following figure (small waveguide is port 2 , and the big waveguide is port 1, the big
waveguide is in first plane and small waveguide is in second plane):
Traslation is defined by offsets in x- and y-axis of Step discontinuity coordinate system, while rotation is defined by an
angle applied around z-axis in clockwise direction. In order to define the values for these parameters it is important to
know how FEST3D places circuit elements in their corresponding spatial position. When building a circuit, FEST3D
locates each element according to a global reference system which is right-handed and settled in the input port of the
circuit. To do so FEST3D concatenates traslations and rotations which are defined by the user in the local reference
system of certain elements. The user must be aware of transformations previously applied to a certain element in
order to properly define offsets and rotation angle in the local reference system of the current element. Depending on
previous movements, the local reference system of the element may be transformed with respect to the global
reference system.
For example, if there has been a rotation and/or a traslation before the current Step, the user must take into account
that the local reference system of the Step is rotated and/or traslated with respect to the global reference system.
Thus, when defining the values of offsets and rotation angle of the current Step, their definition must be done with
respect to the transformed local reference system.
The easiest way to properly define traslations and rotation of Step discontinuity is by connecting its port 1 to a
waveguide that whenever possible has not been previously moved. This way, the local reference system of the Step is
not transformed with respect the global coordinate system and the offsets and rotation angle will be easily defined.
The following example illustrates this fact.
waveguides 1 and 2 are aligned with z-axis of global coordinate system and
waveguide 3 is rotated 45º and traslated 2 mm in X and Y directions with respect to the global reference
system of the circuit.
To do so, Step 1 must rotate and traslate waveguide 3 with respect to waveguide 1 in order to locate it in the proper
spatial position and Step 2 must undo that transformation, so that waveguide 2 remains aligned with waveguide 1
(see the following images).
Option 1
The easiest way to define the values of offsets and rotation angle of Steps 1 and 2 is the following one:
Steps 1 and 2 connect their port 1 to waveguides 1 and 2 respectively, which means that their local reference systems
are located in these waveguides. As waveguides 1 and 2 are not rotated nor traslated in x- and y-axis with respect to
the global reference system of the circuit, local reference systems of Step 1 and 2 are not transformed.
Values of X and Y offsets and rotation angle of Steps 1 and 2 locate waveguide 3 in the same spatial position,
although being defined in different coordinate systems, which are shown in the following pictures:
Option 2
We consider now an alternative way of connecting circuit elements to obtain the same structure as before. We just
change the way Step 2 is connected: we connect port 1 of Step 2 to waveguide 3. Step 1 changes the position of
waveguide 3 and so the local coordinate system of Step 2, which is located in waveguide 3.
In the structure we want to obtain waveguides 1 and 2 are aligned, so we have to undo the transformation carried out
by Step 1 through Step 2. In order to define the offsets and rotation of Step 2, we must take into account that its local
coordinate system is also modified with respect the global coordinate system. In this case it is advisable to work
with matrix representation.
Traslations in x- and y-axis and rotations around z-axis can be defined by the following affine transformation matrix:
For the particular transformations carried out by Step 1, the matrix takes the form:
A=
cos [45] -sin [45] 0 2
sin [45] cos [45] 0 2
0 0 10
0 0 01
In order to know the specific movements that undo these tranfomations, we must compute the inverse of matrix A:
A -1 =
0.707107 0.707107 0 -2.82843
-0.707107 0.707107 0 0
0 0 1 0
0 0 0 1
which corresponds to a rotation of 45º around z-axis and a traslation of -2.82843 in x-axis. These values define Step 2
parameters:
If we do not consider that the local reference system of Step 2 is transformed by the modifications done to
waveguide 3 and define offsets and rotation of Step 2 to undo the transformations introduced by Step 1 with the
following values:
we will obtain a structure which is not what we expected. As shown in the picture below, waveguides 1 and 2 are not
aligned with the z-axis.
Please refer to the N-Step element for further details and examples, remembering that a Step is simply an N-Step with
exactly 1 small waveguide.
Errors
The Step discontinuity can produce the following errors under certain circumstances. For each error, the possible
solutions or workarounds are explained.
The Enable/Disable button allows enabling and disabling this element, as described in the Main Window Edit menu.
For the second port of the Step, the following port parameters can be edited:
X Offset (mm) the X coordinate of the port 2 waveguide center, relative to the port 1 waveguide.
Y Offset (mm) the Y coordinate of the port 2 waveguide center, relative to the port 1 waveguide.
Rotation (degrees) the rotation of the port 2 waveguide, relative to the port 1 waveguide.
2.4.2.1.2 N-Step
This section describes the N-Step discontinuity and how to use it, as well as its features and limitations.
The N-Step discontinuity section contains the following topics:
Errors The possible errors produced by this element, and solutions or workarounds to them.
Using the N-Step How to create, edit and use this element from FEST3D.
Definition
The N-Step discontinuity is a zero-thickness surface used to attach two or more waveguides.
One of the attached waveguides must be the big one i.e. its cross section must contain all the cross sections of the
other (small) waveguides.
The N-Step has as many ports as the number of attached waveguides. Ports are used to connect elements together.
In this case, each waveguide is attached to a different port of the N-Step.
The big waveguide must be attached to port 1 of the N-Step. The small waveguides must be attached to ports
number 2 and higher of the N-Step.
Each small waveguide can be rotated and translated with respect to the big waveguide, as shown in the following
figure, where the z axis is pointing outwards the screen:
The coordinate system imposed at any port of the N-Step by the previous waveguide is rotated and translated to the
others ports.
The cross sections of the small waveguides must not intersect and must be completely contained in the cross section
of the big waveguide.
For example, the following figure shows an admissible combination:
Errors
The N-Step discontinuity can produce the following errors under certain circumstances. For each error, the possible
solutions or workarounds are explained.
The following figures show a typical Element Properties dialog box for the N-Step discontinuity:
The Enable/Disable button allows enabling and disabling this element, as described in the Main Window Edit menu.
For each port of the N-Step attached to a small waveguide (i.e. all ports except the first), the following port
parameters can be edited:
X Offset (mm) the X coordinate of the small waveguide center, relative to the big waveguide.
Y Offset (mm) the Y coordinate of the small waveguide center, relative to the big waveguide.
Rotation (degrees) the rotation of the small waveguide, relative to the big waveguide.
Errors The possible errors produced by this element, and solutions or workarounds to
them.
Using the N-Port User How to create, edit and use this element from FEST3D.
Defined
Definition
The N-Port User Defined discontinuity is a general-purpose element, whose electromagnetic characteristics are
completely configurable by specifying its S, Z or Y matrices. The S, Z or Y matrices can be obtained using the Compute
Z Matrix feature of FEST3D on another circuit, or can be imported from any other software that can produce them.
This allows reducing a whole circuit to a single element, reusable in more complex circuits.
The N-Port User Defined element has many ports as specified in the S, Z or Y matrix. Each port must be connected to
a waveguide (also see Limitations below).
Limitations
The N-Port User Defined discontinuity has some limitations and caveats you should be aware of.
Frequency points
The same frequency points used for the computation of the exported matrix must be used by the circuit
containing an N-Port User Defined discontinuity.
Errors
The User Defined discontinuity can produce the following errors under certain circumstances. For each error, the
possible solutions or workarounds are explained.
Sorry, the element User Defined number n was defined with different symmetries from what is defined
in the circuit
You connected the User Defined in a circuit with different symmetries. Solution: use the same symmetries.
Sorry, in the element User Defined n the relative electric permittivity of port p does not match with the
relative electric permittivity of the circuit where it is connected to
You connected to the User Defined a waveguide filled with a different dielectric material from what is specified
in the S, Z or Y matrix file. Solution: use the same dielectric material for that port.
Sorry, in the element User Defined n the relative electric permeability of port p do not match with the
relative electric permeability of the circuit where it is connected to
You connected to the User Defined a waveguide filled with a different dielectric material from what is specified
in the S, Z or Y matrix file. Solution: use the same dielectric material for that port.
Sorry, in the element User Defined n the conductivity of port p do not match with the conductivity of
the circuit where it is connected to
You connected to the User Defined a waveguide with different conductivity from what is specified in the S, Z or
Y matrix file. Solution: use the same conductivity for that port.
Sorry, in the element User Defined the waveguide type of port does not match with the waveguide type
of circuit where it is connected to. In the element User Defined n geometrical dimensions i of port p do
not match with the circuit
You connected to the User Defined a waveguide with different dimensions from what is specified in the S, Z or
Y matrix file. Solution: use the same dimensions for that port.
In the element User Defined the number of frequency points in the input file mismatch the number of
frequency points in the circuit
Solution: use the same number of frequency points.
In the element User Defined n the frequency points in the input file mismatch the frequency points in
the circuit
Solution: use the same frequency points.
Sorry, in the element User Defined n the number of modes does not agree with the number of
accessible modes in wg. x
Solution: use the same number of modes.
Sorry, in the element User Defined the mode number k does not agree with its corresponding mode in
wg. x
Solution: use the same mode expansion.
The Enable/Disable button allows enabling and disabling this element, as described in the Main Window Edit menu.
The name and path of the file can be either entered directly (hit the Enter key when done) or chosen with the help of
an Open File dialog. The frequency and parameters ranges contained in the file are automatically read and shown in
the dialog box.
Errors The possible errors produced by this element, and solutions or workarounds to
them.
Using the 1-Port User How to create, edit and use this element from FEST3D.
Defined
Interface with FEKO How to use to interact with FEKO Simulation Software.
Definition
The 1-Port User Defined discontinuity is a general-purpose element of one port, whose electromagnetic
characteristics are completely configurable by specifying its S, Z or Y matrices. The S, Z or Y matrices can be obtained
using the Compute Z Matrix feature of FEST3D on another one port circuit, or can be imported from any other
software that can produce them.
Limitations
The 1-Port User Defined discontinuity has some limitations and caveats you should be aware of.
Frequency points
The same frequency points used for the computation of the exported matrix must be used by the circuit
containing an 1-Port User Defined discontinuity.
Errors
The 1-Port User Defined discontinuity can produce the following errors under certain circumstances. For each error,
the possible solutions or workarounds are explained.
Sorry, the element 1-Port User Defined number n was defined with different symmetries from what is
defined in the circuit
You connected the 1-Port User Defined in a circuit with different symmetries. Solution: use the same
symmetries.
Sorry, in the element 1-Port User Defined n the relative electric permittivity of port 1 do not match with
the relative electric permittivity of the circuit where it is connected to
You connected to the 1-Port User Defined a waveguide filled with a different dielectric material from what is
specified in the S, Z or Y matrix file. Solution: use the same dielectric material for that port.
Sorry, in the element 1-Port User Defined n the relative electric permeability of port 1 do not match
with the relative electric permeability of the circuit where it is connected to
You connected to the 1-Port User Defined a waveguide filled with a different dielectric material from what is
specified in the S, Z or Y matrix file. Solution: use the same dielectric material for that port.
Sorry, in the element 1-Port User Defined n the conductivity of port 1 do not match with the
conductivity of the circuit where it is connected to
You connected to the 1-Port User Defined a waveguide with different conductivity from what is specified in the
S, Z or Y matrix file. Solution: use the same conductivity for that port.
Sorry, in the element 1-Port User Defined the waveguide type of port does not match with the
waveguide type of circuit where it is connected to. In the element 1-Port User Defined n geometrical
dimensions i of port 1 does not match with the circuit
You connected to the 1-Port User Defined a waveguide with different dimensions from what is specified in the
S, Z or Y matrix file. Solution: use the same dimensions for that port.
In the element 1-Port User Defined the number of frequency points in the input file mismatch the
number of frequency points in the circuit
Solution: use the same number of frequency points.
In the element 1-Port User Defined n the frequency points in the input file mismatch the frequency
points in the circuit
Solution: use the same frequency points.
Sorry, in the element 1-Port User Defined n the number of modes does not agree with the number of
accessible modes in wg. x
Solution: use the same number of modes.
Sorry, in the element 1-Port User Defined the mode number k does not agree with its corresponding
mode in wg. x
Solution: use the same mode expansion.
The Enable/Disable button allows enabling and disabling this element, as described in the Main Window Edit menu.
The name and path of the file can be either entered directly (hit the Enter key when done) or chosen with the help of
an Open File dialog. The frequency and parameters ranges contained in the file are automatically read and shown in
the dialog box.
2.4.2.1.5 Lumped
This section describes the Lumped discontinuity and how to use it, as well as its features and limitations.
The Lumped discontinuity section contains the following topics:
Errors The possible errors produced by this element, and solutions or workarounds to them.
Using the Lumped How to create, edit and use this element from FEST3D.
Definition
The Lumped discontinuity is configured by specifying its Z matrix. The Z matrix can be completely specified by the
user, or some predefined parametrization can be used: currently supported cases are shunt elements, transmission
lines and lossless transmission lines.
The Lumped element must have exactly two ports, connected to two identical waveguides (except for their lengths).
It is even possible to Optimize the parameters used to specify the Z matrix of this element.
Limitations
The Lumped discontinuity has some limitations and caveats you should be aware of:
Errors
The Lumped discontinuity should not produce errors.
The Element Properties dialog box for the Lumped discontinuity allows the user to create impedance matrices for the
following circuit-like components:
Inverter
Parallel impedance
T configuration impedances
Each impedance can be defined as a parallel of one or more of the following basic circuit-like components:
If the value of a resistance, inductance or capacity is set to zero (respectively 0 Ohm, 0 nanoHenry or 0 nanoFarad to
be exact), then such component is assumed not to be present. This allows the following combinations of components
in parallel: RLC, RL, RC, LC, R, L, C.
The Enable/Disable button allows enabling and disabling this element, as described in the Main Window Edit menu.
Errors The possible errors produced by this element, and solutions or workarounds to them.
Using the Coupling Matrix How to create, edit and use this element from FEST3D.
Definition
The Coupling Matrix (CM) discontinuity represents a generalized multicoupled network through an N x N matrix
Limitations
The Coupling Matrix discontinuity has some limitations and caveats you should be aware of:
Errors
The Coupling Matrix discontinuity can produce the following errors under certain circumstances:
The factorization has been completed, but the factor U is exactly singular, so the solution could not be
computed. The coupling matrix set is singular, that is, the determinant of the matrix is zero.
The Element Properties dialog box for the Coupling Matrix discontinuity allows the user to create coupling matrices
with the following parameters:
It is allowed visualizing the S-Parameters calculated from the Coupling Matrix element. The frequency response is
calculated independently of the waveguides connected to the element by normalizing the source and load
2.4.2.1.7 Touchstone
This section describes the Touchstone discontinuity and how to use it, as well as its features and limitations.
The Touchstone discontinuity section contains the following topics:
Errors The possible errors produced by this element, and solutions or workarounds to them.
Using the Touchstone How to create, edit and use this element from FEST3D.
Definition
The Touchstone discontinuity is a general-purpose element, whose electromagnetic characteristics are
completely specified by loading a Touchstone® file (also known as SnP file), which is an ASCII text file used for
documenting a N-port network parameter data. The Touchstone discontinutiy only allows Version 1.0
Touchstone® files (".ts" Version 2.0 extension is not allowed).
Limitations
The Touchstone discontinuity has some limitations and caveats you should be aware of:
Errors
The Touchstone discontinuity can produce the following errors under certain circumstances related to the loading of
the Touchstone® file:
Error loading the option line in touchstone file. The allowed values for the frequency units are: GHz, MHz, KHz
and Hz.
Error loading the option line in touchstone file. Only Scattering parameters (S) are allowed.
Error loading the option line in touchstone file. The allowed values for the format data are: RI for real-
imaginary, MA for magnitude-angle and DB for dB-angle (dB=20*log10|magnitude|).
Error loading the option line in touchstone file. The reference resistance to which the parameters are
normalized must be a positive number in Ohms. Zero value will consider the parameters as not renormalized.
Error loading the option line in touchstone file. The option line must be formatted as follows: # <frequency
unit> <parameter> <format> R <n>.
Error loading the option line in touchstone file. Option parameters not found in touchstone file.
The Enable/Disable button allows enabling and disabling this element, as described in the Main Window Edit menu.
The name and path of the file can be either entered directly (hit the Enter key when done) or chosen with the help of
an Open File dialog.
Errors The possible errors produced by this element, and solutions or workarounds to
them.
Using the Rounded corner iris How to create, edit and use this element from FEST3D.
3D
Definition
The Rounded corner iris discontinuity represents an iris with rounded corners which are built in the H- or E-plane. Top
and side views for both planes are sketched in the figures below.
The Rounded corner iris 3D discontinuity is an extension of the rounded corner iris (2D), which allows geometries not
purely inductive or capacitive.
Limitations
This element has some limitations and caveats you should be aware of:
High memory consumption using parallelization in circuits with many irises
If small values of mesh sizes are specified (for high accuracy or convergence tests), then very large meshes and
dense matrices are required in the simulation, consuming an important amount of RAM. Once the meshing of
the element is performed, the information window will show an estimation of the maximum total memory that
will be used during calculations. Besides, the software will automatically detect if the memory requirements are
greater than the RAM memory available in the system, and will stop the simulation if necessary. If there are
several different irises in the circuit, and multicore simulation is desired, it is important to take into
account that these RAM requirements are increased, and a slowdown in the computer performance might
be encountered. For those cases, it is recommended to employ a lower number of processors, which may allow
successfully completing a simulation that cannot be performed using more cores due to memory limitation
problems. If reducing the number of processors the memory problems still persist, it is advisable to increase
the mesh size values (reduce precision) of the posts or rounded corners in the cavity (explained in the
specifications section below) for performing the simulation.
Errors
The Rounded corner iris 3D discontinuity can produce the following errors under certain circumstances. For each error,
FATAL ERROR. Not even a single resonant mode can be obtained for this cavity. Please change the
cavity dimensions or increase the Maximum Frequency of the Solver BI-RME 3D RWG
The maximum frequency introduced is under the cut-off frequency of the cavity that contains the 3D iris, used
by the Solver BI-RME 3D RWG. Provided that the dimensions of the iris and the ports are correct, the solution is
to increase the value of this maximum frequency. It is recommended to set it to a value two or three times the
maximum frequency of the desired analysis band.
FATAL ERROR. No 3D mesh detected. Please re-check the geometry, or try to reduce the mesh size
If this error appears, it means that the meshing algorithm was able to create a 2D mesh, but not a 3D. This 3D
mesh is necessary to compute data employed for the EM fields calculations. For this reason, the simulation is
forbidden if the 3D mesh is not available. This situation may happen if a wrong geometry has been specified.
The Enable/Disable button allows enabling and disabling this element, as described in the Main Window Edit menu.
The following parameters can be edited:
The particular geometry of this element is analyzed using the electromagnetic Solver BI-RME 3D RWG. This Solver
considers Rao-Wilton-Glisson (RWG) basis functions for modelling the surface currents of the posts. This Solver
requires that the geometry is meshed with triangular patches onto which the RWG basis functions are defined.
Continuing with the description of the Element Properties, the different excitation ports of the discontinuity are
configured in the Ports tab, as shown in the figures below. This discontinuity always considers two ports. For each
port, a specification tab is shown. A waveguide must be selected from the Attached waveguide list, which will be
filled with the connections already associated to this element. For the case of the second port tab, X and Y offsets
can be set. These offsets are defined with respect to the port 1 as depicted in the legend figures (parameters
p2_off_x and p2_off_y).
If 30 or less accessible modes are employed in the rectangular waveguide, the triangle size is chosen as 1/5 of
the minimum dimension (a,b) of the waveguide.
If the number of coaxial modes is between 30 and 45, the triangle size is chosen as 0.2 times the cut-off
wavelength associated to the largest mode number desired in the rectangular waveguide.
If 45 or more modes are employed for the coaxial, the triangle size is chosen as 0.1 times the cut-off
wavelength associated to the largest mode number desired in the rectangular waveguide.
If a large amount of accessible modes is desired for the smaller waveguide port, it is necessary to take into
account that very fine meshes will be created using the automatic criterion, slowing down the simulation time
and increasing the memory consumption. Thus, it is not recommended to employ a high number of accessible
modes unless it is mandatory. If this is the case, one way to deal with the mentioned drawback is to set
manually the mesh size value for those cases, using the value that is shown in the element information as a
reference. Tests with larger values can be performed in order to find a tradeoff between convergence,
accuracy and computational cost.
Finally, it is important to remind again that the Mesh size port value is only necessary for the cases of different
port sections connected to this element, and only applies to the smaller port section. Values set to the larger
port or to any of the ports if both sections are equal, will not take any effect during simulation.
The electromagnetic fields of this discontinuity can be computed and visualized. For this purpose, The EM Field tab
allows one to specify a mesh size value associated to the maximum size of the tetrahedra employed in the meshing of
the air volume region inside the cavity. An explanation figure of the parameter is also shown in the tab. This value can
be chosen as the same as specified in the general properties of the field computation, or can be specified for the
particular element. A small value will give a more detailed resolution of the fields, but will require a longer time for the
calculations. On the other hand, very large values will lead to a poor resolution in the visualization. It is recommended
to manually set a tradeoff value taking into account the dimensions of the cavity under consideration.
Cubic Junction
T-Junction
Y-Junction (60 deg)
Y-Junction general with N screws
2D OMT
2D Compensated Tee
Errors The possible errors produced by this element, and solutions or workarounds to them.
Using the C-Junction How to create, edit and use this element from FEST3D.
Definition
The C-Junction discontinuity is a cubic or parellelepiped cavity. Each surface of the cavity can be connected to zero or
one rectangular waveguide.
The dimensions of the C-Junction are taken from the adjacent waveguides. As a maximum, the total number of
waveguides connected to the C-Junction is six.
This type of discontinuity enforces a fixed position of the coordinate system in each port. The next figure shows this
distribution.
Limitations
The C-Junction can be connected only to rectangular waveguides. Two rectangular connected waveguides with
common sides must have the same dimensions on that sides.
The dimensions a, b and c of the C-Junction can not be left undefined so at least two rectangular waveguides
have to be connect to the discontinuity.
The waveguides located in opposite C-junction faces must have the same number of accessible modes.
EM Fields can not be computed on this element
Errors
The C-Junction discontinuity can produce the following errors under certain circumstances. For each error, the
possible solutions or workarounds are explained.
The Enable/Disable button allows enabling and disabling this element, as described in the Main Window Edit menu.
The following C-Junction parameters can be edited:
These number of modes must be higher than the corresponding number of accessible modes of the adjacent
waveguides. Setting this value to 0 the number of modes taken will be equal to the corresponding number of
accessible modes.
In the lower part of the window, the number of ports are defined and the situation of each port in the C-junction is
given: front, back, right, left, top and bottom.
2.4.2.2.2 T-Junction
This section describes the T-Junction discontinuity and how to use it, as well as its features and limitations.
The T-Junction discontinuity section contains the following topics:
Using the T-Junction How to create, edit and use this element from FEST3D.
Definition
The T-Junction discontinuity is a parallelepiped cavity connected to three Rectangular waveguides, forming a T-like
shape. It is a special case of the more general element C-Junction. The dimensions of the parallelepiped cavity are
determined as the intersection of the connected Rectangular waveguides.
Please refer to the C-Junction element for further details and examples, remembering that a T-Junction is a special
case of it.
Limitations
The T-Junction discontinuity has the same limitations and caveats as the C-Junction.
The Enable/Disable button allows enabling and disabling this element, as described in the Main Window Edit menu.
In the lower part of the window, the number of ports are defined and the situation of each port in the C-junction is
given: front, back, right, left, top and bottom.
Errors The possible errors produced by this element, and solutions or workarounds to them.
Using the Y-junction How to create, edit and use this element from FEST3D.
Definition
The General Y-junction with N screws discontinuity, based on the Arbitrary shape , represents a generalized Y-junction
among three Rectangular waveguides. Additional posts (rectangular metal insertions and screws) can be considered
inside the Y-junction as well. This element is a template that lets you to specify the geometry of the circuit defining a
reduced number of parameters, without using the Arbitrary Shape Editor.
For these reasons many of the limitations and remarks of the Arbitrary shape element apply to this element as well.
The only difference comes from the definition of the coordinate system on each of the three ports.
The user can specify the geometry as shown in the following figure:
The user must specify the lengths L12, L13, L2 and L3, and the angles 2 and 3 (in degrees). All lengths and widths must
be positive. Angles can be positive, negative or zero.
Examples:
Limitations
This element has the same limitations and caveats as the Arbitrary shape it is derived from.
In addition to this, the user should be aware that only some of the most common errors (negative lengths or port
widths) are detected and suitable error messages are issued. In general, it is up to the user to ensure that the
geometry is valid.
Errors
The Y-junction discontinuity can produce the same errors as the Arbitrary shape it is derived from.
The Enable/Disable button allows enabling and disabling this element, as described in the Main Window Edit menu.
The following parameters can be edited:
L12: Distance from port 1 to the point where port 2 branch starts.
L13: Distance from port 1 to the point where port 3 branch starts.
L2: Length of port 2 branch.
L3: Length of port 3 branch.
Angle 2: Angle between port 2 and port 1.
Angle 3: Angle between port 3 and port 1.
Dielectric Permittivity: the relative dielectric permittivity of the homogeneous medium filling this element (1.0
To conclude with the specific properties tab, two checkboxes allow the user to perform Multipactor and Corona
analysis of this discontinuity.
Continuing with the description of the Element Properties, the different excitation ports of the discontinuity are
configured in the Ports tab, as shown in the figure below. This discontinuity always considers three ports. For each
port, a specification tab is shown. A waveguide must be selected from the Attached waveguide list, which will be
filled with the connections already associated to this element.
Another part of the specifications of this element is the General posts tab, as shown in the figure below. Here,
additional posts (full constant width/height) can be inserted in the geometry if desired, by pressing the Add
button. Two post shapes can be selected:
Rectangular metal insertions. The parameters of these insertions are the same as the ones defined in the
Waveguide step with N metal inserts discontinuities.
Screws. The parameters of these insertions are the same as the ones described in the Waveguide step with N
The electromagnetic fields of this discontinuity can be computed and visualized. For this purpose, The EM Field tab
allows one to specify a mesh size value associated to the maximum size of the tetrahedra employed in the meshing of
the air volume region inside the cavity. An explanation figure of the parameter is also shown in the tab. This value can
be chosen as the same as specified in the general properties of the field computation, or can be specified for the
particular element. A small value will give a more detailed resolution of the fields, but will require a longer time for the
Hints
If the two angles of the arms are set to 90 degrees, a T junction is created.
The electromagnetic Solver will perform more efficient analysis for small values of lengths of the different
branches. Larger ports can be easily considered by increasing the length of the respective waveguides attached
to this element.
Definition
The Y-junction (60 degrees) discontinuity is based on the General Y-junction with N screws discontinuity, and has the
same characteristics and limitations. The only considerations to be taken is that the angles of the arms are fixed to
60 degrees and that no screws can be positioned inside of the Y-junction.
Please refer to General Y-junction with N screws discontinuity to get more information.
2.4.2.2.5 2D OMT
This section describes the 2D OMT discontinuity and how to use it, as well as its features and limitations.
The 2D OMT section contains the following topics:
Errors The possible errors produced by this element, and solutions or workarounds to them.
Using the 2D OMT How to create, edit and use this element from FEST3D.
Definition
The 2D OMT, based on the Arbitrary shape, represents an OMT among three Rectangular waveguides. Additional
posts (rectangular metal insertions and screws) can be considered inside the OMT as well. This element is a template
that lets you to specify the geometry of the circuit defining a reduced number of parameters, without using the
Arbitrary Shape Editor.
For these reasons many of the limitations and remarks of the Arbitrary shape element apply to this element as well.
The only difference comes from the definition of the coordinate system on each of the three ports.
The user can specify the geometry as shown in the following figure:
The user must specify the lengths dn and ln for every step. Additionally port lengths lp1, lp2 and lp3 can be set.
A radius for every edge of steps can be set. Lp1, Lp2 and Lp3 and radius can be zero. Offset can be positive, negative
or zero. Rest of dimensions must be positive.
Limitations
This element has the same limitations and caveats as the Arbitrary shape it is derived from.
In addition to this, the user should be aware that only some of the most common errors (negative lengths or port
widths) are detected and suitable error messages are issued. In general, it is up to the user to ensure that the
geometry is valid.
Errors
The 2D OMT discontinuity can produce the same errors as the Arbitrary shape it is derived from.
Number of steps: (1 by default). For each step, a specific tab will appear, in which two parameters are set:
li (mm/inches): Distance l of each step (shown in the legend).
di (mm/inches): Distance d of each step (shown in the legend).
Lp1 (mm/inches): Distance from port 1 to the point where port 2 branch starts. It can be zero.
Lp2 (mm/inches): Distance from port 2 to the point where port 1 branch starts. It can be zero.
Lp3 (mm/inches): Distance from port 3 to the point where port 1 branch starts. It can be zero.
P3 Offset (mm/inches): Offset of the port 3 respect to the center of that wall.
R: Optional rounding radius used in the external corners (shown in the legend).
Dielectric Permittivity: the relative dielectric permittivity of the homogeneous medium filling this element (1.0
is vacuum).
Dielectric Permeability: the relative dielectric permeability of the homogeneous medium filling this element
(1.0 is vacuum).
Select type of geometry: Here the geometry can be specified to be Constant width or Constant height.
Maximum frequency (GHz): the highest frequency for the analysis of the component. By default, it is set
to 0.0, which means that this value is taken automatically as the double of the maximum frequency analyzed in
the circuit. A modification of the maximum simulated frequency can result in a change of the S parameters. It
could also slow down the simulation unnecessarily.
To conclude with the specific properties tab, two checkboxes allow the user to perform Multipactor and Corona
analysis of this discontinuity.
Continuing with the description of the Element Properties, the different excitation ports of the discontinuity are
configured in the Ports tab, as shown in the figure below. This discontinuity always considers three ports. For each
port, a specification tab is shown. A waveguide must be selected from the Attached waveguide list, which will be
filled with the connections already associated to this element.
Another part of the specifications of this element is the General posts tab, as shown in the figure below. Here,
additional posts (full constant width/height) can be inserted in the geometry if desired, by pressing the Add
button. Two post shapes can be selected:
Rectangular metal insertions. The parameters of these insertions are the same as the ones defined in the
Waveguide step with N metal inserts discontinuities.
Screws. The parameters of these insertions are the same as the ones described in the Waveguide step with N
screws discontinuities.
The electromagnetic fields of this discontinuity can be computed and visualized. For this purpose, The EM Field tab
Hints
The electromagnetic Solver will perform more efficient analysis for small values of lengths of the different
branches. Larger ports can be easily considered by increasing the length of the respective waveguides attached
to this element.
Errors The possible errors produced by this element, and solutions or workarounds to
them.
Using the 2D Compensated How to create, edit and use this element from FEST3D.
tee
Definition
The 2D Compensated Tee, based on the Arbitrary shape, represents a T-junction among three Rectangular
waveguides. Additional posts (rectangular metal insertions and screws) can be considered inside the T-junction as
well. This element is a template that lets you to specify the geometry of the circuit defining a reduced number of
parameters, without using the Arbitrary Shape Editor.
For these reasons many of the limitations and remarks of the Arbitrary shapeelement apply to this element as well.
The only difference comes from the definition of the coordinate system on each of the three ports.
The user can specify the geometry as shown in the following figure:
The user must specify the lengths Lp1, Lp2, Lp3 and the dimensions of the insertion Wi, Li, Ri, Re, Rp and its offset.
Lp1, Lp2 and Lp3 and radius can be zero. Offset can be positive, negative or zero. Rest of dimensions must be positive.
Limitations
This element has the same limitations and caveats as the Arbitrary shapeit is derived from.
In addition to this, the user should be aware that only some of the most common errors (negative lengths or port
widths) are detected and suitable error messages are issued. In general, it is up to the user to ensure that the
geometry is valid.
Errors
The 2D Compensated Tee discontinuity can produce the same errors as the Arbitrary shapeit is derived from.
The Enable/Disable button allows enabling and disabling this element, as described in the Main Window Edit menu.
The following parameters can be edited:
Lp1: Distance from port 1 to the point where port 2 branch starts. It can be zero.
Lp2: Distance from port 2 to the point where port 1 branch starts. It can be zero.
Lp3: Distance from port 3 to the point where port 1 branch starts. It can be zero.
Offset: Offset of the insert from the mid point of port 1.
Wi: Width of metal insert.
Dielectric Permittivity: the relative dielectric permittivity of the homogeneous medium filling this element (1.0
is vacuum).
Dielectric Permeability: the relative dielectric permeability of the homogeneous medium filling this element
(1.0 is vacuum).
Select type of geometry: Here the geometry can be specified to be Constant width or Constant height.
Maximum frequency (GHz): the highest frequency for the analysis of the component. By default, it is set
to 0.0, which means that this value is taken automatically as the double of the maximum frequency analyzed in
the circuit. A modification of the maximum simulated frequency can result in a change of the S parameters. It
could also slow down the simulation unnecessarily.
To conclude with the specific properties tab, two checkboxes allow the user to perform Multipactor and Corona
analysis of this discontinuity.
Continuing with the description of the Element Properties, the different excitation ports of the discontinuity are
configured in the Ports tab, as shown in the figure below. This discontinuity always considers three ports. For each
port, a specification tab is shown. A waveguide must be selected from the Attached waveguide list, which will be
filled with the connections already associated to this element.
Another part of the specifications of this element is the General posts tab, as shown in the figure below. Here,
additional posts (full constant width/height) can be inserted in the geometry if desired, by pressing the Add
button. Two post shapes can be selected:
Rectangular metal insertions. The parameters of these insertions are the same as the ones defined in the
Waveguide step with N metal inserts discontinuities.
Screws. The parameters of these insertions are the same as the ones described in the Waveguide step with N
screws discontinuities.
The electromagnetic fields of this discontinuity can be computed and visualized. For this purpose, The EM Field tab
allows one to specify a mesh size value associated to the maximum size of the tetrahedra employed in the meshing of
the air volume region inside the cavity. An explanation figure of the parameter is also shown in the tab. This value can
be chosen as the same as specified in the general properties of the field computation, or can be specified for the
particular element. A small value will give a more detailed resolution of the fields, but will require a longer time for the
calculations. On the other hand, very large values will lead to a poor resolution in the visualization. It is recommended
to manually set a tradeoff value taking into account the dimensions of the cavity under consideration.
Hints
The electromagnetic Solver will perform more efficient analysis for small values of lengths of the different
branches. Larger ports can be easily considered by increasing the length of the respective waveguides attached
to this element.
2.4.2.3 Bends
Errors The possible errors produced by this element, and solutions or workarounds to them.
Using the Stepped Bend How to create, edit and use this element from FEST3D.
Definition
The Stepped Bend discontinuity based on the Arbitrary shape (constant width/height) , represents a special bend
shape between two rectangular waveguides (ports 1 and 2), in which the non-shared corner of the bend is made out
of steps. An optional rounding radius can be considered for defining the stepped geometry, as shown in the figure
below.
The Enable/Disable button allows enabling and disabling this element, as described in the Main Window Edit menu.
R (mm/inches): Optional rounding radius used in the external corners (shown in the legend).
Length port 1 (mm/inches): Piece of length of the port 1 (shown in the legend).
Length port 2 (mm/inches): Piece of length of the port 2 (shown in the legend).
Number of steps (1 by default). For each step, a specific tab will appear, in which two parameters are set:
li (mm/inches): Distance l of each step (shown in the legend).
di (mm/inches): Distance d of each step (shown in the legend).
Dielectric Permittivity: the relative dielectric permittivity of the homogeneous medium filling this element (1.0
is vacuum).
Dielectric Permeability: the relative dielectric permeability of the homogeneous medium filling this element
(1.0 is vacuum).
Bend direction: This direction of the turn of the bend from port 1. It can be set as "Right", "Left", ""Up" or
"Down". Depending on this parameter, the geometry will be automatically set as Constant width or Constant
height.
Max Frequency (0 = auto) (GHz): the highest frequency for the analysis of the component. In most cases
it can be set to “auto”, which means that this value is taken automatically as the double of the maximum
frequency analyzed in the circuit. A modification of the maximum simulated frequency can result in a change of
the S parameters. It could also slow down the simulation unnecessarily.
To conclude with the specific properties tab, two checkboxes allow the user to perform Multipactor and Corona
analysis of this discontinuity.
Continuing with the description of the Element Properties, the different excitation ports of the discontinuity are
configured in the Ports tab, as shown in the figure below. This discontinuity always considers two ports. For each
port, a specification tab is shown. A waveguide must be selected from the Attached waveguide list, which will be
filled with the connections already associated to this element.
The electromagnetic fields of this discontinuity can be computed and visualized. For this purpose, The EM Field tab
allows one to specify a mesh size value associated to the maximum size of the tetrahedra employed in the meshing of
the air volume region inside the cavity. An explanation figure of the parameter is also shown in the tab. This value can
be chosen as the same as specified in the general properties of the field computation, or can be specified for the
particular element. A small value will give a more detailed resolution of the fields, but will require a longer time for the
Limitations
This element has the same limitations and caveats as the Arbitrary shape discontinuity.
Errors
This element can produce the same errors as the Arbitrary shape.
Hints
Better convergence is achieved if non-zero values of Length of port 1 and 2 are used (typically 1/10 of the size
of each respective port).
Errors The possible errors produced by this element, and solutions or workarounds to them.
Using the Mitered Bend How to create, edit and use this element from FEST3D.
Definition
The Mitered Bend discontinuity based on the Arbitrary shape (constant width/height) , represents a special bend
shape between two rectangular waveguides (ports 1 and 2), in which the non-shared corner of the bend is a mitered
corner, which may have an additional intermediate point(depending on the parameters' values L1' and L2' given by
the user). An additional rounding radius can be also considered. Geometry examples are shown in the figure below.
L1 (mm/inches): Distance defined from port 2 to the mitered corner (shown in the legend).
L2 (mm/inches): Distance defined from port 1 to the mittered corner (shown in the legend).
L1' (mm/inches): Distance defined from L1 to the position of an optional intermediate point in the mitered
corner (shown in the legend).
L2 '(mm/inches): Distance defined from L2 to the position of an optional intermediate point in the mitered
corner (shown in the legend).
Length port 1 (mm/inches): Piece of length of the port 1 (shown in the legend).
Length port 2 (mm/inches): Piece of length of the port 21 (shown in the legend).
R (mm/inches): Optional rounding radius used in the external corners (shown in the legend).
Dielectric Permittivity: the relative dielectric permittivity of the homogeneous medium filling this element (1.0
is vacuum).
Dielectric Permeability: the relative dielectric permeability of the homogeneous medium filling this element
(1.0 is vacuum).
Bend direction: This direction of the turn of the bend from port 1. It can be set as "Right", "Left", ""Up" or
"Down". Depending on this parameter, the geometry will be automatically set as Constant width or Constant
height.
Max Frequency (0 = auto) (GHz): the highest frequency for the analysis of the component. In most cases
it can be set to “auto”, which means that this value is taken automatically as the double of the maximum
frequency analyzed in the circuit. A modification of the maximum simulated frequency can result in a change of
the S parameters. It could also slow down the simulation unnecessarily.
To conclude with the specific properties tab, two checkboxes allow the user to perform Multipactor and Corona
analysis of this discontinuity.
Continuing with the description of the Element Properties, the different excitation ports of the discontinuity are
configured in the Ports tab, as shown in the figure below. This discontinuity always considers two ports. For each
port, a specification tab is shown. A waveguide must be selected from the Attached waveguide list, which will be
filled with the connections already associated to this element.
The electromagnetic fields of this discontinuity can be computed and visualized. For this purpose, The EM Field tab
allows one to specify a mesh size value associated to the maximum size of the tetrahedra employed in the meshing of
the air volume region inside the cavity. An explanation figure of the parameter is also shown in the tab. This value can
be chosen as the same as specified in the general properties of the field computation, or can be specified for the
particular element. A small value will give a more detailed resolution of the fields, but will require a longer time for the
calculations. On the other hand, very large values will lead to a poor resolution in the visualization. It is recommended
Limitations
This element has the same limitations and caveats as the Arbitrary shape discontinuity.
Errors
Hints
Better convergence is achieved if non-zero values of Length of port 1 and 2 are used (typically 1/10 of the size
of each respective port).
2.4.2.3.3 2D Curved
This section describes the 2D Curved discontinuity and how to use it, as well as its features and limitations.
The 2D Curved discontinuity section contains the following topics:
Errors The possible errors produced by this element, and solutions or workarounds to them.
Using the 2D Curved How to create, edit and use this element from FEST3D.
Definition
The 2D Curved discontinuity based on the Arbitrary shape (constant width/height) , represents a curved bend shape
between two rectangular waveguides (ports 1 and 2). The user can specify the geometry as shown in the following
figure:
Limitations
This element has the same limitations and caveats as the Arbitrary shape it is derived from.
In addition to this, the user should be aware that only some of the most common errors (negative angle
or different port sizes) are detected and suitable error messages are issued. In general, it is up to the user to ensure
that the geometry is valid.
Errors
The 2D Curved discontinuity can produce the same errors as the Arbitrary shape it is derived from.
The Enable/Disable button allows enabling and disabling this element, as described in the Main Window Edit menu.
The following parameters can be edited:
Dielectric Permittivity: the relative dielectric permittivity of the homogeneous medium filling this element (1.0
is vacuum).
Dielectric Permeability: the relative dielectric permeability of the homogeneous medium filling this element
(1.0 is vacuum).
Select type of geometry: Here the geometry can be specified to be Constant width or Constant height.
Maximum frequency (GHz): the highest frequency for the analysis of the component. By default, it is set
to 0.0, which means that this value is taken automatically as the double of the maximum frequency analyzed in
the circuit. A modification of the maximum simulated frequency can result in a change of the S parameters. It
could also slow down the simulation unnecessarily.
To conclude with the specific properties tab, two checkboxes allow the user to perform Multipactor and Corona
analysis of this discontinuity.
Continuing with the description of the Element Properties, the different excitation ports of the discontinuity are
configured in the Ports tab, as shown in the figure below. This discontinuity always considers two ports. For each
port, a specification tab is shown. A waveguide must be selected from the Attached waveguide list, which will be
filled with the connections already associated to this element.
Please note that input and output waveguides must have same dimensions when being connected through this
element.
The electromagnetic fields of this discontinuity can be computed and visualized. For this purpose, The EM Field tab
allows one to specify a mesh size value associated to the maximum size of the tetrahedra employed in the meshing of
the air volume region inside the cavity. An explanation figure of the parameter is also shown in the tab. This value can
be chosen as the same as specified in the general properties of the field computation, or can be specified for the
particular element. A small value will give a more detailed resolution of the fields, but will require a longer time for the
calculations. On the other hand, very large values will lead to a poor resolution in the visualization. It is recommended
to manually set a tradeoff value taking into account the dimensions of the cavity under consideration.
Hints
For Curvature Angle > 90 degrees, it is recommended to split the bend into multiple sub-bends (connected by
zero-length waveguides) to improve performance
For Mean Radius > A, it is recommended to split the bend into multiple sub-bends (connected by zero-length
waveguides) to improve performance.
Using the Arbitrary shape (constant How to create, edit and use this element from FEST3D.
width/height)
Definition
The Arbitrary shape (constant width/height) discontinuity represents a microwave circuit that is constant along a
certain direction, but is otherwise arbitrary in the normal plane. It is employed to model rectangular waveguide
junctions where all the waveguides have the same width (parameter 'A') or height (parameter 'B'). In addition, the
centre of these waveguides must be contained in the same plane (perpendicular to the constant direction) as shown
in the following figures.
In order to geometrically define a Arbitrary shape (constant width/height) discontinuity, one must describe the
arbitrary 2D contour of the component and the position of the ports. Additionally, the user must define whether the
2D contour is extruded in the direction of the width (A) or height (B) of the connected waveguides by choosing the
appropriate "Constant height" or "Constant width" radio button.
The contour of the Arbitrary shape (constant width/height) discontinuity is described in a .mesh file that can be
generated and modified using the Arbitrary Shape Editor integrated in FEST3D. It contains a collection of straight
segments, circular and/or elliptical arcs that define a closed path (open contours are not supported). Multiple
contours are allowed, representing elements that are multiply-connected (ie. having one or more "holes"). However,
this contours cannot intersect or be mutually tangent. Furthermore, an internal contour cannot be placed within
another internal contour (see figures).
The ports of the structure can be defined as the interfaces between the discontinuity and each of the connected
Rectangular waveguides. There is no limit in the number of ports that an Arbitrary shape (constant width/height)
discontinuity can support. To define their position, the segments that define the intersection between the plane
containing the arbitrary section and the transversal plane of each connected waveguide must be marked as ports in
the Arbitrary Shape Editor.
Each port has its own fixed coordinate system, and the waveguide that is connected to such port adopts the same
coordinate system. In the previous figures, the two examples of the constant-height and constant-width components
included each port coordinate system as a reference. For other structures, the procedure to determine unambiguously
the orientation of the coordinate system for each port can be described as follows:
Starting from the 2D arbitrary contour, define the vectors tangent to the contour at the ports (t) in a
counter-clockwise sense and the normal vectors (n) pointing inwards.
From t and n, vector u can be found as u = t X n
The constant dimension of the ports will be aligned with u , meaning that for constant-height
discontinuities u = y and for constant-width discontinuities u = x.
Knowing one of the waveguide transversal components u, the other that remains unknown v (ie. v = x for
constant-height discontinuities and v = y for constant-width components), can be found following this
rule:
Regarding the parameters of the electromagnetic Solver based in the BI-RME 2D method that analyzes this
component, the user must fix a maximum frequency value as well. The maximum frequency value is related to the
higher resonant mode considered within the discontinuity when all the ports are short-circuited.
A material different from vacuum can be chosen to fill the discontinuity. In such a case, the dielectric properties
(relative dielectric permittivity and permeability) of this material must be specified.
Although this element typically represents an E-plane or H-plane component, the discontinuity accepts any
rectangular waveguide mode as excitation. Consequently, it can be regarded as a full-wave element. However, if this
element is indeed used within an E-plane or H-plane circuit, it is advised to select the general "All-capacitive" or "All-
Limitations
The Const width/height discontinuity has some limitations and caveats you should be aware of.
Some loss in accuracy should be expected if the contour includes very thin regions or internal contours very
close to the boundary or to other internal contours, as shown in the following figures.
If you cannot avoid these cases, you are recommended to set a high value of Max Frequency (see below).
Slow convergence in some cases
The simulation of some geometries, including the ones explained in low accuracy in some cases above, may
require some extra user effort to reach convergence. In particular, the default auto setting of Max Frequency
parameter explained below, may not be enough to reach convergence. In these cases, the Convergence Study
must be performed including the Max Frequency parameter with all other numeric accuracy parameters and
tuning all of them manually.
Errors
The Const width/height arbitrary shape discontinuity can produce the following errors under certain circumstances.
For each error, the possible solutions or workarounds are explained.
The Enable/Disable button allows enabling and disabling this element, as described in the Main Window Edit menu.
The following parameters can be edited:
MESH File: the file containing the arbitrary shape cross-section (profile) for this element
Edit button: The Edit button opens the Arbitrary Shape Editor allowing the user to view/edit the mesh file.
To conclude with the specific properties tab, two checkboxes allow the user to perform Multipactor and Corona
analysis of this discontinuity.
Continuing with the description of the Element Properties, the different excitation ports of the discontinuity are
configured in the Ports tab, as shown in the figure below. The number of ports that have been defined in the
MESH file appear automatically in this tab. For each port, a specification tab is shown. A waveguide must be
selected from the Attached waveguide list, which will be filled with the connections already associated to this
element.
The electromagnetic fields of this discontinuity can be computed and visualized. For this purpose, The EM Field tab
allows one to specify a mesh size value associated to the maximum size of the tetrahedra employed in the meshing of
the air volume region inside the cavity. An explanation figure of the parameter is also shown in the tab. This value can
be chosen as the same as specified in the general properties of the field computation, or can be specified for the
particular element. A small value will give a more detailed resolution of the fields, but will require a longer time for the
calculations. On the other hand, very large values will lead to a poor resolution in the visualization. It is recommended
Using the Waveguide step with N metal How to create, edit and use this element from FEST3D.
inserts
Definition
The Waveguide step with N metal inserts, based on the Arbitrary shape element, represents a waveguide with N
rectangular metal inserts of rectangular shape like the one sketched in the figure below. This element must have
constant height or width.
Limitations
This element has the same limitations as the Arbitrary shape element.
Errors
This element has the same limitations as the Arbitrary shape element.
The following picture shows a typical Element Properties dialog box for the Waveguide step with N metal inserts.
The Enable/Disable button allows enabling and disabling this element, as described in the Main Window Edit menu.
Regarding the geometry of this element, there are some particular parameters to define depending on the geometry
of the contour (squared or non-squared):
SQUARE CASE
NON-SQUARE CASE
L1 (mm/inches): The length of the waveguide with metal inserts connected to port 1.
L2 (mm/inches): The length of the waveguide with metal inserts connected to port 2.
OFFSET (mm/inches): The offset between port 1 and port 2 is positive towards the right (when looking from
port 1).
Ri (mm/inches): Radius of the internal corners.
Re (mm/inches): Radius of the external corners.
Dielectric Permittivity: the relative dielectric permittivity of the homogeneous medium filling this element (1.0
is vacuum).
Dielectric Permeability: the relative dielectric permeability of the homogeneous medium filling this element
(1.0 is vacuum).
Select type of geometry: Here the geometry can be specified to be Constant width or Constant height.
Maximum frequency (GHz): the highest frequency for the analysis of the component. By default, it is set
to 0.0, which means that this value is taken automatically as the double of the maximum frequency analyzed in
the circuit. A modification of the maximum simulated frequency can result in a change of the S parameters. It
could also slow down the simulation unnecessarily.
To conclude with the specific properties tab, two checkboxes allow the user to perform Multipactor and Corona
analysis of this discontinuity.
Continuing with the description of the Element Properties, the different excitation ports of the discontinuity are
configured in the Ports tab, as shown in the figure below. This discontinuity always considers two ports. For each
port, a specification tab is shown. A waveguide must be selected from the Attached waveguide list, which will be
filled with the connections already associated to this element.
Another part of the specifications of this element is the Metal inserts tab, as shown in the figure below.
Here, rectangular metal insertions (full constant width/height) can be set. One metal insertion is considered by default,
ready to be defined. Additional insertions can be included in the geometry if desired, by pressing the Add button.
For each metal insert, the following parameters can be edited:
The electromagnetic fields of this discontinuity can be computed and visualized. For this purpose, The EM Field tab
allows one to specify a mesh size value associated to the maximum size of the tetrahedra employed in the meshing of
the air volume region inside the cavity. An explanation figure of the parameter is also shown in the tab. This value can
be chosen as the same as specified in the general properties of the field computation, or can be specified for the
particular element. A small value will give a more detailed resolution of the fields, but will require a longer time for the
calculations. On the other hand, very large values will lead to a poor resolution in the visualization. It is recommended
to manually set a tradeoff value taking into account the dimensions of the cavity under consideration.
Hints
This element can be replaced by the N-step in many situations. Using the N-step with inductive/capacitive
symmetries in the circuit will speed up the simulation in the frequency-independent part but it may slow down
the simulation in the frequency-dependent part. Implementing a circuit with the metal insert element and with
the N-step can help to verify if the simulation result is accurate since these elements are based on completely
different numerical techniques.
The electromagnetic Solver will perform more efficient analysis for small values of L/L1/L2. Larger ports can be
easily achieved by increasing the length of the respective waveguides attached to this element.
Errors The possible errors produced by this element, and solutions or workarounds
to them.
Using the 2D Discontinuity with How to create, edit and use this element from FEST3D.
screws
Definition
The Waveguide step with N metal inserts, based on the Arbitrary shape element, represents a waveguide with N metal
inserts of circular shape (screws) like the one sketched in the figure below. This element must have constant its height
or its width.
Limitations
This element has the same limitations as the Arbitrary shape element.
Errors
This element has the same limitations as the Arbitrary shape element.
The following picture shows a typical Element Properties dialog box for the Waveguide step with N Screws.
The Enable/Disable button allows enabling and disabling this element, as described in the Main Window Edit menu.
Regarding the geometry of this element, there are some particular parameters to define depending on the geometry
of the contour (squared or non-squared):
SQUARE CASE
NON-SQUARE CASE
Dielectric Permittivity: the relative dielectric permittivity of the homogeneous medium filling this element (1.0
is vacuum).
Dielectric Permeability: the relative dielectric permeability of the homogeneous medium filling this element
(1.0 is vacuum).
Select type of geometry: Here the geometry can be specified to be Constant width or Constant height.
Maximum frequency (GHz): the highest frequency for the analysis of the component. By default, it is set
to 0.0, which means that this value is taken automatically as the double of the maximum frequency analyzed in
the circuit. A modification of the maximum simulated frequency can result in a change of the S parameters. It
could also slow down the simulation unnecessarily.
To conclude with the specific properties tab, two checkboxes allow the user to perform Multipactor and Corona
analysis of this discontinuity.
Continuing with the description of the Element Properties, the different excitation ports of the discontinuity are
configured in the Ports tab, as shown in the figure below. This discontinuity always considers two ports. For each
port, a specification tab is shown. A waveguide must be selected from the Attached waveguide list, which will be
filled with the connections already associated to this element.
Another part of the specifications of this element is the Screws tab, as shown in the figure below. Here, circular metal
insertions (full constant width/height) can be set. One screw is considered by default, ready to be defined. Additional
screws can be included in the geometry if desired, by pressing the Add button.
For each screw, the following parameters can be edited:
The electromagnetic fields of this discontinuity can be computed and visualized. For this purpose, The EM Field tab
Hints
Errors The possible errors produced by this element, and solutions or workarounds to them.
Using the Half iris rounded How to create, edit and use this element from FEST3D.
Definition
The Waveguide step with rounded corners discontinuity, based on the Arbitrary shape element, represents a transition
between two rectangular waveguides of different height or width (only one can be different at the same time)
including rounded corners.
The Waveguide step with rounded corners discontinuity is a special case of the more general element named
Arbitrary shape .
Limitations
This element has the same limitations as the Arbitrary shape element.
Errors
This element has the same limitations as the Arbitrary shape element.
The Enable/Disable button allows enabling and disabling this element, as described in the Main Window Edit menu.
The following parameters can be edited:
Dielectric Permittivity: the relative dielectric permittivity of the homogeneous medium filling this element (1.0
is vacuum).
Dielectric Permeability: the relative dielectric permeability of the homogeneous medium filling this element
(1.0 is vacuum).
Select type of geometry: Here the geometry can be specified to be Constant width or Constant height.
Maximum frequency (GHz): the highest frequency for the analysis of the component. By default, it is set
to 0.0, which means that this value is taken automatically as the double of the maximum frequency analyzed in
the circuit. A modification of the maximum simulated frequency can result in a change of the S parameters. It
could also slow down the simulation unnecessarily.
To conclude with the specific properties tab, two checkboxes allow the user to perform Multipactor and Corona
analysis of this discontinuity.
Continuing with the description of the Element Properties, the different excitation ports of the discontinuity are
configured in the Ports tab, as shown in the figure below. This discontinuity always considers two ports. For each
port, a specification tab is shown. A waveguide must be selected from the Attached waveguide list, which will be
filled with the connections already associated to this element.
The electromagnetic fields of this discontinuity can be computed and visualized. For this purpose, The EM Field tab
allows one to specify a mesh size value associated to the maximum size of the tetrahedra employed in the meshing of
the air volume region inside the cavity. An explanation figure of the parameter is also shown in the tab. This value can
be chosen as the same as specified in the general properties of the field computation, or can be specified for the
particular element. A small value will give a more detailed resolution of the fields, but will require a longer time for the
calculations. On the other hand, very large values will lead to a poor resolution in the visualization. It is recommended
to manually set a tradeoff value taking into account the dimensions of the cavity under consideration.
Errors The possible errors produced by this element, and solutions or workarounds to
them.
Using the Rounded corner How to create, edit and use this element from FEST3D.
iris
Definition
The Rounded corner iris discontinuity, based on the Arbitrary shape element, represents an iris in either constant
width or height, like the one sketched in the figure below.
The Rounded corner iris discontinuity is a special case of the more general element named Arbitrary shape .
Limitations
This element has the same limitations as the Arbitrary shape element.
Errors
This element has the same limitations as the Arbitrary shape element.
The Enable/Disable button allows enabling and disabling this element, as described in the Main Window Edit menu.
The following parameters can be edited:
Dielectric Permittivity: the relative dielectric permittivity of the homogeneous medium filling this element (1.0
is vacuum).
Dielectric Permeability: the relative dielectric permeability of the homogeneous medium filling this element
(1.0 is vacuum).
Select type of geometry: Here the geometry can be specified to be Constant width or Constant height.
Maximum frequency (GHz): the highest frequency for the analysis of the component. By default, it is set
to 0.0, which means that this value is taken automatically as the double of the maximum frequency analyzed in
the circuit. A modification of the maximum simulated frequency can result in a change of the S parameters. It
could also slow down the simulation unnecessarily.
To conclude with the specific properties tab, two checkboxes allow the user to perform Multipactor and Corona
analysis of this discontinuity.
Continuing with the description of the Element Properties, the different excitation ports of the discontinuity are
configured in the Ports tab, as shown in the figure below. This discontinuity always considers two ports. For each
port, a specification tab is shown. A waveguide must be selected from the Attached waveguide list, which will be
filled with the connections already associated to this element.
The electromagnetic fields of this discontinuity can be computed and visualized. For this purpose, The EM Field tab
allows one to specify a mesh size value associated to the maximum size of the tetrahedra employed in the meshing of
the air volume region inside the cavity. An explanation figure of the parameter is also shown in the tab. This value can
be chosen as the same as specified in the general properties of the field computation, or can be specified for the
particular element. A small value will give a more detailed resolution of the fields, but will require a longer time for the
calculations. On the other hand, very large values will lead to a poor resolution in the visualization. It is recommended
to manually set a tradeoff value taking into account the dimensions of the cavity under consideration.
Errors The possible errors produced by this element, and solutions or workarounds to
them.
Using the 2D Rounded How to create, edit and use this element from FEST3D.
Short
Definition
The 2D Rounded short, based on the Arbitrary shape , represents a one port short waveguide. This element is a
template that lets you to specify the geometry of the circuit defining a reduced number of parameters, without using
the Arbitrary Shape Editor.
For these reasons many of the limitations and remarks of the Arbitrary shape element apply to this element as well.
The user can specify the geometry as shown in the following figure:
The user must specify the length L and radius R. Neither R or L can be 0.
Limitations
This element has the same limitations and caveats as the Arbitrary shape it is derived from.
Errors
The 2D Rounded short discontinuity can produce the same errors as the Arbitrary shape it is derived from.
The Enable/Disable button allows enabling and disabling this element, as described in the Main Window Edit menu.
The following parameters can be edited:
Dielectric Permittivity: the relative dielectric permittivity of the homogeneous medium filling this element (1.0
is vacuum).
Dielectric Permeability: the relative dielectric permeability of the homogeneous medium filling this element
(1.0 is vacuum).
Select type of geometry: Here the geometry can be specified to be Constant width or Constant height.
Maximum frequency (GHz): the highest frequency for the analysis of the component. By default, it is set
to 0.0, which means that this value is taken automatically as the double of the maximum frequency analyzed in
the circuit. A modification of the maximum simulated frequency can result in a change of the S parameters. It
could also slow down the simulation unnecessarily.
To conclude with the specific properties tab, two checkboxes allow the user to perform Multipactor and Corona
analysis of this discontinuity.
Continuing with the description of the Element Properties, the different excitation ports of the discontinuity are
configured in the Ports tab, as shown in the figure below. This discontinuity always considers one port. For that
port, a waveguide must be selected from the Attached waveguide list, which will be filled with the connections
already associated to this element.
The electromagnetic fields of this discontinuity can be computed and visualized. For this purpose, The EM Field tab
allows one to specify a mesh size value associated to the maximum size of the tetrahedra employed in the meshing of
the air volume region inside the cavity. An explanation figure of the parameter is also shown in the tab. This value can
be chosen as the same as specified in the general properties of the field computation, or can be specified for the
Hints
The electromagnetic Solver will perform more efficient analysis for small values of L. Larger ports can be
easily achieved by increasing the length of the respective waveguides attached to this element.
Errors The possible errors produced by this element, and solutions or workarounds to them.
Using the Cavity with posts How to create, edit and use this element from FEST3D.
Definition
The Cavity with posts discontinuity represents a rectangular cavity with resonant posts and/or tuning screws of various
shapes, whose geometrical parameters and position are specified by the user. The posts can be positioned at any of
the 6 different surfaces of the rectangular cavity (see figure A below). Input/Output rectangular ports can also be
placed on the walls. For performing the analysis, two different electromagnetic Solver types based on the BI-RME 3D
method can be selected (see the main specifications below).
Figure A: Cavity dimensions, surface names and the local reference coordinate system employed
Regarding the geometrical specifications, several different shapes can be considered for the posts, which are shown in
figure B. By default, any post will be placed at the center of the bottom surface. The user can change this surface, and
specify an offset with respect to the center. For rectangular-shaped posts, a rotation angle can be also applied, taking
into account the main reference system defined in figure A (examples are depicted in figure C for the different
surfaces of the cavity).
Limitations
The Cavity with posts discontinuity has some limitations and caveats you should be aware of:
Connections to other elements
This element can only be connected to Rectangular waveguides.
High memory consumption using parallelization in circuits with many cavities using the Solver BI-RME
3D RWG
If the Solver BI-RME 3D RWG is selected and small values of mesh sizes are specified (for high accuracy or
convergence tests), then very large meshes and dense matrices are required in the simulation, consuming an
important amount of RAM. Once the meshing of the element is performed, the information window will show
an estimation of the maximum total memory that will be used during calculations. Besides, the software will
automatically detect if the memory requirements are greater than the RAM memory available in the system,
and will stop the simulation if necessary. If there are several different cavities in the circuit, and multicore
simulation is desired, it is important to take into account that these RAM requirements are increased,
and a slowdown in the computer performance might be encountered. For those cases, it is recommended to
employ a lower number of processors, which may allow successfully completing a simulation that cannot be
performed using more cores due to memory limitation problems. If reducing the number of processors the
memory problems still persist, it is advisable to increase the mesh size values (reduce precision) of the posts or
rounded corners in the cavity (explained in the specifications section below) for performing the simulation.
Errors
The Cavity with posts discontinuity can produce the following errors under certain circumstances. For each error, the
possible solutions or workarounds are explained.
FATAL ERROR. Not even a single resonant mode can be obtained for this cavity. Please change the
cavity dimensions or increase the Maximum Frequency of the Solver (Solver Name)
The maximum frequency introduced is under the cut-off frequency of the cavity delimited by the specified
dimensions (see the specifications of the dialog box below). Provided that these dimensions are correct, the
solution is to increase the value of this maximum frequency. It is recommended to set it to a value two or three
times the maximum frequency of the desired analysis band.
FATAL ERROR while performing simulation. (Error of some kind). Re-check the geometry, or try to
reduce mesh size(s) value(s)
The eigenvalue problem can not be solved due to problems with the building of the matrices. This error can be
produced by an illegal position of the posts not detected by FEST3D. Another source for errors in the
eigenvalue problem is that the meshing of some of the post surfaces is not accurate enough. If the positions of
the posts are correct, the mesh sizes should be reduced, specially if the dimensions of radii or lengths are small.
FATAL ERROR while performing simulation. Error while building mesh. Please try to reduce mesh size
value(s)
This error occurs when there is a problem building the internal meshing of the posts needed by this element,
when the Solver BI-RME 3D Cylindrical is selected. This problem usually appears when using posts of
mushroom or hollow type, if the mesh size value specified by the user is not adequate for the dimensions of
the post. The values used for mesh size must be reduced in order to avoid this error.
FATAL ERROR. No 3D mesh detected. Please re-check the geometry, or try to reduce mesh size of the
post(s)
The Enable/Disable button allows enabling and disabling this element, as described in the Main Window Edit menu.
The following parameters can be edited:
To conclude with the specific properties tab, two checkboxes allow the user to perform Multipactor and Corona
analysis of this discontinuity. For performing this analysis, it is necessary to choose the Solver BI-RME 3D RWG
for the simulation. Otherwise, a warning message will be shown to the user.
Continuing with the description of the Element Properties, the different excitation ports of the cavity are defined in
the Ports tab.
The ports of this element can be inserted in two ways:
By performing connections with waveguides before opening the element properties. These connections will be
automatically detected as new ports.
By pressing the Add port button (a connection with a waveguide will be required later before completing the
circuit).
For each port, a specification tab will appear. In first place, a waveguide must be selected from the Attached
waveguide list, which will be filled with the connections already associated to this element.
Additionally, for each port tab the following general information can be edited:
Surface: Specifies the surface of the cavity that is assigned to the port. This surface can be chosen in a menu
that obeys the names shown in figure A.
Offsets: Depending on the cavity surface chosen for placing the port, the coherent directions for offsets will be
displayed for each case. Following figures A and C, conventions are:
Surface Front: Only X and Y offsets can be edited (Z offset will be fixed to 0)
Surface Back: Only X and Y offsets can be edited (Z offset will be fixed to C)
Surface Right: Only Y and Z offsets can be edited (X offset will be fixed to A/2)
The offsets and the mesh size of the port only make sense if a rectangular waveguide smaller than the cavity
surface dimensions is considered. The mesh density employed for the port must be increased for large numbers of
accessible modes of the rectangular waveguide, in order to maintain the accuracy of the method. As a consequence, a
large number of accessible modes in the waveguide port will require a higher computational cost.
In order to help the user to take into account these considerations, it is recommended to set this value to zero,
allowing this way FEST3D to automatically choose an adequate value as a default. The automatic criterion employed
obeys the following rules:
If 30 or less accessible modes are employed in the rectangular waveguide, the triangle size is chosen as 1/5 of
the minimum dimension (a,b) of the waveguide.
If the number of coaxial modes is between 30 and 45, the triangle size is chosen as 0.2 times the cut-off
wavelength associated to the largest mode number desired in the rectangular waveguide.
If 45 or more modes are employed for the coaxial, the triangle size is chosen as 0.1 times the cut-off
wavelength associated to the largest mode number desired in the rectangular waveguide.
Nevertheless, in a common usage of this element, the rectangular ports will have the same dimensions as the
corresponding cavity surfaces delimited by the cavity dimensions A,B,L specified. In those cases, these
parameters (offsets and mesh size) have no meaning, and the internal electromagnetic Solver employs
analytical expressions for dealing with these ports, which require much less computational effort.
For this reason, it is recommended to build a circuit using waveguides with the same dimensions as the
cavities wherever it is possible, employing Step discontinuities if different size of waveguides is desired
between cavities. A warning message will appear in order to alert the user to have this situation in mind if
smaller ports are selected. Nevertheless, there might be some cases in which the connection of smaller
rectangular ports will be mandatory, such as when rounded corners are used in the cavity.
As a final comment, the information window will show, for each discontinuity of this kind, the exact value of the mesh
size that is being employed for the mesh discretization of the rectangular port. The user can take this value as
reference in order to manually increase it for speeding up calculations, or decreasing it if more precision is desired,
taking into account the memory limitations.
Another important part of the specifications of this element is the General Posts tab. Here, the different posts/tuning
screws desired for the geometry are defined. By default, a Cylindrical post is already considered, ready to be defined.
More posts can be inserted by selecting the post shape from the available list and pressing the Add button. It is
important to mention that if draft angle, rectangular or helical shapes are selected, simulation is only allowed
if the Solver BI-RME 3D RWG is selected.
For each post, the user can edit the specifications for the position, dimensions, mesh size and offsets of the post.
Any of the posts can be discarded by pressing the Delete post button on each tab. Depending on the shape of the
post, a specific legend with the definition of the geometrical parameters is automatically shown at the right side of the
window. Legends with the offset definitions and the other types of post shapes are also displayed for reference.
Additionally, most of the post shapes admit the definition of roundings of the cap (and the base as well for the case
of rectangular shapes). By pressing the Round the post cap/base button, a new window will appear on which the
different types of roundings available for the particular post shape can be set. The post will indicate if any cap or
base rounding has been previously activated.
The mesh size parameter indicates the density of the mesh of the associated geometry, employed by
the electromagnetic Solver. The user should change this mesh size for each particular case, taking into account the
maximum and minimum dimensions employed. The smaller the mesh size, the finest the internal meshing, which will
lead to more accurate results, but it will also slow down the simulation time. Also, very small values may produce
memory allocation problems, due to large size of the matrices involved.
The definition of this value depends on the basis functions of the selected Solver type:
For the high order cylindrical basis functions of the BI-RME 3D Cylindrical Solver, indicates the size of the
linear segments used for surface discretization.
For the triangular RWG basis functions of the BI-RME 3D RWG Solver, indicates the size of the 2D triangles
used for the surface meshing.
The user has to bear in mind that the convergence speed of the two types of basis functions is different, and
the use of the same value of mesh size might not be adequate for the both types of Solvers at the same time.
Generally, convergent results are achieved faster with the BI-RME 3D Cylindrical Solver, and smaller values will
be required for the BI-RME 3D RWG for obtaining similar accuracy. On the other hand, if very small values are
already used in the cylindrical function case, the change to RWG basis functions must be done with care, since
very large mesh densities might be produced.
The electromagnetic fields of this discontinuity can be computed and visualized. With this purpose, The EM Field tab
For general field visualizations, the mesh size value specified for the cavity will produce a uniform mesh density along
Taking as reference value the mesh size specified for the High Power algorithm (Corona or Multipactor), the
refinement procedure is applied following the scheme shown in Figure I. Considering a general cylindrical post (it can
be any of the defined shapes in Figure B), a General Refinement Area is defined around the geometrical center of the
post, consisting in a fictitious box defined in terms of the post radius. Inside this General Area, the original mesh size is
reduced by a factor 2. This means that the resolution of the fields computed inside the region is exactly the double of
the one employed in the air far from the post, according to the original value specified.
As the strongest field variations in the posts are always located at the cap of the cylindrical shape, a Cap Refinement
Area is also defined using a second box centered in the middle of the cylinder tape. The box width and height are the
same as the defined for the box of the General Area. Inside this Cap Area, the original mesh size is reduced in a factor
8. Besides, the height of this Area is also defined in terms of the mesh size specified. This definition ensures that,
independently of the value of the mesh size for the rest of the cavity, the Cap Region will always consider a higher
resolution for the field computations in this critical area, with at least 2 triangles defined around the tape in the
direction of the cylinder axis.
As final comments, the simplified scheme of Figure I only shows the case of a cylinder whose base is placed on the
bottom wall of the cavity, but the procedure is equally applied to all the posts that appear in the cavity, independently
of their orientation. Finally, this refinement procedure is also applied to the Export Fields to Spark 3D option, since the
goal of this exportation is to perform a High Power analysis as well. For this case, the mesh size associated to this tab
of the properties will be the one used for the refinement reference.
Figure I. Scheme of the automatic refinement applied to the air meshing for field computations using High Power
analysis. MS is the mesh size specified by the user for Corona, Multipactor, or general field exportation.
Errors The possible errors produced by this element, and solutions or workarounds to
them.
Using the Straight feed How to create, edit and use this element from FEST3D.
cavity
Definition
The Straight feed cavity discontinuity consists in a rectangular cavity which is excited using a straight coaxial probe.
The cavity dimensions, the local reference system, and the different surface names are depicted in figure A, and are
the same as in the Cavity with posts. The geometrical parameters and positions of the probe are shown in figure B and
can be specified by the user. Besides this main excitation block, rectangular ports and additional
resonant posts/tuning screws can be considered at any of the cavity walls. For performing the analysis, two different
electromagnetic Solver types based on the BI-RME 3D method can be selected (see the main specifications below).
Figure A: Cavity dimensions, surface names and the local reference coordinate system employed
Limitations
The Straight feed cavity discontinuity has some limitations and caveats you should be aware of:
High memory consumption using parallelization in circuits with many cavities using the Solver BI-RME
3D RWG
If the Solver BI-RME 3D RWG is selected and small values of mesh sizes are specified (for high accuracy or
convergence tests), then very large meshes and dense matrices are required in the simulation, consuming an
important amount of RAM. Once the meshing of the element is performed, the information window will show
an estimation of the maximum total memory that will be used during calculations. Besides, the software will
automatically detect if the memory requirements are greater than the RAM memory available in the system,
and will stop the simulation if necessary. If there are several different cavities in the circuit, and multicore
simulation is desired, it is important to take into account that these RAM requirements are increased,
and a slowdown in the computer performance might be encountered. For those cases, it is recommended to
employ a lower number of processors, which may allow successfully completing a simulation that cannot be
performed using more cores due to memory limitation problems. If reducing the number of processors the
memory problems still persist, it is advisable to increase the mesh size values (reduce precision) of the posts or
rounded corners in the cavity (explained in the specifications section below) for performing the simulation.
Use of probe radius larger than the inner radius of the coaxial.
The electromagnetic BI-RME 3D Solver used by this element does not directly allow modeling an excitation
probe contacting a coaxial port with a smaller inner radius. Anyway, it is possible to simulate this kind of
structures, by employing the strategy shown in the schematic below (figure C). By means of a Step
discontinuity, an additional auxiliary coaxial with zero length can be inserted between the real coaxial
waveguide and the Straight probe discontinuity, in which the radius desired for the probe can be set. This
auxiliary coaxial can be connected to the Straight probe and solved by the inner kernel. The Step will take into
account the differences between the two coaxials by computing the appropiate coupling integrals. On the
other hand, it is important to bear in mind that if a radius value smaller than the inner of coaxial is required for
the probe, there is no need to employ this strategy since this situation is directly supported by the Solver.
Figure C: Schematic example for using a probe with a radius larger the inner radius of the coaxial waveguide port.
Errors
The Straight feed cavity discontinuity can produce the following errors under certain circumstances. For each error, the
FATAL ERROR while performing simulation. (Error of some kind). Re-check the geometry, or try to
reduce mesh size(s) value(s)
The eigenvalue problem can not be solved due to problems with the building of the matrices. This error can be
produced by an illegal position of the posts not detected by FEST3D. Another source for errors in the
eigenvalue problem is that the meshing of some of the post surfaces is not accurate enough. If the positions of
the posts are correct, the mesh sizes should be reduced, specially if the dimensions of radii or lengths are small.
FATAL ERROR while performing simulation. Error while building mesh. Please try to reduce mesh size
value(s)
This error occurs when there is a problem building the internal meshing of the posts needed by this element,
when the Solver BI-RME 3D Cylindrical is selected. This problem usually appears when using posts of
mushroom or hollow type, if the mesh size value specified by the user is not adequate for the dimensions of
the post. The values used for mesh size must be reduced in order to avoid this error.
FATAL ERROR. No 3D mesh detected. Please re-check the geometry, or try to reduce mesh size of the
post(s)
If the Solver BI-RME 3D RWG is chosen, this element requires to create a 3D mesh for the whole cavity
together with the posts, from which the surface meshing of metallic objects is extracted. If this error appears, it
means that the meshing algorithm was able to create a 2D mesh, but not a 3D. This 3D mesh is necessary to
compute data employed for the EM fields calculations. For this reason, the simulation is forbidden if the 3D
mesh is not available. This situation may happen if a wrong geometry has been specified (e.g., posts colliding
with each other). The dimensions and offsets of the posts should be revised, and verified with the 3D viewer in
order to detect any possible geometrical problems. If the geometry is correct, another source for this error is
that very small air gaps are present in the cavity, which can not be dealt by the 3D meshing algorithm for the
given mesh sizes. Reducing their values might be the solution for a correct 3D mesh generation. If the problem
persists, the user can ask for support on his specific geometry.
The Enable/Disable button allows enabling and disabling this element, as described in the Main Window Edit menu.
The following parameters can be edited:
To conclude with the specific properties tab, two checkboxes allow the user to perform Multipactor and Corona
analysis of this discontinuity. For performing this analysis, it is necessary to choose the Solver BI-RME 3D RWG
for the simulation. Otherwise, a warning message will be shown to the user.
Continuing with the description of the Element Properties, the different excitation ports of the cavity are defined in
the Ports tab.
The ports of this element can be inserted in two ways:
By performing connections with waveguides before opening the element properties. These connections will be
automatically detected as new ports.
By pressing the Add port button (a connection with a waveguide will be required later before completing the
circuit).
For each port, a specification tab will appear. In first place, a waveguide must be selected from the Attached
waveguide list, which will be filled with the connections already associated to this element. If the waveguide is of
Coaxial type, a probe must selected from the Type of probe list. For this element, only the Magnetic probe is allowed.
By default, the first port tab will be already assigned to the Coaxial waveguide that is required before opening the
specifications window, as shown in Figure E. Also the probe will be automatically displayed and ready to be
configured. The rest of the ports will be configured rectangular waveguides (Figure F). Nevertheless, it is possible to
define a different order for the ports, so that the Coaxial port is not the first one.
Regarding the specific parameters of the Straight probe, the following parameters can be edited:
The mesh size parameter indicates the density of the mesh of the associated geometry, employed by
the electromagnetic Solver. The user should change this mesh size for each particular case, taking into account the
maximum and minimum dimensions employed. The smaller the mesh size, the finest the internal meshing, which will
lead to more accurate results, but it will also slow down the simulation time. Also, very small values may produce
memory allocation problems, due to large size of the matrices involved.
The definition of this value depends on the basis functions of the selected Solver type:
For the high order cylindrical basis functions of the BI-RME 3D Cylindrical Solver, indicates the size of the
linear segments used for surface discretization.
For the triangular RWG basis functions of the BI-RME 3D RWG Solver, indicates the size of the 2D triangles
used for the surface meshing.
The user has to bear in mind that the convergence speed of the two types of basis functions is different, and
the use of the same value of mesh size might not be adequate for the both types of Solvers at the same time.
Generally, convergent results are achieved faster with the BI-RME 3D Cylindrical Solver, and smaller values will
be required for the BI-RME 3D RWG for obtaining similar accuracy. On the other hand, if very small values are
already used in the cylindrical function case, the change to RWG basis functions must be done with care, since
very large mesh densities might be produced.
Figure E: Port properties of the Straight feed cavity, case of a coaxial port
Figure F: Port properties of the Straight feed cavity, case of a rectangular port
Additionally, for each port tab the following general information can be edited:
Surface: Specifies the surface of the cavity that is assigned to the port. This surface can be chosen in a menu
that obeys the names shown in figure A.
Offsets: Depending on the cavity surface chosen for placing the port, the coherent directions for offsets will be
displayed for each case. Following figures A and C, conventions are:
Surface Front: Only X and Y offsets can be edited (Z offset will be fixed to 0)
Surface Back: Only X and Y offsets can be edited (Z offset will be fixed to C)
If 30 or less accessible modes are employed in the coaxial waveguide, the triangle size is chosen as 1/5 of the
difference between the external and internal radius of the coaxial.
If the number of coaxial modes is between 30 and 45, the triangle size is chosen as 0.2 times the cut-
off wavelength associated to the largest mode number desired in the coaxial.
If 45 or more modes are employed for the coaxial, the triangle size is chosen as 0.1 times the cut-off
wavelength associated to the largest mode number desired in the coaxial.
As a final comment, the information window will show, for each discontinuity of this kind, the exact value of the mesh
size that is being employed for each port that requires meshing, as well as the number of triangles generated. The
user can take this mesh size value as reference in order to manually increase it for speeding up calculations (for very
small number of modes, the automatic criterion based on the port geometry can be relaxed without remarkable loss
of accuracy), or decreasing it if more precision is desired, taking into account the memory limitations.
Another part of the specifications of this element is the General posts tab. Here, additional resonant posts/tuning
screws can be inserted in the geometry if desired, by pressing the Add button. The post parameters and the
different shapes allowed are the same as explained in the Cavity with posts discontinuity.
The electromagnetic fields of this discontinuity can be computed and visualized. With this purpose, The EM Field tab
Errors The possible errors produced by this element, and solutions or workarounds to
them.
Using the Mushroom feed How to create, edit and use this element from FEST3D.
cavity
Definition
The Mushroom feed cavity discontinuity consists in a rectangular cavity which is excited using a coaxial probe with
two cylindrical sections (mushroom shape). The cavity dimensions, the local reference system, and the different
surface names are depicted in figure A, and are the same as in the Cavity with posts. The geometrical parameters and
positions of the probe are shown in figure B and can be specified by the user. Besides this main excitation block,
rectangular ports and additional resonant posts/tuning screws can be considered at any of the cavity walls. For
performing the analysis, two different electromagnetic Solver types based on the BI-RME 3D method can be selected
(see the main specifications below).
Figure A: Cavity dimensions, surface names and the local reference coordinate system employed
Limitations
The Mushroom feed cavity discontinuity has some limitations and caveats you should be aware of:
High memory consumption using parallelization in circuits with many cavities using the Solver BI-RME
3D RWG
If the Solver BI-RME 3D RWG is selected and small values of mesh sizes are specified (for high accuracy or
convergence tests), then very large meshes and dense matrices are required in the simulation, consuming an
important amount of RAM. Once the meshing of the element is performed, the information window will show
an estimation of the maximum total memory that will be used during calculations. Besides, the software will
automatically detect if the memory requirements are greater than the RAM memory available in the system,
and will stop the simulation if necessary. If there are several different cavities in the circuit, and multicore
simulation is desired, it is important to take into account that these RAM requirements are increased,
and a slowdown in the computer performance might be encountered. For those cases, it is recommended to
employ a lower number of processors, which may allow successfully completing a simulation that cannot be
performed using more cores due to memory limitation problems. If reducing the number of processors the
memory problems still persist, it is advisable to increase the mesh size values (reduce precision) of the posts or
rounded corners in the cavity (explained in the specifications section below) for performing the simulation.
Use of probe radius larger than the inner radius of the coaxial.
The electromagnetic BI-RME 3D Solver used by this element does not directly allow modeling an excitation
probe contacting a coaxial port with a smaller inner radius. Anyway, it is possible to simulate this kind of
structures, by employing the strategy shown in the schematic below (figure C). By means of a Step
discontinuity, an additional auxiliary coaxial with zero length can be inserted between the real coaxial
waveguide and the Straight probe discontinuity, in which the radius desired for the probe can be set. This
auxiliary coaxial can be connected to the Straight probe and solved by the inner kernel. The Step will take into
account the differences between the two coaxials by computing the appropiate coupling integrals. On the
other hand, it is important to bear in mind that if a radius value smaller than the inner of coaxial is required for
the probe, there is no need to employ this strategy since this situation is directly supported by the Solver.
Figure C: Schematic example for using a probe with a radius larger the inner radius of the coaxial waveguide port.
Errors
The Mushroom feed cavity discontinuity can produce the following errors under certain circumstances. For each error,
the possible solutions or workarounds are explained.
FATAL ERROR. Not even a single resonant mode can be obtained for this cavity. Please change the
cavity dimensions or increase the Maximum Frequency of the Solver (Solver Name)
The maximum frequency introduced is under the cut-off frequency of the cavity delimited by the specified
dimensions (see the specifications of the dialog box below). Provided that these dimensions are correct, the
solution is to increase the value of this maximum frequency. It is recommended to set it to a value two or three
times the maximum frequency of the desired analysis band.
FATAL ERROR while performing simulation. (Error of some kind). Re-check the geometry, or try to
reduce mesh size(s) value(s)
The eigenvalue problem can not be solved due to problems with the building of the matrices. This error can be
produced by an illegal position of the posts not detected by FEST3D. Another source for errors in the
eigenvalue problem is that the meshing of some of the post surfaces is not accurate enough. If the positions of
the posts are correct, the mesh sizes should be reduced, specially if the dimensions of radii or lengths are small.
FATAL ERROR while performing simulation. Error while building mesh. Please try to reduce mesh size
value(s)
This error occurs when there is a problem building the internal meshing of the posts needed by this element,
when the Solver BI-RME 3D Cylindrical is selected. This problem usually appears when using posts of
mushroom or hollow type, if the mesh size value specified by the user is not adequate for the dimensions of
the post. The values used for mesh size must be reduced in order to avoid this error.
FATAL ERROR. No 3D mesh detected. Please re-check the geometry, or try to reduce mesh size of the
post(s)
If the Solver BI-RME 3D RWG is chosen, this element requires to create a 3D mesh for the whole cavity
together with the posts, from which the surface meshing of metallic objects is extracted. If this error appears, it
means that the meshing algorithm was able to create a 2D mesh, but not a 3D. This 3D mesh is necessary to
compute data employed for the EM fields calculations. For this reason, the simulation is forbidden if the 3D
mesh is not available. This situation may happen if a wrong geometry has been specified (e.g., posts colliding
with each other). The dimensions and offsets of the posts should be revised, and verified with the 3D viewer in
order to detect any possible geometrical problems. If the geometry is correct, another source for this error is
that very small air gaps are present in the cavity, which can not be dealt by the 3D meshing algorithm for the
given mesh sizes. Reducing their values might be the solution for a correct 3D mesh generation. If the problem
persists, the user can ask for support on his specific geometry.
The Enable/Disable button allows enabling and disabling this element, as described in the Main Window Edit menu.
The following parameters can be edited:
To conclude with the specific properties tab, two checkboxes allow the user to perform Multipactor and Corona
analysis of this discontinuity. For performing this analysis, it is necessary to choose the Solver BI-RME 3D RWG
for the simulation. Otherwise, a warning message will be shown to the user.
Continuing with the description of the Element Properties, the different excitation ports of the cavity are defined in
the Ports tab.
The ports of this element can be inserted in two ways:
By performing connections with waveguides before opening the element properties. These connections will be
automatically detected as new ports.
By pressing the Add port button (a connection with a waveguide will be required later before completing the
circuit).
For each port, a specification tab will appear. In first place, a waveguide must be selected from the Attached
waveguide list, which will be filled with the connections already associated to this element. If the waveguide is of
Coaxial type, a probe must selected from the Type of probe list. For this element, only the Magnetic probe is allowed.
By default, the first port tab will be already assigned to the Coaxial waveguide that is required before opening the
specifications window, as shown in Figure E. Also the probe will be automatically displayed and ready to be
configured. The rest of the ports will be configured rectangular waveguides (Figure F). Nevertheless, it is possible to
define a different order for the ports, so that the Coaxial port is not the first one.
Regarding the specific parameters of the Mushroom probe, the following parameters can be edited:
L1 (mm/inches): Length of the first cylindrical section of the probe (see figure B).
R probe (mm/inches): The radius of the first cylindrical section of the probe (see figure B). If it is set to zero,
the default value of the inner conductor of the coaxial waveguide used as the port will be
The mesh size parameter indicates the density of the mesh of the associated geometry, employed by
the electromagnetic Solver. The user should change this mesh size for each particular case, taking into account the
maximum and minimum dimensions employed. The smaller the mesh size, the finest the internal meshing, which will
lead to more accurate results, but it will also slow down the simulation time. Also, very small values may produce
memory allocation problems, due to large size of the matrices involved.
The definition of this value depends on the basis functions of the selected Solver type:
For the high order cylindrical basis functions of the BI-RME 3D Cylindrical Solver, indicates the size of the
linear segments used for surface discretization.
For the triangular RWG basis functions of the BI-RME 3D RWG Solver, indicates the size of the 2D triangles
used for the surface meshing.
The user has to bear in mind that the convergence speed of the two types of basis functions is different, and
the use of the same value of mesh size might not be adequate for the both types of Solvers at the same time.
Generally, convergent results are achieved faster with the BI-RME 3D Cylindrical Solver, and smaller values will
be required for the BI-RME 3D RWG for obtaining similar accuracy. On the other hand, if very small values are
already used in the cylindrical function case, the change to RWG basis functions must be done with care, since
very large mesh densities might be produced.
Figure E: Port properties of the Mushroom feed cavity, case of a coaxial port
Figure F: Port properties of the Mushroom feed cavity, case of a rectangular port
Additionally, for each port tab the following general information can be edited:
Surface: Specifies the surface of the cavity that is assigned to the port. This surface can be chosen in a menu
that obeys the names shown in figure A.
Offsets: Depending on the cavity surface chosen for placing the port, the coherent directions for offsets will be
displayed for each case. Following figures A and C, conventions are:
Surface Front: Only X and Y offsets can be edited (Z offset will be fixed to 0)
Surface Back: Only X and Y offsets can be edited (Z offset will be fixed to C)
Surface Right: Only Y and Z offsets can be edited (X offset will be fixed to A/2)
If 30 or less accessible modes are employed in the coaxial waveguide, the triangle size is chosen as 1/5 of the
difference between the external and internal radius of the coaxial.
If the number of coaxial modes is between 30 and 45, the triangle size is chosen as 0.2 times the cut-
off wavelength associated to the largest mode number desired in the coaxial.
If 45 or more modes are employed for the coaxial, the triangle size is chosen as 0.1 times the cut-off
wavelength associated to the largest mode number desired in the coaxial.
As a final comment, the information window will show, for each discontinuity of this kind, the exact value of the mesh
size that is being employed for each port that requires meshing, as well as the number of triangles generated. The
user can take this mesh size value as reference in order to manually increase it for speeding up calculations (for very
small number of modes, the automatic criterion based on the port geometry can be relaxed without remarkable loss
of accuracy), or decreasing it if more precision is desired, taking into account the memory limitations.
Another part of the specifications of this element is the General posts tab. Here, additional resonant posts/tuning
screws can be inserted in the geometry if desired, by pressing the Add button. The post parameters and the
different shapes allowed are the same as explained in the Cavity with posts discontinuity.
The electromagnetic fields of this discontinuity can be computed and visualized. With this purpose, The EM Field tab
allows to specify a mesh size value associated to the maximum size of the tetrahedra employed in the meshing of the
air volume region inside the cavity. An explanation figure of the parameter is also shown in the tab. This value can be
In addition, it is also important to mention that, for performing High Power analysis, FEST3D performs an
automatic refinement procedure, which is the same as the one explained in the Cavity with posts discontinuity.
Errors The possible errors produced by this element, and solutions or workarounds
to them.
Using the Straight contact feed How to create, edit and use this element from FEST3D.
cavity
Definition
The Straight contact feed cavity discontinuity consists in a rectangular waveguide section which is excited using a
straight coaxial probe which feeds a post that is attached to any of the cavity walls orthogonal to the coaxial. The
cavity dimensions, the local reference system, and the different surface names are depicted in figure A, and are the
same as in the Cavity with Posts. The geometrical parameters and positions of the probe and the contact post are
shown in figure B and can be specified by the user. Besides this main excitation block (probe together with contact
post), rectangular ports and additional resonant posts/tuning screws can be considered at any of the cavity walls. For
performing the analysis, an electromagnetic Solver based on the BI-RME 3D method with RWG basis functions is
employed.
Figure A: Cavity dimensions, surface names and the local reference coordinate system employed
Regarding the geometrical specifications of the excitation probe, a schematic picture of a common practical case with
the contact post attached to the bottom surface is shown in figure B, including the names of the relevant dimensions
Limitations
The Straight contact feed cavity discontinuity has some limitations and caveats you should be aware of:
Use of probe radius larger than the inner radius of the coaxial.
The electromagnetic BI-RME 3D Solver used by this element does not directly allow modeling an excitation
probe contacting a coaxial port with a smaller inner radius. Anyway, it is possible to simulate this kind of
structures, by employing the strategy shown in the schematic below (figure C). By means of a Step
discontinuity, an additional auxiliary coaxial with zero length can be inserted between the real coaxial
waveguide and the Straight probe discontinuity, in which the radius desired for the probe can be set. This
auxiliary coaxial can be connected to the Straight probe and solved by the inner kernel. The Step will take into
account the differences between the two coaxials by computing the appropiate coupling integrals. On the
other hand, it is important to bear in mind that if a radius value smaller than the inner of coaxial is required for
the probe, there is no need to employ this strategy since this situation is directly supported by the Solver.
Figure C: Schematic example for using a probe with a radius larger the inner radius of the coaxial waveguide port.
Errors
The Straight contact feed cavity discontinuity can produce the following errors under certain circumstances. For each
error, the possible solutions or workarounds are explained.
FATAL ERROR. Not even a single resonant mode can be obtained for this cavity. Please change the
cavity dimensions or increase the Maximum Frequency of the Solver (Solver Name)
The maximum frequency introduced is under the cut-off frequency of the cavity delimited by the specified
dimensions (see the specifications of the dialog box below). Provided that these dimensions are correct, the
FATAL ERROR while performing simulation. (Error of some kind). Re-check the geometry, or try to
reduce mesh size(s) value(s)
The eigenvalue problem can not be solved due to problems with the building of the matrices. This error can be
produced by an illegal position of the posts not detected by FEST3D. Another source for errors in the
eigenvalue problem is that the meshing of some of the post surfaces is not accurate enough. If the positions of
the posts are correct, the mesh sizes should be reduced, specially if the dimensions of radii or lengths are small.
FATAL ERROR. No 3D mesh detected. Please re-check the geometry, or try to reduce mesh size of the
post(s)
If this error appears, it means that the meshing algorithm was able to create a 2D mesh, but not a 3D. This 3D
mesh is necessary to compute data employed for the EM fields calculations. For this reason, the simulation is
forbidden if the 3D mesh is not available. This situation may happen if a wrong geometry has been specified
(e.g., posts colliding with each other). The dimensions and offsets of the posts should be revised, and verified
with the 3D viewer in order to detect any possible geometrical problems. If the geometry is correct, another
source for this error is that very small air gaps are present in the cavity, which can not be dealt by the 3D
meshing algorithm for the given mesh sizes. Reducing their values might be the solution for a correct 3D mesh
generation. If the problem persists, the user can ask for support on his specific geometry.
The Enable/Disable button allows enabling and disabling this element, as described in the Main Window Edit menu.
The following parameters can be edited:
To conclude with the specific properties tab, two checkboxes allow the user to perform Multipactor and Corona
analysis of this discontinuity.
Continuing with the description of the Element Properties, the different excitation ports of the cavity are defined in
the Ports tab.
The ports of this element can be inserted in two ways:
By performing connections with waveguides before opening the element properties. These connections will be
automatically detected as new ports.
By pressing the Add port button (a connection with a waveguide will be required later before completing the
circuit).
For each port, a specification tab will appear. In first place, a waveguide must be selected from the Attached
waveguide list, which will be filled with the connections already associated to this element. If the waveguide is of
Coaxial type, a probe must selected from the Type of probe list. For this element, only the Straight contact probe is
allowed. For this probe, the shape of the required contact post can be chosen as well from the Type of contact post
list (a view of the different allowed contact posts is also shown at the right side of the window). By default, the first
port tab will be already assigned to the Coaxial waveguide that is required before opening the specifications window,
as shown in Figure E. Also the probe will be automatically displayed and ready to be configured. The rest of the ports
will be configured rectangular waveguides (Figure F). Nevertheless, it is possible to define a different order for the
ports, so that the coaxial port is not the first one.
Regarding the specific parameters of the Straight contact probe, the following parameters can be edited:
L post (mm/inches): The distance between the contact post and the coaxial port (see figure B).
R probe (mm/inches): The radius of the probe (see figure B). If it is set to zero, the default value of the
inner conductor of the coaxial waveguide used as the port will be considered. The electromagnetic Solver
does not directly support values larger than this inner radius, but smaller values are also allowed for
simulations. Nevertheless, it is possible to perform simulations with larger radius for the probe, by applying the
strategy described in the limitations section.
Mesh size probe (mm/inches): This parameter indicates the typical length that will be used for the triangular
mesh employed by this discontinuity for modeling the coaxial probe.
Below these probe parameters, the contact post parameters are also displayed. Depending on the shape of the post
selected, the legend at the right will show the geometrical parameters that can be edited for the particular geometry
(see figure E).
Figure E: Port properties of the Straight contact feed cavity, case of a coaxial port
Figure F: Port properties of the Straight contact feed cavity, case of a rectangular port
Additionally, for each port tab the following general information can be edited:
Surface: Specifies the surface of the cavity that is assigned to the port. This surface can be chosen in a menu
that obeys the names shown in figure A.
Offsets: Depending on the cavity surface chosen for placing the port, the coherent directions for offsets will be
displayed for each case. Following figures A and C, conventions are:
Surface Front: Only X and Y offsets can be edited (Z offset will be fixed to 0)
If 30 or less accessible modes are employed in the coaxial waveguide, the triangle size is chosen as 1/5 of the
difference between the external and internal radius of the coaxial.
If the number of coaxial modes is between 30 and 45, the triangle size is chosen as 0.2 times the cut-
off wavelength associated to the largest mode number desired in the coaxial.
If 45 or more modes are employed for the coaxial, the triangle size is chosen as 0.1 times the cut-off
wavelength associated to the largest mode number desired in the coaxial.
As a final comment, the information window will show, for each discontinuity of this kind, the exact value of the mesh
size that is being employed for each port that requires meshing, as well as the number of triangles generated. The
user can take this mesh size value as reference in order to manually increase it for speeding up calculations (for very
small number of modes, the automatic criterion based on the port geometry can be relaxed without remarkable loss
of accuracy), or decreasing it if more precision is desired, taking into account the memory limitations.
Another part of the specifications of this element is the General posts tab. Here, additional resonant posts/tuning
screws can be inserted in the geometry if desired, by pressing the Add button. The post parameters and the
different shapes allowed are the same as explained in the Cavity with posts discontinuity.
Errors The possible errors produced by this element, and solutions or workarounds
to them.
Using the S-Shape contact feed How to create, edit and use this element from FEST3D.
cavity
Definition
The S-Shape contact feed cavity discontinuity consists in a rectangular cavity which is excited using a S-shaped coaxial
probe which feeds a post that is attached to any of the cavity walls orthogonal to the coaxial. The cavity dimensions,
the local reference system, and the different surface names are depicted in figure A, and are the same as in the Cavity
with Posts. The geometrical parameters and positions of the probe and the contact post are shown in figure B and can
be specified by the user. Besides this main excitation block (probe together with contact post), rectangular ports and
additional resonant posts/tuning screws can be considered at any of the cavity walls. For performing the analysis, an
electromagnetic Solver based on the BI-RME 3D method with RWG basis functions is employed.
Figure A: Cavity dimensions, surface names and the local reference coordinate system employed
Limitations
The S-Shape contact feed cavity discontinuity has some limitations and caveats you should be aware of:
Use of probe radius larger than the inner radius of the coaxial.
The electromagnetic BI-RME 3D Solver used by this element does not directly allow modeling an excitation
probe contacting a coaxial port with a smaller inner radius. Anyway, it is possible to simulate this kind of
structures, by employing the strategy shown in the schematic below (figure C). By means of a Step
discontinuity, an additional auxiliary coaxial with zero length can be inserted between the real coaxial
waveguide and the Straight probe discontinuity, in which the radius desired for the probe can be set. This
auxiliary coaxial can be connected to the Straight probe and solved by the inner kernel. The Step will take into
account the differences between the two coaxials by computing the appropiate coupling integrals. On the
other hand, it is important to bear in mind that if a radius value smaller than the inner of coaxial is required for
the probe, there is no need to employ this strategy since this situation is directly supported by the Solver.
Figure C: Schematic example for using a probe with a radius larger the inner radius of the coaxial waveguide port.
Errors
The S-Shape contact feed cavity discontinuity can produce the following errors under certain circumstances. For each
error, the possible solutions or workarounds are explained.
FATAL ERROR. Not even a single resonant mode can be obtained for this cavity. Please change the
cavity dimensions or increase the Maximum Frequency of the Solver (Solver Name)
The maximum frequency introduced is under the cut-off frequency of the cavity delimited by the specified
dimensions (see the specifications of the dialog box below). Provided that these dimensions are correct, the
FATAL ERROR while performing simulation. (Error of some kind). Re-check the geometry, or try to
reduce mesh size(s) value(s)
The eigenvalue problem can not be solved due to problems with the building of the matrices. This error can be
produced by an illegal position of the posts not detected by FEST3D. Another source for errors in the
eigenvalue problem is that the meshing of some of the post surfaces is not accurate enough. If the positions of
the posts are correct, the mesh sizes should be reduced, specially if the dimensions of radii or lengths are small.
FATAL ERROR. No 3D mesh detected. Please re-check the geometry, or try to reduce mesh size of the
post(s)
If this error appears, it means that the meshing algorithm was able to create a 2D mesh, but not a 3D. This 3D
mesh is necessary to compute data employed for the EM fields calculations. For this reason, the simulation is
forbidden if the 3D mesh is not available. This situation may happen if a wrong geometry has been specified
(e.g., posts colliding with each other). The dimensions and offsets of the posts should be revised, and verified
with the 3D viewer in order to detect any possible geometrical problems. If the geometry is correct, another
source for this error is that very small air gaps are present in the cavity, which can not be dealt by the 3D
meshing algorithm for the given mesh sizes. Reducing their values might be the solution for a correct 3D mesh
generation. If the problem persists, the user can ask for support on his specific geometry.
The Enable/Disable button allows enabling and disabling this element, as described in the Main Window Edit menu.
The following parameters can be edited:
To conclude with the specific properties tab, two checkboxes allow the user to perform Multipactor and Corona
analysis of this discontinuity.
Continuing with the description of the Element Properties, the different excitation ports of the cavity are defined in
the Ports tab.
The ports of this element can be inserted in two ways:
By performing connections with waveguides before opening the element properties. These connections will be
automatically detected as new ports.
By pressing the Add port button (a connection with a waveguide will be required later before completing the
circuit).
For each port, a specification tab will appear. In first place, a waveguide must be selected from the Attached
waveguide list, which will be filled with the connections already associated to this element. If the waveguide is of
Coaxial type, a probe must selected from the Type of probe list. For this element, only the Straight contact probe is
allowed. For this probe, the shape of the required contact post can be chosen as well from the Type of contact post
list (a view of the different allowed contact posts is also shown at the right side of the window). By default, the first
port tab will be already assigned to the Coaxial waveguide that is required before opening the specifications window,
as shown in Figure E. Also the probe will be automatically displayed and ready to be configured. The rest of the ports
will be configured rectangular waveguides (Figure F). Nevertheless, it is possible to define a different order for the
ports, so that the coaxial port is not the first one.
Regarding the specific parameters of the Top contact probe, the following parameters can be edited:
L post (mm/inches): The distance between the contact post and the coaxial port (see figure B).
L1 (mm/inches): The length of the straight part of the S shape that starts from the coaxial port (see figure B).
L2 (mm/inches): The length of the straight part of the S shape that contacts the post (see figure B).
R probe (mm/inches): The radius of the probe (see figure B). If it is set to zero, the default value of the
inner conductor of the coaxial waveguide used as the port will be considered. The electromagnetic Solver
does not directly support values larger than this inner radius, but smaller values are also allowed for
simulations. Nevertheless, it is possible to perform simulations with larger radius for the probe, by applying the
strategy described in the limitations section.
H contact (mm/inches): The height at which the probe contacts the post (see figure B).
Mesh size probe (mm/inches): This parameter indicates the typical length that will be used for the triangular
mesh employed by this discontinuity for modeling the coaxial probe.
Below these probe parameters, the contact post parameters are also displayed. Depending on the shape of the post
Figure E: Port properties of the S-Shape contact feed cavity, case of a coaxial port
Figure F: Port properties of the S-Shape contact feed cavity, case of a rectangular port
Additionally, for each port tab the following general information can be edited:
Surface: Specifies the surface of the cavity that is assigned to the port. This surface can be chosen in a menu
that obeys the names shown in figure A.
Offsets: Depending on the cavity surface chosen for placing the port, the coherent directions for offsets will be
displayed for each case. Following figures A and C, conventions are:
Surface Front: Only X and Y offsets can be edited (Z offset will be fixed to 0)
If 30 or less accessible modes are employed in the coaxial waveguide, the triangle size is chosen as 1/5 of the
difference between the external and internal radius of the coaxial.
If the number of coaxial modes is between 30 and 45, the triangle size is chosen as 0.2 times the cut-
off wavelength associated to the largest mode number desired in the coaxial.
If 45 or more modes are employed for the coaxial, the triangle size is chosen as 0.1 times the cut-off
wavelength associated to the largest mode number desired in the coaxial.
As a final comment, the information window will show, for each discontinuity of this kind, the exact value of the mesh
size that is being employed for each port that requires meshing, as well as the number of triangles generated. The
user can take this mesh size value as reference in order to manually increase it for speeding up calculations (for very
small number of modes, the automatic criterion based on the port geometry can be relaxed without remarkable loss
of accuracy), or decreasing it if more precision is desired, taking into account the memory limitations.
Another part of the specifications of this element is the General posts tab. Here, additional resonant posts/tuning
screws can be inserted in the geometry if desired, by pressing the Add button. The post parameters and the
different shapes allowed are the same as explained in the Cavity with posts discontinuity.
The electromagnetic fields of this discontinuity can be computed and visualized. For this purpose, The EM Field tab
In addition, it is also important to mention that, for performing High Power analysis, FEST3D performs an
Errors The possible errors produced by this element, and solutions or workarounds to them.
Using the Loop feed cavity How to create, edit and use this element from FEST3D.
Definition
The Loop feed cavity consists in a rectangular cavity which is excited using a loop coaxial probe. The cavity
dimensions, the local reference system, and the different surface names are depicted in figure A, and are the same as
in the Cavity with posts. The geometrical parameters and positions of the probe are shown in figure B and can be
specified by the user. Besides this main excitation block, rectangular ports and additional resonant posts/tuning
screws can be considered at any of the cavity walls. For performing the analysis, an electromagnetic Solver based on
the BI-RME 3D method with RWG basis functions is employed.
Figure A: Cavity dimensions, surface names and the local reference coordinate system employed
Regarding the geometrical specifications of the excitation probe, a schematic picture of a common practical case is
shown in figure B, including the names of the relevant dimensions to be specified by the user. The rest of the
geometrical parameters needed to build the probe are auto calculated. A rotation angle for the loop is also
considered, whose definitions depending on the surface of the probe are also shown in the figure.
Limitations
The Loop feed cavity discontinuity has some limitations and caveats you should be aware of:
Use of probe radius larger than the inner radius of the coaxial.
The electromagnetic BI-RME 3D Solver used by this element does not directly allow modeling an excitation
probe contacting a coaxial port with a smaller inner radius. Anyway, it is possible to simulate this kind of
structures, by employing the strategy shown in the schematic below (figure C). By means of a Step
discontinuity, an additional auxiliary coaxial with zero length can be inserted between the real coaxial
waveguide and the Straight probe discontinuity, in which the radius desired for the probe can be set. This
auxiliary coaxial can be connected to the Straight probe and solved by the inner kernel. The Step will take into
account the differences between the two coaxials by computing the appropiate coupling integrals. On the
other hand, it is important to bear in mind that if a radius value smaller than the inner of coaxial is required for
the probe, there is no need to employ this strategy since this situation is directly supported by the Solver.
Figure C: Schematic example for using a probe with a radius larger the inner radius of the coaxial waveguide port.
Errors
The Loop feed cavity discontinuity can produce the following errors under certain circumstances. For each error, the
possible solutions or workarounds are explained.
FATAL ERROR. Not even a single resonant mode can be obtained for this cavity. Please change the
cavity dimensions or increase the Maximum Frequency of the Solver (Solver Name)
The maximum frequency introduced is under the cut-off frequency of the cavity delimited by the specified
dimensions (see the specifications of the dialog box below). Provided that these dimensions are correct, the
solution is to increase the value of this maximum frequency. It is recommended to set it to a value two or three
times the maximum frequency of the desired analysis band.
FATAL ERROR while performing simulation. (Error of some kind). Re-check the geometry, or try to
reduce mesh size(s) value(s)
The eigenvalue problem can not be solved due to problems with the building of the matrices. This error can be
produced by an illegal position of the posts not detected by FEST3D. Another source for errors in the
eigenvalue problem is that the meshing of some of the post surfaces is not accurate enough. If the positions of
the posts are correct, the mesh sizes should be reduced, specially if the dimensions of radii or lengths are small.
FATAL ERROR. No 3D mesh detected. Please re-check the geometry, or try to reduce mesh size of the
post(s)
If this error appears, it means that the meshing algorithm was able to create a 2D mesh, but not a 3D. This 3D
mesh is necessary to compute data employed for the EM fields calculations. For this reason, the simulation is
forbidden if the 3D mesh is not available. This situation may happen if a wrong geometry has been specified
(e.g., posts colliding with each other). The dimensions and offsets of the posts should be revised, and verified
with the 3D viewer in order to detect any possible geometrical problems. If the geometry is correct, another
source for this error is that very small air gaps are present in the cavity, which can not be dealt by the 3D
meshing algorithm for the given mesh sizes. Reducing their values might be the solution for a correct 3D mesh
generation. If the problem persists, the user can ask for support on his specific geometry.
The Enable/Disable button allows enabling and disabling this element, as described in the Main Window Edit menu.
The following parameters can be edited:
To conclude with the specific properties tab, two checkboxes allow the user to perform Multipactor and Corona
analysis of this discontinuity.
Continuing with the description of the Element Properties, the different excitation ports of the cavity are defined in
the Ports tab.
The ports of this element can be inserted in two ways:
By performing connections with waveguides before opening the element properties. These connections will be
automatically detected as new ports.
By pressing the Add port button (a connection with a waveguide will be required later before completing the
circuit).
For each port, a specification tab will appear. In first place, a waveguide must be selected from the Attached
waveguide list, which will be filled with the connections already associated to this element. If the waveguide is of
Coaxial type, a probe must selected from the Type of probe list. For this element, only the Magnetic probe is allowed.
By default, the first port tab will be already assigned to the Coaxial waveguide that is required before opening the
specifications window, as shown in Figure E. Also the probe will be automatically displayed and ready to be
configured. The rest of the ports will be configured rectangular waveguides (Figure F). Nevertheless, it is possible to
define a different order for the ports, so that the Coaxial port is not the first one.
Regarding the specific parameters of the Magnetic loop probe, the following parameters can be edited:
Lloop (mm/inches): Penetration length of the loop inside the cavity (see figure B).
Dloop (mm/inches): Distance between input and output of the loop in the corresponding surface wall (see
figure B).
Rprobe (mm/inches): The radius of the probe (see figure B). If it is set to zero, the default value of the
inner conductor of the coaxial waveguide used as the port will be considered. The electromagnetic Solver
does not directly support values larger than this inner radius, but smaller values are also allowed for
Figure E: Port properties of the Loop feed cavity, case of a coaxial port
Figure F: Port properties of the Loop feed cavity, case of a rectangular port
Additionally, for each port tab the following general information can be edited:
Surface: Specifies the surface of the cavity that is assigned to the port. This surface can be chosen in a menu
that obeys the names shown in figure A.
Offsets: Depending on the cavity surface chosen for placing the port, the coherent directions for offsets will be
displayed for each case. Following figures A and C, conventions are:
If 30 or less accessible modes are employed in the coaxial waveguide, the triangle size is chosen as 1/5 of the
difference between the external and internal radius of the coaxial.
If the number of coaxial modes is between 30 and 45, the triangle size is chosen as 0.2 times the cut-
off wavelength associated to the largest mode number desired in the coaxial.
If 45 or more modes are employed for the coaxial, the triangle size is chosen as 0.1 times the cut-off
wavelength associated to the largest mode number desired in the coaxial.
As a final comment, the information window will show, for each discontinuity of this kind, the exact value of the mesh
size that is being employed for each port that requires meshing, as well as the number of triangles generated. The
user can take this mesh size value as reference in order to manually increase it for speeding up calculations (for very
small number of modes, the automatic criterion based on the port geometry can be relaxed without remarkable loss
of accuracy), or decreasing it if more precision is desired, taking into account the memory limitations.
Another part of the specifications of this element is the General posts tab. Here, additional resonant posts/tuning
screws can be inserted in the geometry if desired, by pressing the Add button. The post parameters and the
different shapes allowed are the same as explained in the Cavity with posts discontinuity.
Errors The possible errors produced by this element, and solutions or workarounds to
them.
Using the Magnetic feed How to create, edit and use this element from FEST3D.
cavity
Definition
The Magnetic feed cavity discontinuity consists in a rectangular cavity which is excited using a coaxial
probe that contacts one of the four neighbor surfaces of the input surface. The cavity dimensions, the local reference
system, and the different surface names are depicted in figure A, and are the same as in the Cavity with posts. The
geometrical parameters and positions of the probe are shown in figure B and can be specified by the user. Besides
this main excitation block, rectangular ports and additional resonant posts/tuning screws can be considered at any of
the cavity walls. For performing the analysis, an electromagnetic Solver based on the BI-RME 3D method with RWG
basis functions is employed.
Figure A: Cavity dimensions, surface names and the local reference coordinate system employed
Limitations
The Magnetic feed cavity discontinuity has some limitations and caveats you should be aware of:
Use of probe radius larger than the inner radius of the coaxial.
The electromagnetic BI-RME 3D Solver used by this element does not directly allow modeling an excitation
probe contacting a coaxial port with a smaller inner radius. Anyway, it is possible to simulate this kind of
structures, by employing the strategy shown in the schematic below (figure C). By means of a Step
discontinuity, an additional auxiliary coaxial with zero length can be inserted between the real coaxial
waveguide and the Straight probe discontinuity, in which the radius desired for the probe can be set. This
auxiliary coaxial can be connected to the Straight probe and solved by the inner kernel. The Step will take into
account the differences between the two coaxials by computing the appropiate coupling integrals. On the
other hand, it is important to bear in mind that if a radius value smaller than the inner of coaxial is required for
the probe, there is no need to employ this strategy since this situation is directly supported by the Solver.
Figure C: Schematic example for using a probe with a radius larger the inner radius of the coaxial waveguide port.
Errors
The Magnetic feed cavity discontinuity can produce the following errors under certain circumstances. For each error,
the possible solutions or workarounds are explained.
FATAL ERROR. Not even a single resonant mode can be obtained for this cavity. Please change the
cavity dimensions or increase the Maximum Frequency of the Solver (Solver Name)
The maximum frequency introduced is under the cut-off frequency of the cavity delimited by the specified
dimensions (see the specifications of the dialog box below). Provided that these dimensions are correct, the
solution is to increase the value of this maximum frequency. It is recommended to set it to a value two or three
times the maximum frequency of the desired analysis band.
FATAL ERROR. No 3D mesh detected. Please re-check the geometry, or try to reduce mesh size of the
post(s)
If this error appears, it means that the meshing algorithm was able to create a 2D mesh, but not a 3D. This 3D
mesh is necessary to compute data employed for the EM fields calculations. For this reason, the simulation is
forbidden if the 3D mesh is not available. This situation may happen if a wrong geometry has been specified
(e.g., posts colliding with each other). The dimensions and offsets of the posts should be revised, and verified
with the 3D viewer in order to detect any possible geometrical problems. If the geometry is correct, another
source for this error is that very small air gaps are present in the cavity, which can not be dealt by the 3D
meshing algorithm for the given mesh sizes. Reducing their values might be the solution for a correct 3D mesh
generation. If the problem persists, the user can ask for support on his specific geometry.
The Enable/Disable button allows enabling and disabling this element, as described in the Main Window Edit menu.
The following parameters can be edited:
To conclude with the specific properties tab, two checkboxes allow the user to perform Multipactor and Corona
analysis of this discontinuity.
Continuing with the description of the Element Properties, the different excitation ports of the cavity are defined in
the Ports tab.
The ports of this element can be inserted in two ways:
By performing connections with waveguides before opening the element properties. These connections will be
automatically detected as new ports.
By pressing the Add port button (a connection with a waveguide will be required later before completing the
circuit).
For each port, a specification tab will appear. In first place, a waveguide must be selected from the Attached
waveguide list, which will be filled with the connections already associated to this element. If the waveguide is of
Coaxial type, a probe must selected from the Type of probe list. For this element, only the Magnetic probe is allowed.
By default, the first port tab will be already assigned to the Coaxial waveguide that is required before opening the
specifications window, as shown in Figure E. Also the probe will be automatically displayed and ready to be
configured. The rest of the ports will be configured rectangular waveguides (Figure F). Nevertheless, it is possible to
define a different order for the ports, so that the Coaxial port is not the first one.
Regarding the specific parameters of the Magnetic probe, the following parameters can be edited:
Lcontact (mm/inches): Distance from the excitation surface to the contact point of the Contact surface.
Lprobe (mm/inches): Length of the straight segment of the probe (see figure B).
Rprobe (mm/inches): The radius of the probe (see figure B). If it is set to zero, the default value of the
inner conductor of the coaxial waveguide used as the port will be considered. The electromagnetic Solver
does not directly support values larger than this inner radius, but smaller values are also allowed for
simulations. Nevertheless, it is possible to perform simulations with larger radius for the probe, by applying the
strategy described in the limitations section.
Alpha (degrees): Probe rotation angle (see figure B). By default this angle is 90 degrees, but smaller and larger
angles can also be employed. The software will automatically validate if the selected angle is appropriate for
building this kind of geometry for the rest of parameters specified.
Contact surface: Surface contacted by the probe (figure B).
Mesh size probe (mm/inches): This parameter indicates the typical length that will be used for the triangular
mesh employed by this discontinuity for modeling the coaxial probe.
Figure E: Port properties of the Magnetic feed cavity, case of a coaxial port
Figure F: Port properties of the Magnetic feed cavity, case of a rectangular port
Additionally, for each port tab the following general information can be edited:
Surface: Specifies the surface of the cavity that is assigned to the port. This surface can be chosen in a menu
that obeys the names shown in figure A.
Offsets: Depending on the cavity surface chosen for placing the port, the coherent directions for offsets will be
displayed for each case. Following figures A and C, conventions are:
Surface Front: Only X and Y offsets can be edited (Z offset will be fixed to 0)
If 30 or less accessible modes are employed in the coaxial waveguide, the triangle size is chosen as 1/5 of the
difference between the external and internal radius of the coaxial.
If the number of coaxial modes is between 30 and 45, the triangle size is chosen as 0.2 times the cut-
off wavelength associated to the largest mode number desired in the coaxial.
If 45 or more modes are employed for the coaxial, the triangle size is chosen as 0.1 times the cut-off
wavelength associated to the largest mode number desired in the coaxial.
As a final comment, the information window will show, for each discontinuity of this kind, the exact value of the mesh
size that is being employed for each port that requires meshing, as well as the number of triangles generated. The
user can take this mesh size value as reference in order to manually increase it for speeding up calculations (for very
small number of modes, the automatic criterion based on the port geometry can be relaxed without remarkable loss
of accuracy), or decreasing it if more precision is desired, taking into account the memory limitations.
Another part of the specifications of this element is the General posts tab. Here, additional resonant posts/tuning
screws can be inserted in the geometry if desired, by pressing the Add button. The post parameters and the
different shapes allowed are the same as explained in the Cavity with posts discontinuity.
The electromagnetic fields of this discontinuity can be computed and visualized. For this purpose, The EM Field tab
allows one to specify a mesh size value associated to the maximum size of the tetrahedra employed in the meshing of
the air volume region inside the cavity. An explanation figure of the parameter is also shown in the tab. This value can
be chosen as the same as specified in the general properties of the field computation, or can be specified for the
particular element. A small value will give a more detailed resolution of the fields, but will require a longer time for the
calculations. On the other hand, very large values will lead to a poor resolution in the visualization. It is recommended
to manually set a tradeoff value taking into account the dimensions of the cavity under consideration.
In addition, it is also important to mention that, for performing High Power analysis, FEST3D performs an
automatic refinement procedure, which is the same as the one explained in the Cavity with posts discontinuity.
Errors The possible errors produced by this element, and solutions or workarounds to
them.
Using the Top contact feed How to create, edit and use this element from FEST3D.
cavity
Definition
The Top contact feed cavity discontinuity consists in a rectangular cavity which is excited using a coaxial probe that
feeds a cylindrical post, which is contacted from its top. The cavity dimensions, the local reference system, and the
different surface names are depicted in figure A, and are the same as in the Cavity with posts. The geometrical
parameters and positions of the probe are shown in figure B and can be specified by the user. Besides this main
excitation block (probe together with contact post), rectangular ports and additional resonant posts/tuning screws can
be considered at any of the cavity walls. For performing the analysis, an electromagnetic Solver based on the BI-RME
3D method with RWG basis functions is employed.
Regarding the geometrical specifications, a schematic picture of a common practical case is shown in figure B,
including the names of the relevant dimensions to be specified by the user. The rest of the geometrical parameters
needed for building the probe are auto calculated.
Limitations
The Top contact feed cavity discontinuity has some limitations and caveats you should be aware of:
Use of probe radius larger than the inner radius of the coaxial.
The electromagnetic BI-RME 3D Solver used by this element does not directly allow modeling an excitation
probe contacting a coaxial port with a smaller inner radius. Anyway, it is possible to simulate this kind of
structures, by employing the strategy shown in the schematic below (figure C). By means of a Step
discontinuity, an additional auxiliary coaxial with zero length can be inserted between the real coaxial
waveguide and the Straight probe discontinuity, in which the radius desired for the probe can be set. This
auxiliary coaxial can be connected to the Straight probe and solved by the inner kernel. The Step will take into
account the differences between the two coaxials by computing the appropiate coupling integrals. On the
other hand, it is important to bear in mind that if a radius value smaller than the inner of coaxial is required for
the probe, there is no need to employ this strategy since this situation is directly supported by the Solver.
Figure C: Schematic example for using a probe with a radius larger the inner radius of the coaxial waveguide port.
Errors
The Top contact feed cavity discontinuity can produce the following errors under certain circumstances. For each
error, the possible solutions or workarounds are explained.
FATAL ERROR. Not even a single resonant mode can be obtained for this cavity. Please change the
cavity dimensions or increase the Maximum Frequency of the Solver (Solver Name)
The maximum frequency introduced is under the cut-off frequency of the cavity delimited by the specified
FATAL ERROR while performing simulation. (Error of some kind). Re-check the geometry, or try to
reduce mesh size(s) value(s)
The eigenvalue problem can not be solved due to problems with the building of the matrices. This error can be
produced by an illegal position of the posts not detected by FEST3D. Another source for errors in the
eigenvalue problem is that the meshing of some of the post surfaces is not accurate enough. If the positions of
the posts are correct, the mesh sizes should be reduced, specially if the dimensions of radii or lengths are small.
FATAL ERROR. No 3D mesh detected. Please re-check the geometry, or try to reduce mesh size of the
post(s)
If this error appears, it means that the meshing algorithm was able to create a 2D mesh, but not a 3D. This 3D
mesh is necessary to compute data employed for the EM fields calculations. For this reason, the simulation is
forbidden if the 3D mesh is not available. This situation may happen if a wrong geometry has been specified
(e.g., posts colliding with each other). The dimensions and offsets of the posts should be revised, and verified
with the 3D viewer in order to detect any possible geometrical problems. If the geometry is correct, another
source for this error is that very small air gaps are present in the cavity, which can not be dealt by the 3D
meshing algorithm for the given mesh sizes. Reducing their values might be the solution for a correct 3D mesh
generation. If the problem persists, the user can ask for support on his specific geometry.
The Enable/Disable button allows enabling and disabling this element, as described in the Main Window Edit menu.
The following parameters can be edited:
To conclude with the specific properties tab, two checkboxes allow the user to perform Multipactor and Corona
analysis of this discontinuity.
Continuing with the description of the Element Properties, the different excitation ports of the cavity are defined in
the Ports tab.
The ports of this element can be inserted in two ways:
By performing connections with waveguides before opening the element properties. These connections will be
automatically detected as new ports.
By pressing the Add port button (a connection with a waveguide will be required later before completing the
circuit).
For each port, a specification tab will appear. In first place, a waveguide must be selected from the Attached
waveguide list, which will be filled with the connections already associated to this element. If the waveguide is of
Coaxial type, a probe must selected from the Type of probe list. For this element, only the Straight contact probe is
allowed. For this probe, the shape of the required contact post can be chosen as well from the Type of contact post
list (a view of the different allowed contact posts is also shown at the right side of the window). By default, the first
port tab will be already assigned to the Coaxial waveguide that is required before opening the specifications window,
as shown in Figure E. Also the probe will be automatically displayed and ready to be configured. The rest of the ports
will be configured rectangular waveguides (Figure F). Nevertheless, it is possible to define a different order for the
ports, so that the coaxial port is not the first one.
Regarding the specific parameters of the Top contact probe, the following parameters can be edited:
R probe (mm/inches): The radius of the probe (see figure B). If it is set to zero, the default value of the
inner conductor of the coaxial waveguide used as the port will be considered. The electromagnetic Solver
does not directly support values larger than this inner radius, but smaller values are also allowed for
simulations. Nevertheless, it is possible to perform simulations with larger radius for the probe, by applying the
strategy described in the limitations section.
Mesh size probe (mm/inches): This parameter indicates the typical length that will be used for the triangular
mesh employed by this discontinuity for modeling the coaxial probe.
Below these probe parameters, the contact post parameters are also displayed. Depending on the shape of the post
selected, the legend at the right will show the geometrical parameters that can be edited for the particular geometry
(see figure E).
Figure E: Port properties of the Top contact feed cavity, case of a coaxial port
Figure F: Port properties of the Top contact feed cavity, case of a rectangular port
Additionally, for each port tab the following general information can be edited:
Surface: Specifies the surface of the cavity that is assigned to the port. This surface can be chosen in a menu
that obeys the names shown in figure A.
Offsets: Depending on the cavity surface chosen for placing the port, the coherent directions for offsets will be
displayed for each case. Following figures A and C, conventions are:
Surface Front: Only X and Y offsets can be edited (Z offset will be fixed to 0)
If 30 or less accessible modes are employed in the coaxial waveguide, the triangle size is chosen as 1/5 of the
difference between the external and internal radius of the coaxial.
If the number of coaxial modes is between 30 and 45, the triangle size is chosen as 0.2 times the cut-
off wavelength associated to the largest mode number desired in the coaxial.
If 45 or more modes are employed for the coaxial, the triangle size is chosen as 0.1 times the cut-off
wavelength associated to the largest mode number desired in the coaxial.
As a final comment, the information window will show, for each discontinuity of this kind, the exact value of the mesh
size that is being employed for each port that requires meshing, as well as the number of triangles generated. The
user can take this mesh size value as reference in order to manually increase it for speeding up calculations (for very
small number of modes, the automatic criterion based on the port geometry can be relaxed without remarkable loss
of accuracy), or decreasing it if more precision is desired, taking into account the memory limitations.
Another part of the specifications of this element is the General posts tab. Here, additional resonant posts/tuning
screws can be inserted in the geometry if desired, by pressing the Add button. The post parameters and the
different shapes allowed are the same as explained in the Cavity with posts discontinuity.
Errors The possible errors produced by this element, and solutions or workarounds to them.
Using the General cavity How to create, edit and use this element from FEST3D.
Definition
The General cavity consists in a rectangular cavity which supports multiple coaxial and rectangular excitation ports
placed at any of its six surface walls, as well as additional resonant posts/tuning screws. The cavity dimensions, the
local reference system, and the different surface names are depicted in figure A.
For performing the analysis, two different electromagnetic Solver types based on the BI-RME 3D method can be
selected (see the main specifications below).
Figure A: Cavity dimensions, surface names and the local reference coordinate system employed
When considering a coaxial port, different types of probe geometries can be selected by the user. All the possible
probe types are included in figure B. For more details on the parameters of each probe, the different specific elements
of the Coaxial library can be consulted.
Figure B: Different types of probes that can be used in this element with a coaxial waveguide port.
Limitations
The Straight Probe discontinuity has some limitations and caveats you should be aware of:
High memory consumption using parallelization in circuits with many cavities using the Solver BI-RME
3D RWG
If the Solver BI-RME 3D RWG is selected and small values of mesh sizes are specified (for high accuracy or
convergence tests), then very large meshes and dense matrices are required in the simulation, consuming an
important amount of RAM. Once the meshing of the element is performed, the information window will show
an estimation of the maximum total memory that will be used during calculations. Besides, the software will
automatically detect if the memory requirements are greater than the RAM memory available in the system,
and will stop the simulation if necessary. If there are several different cavities in the circuit, and multicore
simulation is desired, it is important to take into account that these RAM requirements are increased,
and a slowdown in the computer performance might be encountered. For those cases, it is recommended to
employ a lower number of processors, which may allow successfully completing a simulation that cannot be
performed using more cores due to memory limitation problems. If reducing the number of processors the
memory problems still persist, it is advisable to increase the mesh size values (reduce precision) of the posts or
rounded corners in the cavity (explained in the specifications section below) for performing the simulation.
Use of probe radius larger than the inner radius of the coaxial.
The electromagnetic BI-RME 3D Solver used by this element does not directly allow modeling an excitation
probe contacting a coaxial port with a smaller inner radius. Anyway, it is possible to simulate this kind of
structures, by employing the strategy shown in the schematic below (figure C). By means of a Step
discontinuity, an additional auxiliary coaxial with zero length can be inserted between the real coaxial
waveguide and the Straight probe discontinuity, in which the radius desired for the probe can be set. This
auxiliary coaxial can be connected to the Straight probe and solved by the inner kernel. The Step will take into
account the differences between the two coaxials by computing the appropiate coupling integrals. On the
other hand, it is important to bear in mind that if a radius value smaller than the inner of coaxial is required for
the probe, there is no need to employ this strategy since this situation is directly supported by the Solver.
Figure C: Schematic example for using a probe with a radius larger the inner radius of the coaxial waveguide port.
Errors
FATAL ERROR while performing simulation. (Error of some kind). Re-check the geometry, or try to
reduce mesh size(s) value(s)
The eigenvalue problem can not be solved due to problems with the building of the matrices. This error can be
produced by an illegal position of the posts not detected by FEST3D. Another source for errors in the
eigenvalue problem is that the meshing of some of the post surfaces is not accurate enough. If the positions of
the posts are correct, the mesh sizes should be reduced, specially if the dimensions of radii or lengths are small.
FATAL ERROR while performing simulation. Error while building mesh. Please try to reduce mesh size
value(s)
This error occurs when there is a problem building the internal meshing of the posts needed by this element,
when the Solver BI-RME 3D Cylindrical is selected. This problem usually appears when using posts of
mushroom or hollow type, if the mesh size value specified by the user is not adequate for the dimensions of
the post. The values used for mesh size must be reduced in order to avoid this error.
FATAL ERROR. No 3D mesh detected. Please re-check the geometry, or try to reduce mesh size of the
post(s)
If the Solver BI-RME 3D RWG is chosen, this element requires to create a 3D mesh for the whole cavity
together with the posts, from which the surface meshing of metallic objects is extracted. If this error appears, it
means that the meshing algorithm was able to create a 2D mesh, but not a 3D. This 3D mesh is necessary to
compute data employed for the EM fields calculations. For this reason, the simulation is forbidden if the 3D
mesh is not available. This situation may happen if a wrong geometry has been specified (e.g., posts colliding
with each other). The dimensions and offsets of the posts should be revised, and verified with the 3D viewer in
order to detect any possible geometrical problems. If the geometry is correct, another source for this error is
that very small air gaps are present in the cavity, which can not be dealt by the 3D meshing algorithm for the
given mesh sizes. Reducing their values might be the solution for a correct 3D mesh generation. If the problem
persists, the user can ask for support on his specific geometry.
The Enable/Disable button allows enabling and disabling this element, as described in the Main Window Edit menu.
The following parameters can be edited:
To conclude with the specific properties tab, two checkboxes allow the user to perform Multipactor and Corona
analysis of this discontinuity. For performing this analysis, it is necessary to choose the Solver BI-RME 3D RWG
for the simulation. Otherwise, a warning message will be shown to the user.
Continuing with the description of the Element Properties, the different excitation ports of the cavity are defined in
the Ports tab.
The ports of this element can be inserted in two ways:
By performing connections with waveguides before opening the element properties. These connections will be
automatically detected as new ports.
By pressing the Add port button (a connection with a waveguide will be required later before completing the
circuit).
For each port, a specification tab will appear. In first place, a waveguide must be selected from the Attached
waveguide list, which will be filled with the connections already associated to this element. If the waveguide is of
Coaxial type, a probe must selected from the Type of probe list. The types of available probes are shown in the right
side of the window, as depicted in Figure E. Once selected, the geometrical parameters of the specific probe as well as
the contact post (if required for the chosen geometry) can be also edited. For detailed description of each probe
parameter, please consult the different particular elements of the Coaxial library. A example of specific probe is
included as a second Coaxial port in Figure F. Another example case of port chosen as a Rectangular waveguide is also
included in figure G.
Figure F: Port properties of the General cavity, case of a second coaxial port with a Mushroom probe
Additionally, for each port tab the following general information can be edited:
Surface: Specifies the surface of the cavity that is assigned to the port. This surface can be chosen in a menu
that obeys the names shown in figure A.
Offsets: Depending on the cavity surface chosen for placing the port, the coherent directions for offsets will be
displayed for each case. Following figures A and C, conventions are:
Surface Front: Only X and Y offsets can be edited (Z offset will be fixed to 0)
Surface Back: Only X and Y offsets can be edited (Z offset will be fixed to C)
Surface Right: Only Y and Z offsets can be edited (X offset will be fixed to A/2)
Surface Top: Only X and Z offsets can be edited (Y offset will be fixed to B/2)
Surface Left: Only Y and Z offsets can be edited (X offset will be fixed to -A/2)
Surface Bottom: Only X and Z offsets can be edited (Y offset will be fixed to -B/2)
If 30 or less accessible modes are employed in the coaxial waveguide, the triangle size is chosen as 1/5 of the
difference between the external and internal radius of the coaxial.
If the number of coaxial modes is between 30 and 45, the triangle size is chosen as 0.2 times the cut-
off wavelength associated to the largest mode number desired in the coaxial.
If 45 or more modes are employed for the coaxial, the triangle size is chosen as 0.1 times the cut-off
wavelength associated to the largest mode number desired in the coaxial.
As a final comment, the information window will show, for each discontinuity of this kind, the exact value of the mesh
size that is being employed for each port that requires meshing, as well as the number of triangles generated. The
user can take this mesh size value as reference in order to manually increase it for speeding up calculations (for very
small number of modes, the automatic criterion based on the port geometry can be relaxed without remarkable loss
of accuracy), or decreasing it if more precision is desired, taking into account the memory limitations.
Another part of the specifications of this element is the General Posts tab. Here, additional resonant posts/tuning
screws can be inserted in the geometry if desired, by pressing the Add button. It is important to mention that if
The electromagnetic fields of this discontinuity can be computed and visualized. With this purpose, The EM Field tab
allows to specify a mesh size value associated to the maximum size of the tetrahedra employed in the meshing of the
air volume region inside the cavity. An explanation figure of the parameter is also shown in the tab. This value can be
chosen the same as specified in the general properties of the field computation, or can be specified for the particular
element. A small value will give a more detailed resolution of the fields, but will require a longer time for the
calculations. On the other hand, very large values will lead to a poor resolution in the visualization. It is recommended
to manually set a tradeoff value taking into account the dimensions of the cavity under consideration.
For performing EM fields computations, it is mandatory to use the Solver BI-RME 3D RWG in the simulation.
In addition, it is also important to mention that, for performing High Power analysis, FEST3D performs an
automatic refinement procedure, which is the same as the one explained in the Cavity with posts discontinuity.
Helical resonator
Errors The possible errors produced by this element, and solutions or workarounds to them.
Using the Helical resonator How to create, edit and use this element from FEST3D.
Definition
The Helical resonator discontinuity represents a rectangular cavity with a resonator of helical shape that can
be positioned at any of the 6 different surfaces of the rectangular cavity (see figure A below). Together with the main
resonator, more helices as well as other types of resonant posts/tuning screws can be included in the cavity. Besides,
input/output rectangular ports can also be placed on the walls. For performing the analysis, an electromagnetic Solver
based on the BI-RME 3D method with RWG basis functions is employed.
Figure A: Cavity dimensions, surface names and the local reference coordinate system employed
Regarding the geometrical specifications, the parameters of the helical shape are shown in figure B. By default, the
helix and the rest of additional posts will be placed at the center of the bottom surface. The user can change this
surface, and specify an offset between the center of the surface and the center of the helix. Examples of offsets for
different post shapes are depicted in figure C for the different surfaces of the cavity, taking into account the main
reference system defined in figure A.
Limitations
The Helical resonator discontinuity has some limitations and caveats you should be aware of:
Errors
The Helical resonator discontinuity can produce the following errors under certain circumstances. For each error, the
possible solutions or workarounds are explained.
FATAL ERROR. Not even a single resonant mode can be obtained for this cavity. Please change the
cavity dimensions or increase the Maximum Frequency of the Solver (Solver Name)
The maximum frequency introduced is under the cut-off frequency of the cavity delimited by the specified
dimensions (see the specifications of the dialog box below). Provided that these dimensions are correct, the
solution is to increase the value of this maximum frequency. It is recommended to set it to a value two or three
times the maximum frequency of the desired analysis band.
FATAL ERROR while performing simulation. (Error of some kind). Re-check the geometry, or try to
reduce mesh size(s) value(s)
The eigenvalue problem can not be solved due to problems with the building of the matrices. This error can be
produced by an illegal position of the posts not detected by FEST3D. Another source for errors in the
eigenvalue problem is that the meshing of some of the post surfaces is not accurate enough. If the positions of
the posts are correct, the mesh sizes should be reduced, specially if the dimensions of radii or lengths are small.
FATAL ERROR. No 3D mesh detected. Please re-check the geometry, or try to reduce mesh size of the
post(s)
If this error appears, it means that the meshing algorithm was able to create a 2D mesh, but not a 3D. This 3D
mesh is necessary to compute data employed for the EM fields calculations. For this reason, the simulation is
forbidden if the 3D mesh is not available. This situation may happen if a wrong geometry has been specified
(e.g., posts colliding with each other). The dimensions and offsets of the posts should be revised, and verified
with the 3D viewer in order to detect any possible geometrical problems. If the geometry is correct, another
source for this error is that very small air gaps are present in the cavity, which can not be dealt by the 3D
meshing algorithm for the given mesh sizes. Reducing their values might be the solution for a correct 3D mesh
generation. If the problem persists, the user can ask for support on his specific geometry.
The Enable/Disable button allows enabling and disabling this element, as described in the Main Window Edit menu.
The following parameters can be edited:
To conclude with the specific properties tab, two checkboxes allow the user to perform Multipactor and Corona
analysis of this discontinuity.
Continuing with the description of the Element Properties, the different excitation ports of the cavity are defined in
the Ports tab.
The ports of this element can be inserted in two ways:
By performing connections with waveguides before opening the element properties. These connections will be
automatically detected as new ports.
By pressing the Add port button (a connection with a waveguide will be required later before completing the
circuit).
For each port, a specification tab will appear. In first place, a waveguide must be selected from the Attached
waveguide list, which will be filled with the connections already associated to this element.
Additionally, for each port tab the following general information can be edited:
Surface: Specifies the surface of the cavity that is assigned to the port. This surface can be chosen in a menu
that obeys the names shown in figure A.
Offsets: Depending on the cavity surface chosen for placing the port, the coherent directions for offsets will be
displayed for each case. Following figures A and C, conventions are:
Surface Front: Only X and Y offsets can be edited (Z offset will be fixed to 0)
Surface Back: Only X and Y offsets can be edited (Z offset will be fixed to C)
The offsets and the mesh size of the port only make sense if a rectangular waveguide smaller than the cavity
surface dimensions is considered. The mesh density employed for the port must be increased for large numbers of
accessible modes of the rectangular waveguide, in order to maintain the accuracy of the method. As a consequence, a
large number of accessible modes in the waveguide port will require a higher computational cost.
In order to help the user to take into account these considerations, it is recommended to set this value to zero,
allowing this way FEST3D to automatically choose an adequate value as a default. The automatic criterion employed
obeys the following rules:
If 30 or less accessible modes are employed in the rectangular waveguide, the triangle size is chosen as 1/5 of
the minimum dimension (a,b) of the waveguide.
If the number of coaxial modes is between 30 and 45, the triangle size is chosen as 0.2 times the cut-off
wavelength associated to the largest mode number desired in the rectangular waveguide.
If 45 or more modes are employed for the coaxial, the triangle size is chosen as 0.1 times the cut-off
wavelength associated to the largest mode number desired in the rectangular waveguide.
Nevertheless, in a common usage of this element, the rectangular ports will have the same dimensions as the
corresponding cavity surfaces delimited by the cavity dimensions A,B,L specified. In those cases, these
parameters (offsets and mesh size) have no meaning, and the internal electromagnetic Solver employs
analytical expressions for dealing with these ports, which require much less computational effort.
For this reason, it is recommended to build a circuit using waveguides with the same dimensions as the
cavities wherever it is possible, employing Step discontinuities if different size of waveguides is desired
between cavities. A warning message will appear in order to alert the user to have this situation in mind if
smaller ports are selected. Nevertheless, there might be some cases in which the connection of smaller
rectangular ports will be mandatory, such as when rounded corners are used in the cavity.
As a final comment, the information window will show, for each discontinuity of this kind, the exact value of the mesh
size that is being employed for the mesh discretization of the rectangular port. The user can take this value as
reference in order to manually increase it for speeding up calculations, or decreasing it if more precision is desired,
taking into account the memory limitations.
Another important part of the specifications of this element is the General Posts tab. By default, a helical resonator
post is already considered, ready to be defined (see figure F). The legend with the different parameters of the
resonator is also included at the right side of the window for reference. Additionally, more posts/tuning screws can be
inserted by selecting the post shape from the available list and pressing the Add button. The post parameters and
the different shapes allowed are the same as explained in the Cavity with posts discontinuity.
The electromagnetic fields of this discontinuity can be computed and visualized. For this purpose, The EM Field tab
allows one to specify a mesh size value associated to the maximum size of the tetrahedra employed in the meshing of
the air volume region inside the cavity. An explanation figure of the parameter is also shown in the tab. This value can
be chosen as the same as specified in the general properties of the field computation, or can be specified for the
particular element. A small value will give a more detailed resolution of the fields, but will require a longer time for the
In addition, it is also important to mention that, for performing High Power analysis, FEST3D performs an
automatic refinement procedure for the additional posts different from the helical shapes, which is the same
as the one explained in the Cavity with posts discontinuity.
Using the Contact feed to helical How to create, edit and use this element from FEST3D.
resonator
Definition
The Contact feed to helical resonator discontinuity consists in a rectangular waveguide section which is excited using
a straight coaxial probe which feeds a helical resonator that is attached to any of the cavity walls orthogonal to the
coaxial. The cavity dimensions, the local reference system, and the different surface names are depicted in figure A,
and are the same as in the Cavity with Posts. The geometrical parameters and positions of the probe and the contact
post are shown in figure B and can be specified by the user. Besides this main excitation block (probe together with
contact helix), rectangular ports and additional resonant posts/tuning screws can be considered at any of the cavity
walls. For performing the analysis, an electromagnetic Solver based on the BI-RME 3D method with RWG basis
functions is employed.
Figure A: Cavity dimensions, surface names and the local reference coordinate system employed
Regarding the geometrical specifications of the excitation probe, a schematic picture of a common practical case with
the contact helix attached to the bottom surface is shown in figure B, including the names of the relevant dimensions
Limitations
The Contact feed to helical resonator discontinuity has some limitations and caveats you should be aware of:
Use of probe radius larger than the inner radius of the coaxial.
The electromagnetic BI-RME 3D Solver used by this element does not directly allow modeling an excitation
probe contacting a coaxial port with a smaller inner radius. Anyway, it is possible to simulate this kind of
structures, by employing the strategy shown in the schematic below (figure C). By means of a Step
discontinuity, an additional auxiliary coaxial with zero length can be inserted between the real coaxial
waveguide and the Straight probe discontinuity, in which the radius desired for the probe can be set. This
auxiliary coaxial can be connected to the Straight probe and solved by the inner kernel. The Step will take into
account the differences between the two coaxials by computing the appropiate coupling integrals. On the
Figure C: Schematic example for using a probe with a radius larger the inner radius of the coaxial waveguide port.
Errors
The Contact feed to helical resonator discontinuity can produce the following errors under certain circumstances. For
each error, the possible solutions or workarounds are explained.
FATAL ERROR. Not even a single resonant mode can be obtained for this cavity. Please change the
cavity dimensions or increase the Maximum Frequency of the Solver (Solver Name)
The maximum frequency introduced is under the cut-off frequency of the cavity delimited by the specified
dimensions (see the specifications of the dialog box below). Provided that these dimensions are correct, the
solution is to increase the value of this maximum frequency. It is recommended to set it to a value two or three
times the maximum frequency of the desired analysis band.
FATAL ERROR while performing simulation. (Error of some kind). Re-check the geometry, or try to
reduce mesh size(s) value(s)
The eigenvalue problem can not be solved due to problems with the building of the matrices. This error can be
produced by an illegal position of the posts not detected by FEST3D. Another source for errors in the
eigenvalue problem is that the meshing of some of the post surfaces is not accurate enough. If the positions of
the posts are correct, the mesh sizes should be reduced, specially if the dimensions of radii or lengths are small.
FATAL ERROR. No 3D mesh detected. Please re-check the geometry, or try to reduce mesh size of the
post(s)
If this error appears, it means that the meshing algorithm was able to create a 2D mesh, but not a 3D. This 3D
mesh is necessary to compute data employed for the EM fields calculations. For this reason, the simulation is
forbidden if the 3D mesh is not available. This situation may happen if a wrong geometry has been specified
(e.g., posts colliding with each other). The dimensions and offsets of the posts should be revised, and verified
with the 3D viewer in order to detect any possible geometrical problems. If the geometry is correct, another
source for this error is that very small air gaps are present in the cavity, which can not be dealt by the 3D
meshing algorithm for the given mesh sizes. Reducing their values might be the solution for a correct 3D mesh
generation. If the problem persists, the user can ask for support on his specific geometry.
The Enable/Disable button allows enabling and disabling this element, as described in the Main Window Edit menu.
The following parameters can be edited:
To conclude with the specific properties tab, two checkboxes allow the user to perform Multipactor and Corona
analysis of this discontinuity.
Continuing with the description of the Element Properties, the different excitation ports of the cavity are defined in
the Ports tab.
The ports of this element can be inserted in two ways:
By performing connections with waveguides before opening the element properties. These connections will be
automatically detected as new ports.
By pressing the Add port button (a connection with a waveguide will be required later before completing the
circuit).
For each port, a specification tab will appear. In first place, a waveguide must be selected from the Attached
waveguide list, which will be filled with the connections already associated to this element. If the waveguide is of
Coaxial type, a probe must selected from the Type of probe list. For this element, only the Straight contact
helix probe is allowed. For this probe, the shape of the required contact post can be chosen as well from the Type of
contact post list (a view of the different allowed contact posts is also shown at the right side of the window). By
default, the first port tab will be already assigned to the Coaxial waveguide that is required before opening the
specifications window, as shown in Figure E. Also the probe will be automatically displayed and ready to be
configured. The rest of the ports will be configured rectangular waveguides (Figure F). Nevertheless, it is possible to
define a different order for the ports, so that the coaxial port is not the first one.
Regarding the specific parameters of the Straight contact helix probe, the following parameters can be edited:
Num. turn contact: The number of the helix turn at which the contact with the coaxial probe is performed.
This value will determine automatically the height of the coaxial port.
R probe (mm/inches): The radius of the probe (see figure B). If it is set to zero, the default value of the
inner conductor of the coaxial waveguide used as the port will be considered. The electromagnetic Solver
does not directly support values larger than this inner radius, but smaller values are also allowed for
simulations. Nevertheless, it is possible to perform simulations with larger radius for the probe, by applying the
strategy described in the limitations section.
L Helix(mm/inches): The distance between the contact helix and the coaxial port (see figure B).
Angle from base(degrees): The angle from the base of the helix to the straight probe (see figure B). This
Below these probe parameters, the parameters of the contact helix are also displayed. These parameters are also
defined in figure B included in the legend at the right of the window.
Figure E: Port properties of the Contact feed to helical resonator, case of a coaxial port
Figure F: Port properties of the Contact feed to helical resonator, case of a rectangular port
Surface: Specifies the surface of the cavity that is assigned to the port. This surface can be chosen in a menu
that obeys the names shown in figure A.
Offsets: Depending on the cavity surface chosen for placing the port, the coherent directions for offsets will be
displayed for each case. Following figures A and C, conventions are:
Surface Front: Only X and Y offsets can be edited (Z offset will be fixed to 0)
Surface Back: Only X and Y offsets can be edited (Z offset will be fixed to C)
Surface Right: Only Y and Z offsets can be edited (X offset will be fixed to A/2)
Surface Top: Only X and Z offsets can be edited (Y offset will be fixed to B/2)
Surface Left: Only Y and Z offsets can be edited (X offset will be fixed to -A/2)
Surface Bottom: Only X and Z offsets can be edited (Y offset will be fixed to -B/2)
Mesh size port (mm/inches): The mesh size of each port of the element can be edited. This value is the typical
size of the triangles used for meshing the geometry of the port. It is important to remark that the correct
choice of the mesh size of the port is critical for the accuracy of the electromagnetic analysis. There are
some particularities to bear in mind regarding this parameter, as detailed below.
The particular port tab is removed by pressing the Delete port button.
Considerations for coaxial ports
When considering a Coaxial waveguide as a port, the mesh density must be increased for large numbers of
accessible modes of the coaxial waveguide in order to maintain the accuracy of the method. As a consequence,
a large number of accessible modes in the coaxial waveguide will require a higher computational cost. This
drawback might be avoided in most of the practical situations, since a large number of modes is not necessary
for a coaxial waveguide in common applications (generally, less than 20 modes will suffice).
Thus, in order to help the user to take into account these considerations, it is recommended to set this value to zero,
allowing FEST3D to automatically choose an adequate value as a default. The automatic criterion employed obeys the
following rules:
If 30 or less accessible modes are employed in the coaxial waveguide, the triangle size is chosen as 1/5 of the
difference between the external and internal radius of the coaxial.
If the number of coaxial modes is between 30 and 45, the triangle size is chosen as 0.2 times the cut-
off wavelength associated to the largest mode number desired in the coaxial.
If 45 or more modes are employed for the coaxial, the triangle size is chosen as 0.1 times the cut-off
wavelength associated to the largest mode number desired in the coaxial.
As a final comment, the information window will show, for each discontinuity of this kind, the exact value of the mesh
size that is being employed for each port that requires meshing, as well as the number of triangles generated. The
user can take this mesh size value as reference in order to manually increase it for speeding up calculations (for very
small number of modes, the automatic criterion based on the port geometry can be relaxed without remarkable loss
of accuracy), or decreasing it if more precision is desired, taking into account the memory limitations.
Another part of the specifications of this element is the General posts tab. Here, additional resonant posts/tuning
screws can be inserted in the geometry if desired, by pressing the Add button. The post parameters and the
different shapes allowed are the same as explained in the Cavity with posts discontinuity.
The electromagnetic fields of this discontinuity can be computed and visualized. For this purpose, The EM Field tab
allows one to specify a mesh size value associated to the maximum size of the tetrahedra employed in the meshing of
the air volume region inside the cavity. An explanation figure of the parameter is also shown in the tab. This value can
be chosen as the same as specified in the general properties of the field computation, or can be specified for the
particular element. A small value will give a more detailed resolution of the fields, but will require a longer time for the
In addition, it is also important to mention that, for performing High Power analysis, FEST3D performs an
automatic refinement procedure, which is the same as the one explained in the Cavity with posts discontinuity.
Errors The possible errors produced by this element, and solutions or workarounds to
them.
Using the General rectangular How to create, edit and use this element from FEST3D.
cavity
Definition
The General rectangular cavity consists in a rectangular cavity which supports multiple coaxial, rectangular and
circular excitation ports, as well as additional resonant posts/tuning screws, which can be configured to be Perfect
Electric Conductor (PEC), or dielectric. The cavity dimensions, the local reference system, and the different surface
names are depicted in figure A.
For performing the analysis, a Finite Element Method (FEM) Solver is employed in order to compute the General
Admittance Matrix (GAM) of the discontinuity. More specifically, this FEM Solver works in Frequency Domain using a
Reduced Order Model (MOR). This Solver is provided by the CST Studio Suite® software package. Therefore the
installation of CST Studio Suite® is required in order to use this element.
Figure A: Cavity dimensions, surface names and the local reference coordinate system employed
For positioning the ports and the posts in the cavity, the user can select any of the six surface walls on which the
geometry will be placed, and specify offset values which will translate the local reference system of each post or
port with respect to the wall center. Additionaly, rotation angles can also be applied around the local axes (u, v,
w) defined for each post or port. The definitions of the local systems and the sign conventions for each case are
shown in figure B.
Figure B: Offset conventions for ports and posts placed on the cavity walls
On the other hand, for the posts there is also the possibility of selecting surface "None", which means that the
base of the post will not be attached to any of the surface walls, and can be freely positioned with respect to the
local reference system defined at the center of the cavity as shown in figure C. The offset values will modify the
position of the reference system (u, v, w) defined at the center of the base of each post. Rotation angles can also
be applied around each one of the 3 post's local axes (u, v, w), in order to modify the default orientation if desired.
Figure C: Free positioning of the post with respect to the local reference system of the cavity
When considering a coaxial port, different types of probe geometries can be selected by the user. All the possible
probe types are included in figure D. When selected in the Ports tab, a specific legend will be shown with the
definition of the geometrical parameters of each probe.
Figure D: Different types of probes that can be used in this element with a coaxial waveguide port.
Regarding the posts, several different shapes can be considered, which are shown in figure E. By default, any post will
be automatically placed at the center of the bottom surface.
Limitations
The General rectangular cavity discontinuity has some limitations and caveats you should be aware of:
On the other hand, collision between posts is possible. Depending on the type of material used for the posts,
the situation will be handled differently:
If all posts are of PEC material, they will be fused and considered as one object.
If there is volume intersection between posts of PEC and dielectric materials, the metallic part of
the intersection will prevail (the intersection volume inside the dielectric will be filled with PEC).
If there is collision between two posts of dielectric materials, one of the two geometries will
prevail over the other in the intersection volume. The criterion for choosing the prevailing geometry
will be the largest value of the product of the relative permittivity and permeability parameters of
the material associated to each post.
Errors
The General rectangular cavity discontinuity can produce the following errors under certain circumstances. For each
error, the possible solutions or workarounds are explained.
Invalid installation path for CST Studio Suite. Please check that CST Studio Suite software is installed,
and that a valid installation path has been provided in the Graphical Interface (Options->Edit
Preferences): The user must ensure that a valid version of the CST Studio Suite® software is correctly installed
in the system, and provide the installation path as explained in the error message. More details about the CST
Studio Suite software requirements can be consulted in the limitations section.
License error while starting CST Studio Suite: A valid license file could not be detected for CST Studio
Suite® software. Please contact support in order to get a valid license file for the software.
Error(s) while running CST solver: This message appears if one or more errors have been detected during
simulation of the CST Solver. The different error descriptions give details of each particular problem. In most
cases, the errors will be related to inconsistencies found in the computation of the port modes or in the mesh
generation. Another source of errors might be lack of memory in the system if very dense meshes are used.
Modifying the number of accessible modes for the ports and/or the mesh parameters (for ports and for the
solver) might solve the problems.
Error while exporting matrix results of CST solver: This error appears if there were problems in the
exportation process of data. This might happen for example if the disk runs out of physical space. The user
must bear in mind that the simulations of the FEM solver might require a large amount of disk space, specially
if very dense meshes are used (e.g. several GBytes). Make sure that the disk in which the FEST3D input file is
located has enough free space and re-run the simulation.
Error while exporting modal fields results of CST solver: This error appears if there were problems in the
exportation process of data related to port modal fields. This might happen for example if the disk runs out of
physical space. The user must bear in mind that the simulations of the FEM solver might require a large amount
of disk space, specially if very dense meshes are used (e.g. several GBytes). Make sure that the disk in which the
FEST3D input file is located has enough free space and re-run the simulation.
The Enable/Disable button allows enabling and disabling this element, as described in the Main Window Edit menu.
The following parameters can be edited:
Besides, the tetrahedral meshing employed by the FEM Solver can be controlled by means of 3 parameters defined in
the same way as done in the CST Studio Suite® software:
Cells per wavelength: This parameter controls the upper limit to the cell size with respect to the smallest
wavelength used in the analysis range (which corresponds to the maximum frequency value set in the
Frequency Specifications for the FEST3D circuit). Increasing this number leads to a higher accuracy, but also
increases the total computation time. The default value is 10, providing a good compromise between the
calculation time and the achievable accuracy for most practical cases.
Smooth mesh with equilibrate ratio: This option controls the mesh smoothing in order to improve quality of
the generated mesh. It represents the maximum ratio between the lengths of two adjacent edges. The closer to
1, the smoother the resulting mesh will be. The default value is 1.2.
Normal tolerance (Deg): This parameter controls the discretization of curved edges and surfaces. Normal
tolerance is the angle in degrees between model edge or face normals at two adjacent mesh vertices. The
default value is 22.5, which forces to use approximately 16 points along circular contours. Lower values of
normal tolerance will lead to smoother discretization of curved surfaces.
Additionally, this element allows to apply mesh refinements in order to speed up the convergence when the cavity
contains cylindrical-shaped excitation probes or posts of PEC material. These refinements consists in the addition of a
virtual box that covers a volume zone surrounding the cap of each post or probe. A generic 2D scheme with the
definition of the refinement box is shown in figure G.
Figure G: Definition of the virtual refinement box applied to cylindrical probes and PEC posts inside the cavity
The mesh volume inside this box is controlled by means of the input refinement factor value. The mesh size
used inside the box is selected as the most restrictive value of the two following criteria:
Criterion 1: mesh size = (smallest wavelength used in the analysis / cells per wavelength) / refinement factor
Criterion 2: mesh size = (maximum perimeter * normal tolerance / 360) / refinement factor
The use of these refinement boxes can be enabled (by default) or disabled by clicking on the Enable refinements
checkbox. In most practical cases it is recommended to enable the use of refinements. Otherwise, the general mesh
parameters (specially normal tolerance and cells per wavelength) must be adjusted to be more restrictive in order
for the Solver to obtain good accuracy for the EM-fields inside the cavity and/or the resonant frequencies of the posts.
This will produce a denser mesh for the volume of the whole element, and higher computational times as a
consequence.
Continuing with the description of the Element Properties, the different excitation ports of the cavity are defined in
the Ports tab.
For each port, a specification tab will appear. In first place, a waveguide must be selected from the Attached
waveguide list, which will be filled with the connections already associated to this element. If the waveguide is of
Coaxial type, a probe must be selected from the Type of probe list. The types of available probes are shown in the
right side of the window, as depicted in Figure H. Once selected, the geometrical parameters of the selected probe
can be also edited. A legend will be shown indicating the definition of the specific parameters of the probe. A example
of specific probe is included as a second Coaxial port in Figure I. Another example case of port chosen as a
Rectangular waveguide is also included in figure J.
Figure H: Port properties of the General rectangular cavity, case of a coaxial port
Figure I: Port properties of the General rectangular cavity, case of a second coaxial port with a Mushroom probe
Figure J: Port properties of the General rectangular cavity, case of a rectangular port
Additionally, for each port tab the following general information can be edited:
Surface: Specifies the surface of the cavity that is assigned to the port. This surface can be chosen in a menu
that obeys the names shown in figure A.
Another part of the specifications of this element is the General Posts tab. Here, additional resonant posts/tuning
screws can be inserted in the geometry if desired, by pressing the Add button.
For each post, the user can edit the specifications for the dimensions of the post. Regarding the positioning, the
surface wall of the cavity, offsets and rotation angles can be edited in the same way as done with the Ports tab,
following the conventions of figures B and C. Depending on the shape of the post, a specific legend with the
definition of the geometrical parameters is automatically shown at the right side of the window. Legends with the
offset definitions and the other types of post shapes are also displayed for reference.
The Material of the post can be also selected. The user can choose between PEC and Lossless dielectric for each one
of the post. In case of selecting lossless dielectric material, the corresponding relative permittivity and permeability
parameters can be edited.
Finally, any of the posts can be discarded by pressing the Delete post button on each tab.
Using the General cylindrical How to create, edit and use this element from FEST3D.
cavity
Definition
The General cylindrical cavity consists in a cylindrical cavity which supports multiple coaxial, rectangular and
circular excitation ports, as well as additional resonant posts/tuning screws, which can be configured to be Perfect
Electric Conductor (PEC), or dielectric. The cavity dimensions, the local reference system, and the different surface
names are depicted in figure A.
For performing the analysis, a Finite Element Method (FEM) Solver is employed in order to compute the General
Admittance Matrix (GAM) of the discontinuity. More specifically, this FEM Solver works in Frequency Domain using a
Reduced Order Model (MOR). This Solver is provided by the CST Studio Suite® software package. Therefore the
installation of CST Studio Suite® is required in order to use this element.
Figure A: Cavity dimensions, surface names and the local reference coordinate system employed
For positioning the ports and the posts in the cavity, the user can select any of the surface walls on which the
Figure B: Offset conventions for ports and posts placed on the cavity walls
On the other hand, for the posts there is also the possibility of selecting surface "None", which means that the
base of the post will not be attached to any of the surface walls, and can be freely positioned with respect to the
local reference system defined at the center of the cavity as shown in figure C. The offset values will modify the
position of the reference system (u, v, w) defined at the center of the base of each post. Rotation angles can also
be applied around each one of the 3 post's local axes (u, v, w), in order to modify the default orientation if desired.
Figure C: Free positioning of the post with respect to the local reference system of the cavity
When considering a coaxial port, different types of probe geometries can be selected by the user. All the possible
probe types are included in figure D. When selected in the Ports tab, a specific legend will be shown with the
definition of the geometrical parameters of each probe.
Figure D: Different types of probes that can be used in this element with a coaxial waveguide port.
Regarding the posts, several different shapes can be considered, which are shown in figure E. By default, any post will
be automatically placed at the center of the bottom surface.
Limitations
The General cylindrical cavity discontinuity has some limitations and caveats you should be aware of:
On the other hand, collision between posts is possible. Depending on the type of material used for the posts,
the situation will be handled differently:
If all posts are of PEC material, they will be fused and considered as one object.
If there is volume intersection between posts of PEC and dielectric materials, the metallic part of
the intersection will prevail (the intersection volume inside the dielectric will be filled with PEC).
If there is collision between two posts of dielectric materials, one of the two geometries will
prevail over the other in the intersection volume. The criterion for choosing the prevailing geometry
will be the largest value of the product of the relative permittivity and permeability parameters of
the material associated to each post.
Errors
The General cylindrical cavity discontinuity can produce the following errors under certain circumstances. For each
error, the possible solutions or workarounds are explained.
Invalid installation path for CST Studio Suite. Please check that CST Studio Suite software is installed,
and that a valid installation path has been provided in the Graphical Interface (Options->Edit
Preferences): The user must ensure that a valid version of the CST Studio Suite® software is correctly installed
in the system, and provide the installation path as explained in the error message. More details about the CST
Studio Suite software requirements can be consulted in the limitations section.
License error while starting CST Studio Suite: A valid license file could not be detected for CST Studio
Suite® software. Please contact support in order to get a valid license file for the software.
Error(s) while running CST solver: This message appears if one or more errors have been detected during
simulation of the CST Solver. The different error descriptions give details of each particular problem. In most
cases, the errors will be related to inconsistencies found in the computation of the port modes or in the mesh
generation. Another source of errors might be lack of memory in the system if very dense meshes are used.
Modifying the number of accessible modes for the ports and/or the mesh parameters (for ports and for the
solver) might solve the problems.
Error while exporting matrix results of CST solver: This error appears if there were problems in the
exportation process of data. This might happen for example if the disk runs out of physical space. The user
must bear in mind that the simulations of the FEM solver might require a large amount of disk space, specially
if very dense meshes are used (e.g. several GBytes). Make sure that the disk in which the FEST3D input file is
located has enough free space and re-run the simulation.
Error while exporting modal fields results of CST solver: This error appears if there were problems in the
exportation process of data related to port modal fields. This might happen for example if the disk runs out of
physical space. The user must bear in mind that the simulations of the FEM solver might require a large amount
of disk space, specially if very dense meshes are used (e.g. several GBytes). Make sure that the disk in which the
FEST3D input file is located has enough free space and re-run the simulation.
The Enable/Disable button allows enabling and disabling this element, as described in the Main Window Edit menu.
The following parameters can be edited:
Besides, the tetrahedral meshing employed by the FEM Solver can be controlled by means of 3 parameters defined in
the same way as done in the CST Studio Suite® software:
Cells per wavelength: This parameter controls the upper limit to the cell size with respect to the smallest
wavelength used in the analysis range (which corresponds to the maximum frequency value set in the
Frequency Specifications for the FEST3D circuit). Increasing this number leads to a higher accuracy, but also
increases the total computation time. The default value is 10, providing a good compromise between the
calculation time and the achievable accuracy for most practical cases.
Smooth mesh with equilibrate ratio: This option controls the mesh smoothing in order to improve quality of
the generated mesh. It represents the maximum ratio between the lengths of two adjacent edges. The closer to
1, the smoother the resulting mesh will be. The default value is 1.2.
Normal tolerance (Deg): This parameter controls the discretization of curved edges and surfaces. Normal
tolerance is the angle in degrees between model edge or face normals at two adjacent mesh vertices. The
default value is 22.5, which forces to use approximately 16 points along circular contours. Lower values of
normal tolerance will lead to smoother discretization of curved surfaces.
Additionally, this element allows to apply mesh refinements in order to speed up the convergence when the cavity
contains cylindrical-shaped excitation probes or posts of PEC material. These refinements consists in the addition of a
virtual box that covers a volume zone surrounding the cap of each post or probe. A generic 2D scheme with the
definition of the refinement box is shown in figure G.
Figure G: Definition of the virtual refinement box applied to cylindrical probes and PEC posts inside the cavity
The mesh volume inside this box is controlled by means of the input refinement factor value. The mesh size
used inside the box is selected as the most restrictive value of the two following criteria:
Criterion 1: mesh size = (smallest wavelength used in the analysis / cells per wavelength) / refinement factor
Criterion 2: mesh size = (maximum perimeter * normal tolerance / 360) / refinement factor
The use of these refinement boxes can be enabled (by default) or disabled by clicking on the Enable refinements
checkbox. In most practical cases it is recommended to enable the use of refinements. Otherwise, the general mesh
parameters (specially normal tolerance and cells per wavelength) must be adjusted to be more restrictive in order
for the Solver to obtain good accuracy for the EM-fields inside the cavity and/or the resonant frequencies of the posts.
This will produce a denser mesh for the volume of the whole element, and higher computational times as a
consequence.
Continuing with the description of the Element Properties, the different excitation ports of the cavity are defined in
the Ports tab.
For each port, a specification tab will appear. In first place, a waveguide must be selected from the Attached
waveguide list, which will be filled with the connections already associated to this element. If the waveguide is of
Coaxial type, a probe must be selected from the Type of probe list. The types of available probes are shown in the
right side of the window, as depicted in Figure H. Once selected, the geometrical parameters of the selected probe
can be also edited. A legend will be shown indicating the definition of the specific parameters of the probe. A example
of specific probe is included as a second Coaxial port in Figure I. Another example case of port chosen as a Circular
waveguide is also included in figure J.
Figure H: Port properties of the General cylindrical cavity, case of a coaxial port
Figure I: Port properties of the General cylindrical cavity, case of a second coaxial port with a S probe
Figure J: Port properties of the General cylindrical cavity, case of a circular port
Additionally, for each port tab the following general information can be edited:
Surface: Specifies the surface of the cavity that is assigned to the port. This surface can be chosen in a menu
that obeys the names shown in figure A.
Another part of the specifications of this element is the General Posts tab. Here, additional resonant posts/tuning
screws can be inserted in the geometry if desired, by pressing the Add button.
For each post, the user can edit the specifications for the dimensions of the post. Regarding the positioning, the
surface wall of the cavity, offsets and rotation angles can be edited in the same way as done with the Ports tab,
following the conventions of figures B and C. Depending on the shape of the post, a specific legend with the
definition of the geometrical parameters is automatically shown at the right side of the window. Legends with the
offset definitions and the other types of post shapes are also displayed for reference.
The Material of the post can be also selected. The user can choose between PEC and Lossless dielectric for each one
of the post. In case of selecting lossless dielectric material, the corresponding relative permittivity and permeability
parameters can be edited.
Finally, any of the posts can be discarded by pressing the Delete post button on each tab.
Using the Lateral couplings to How to create, edit and use this element from FEST3D.
cylindrical cavity
Definition
The Lateral couplings to cylindrical cavity discontinuity consists in a cylindrical cavity whose radius is defined by two
circular ports (namely ports 1 and 2). The length of the cavity is provided by the user. Additionally, lateral ports can
access the cavity (at least one). The cavity dimensions, the local reference system and the definition of the geometrical
parameters of the ports are shown in figures A and B.
For performing the analysis, a Finite Element Method (FEM) Solver is employed in order to compute the General
Admittance Matrix (GAM) of the discontinuity. More specifically, this FEM Solver works in Frequency Domain using a
Reduced Order Model (MOR). This Solver is provided by the CST Studio Suite® software package. Therefore the
installation of this software is required in order to use this element.
Limitations
The Lateral couplings to cylindrical cavity discontinuity has some limitations and caveats you should be aware of:
Errors
The Lateral couplings to cylindrical cavity discontinuity can produce the following errors under certain circumstances.
For each error, the possible solutions or workarounds are explained.
Invalid installation path for CST Studio Suite. Please check that CST Studio Suite software is installed,
and that a valid installation path has been provided in the Graphical Interface (Options->Edit
Preferences): The user must ensure that a valid version of the CST Studio Suite® software is correctly installed
in the system, and provide the installation path as explained in the error message. More details about the CST
Studio Suite software requirements can be consulted in the limitations section.
License error while starting CST Studio Suite: A valid license file could not be detected for CST Studio
Suite® software. Please contact support in order to get a valid license file for the software.
Error(s) while running CST solver: This message appears if one or more errors have been detected during
simulation of the CST Solver. The different error descriptions give details of each particular problem. In most
cases, the errors will be related to inconsistencies found in the computation of the port modes or in the mesh
generation. Another source of errors might be lack of memory in the system if very dense meshes are used.
Modifying the number of accessible modes for the ports and/or the mesh parameters (for ports and for the
solver) might solve the problems.
Error while exporting matrix results of CST solver: This error appears if there were problems in the
exportation process of data. This might happen for example if the disk runs out of physical space. The user
Error while exporting modal fields results of CST solver: This error appears if there were problems in the
exportation process of data related to port modal fields. This might happen for example if the disk runs out of
physical space. The user must bear in mind that the simulations of the FEM solver might require a large amount
of disk space, specially if very dense meshes are used (e.g. several GBytes). Make sure that the disk in which the
FEST3D input file is located has enough free space and re-run the simulation.
The Enable/Disable button allows enabling and disabling this element, as described in the Main Window Edit menu.
The following parameters can be edited:
Length (mm/inches): The length of the circular cavity (see figure A).
Dielectric permittivity (relative) : Relative permittivity of the medium inside the cavity (vacuum by default).
Dielectric permeability (relative) : Relative permeability of the medium inside the cavity (vacuum by default).
Besides, the tetrahedral meshing employed by the FEM Solver can be controlled by means of 3 parameters defined in
the same way as done in the CST Studio Suite® software:
Continuing with the description of the Element Properties, the different excitation ports of the cavity are defined in
the Ports tab.
The ports of this element can be inserted in two ways:
By performing connections with waveguides before opening the element properties. These connections will be
automatically detected as new ports.
By pressing the Add port button (a connection with a waveguide will be required later before completing the
circuit).
The first two ports are expected to be Circular waveguides which are used to define the cavity radius according to
figure A. The rest of the ports tabs belong to lateral exitations.
For each port, a specification tab will appear. There are two basic fields which can be edited for any of the ports:
In first place, a waveguide must be selected from the Attached waveguide list, which will be filled with the
connections already associated to this element.
Cells per min. mode wavelength: This parameter controls the cell size with respect to the minimum
wavelength considering all the accessible modes used in the waveguide associated to the port. The choice of
this parameter is very important in order to ensure acceptable convergence for the solution of all the
port modes. Small values may lead to simulation warnings and/or errors and unstable results depending
on the number of accessible modes. The default value is 5, which offers a good compromise between
simulation time and good discretization for solving all the accessible modes of the port. Larger values of
this parameter will force to use finer discretization of the port surface, increasing the overall meshing of the 3D
structure and the simulation time as a consequence. It is also worth mentioning that this parameter may take
no effect in the overall meshing for the cases where the general mesh parameters used for the FEM Solver are
restrictive enough for the structure under analysis (this will depend on the values of the mesh parameters, the
geometry dimensions and the frequency range used in the simulation)
Besides, for each one of the lateral port tabs the following information can be edited:
Position angle (Degrees): Specifies an angle value for rotating the lateral port along the propagation direction
(Z axis) when observing the cavity from the perspective of Port 1 (see figure B).
Rotation angle (Degrees): Specifies an angle value for rotating the lateral port along X axis when observing
the cavity in side view (see figure B). This parameter is only editable for the case of Rectangular waveguide
ports.
Offset Z (mm/inches): Indicates an optional displacement value in the propagation direction (Z axis) with
respect the center of the cavity (see figure B).
Port length (mm/inches): Indicates a separation distance value measured from the cross section of the
waveguide port to the circular cavity (see figure B). It is recommended to use values greater than zero in
order to obtain more stable and convergent results.
Blend radius (mm/inches): Specifies an optional value of a radius used for blending the edges of the cross
Figure D: Port properties of the Lateral couplings to cylindrical cavity, case of one of the fixed ports (1 and 2)
Figure E: Port properties of the Lateral couplings to cylindrical cavity, case of a lateral port
Errors The possible errors produced by this element, and solutions or workarounds to them.
Using the General cavity How to create, edit and use this element from FEST3D.
Definition
The T-Junction circular to rectangular discontinuity consists in a cylindrical cavity whose radius is defined by two
circular ports (namely ports 1 and 2) which is accesed by a lateral port of rectangular shape (port 3). The length of the
cavity is provided by the user. The cavity dimensions, the local reference system and the definition of the geometrical
parameters of the ports are shown in figures A and B.
For performing the analysis, a Finite Element Method (FEM) Solver is employed in order to compute the General
Admittance Matrix (GAM) of the discontinuity. More specifically, this FEM Solver works in Frequency Domain using a
Reduced Order Model (MOR). This Solver is provided by the CST Studio Suite® software package. Therefore the
installation of this software is required in order to use this element.
Limitations
The T-Junction circular to rectangular discontinuity has some limitations and caveats you should be aware of:
Errors
The T-Junction circular to rectangular discontinuity can produce the following errors under certain circumstances. For
each error, the possible solutions or workarounds are explained.
Invalid installation path for CST Studio Suite. Please check that CST Studio Suite software is installed,
and that a valid installation path has been provided in the Graphical Interface (Options->Edit
Preferences): The user must ensure that a valid version of the CST Studio Suite® software is correctly installed
in the system, and provide the installation path as explained in the error message. More details about the CST
Studio Suite software requirements can be consulted in the limitations section.
License error while starting CST Studio Suite: A valid license file could not be detected for CST Studio
Suite® software. Please contact support in order to get a valid license file for the software.
Error(s) while running CST solver: This message appears if one or more errors have been detected during
simulation of the CST Solver. The different error descriptions give details of each particular problem. In most
cases, the errors will be related to inconsistencies found in the computation of the port modes or in the mesh
generation. Another source of errors might be lack of memory in the system if very dense meshes are used.
Modifying the number of accessible modes for the ports and/or the mesh parameters (for ports and for the
solver) might solve the problems.
Error while exporting modal fields results of CST solver: This error appears if there were problems in the
exportation process of data related to port modal fields. This might happen for example if the disk runs out of
physical space. The user must bear in mind that the simulations of the FEM solver might require a large amount
of disk space, specially if very dense meshes are used (e.g. several GBytes). Make sure that the disk in which the
FEST3D input file is located has enough free space and re-run the simulation.
The Enable/Disable button allows enabling and disabling this element, as described in the Main Window Edit menu.
The following parameters can be edited:
Length (mm/inches): The length of the circular cavity (see figure A).
Dielectric permittivity (relative) : Relative permittivity of the medium inside the cavity (vacuum by default).
Dielectric permeability (relative) : Relative permeability of the medium inside the cavity (vacuum by default).
Besides, the tetrahedral meshing employed by the FEM Solver can be controlled by means of 3 parameters defined in
the same way as done in the CST Studio Suite® software:
Continuing with the description of the Element Properties, the different excitation ports of the cavity are defined in
the Ports tab.
The first two ports are expected to be Circular waveguides which are used to define the cavity radius according to
figure A. The rest of the ports tabs belong to lateral exitations.
For each port, a specification tab will appear. There are two basic fields which can be edited for any of the ports:
In first place, a waveguide must be selected from the Attached waveguide list, which will be filled with the
connections already associated to this element.
Cells per min. mode wavelength: This parameter controls the cell size with respect to the minimum
wavelength considering all the accessible modes used in the waveguide associated to the port. The choice of
this parameter is very important in order to ensure acceptable convergence for the solution of all the
port modes. Small values may lead to simulation warnings and/or errors and unstable results depending
on the number of accessible modes. The default value is 5, which offers a good compromise between
simulation time and good discretization for solving all the accessible modes of the port. Larger values of
this parameter will force to use finer discretization of the port surface, increasing the overall meshing of the 3D
structure and the simulation time as a consequence. It is also worth mentioning that this parameter may take
no effect in the overall meshing for the cases where the general mesh parameters used for the FEM Solver are
restrictive enough for the structure under analysis (this will depend on the values of the mesh parameters, the
geometry dimensions and the frequency range used in the simulation)
Besides, for the third port tab the following information can be edited:
Position angle (Degrees): Specifies an angle value for rotating the lateral port along the propagation direction
(Z axis) when observing the cavity from the perspective of Port 1 (see figure B).
Rotation angle (Degrees): Specifies an angle value for rotating the lateral port along X axis when observing
the cavity in side view (see figure B).
Offset Z (mm/inches): Indicates an optional displacement value in the propagation direction (Z axis) with
respect the center of the cavity (see figure B).
Port length (mm/inches): Indicates a separation distance value measured from the cross section of the
waveguide port to the circular cavity (see figure B). It is recommended to use values greater than zero in
order to obtain more stable and convergent results.
Blend radius (mm/inches): Specifies an optional value of a radius used for blending the edges of the cross
section of the waveguide port which are in contact with the circular cavity (see figure B).
Figure D: Port properties of the T-Junction circular to rectangular, case of one of the fixed ports (1 and 2)
Figure E: Port properties of the T-Junction circular to rectangular, case of third port
Errors The possible errors produced by this element, and solutions or workarounds to them.
Using the General cavity How to create, edit and use this element from FEST3D.
Definition
The T-Junction circular to circular discontinuity consists in a cylindrical cavity whose radius is defined by two circular
ports (namely ports 1 and 2) which is accesed by a lateral port of circular shape (port 3). The length of the cavity is
provided by the user. The cavity dimensions, the local reference system and the definition of the geometrical
parameters of the ports are shown in figures A and B.
For performing the analysis, a Finite Element Method (FEM) Solver is employed in order to compute the General
Admittance Matrix (GAM) of the discontinuity. More specifically, this FEM Solver works in Frequency Domain using a
Reduced Order Model (MOR). This Solver is provided by the CST Studio Suite® software package. Therefore the
installation of this software is required in order to use this element.
Limitations
The T-Junction circular to circular discontinuity has some limitations and caveats you should be aware of:
Connections to other elements
This element can only be connected to Circular waveguides.
Errors
The T-Junction circular to circular discontinuity can produce the following errors under certain circumstances. For each
error, the possible solutions or workarounds are explained.
Invalid installation path for CST Studio Suite. Please check that CST Studio Suite software is installed,
and that a valid installation path has been provided in the Graphical Interface (Options->Edit
Preferences): The user must ensure that a valid version of the CST Studio Suite® software is correctly installed
in the system, and provide the installation path as explained in the error message. More details about the CST
Studio Suite software requirements can be consulted in the limitations section.
License error while starting CST Studio Suite: A valid license file could not be detected for CST Studio
Suite® software. Please contact support in order to get a valid license file for the software.
Error(s) while running CST solver: This message appears if one or more errors have been detected during
simulation of the CST Solver. The different error descriptions give details of each particular problem. In most
cases, the errors will be related to inconsistencies found in the computation of the port modes or in the mesh
generation. Another source of errors might be lack of memory in the system if very dense meshes are used.
Modifying the number of accessible modes for the ports and/or the mesh parameters (for ports and for the
solver) might solve the problems.
Error while exporting modal fields results of CST solver: This error appears if there were problems in the
exportation process of data related to port modal fields. This might happen for example if the disk runs out of
physical space. The user must bear in mind that the simulations of the FEM solver might require a large amount
of disk space, specially if very dense meshes are used (e.g. several GBytes). Make sure that the disk in which the
FEST3D input file is located has enough free space and re-run the simulation.
The Enable/Disable button allows enabling and disabling this element, as described in the Main Window Edit menu.
The following parameters can be edited:
Length (mm/inches): The length of the circular cavity (see figure A).
Dielectric permittivity (relative) : Relative permittivity of the medium inside the cavity (vacuum by default).
Dielectric permeability (relative) : Relative permeability of the medium inside the cavity (vacuum by default).
Besides, the tetrahedral meshing employed by the FEM Solver can be controlled by means of 3 parameters defined in
the same way as done in the CST Studio Suite® software:
Continuing with the description of the Element Properties, the different excitation ports of the cavity are defined in
the Ports tab.
The first two ports are expected to be Circular waveguides which are used to define the cavity radius according to
figure A. The rest of the ports tabs belong to lateral exitations.
For each port, a specification tab will appear. There are two basic fields which can be edited for any of the ports:
In first place, a waveguide must be selected from the Attached waveguide list, which will be filled with the
connections already associated to this element.
Cells per min. mode wavelength: This parameter controls the cell size with respect to the minimum
wavelength considering all the accessible modes used in the waveguide associated to the port. The choice of
this parameter is very important in order to ensure acceptable convergence for the solution of all the
port modes. Small values may lead to simulation warnings and/or errors and unstable results depending
on the number of accessible modes. The default value is 5, which offers a good compromise between
simulation time and good discretization for solving all the accessible modes of the port. Larger values of
this parameter will force to use finer discretization of the port surface, increasing the overall meshing of the 3D
structure and the simulation time as a consequence. It is also worth mentioning that this parameter may take
no effect in the overall meshing for the cases where the general mesh parameters used for the FEM Solver are
restrictive enough for the structure under analysis (this will depend on the values of the mesh parameters, the
geometry dimensions and the frequency range used in the simulation)
Besides, for the third port tab the following information can be edited:
Position angle (Degrees): Specifies an angle value for rotating the lateral port along the propagation direction
(Z axis) when observing the cavity from the perspective of Port 1 (see figure B).
Offset Z (mm/inches): Indicates an optional displacement value in the propagation direction (Z axis) with
respect the center of the cavity (see figure B).
Port length (mm/inches): Indicates a separation distance value measured from the cross section of the
waveguide port to the circular cavity (see figure B). It is recommended to use values greater than zero in
order to obtain more stable and convergent results.
Blend radius (mm/inches): Specifies an optional value of a radius used for blending the edges of the cross
section of the waveguide port which are in contact with the circular cavity (see figure B).
Figure D: Port properties of the T-Junction circular to circular, case of one of the fixed ports (1 and 2)
Figure E: Port properties of the T-Junction circular to circular, case of third port
Allowed Symmetries
The following table lists the symmetries allowed by the various elements within the circuit. This does not necessarily
mean that the symmetries are taken into account in the element, but just that the circuit formed by those elements
support such symmetries. In case that more than one symmetry is specified simultaneously in a circuit, the elements
must allow them all.
All-
All-Inductive All-Capacitive X symmetry Y symmetry TEM
Cylindrical
Rectangular yes yes yes yes no no
Coaxial no no no no no yes
Circular Arbitrary, no no no no no no
Arbitrary Circular with an Ellipse,
Arbitrary Circular with a Cross,
Arbitrary Circular with Screws ,
Circular Elliptic iris
Radiating Array no no no no no no
Implemented Symmetries
The following table lists the implemented symmetries by the various kind of elements. This means that these elements
exploit such symmetries.
All- All-
X symmetry Y symmetry All-Cylindrical TEM
Inductive Capacitive
Rectangular yes yes yes yes no no
Coaxial no no no no no yes
Arbitrary Circular, no no no no no no
Arbitrary Circular with an Ellipse,
Arbitrary Circular with a Cross,
Arbitrary Circular with Screws,
Circular Elliptic iris
Radiating Array no no no no no no
T-Junction no no no no no no
Coaxial library no no no no no no
3 Index
1-Port User Defined, 306-308
2D Compensated Tee, 345-351
2D Curved, 363-368
2D OMT, 336-345
2D Rounded short, 401-406
3D Viewer, 99-103
ACW with a Cross, 274-277
ACW with an Ellipse, 271-274
ACW with Screws, 277-281
Adaptive Frequency Sampling Method, 110-114
Allowed Symmetries, 599-600
Analysis, 108
Arbitrary Rectangular (ARW), 228-232
Arbitrary shape, 368-377
Cavity with posts, 407-420
Circular Arbitrary (ACW), 265-271
Circular Waveguide, 224-226
Circular-Elliptic Iris, 285-286
CLI, 212-216
Coaxial cavity library, 407
Coaxial waveguide, 226-228 , 232-235
Compare Results tool, 106-108
Contact feed to helical resonator, 524-536
Convergence Study, 132-133
Corona Discharge Analysis, 182-193
Coupling Matrix, 310-313
Cross waveguide, 235-238
CST solver library, 536
Cubic Junction, 325-327
Curved waveguide, 281-285
Design, 136
Discontinuities, 290-294
Draft waveguide, 238-241
ElectroMagnetic Computational Engine (EMCE), 108-110
Elements bar, 93
Elements Database, 216
Elliptic waveguide, 241-244