1
.TH OUTPUT 1 "24th October 2000" "Version 1.16"
9
output \- Yagi-Uda project antenna display program
35
is one of a number of executable programs that forms part of a set of
36
programs, collectively known as the
38
, which were designed for analysis and optimisation of Yagi-Uda antennas.
40
calculates the gain, FB ratio, input impedance etc etc of an antenna that was described by the
45
and has had the element currents calculated with the program
47
The data about the forward gain, VSWR, FB ratio, input impedance etc is written to a file
49
Angular data, giving the variation of gain with theta and phi is put into a file
52
Sometimes the program fails to find the 3dB bandwidths in the E and H planes,
53
and bombs out with a 'zbrent' error. This can occur if:
55
(1) The antenna has an almost isotropic pattern, in which case its never 3dB
56
down, so the 3dB point is undefined.
58
(2) The 3dB point is outside the assumed angular range.
59
You then have to either:
61
(a) Calculate with the -e option, which avoids calculation of the 3dB E-plane beamwidth or
63
(b) Do (a) above, then find approximately where the 3dB point is (from the .gai file -see later), then set
64
options -E and -H so the program calculates them properly.
69
The DOS .EXE files as distributed require a 387 maths coprocessor to be
70
present and will not run without it. A 486, Pentium, and I assume later
71
processors of this series will run it without any extra hardware. The DOS files are no longer being
72
maintained, so are out of sync with the latest source.
76
Calculate the maximum level of any sidelobe - not just the rear on as the
77
FB ratio tells us. If the sidelobe and FB ratio are equal, it means the
78
biggest sidelobe is the rear one. If the Sidelobe is less than the FB
79
ratio, then another lobe is more significant. Look in the '.gai' file (see
80
below) to see where it is. This option slows the program quite a bit.
83
Suppress calculation of the 3dB E-plane bandwidth. This is sometimes necessary if the programme is
84
unable to find the 3 dB beamwidth, to prevent an error occuring.
87
Suppress calculation of the 3dB H-plane bandwidth. This is sometimes necessary if the programme is
88
unable to find the 3 dB beamwidth, to prevent an error occuring.
91
Put data into a file filename.freq for reading into gnuplot, and a commmand file filename.gc for
92
gnuplot to use. (run 'output -p filename' then 'gnuplot filename.gc' )
95
Suppress all diagnostic output. By default, the program print the percentage of the job completed.
98
When the program computes the E-plane 3dB beamwidth, it assumes the antenna pattern is 3dB down somewhere in the range 90 to Emax, where E_max is by default 179 degrees. This can fail if it is never 3dB down in the range, or if it happened to go 3dB down in two or more points. You can change E_max, if you need to, but
99
rarely if every should need to. I've never seen a failure here, but are guarding against one. If you dont want the pattern, use the -e option instead, which skips it. See also '-H' below.
102
When the program computes the H-plane 3dB beamwidth, it assumes the antenna pattern is 3dB down somewhere in the range 0 to Hmax, where H_max is by defualt 60 degrees. This can fail if it is never 3dB down in the range, or if it happended to go 3dB down in two or more points. Also, if it goes more than 3dB down, but that starts to come up again. You can change H_max, if you need to, as
103
failures do occasionally occur. If you dont want the pattern use -h option instead, which will skip it.
105
An obvious example of an antenna where you cant find the 3dB bandwidth for the H-plane is the 1ele dipole. The radiation is symmetrical about its axis, so the level is the same everywhere in the H plane. The program automatically avoids calculating it for a 1 ele beam.
109
Zo is the characteristic impedance used when calculating the VSWR. By default it's 50 Ohms, but can be changed to any real, positive value.
113
is the name of the file containing the antenna description. It is expected
114
to be in a format created by
118
- two other programs in the
120
The is also expected to exist a binary file
125
I'm not aware of any limitations, apart from that filenames, including full
126
path, can't exceed 90 characters.
129
filename ASCII file with antenna description.
130
filename.out Binary data file, created by yagi.
131
filename.dat ASCII file with gain, FB ratio etc.
132
filename.gai ASCII file with angular dependence of gain.
136
first(1), input(1), yagi(1), optimise(1).
139
Both DOS and Unix versions have been built. The DOS version as
140
distributed requires a 386 PC with a 387 maths coprocessor.
142
Bugs should be reported to
143
.BR david.kirkby@onetel.net .
144
Bugs tend actually to be fixed if they can be isolated, so it is in your
145
interest to report them in such a way that they can be easily reproduced.
146
The program gives errors if element lengths are well away from a half-wave (by a factor of ~3)
147
due to a breakdown in the equations.
148
If the input file is edited manually and done incorrectly, there can be unpredictable results.
153
Dr. David Kirkby G8WRB (david.kirkby@onetel.net).
154
with help with converting to DOS from Dr. Joe Mack NA3T (mack@fcrfv2.ncifcrf.gov)
added
removed
.pc/debian-changes-1.19-6.2/man/man1/output.1
