In this menu we can see a set of options used to feed an antenna with the data represented in the table below.

DIA Files Editor
The radiation pattern section defines the three types that can be chosen and, depending on each one, a different table is then displayed: REV, RV2 and 3DE. The general features of each one of these options are explained below:
Radiation pattern: In this section we can see three options: the type of radiation (mentioned above), angular range to be considered, only visible in REV type, and Polarization, to indicate a linear or circular polarization.

Radiation Pattern
Theta and Phi sections: used to mark the initial and final values in degrees that define the angular sweeps.

Theta and Phi Menu
File Content: In this section the user can select an operation and load in the formula using the button Load Formula, and introduce a customized mathematic formula. To do this the Theta o Phi variables are required, as well as the operation, shown in the drop down menu.

File Content
- Operations of File Content: operations available to be applied to a given formula are as follows:
-
abs (absolute value)
-
acos (arccosine)
-
acosr(arccosine in radians)
-
asin (arcsine)
-
asinr (arcsine in radians)
-
atan(arctangent)
-
atanr(arctangent in radians)
- ceil
-
cos(cosine)
-
cosr(cosine in radians)
-
deg(value in degrees with a circumference of 360 parts)
-
exp(elevate a number to an exponent)
-
floor
-
ln(natural logarithm)
-
log(logarithm with the introduced base)
-
log10(logarithm in 10 base)
-
max(maximum)
-
min(minimum)
-
mod(module)
-
pow(to raise a number to the power)
-
rad(value in degrees with a circumference of 360 parts)
-
random(random value)
-
round(round up of value)
-
sin(sine)
-
sinr(sine in radians)
-
sqrt(square root of value)
-
tan(tangent)
-
tanr (tangent in radians)
After creating the formula, the user needs to select the cells in the table where the formula is going to be applied and press Apply.
To insert multiple values in the table, insert the number in Value and select the required cells and then press Fill value to selection.
In order to reset the initial values, press Update Cut Ranges.
Finally to save the data calculated using the formula, press Save or load previous data with the button Load DIA File.
After seen the basics, let us overview each type options:
REV: The user can select Phi degrees on Radiation pattern and the table will include the following information:

REV File Content
The attribute Theta describes the angle in degrees, Etheta (dB) and EPhi (dB) describe the module and Etheta(deg) and EPhi(deg) the phase values.
RV2: With this option it is not possible to select Phi degrees on Radiation pattern. In this case the table will contain the following information:

RV2 File Content
In this case the field is expressed in the E-plane components and the H-plane components (module in dB and phase in degrees), instead of using the theta and phi components as in the previous case.
3DE: With this option it is not possible to select Phi degrees on Radiation pattern. In this case the table will contain the following information:

3DE File Content
The table values in this case are the same as those shown for the REV option. In this case the full pattern is provided and no revolution condition is assumed.
This section describes the structure of the radiation pattern files in newFASANT.
These files are plain text files whose format depends on the kind of radiation pattern. The radiation pattern file contains:
Title
|
Description
|
Possible values
|
File description
|
Three lines describing the file.
|
Any. These lines will be interpreted as comments.
|
Cut
|
Only if radiation pattern is REV (revolution).
The cut in theta or phi.
|
TH=<angle>
PH=<angle>
Comments: <angle> is a decimal number representing the angle in degrees.
|
Polarization
|
Only for linearly polarized antennas.
Polarization of the radiated field.
|
Eth
Eph
Eth, Eph
|
Polarization
|
Only for circularly polarized antennas.
Polarization of the radiated field.
|
Ui
Ud
Ui, Ud
Comments: Use Ui for LHCP polarized antennas, Ud for RHCP polarized antennas, and Ui,Ud for both LHCP and RHCP polarized antennas.
|
Blank line
|
A blank, empty line (necessary).
|
None.
|
Sweep
|
Sweep in the direction of theta and phi.
|
<initial_theta><num_points_theta><step_theta><initial_phi><num_points_phi><step_phi>
Comments: All initial angles and steps are specified in degrees. The values are delimited by, at least, one blank space.
|
Blank line
|
A blank, empty line (necessary).
|
None.
|
And then, for each sampled direction (note: brackets denote optional values and must not appear in the radiation pattern files):
Title
|
Description
|
Possible values
|
Data (REV)
|
If radiation pattern of the antenna is REV (revolution).
Value of the field in the direction.
|
<theta> [<phi>] [<eth_amplitude><eth_phase>] [<phi_amplitude><phi_phase>].
|
Data (RV2)
|
If radiation pattern of the antenna is RV2 (semi-revolution).
Value of the field in the direction.
|
<theta> [<phi>] <eplane_amplitude><eplane_phase><hplane_amplitude><hplane_phase>
Comments: HPlane phase must be equal to EPlane phase + 180 degrees.
|
Data (3DE)
|
If radiation pattern of the antenna is 3DE (generic).
Value of the field in the direction.
|
<theta> [<phi>] [<eth_amplitude><eth_phase>] [<phi_amplitude><phi_phase>]
|
It is necessary to define the field values for each point defined in the Sweep line.
How to create a Pattern File step by step
This part explains, step by step, how to create a Pattern File, in the case a 3DE Linear file with a sweep on theta from 0º to 180º on steps of 45º and a sweep on phi from 0º to 360º with steps of 45º.For real cases increment value is recommended to be a lower value e.g. 1º.
For field amplitude values, (dB) columns, the function will be 20*log10(pow(cosd(Theta/2.),4)) for 'Eth' column and 20*log10(pow(cosd(Theta/2.),3)) for 'Eph' column. For field phase values, (deg) columns of the two components, the value will be 0.0.
Step 1: Select Radiation Pattern Type with the combo box named 'type'. For the case, select '3DE' option.

After the selection, the table contents changes to 3DE type contents. This option disables 'Cut' option because the sweep will be on the two coordinates.
Step 2: Select Radiation Pattern Polarization with the combo box named 'Polarization'. Select 'LIN' option in the list to generate a linear polarizated pattern.
Step 3: Set Theta and Phi sweep. Introduce the initial, final and increment per step values to define the sweep. For the case Theta starts on 0º and goes to 180º with an increment of 45º. Phi starts on 0º and goes to 360º with an increment of 45º. Then click on 'Update Cuts Ranges' button to update Theta and Phi columns of the table.

Step 4: Set Etheta Field amplitude values (Eth (dB) column). To do this, is necesary to introduce the formula on the text field named 'f(theta,Phi)' using the combo boxes of parameters and functions at the top of the 'File Content' panel, and the 'Load Formula' button to load the selected formula on the text field. Is possible to hand write the functions on the text field. When the formula will be completed is necessary to select the cells to assign the values. In the case select first cell on the third column and with 'Mayus.' key pressed select the last cell of the same column to sellect all the column cells. Then click on 'Apply' button.

Step 5: Set Etheta Field phase values (Eth (deg) column). To do this, is necesary to introduce the value 0.0 on the text field named 'Value' at the bottom of the 'File Content' panel then select all the cells of the column and click on 'Fill value to selection' button.

Step 6: Set Ephi Field amplitude values (Eph (dB) column). To do this, repeat 'Step 4' with the formula for 'Eph' component.

Step 7: Repeat 'Step 5' with the last column to complete the file contents.

Step 8: Export the table values as a Pattern File, '.dia', file clicking on 'Save' button at the bottom of the 'File Content' panel and selecting the computer directory on the file chooser that appears.

To add more complexity to the files is possible to define more complex formulas to define the values. For example:
Set Etheta amplitude values, 'Eth (dB)'column, to the following formula.

Set Etheta phase values, 'Eth (deg)' column, from phi 135º to the end to 180º value.

Set Ephi phase values, 'Eph (deg)' column, from phi 180º to the end to 180º value.

Then, export the file.

Example 1: ‘boc0677.dia’ file
Some of the contents of the file are omitted for brevity.
NAME (Semi-revolution RV2)
PLANE_C_1.m
8000
Eth
.0 181 1.0 .0 1 .0
.0 .00000 .0 .00000 .180
1.0 .00000 .0 .00000 .180
2.0 .00000 .0 .00000 .180
3.0 .00000 .0 .00000 .180
4.0 .00000 .0 .00000 .180
5.0 -.10000 .0 .00000 .180
6.0 -.10000 .0 -.10000 .180
...
177.0 -22.40000 .0 -20.10000 .180
178.0 -22.40000 .0 -19.90000 .180
179.0 -22.40000 .0 -19.60000 .180
180.0 -22.40000 .0 -19.50000 .180
Example 2: ‘antlin.dia’ file
Some of the contents of the file are omitted for brevity.
HORN KU (GENERIC DIAGRAM 3DE)
TRIDIMENSIONAL.
11.705E09
Eth,Eph
0. 181 1. 0. 72 5.
.00 .00 19.30 11.99 -13.52 16.58
1.00 .00 19.26 10.12 -12.94 12.40
2.00 .00 19.17 8.01 -12.33 11.45
...
178.00 .00 -45.44 152.96 -49.41 69.34
179.00 .00 -46.34 171.15 -44.65 86.60
180.00 .00 -44.81 177.94 -41.65 68.53
.00 5.00 19.28 12.26 -3.96 190.82
1.00 5.00 19.25 10.45 -4.20 189.62
2.00 5.00 19.16 8.45 -4.55 187.06
3.00 5.00 19.03 6.38 -4.83 183.02
...
178.00 355.00 -38.42 115.93 -37.56 293.68
179.00 355.00 -39.74 135.22 -42.42 240.49
180.00 355.00 -38.57 137.33 -46.54 154.71
Example 3: ‘tx.dia’ file
TX REVOLUTION ANTENNA (REV)
Frequency:
3 GHz
PH=0.0
Eth
0.0 19 10 0.0 1 0.0
0 -80.0 0.0
10 -15.2 0.0
20 -9.32 0.0
30 -6.02 0.0
40 -3.84 0.0
50 -2.31 0.0
60 -1.25 0.0
70 -0.54 0.0
80 -0.13 0.0
90 0.0 0.0
100 -0.13 0.0
110 -0.54 0.0
120 -1.25 0.0
130 -2.31 0.0
140 -3.84 0.0
150 -6.02 0.0
160 -9.32 0.0
170 -15.2 0.0
180 -80.0 0.0