NAME

       yagi - Yagi-Uda project antenna current calculator

SYNOPSIS

       yagi [ - dhps ] filename

DESCRIPTION

       The  program  yagi  is  one of a number of executable programs that forms part of a set of
       programs, collectively known as the Yagi-Uda project , which were  designed  for  analysis
       and optimisation of Yagi-Uda antennas.  yagi calculates the currents at the centre of each
       element at one or more frequencies, as specified in the input file.

AVAILABILITY

OPTIONS

       -d     Display element currents. When this option is used, a bar graph with up to 70 stars
              (*)  is used to display the absolute magnitude of the element currents. The element
              with the greatest element current has 70  *'s,  all  others  have  a  corresponding
              smaller  number,  depending  on  the  their  relative current. The element current,
              normallised to the maximum, is also shown as a 4 digit floating point number.

       -h     Print a help message.

       -p     Print the Z matrix. The  Z  matrix  is  the  impedance  matrix,  showing  the  self
              impedance  of  the  elements  on  the  diagonal  and  the  mutual impedance off the
              diagonal.

       -s     Suppress all diagnostic output. By default, the program print the percentage of the
              job completed.

        filename
              is the name of the file containing the antenna description. It is expected to be in
              a format created by either input or first - two  other  programs  in  the  Yagi-Uda
              project.   This  is  an ASCII text file. The antenna currents are written to a file
              filename.out which is a binary file. It is not intended to be read by humans.

Limitations

       I'm not aware of any limitations, apart from that filenames, including  full  path,  can't
       exceed 90 characters.

FILES

       filename.out       Binary data file

SEE ALSO

       first(1), input(1), output(1), optimise(1), first(5), input(5), output(5) and optimise(5).

PLATFORMS

       Both  DOS and Unix versions have been built. The DOS version as distributed requires a 386
       PC with a 387 maths coprocessor.

BUGS

       Bugs should be reported to david.kirkby@onetel.net.  Bugs tend actually  to  be  fixed  if
       they can be isolated, so it is in your interest to report them in such a way that they can
       be easily reproduced.  If the input file is edited manually and  done  incorrectly,  there
       can be unpredictable results.

AUTHORS

       Dr.  David  Kirkby  G8WRB (david.kirkby@onetel.net), with help with converting to DOS from
       Dr. Joe Mack NA3T (mack@fcrfv2.ncifcrf.gov).