YAGI(1)

πŸ’– yagi β€” Yagi-Uda project antenna current calculator πŸ’–

okay so bestie, this is the manual for yagi(1) β€” yeah it lives in the General Commands Manual, we love a classic ✨


🌸 NAME 🌸

yagi β€” Yagi-Uda project antenna current calculator. that's it, that's the whole vibe πŸ¦‹


✨ SYNOPSIS ✨

yagi [ - dhps ] filename

πŸ’… DESCRIPTION πŸ’…

so yagi is one of a whole little squad of executable programs that are all part of one set of programs, collectively known as the Yagi-Uda project πŸ‘‘ and the whole point of that squad is analysis and optimisation of Yagi-Uda antennas, periodt.

what this one does: yagi calculates the currents at the centre of each element, at one or more frequencies β€” whichever frequencies you specified in the input file. she's a calculator, she's focused, she ate πŸ’–


πŸŽ€ AVAILABILITY πŸŽ€

ngl bestie, this section is literally empty. nothing here. not a crumb. moving on πŸ™ˆ


🌈 OPTIONS 🌈

  • -d β€” display element currents πŸ”₯ when you use this one, you get a bar graph with up to 70 stars (*) showing the absolute magnitude of the element currents. the element with the greatest element current gets all 70 *'s, and everyone else gets a correspondingly smaller number of them, depending on their relative current. the element current, normalised to the maximum, is also shown as a 4 digit floating point number. it's giving chart-topping behaviour, fr fr ⭐
  • -h β€” print a help message 🫢 short king of an option, we stan.
  • -p β€” print the Z matrix πŸ’œ the Z matrix is the impedance matrix β€” it shows the self impedance of the elements on the diagonal, and the mutual impedance off the diagonal. diagonal = self, off-diagonal = mutual, that's the whole shape of it, iykyk.
  • -s β€” suppress all diagnostic output πŸ”‡ by default the program prints the percentage of the job completed, so if you want silence? this is your girl.
  • filename β€” the name of the file containing the antenna description πŸ“„ it's expected to be in a format created by either input or first β€” two other programs in the Yagi-Uda project, in case you were wondering who her friends are. this is an ASCII text file. the antenna currents get written to a file called filename.out, which is a binary file. it is not intended to be read by humans, bestie β€” hands off, she's shy 😭

🧚 Limitations 🧚

okay so the author says they're not aware of any limitations, apart from one: filenames, including the full path, can't exceed 90 characters πŸ’€ so keep those paths short and cute.


πŸ“ 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) β€” go read the whole family, they're all iconic in their own way 🫢


πŸ’œ PLATFORMS πŸ’œ

both DOS and Unix versions have been built πŸ‘‘ and just so you know, the DOS version as distributed requires a 386 PC with a 387 maths coprocessor. retro tech moment, we love to see it 🌈


πŸ’€ BUGS πŸ’€

bugs should be reported to david.kirkby@onetel.net πŸ“§ and here's the tea: bugs tend actually to get fixed if they can be isolated, so it is genuinely in your interest to report them in such a way that they can be easily reproduced. help them help you, bestie πŸ™

⚠️ also, if the input file is edited manually and done incorrectly, there can be unpredictable results. so like… don't freestyle it 😭

πŸ‘‘ AUTHORS πŸ‘‘

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


and that's the whole page, bestie πŸŽ€ this was Version 1.16, dated the 24th October 2000 β€” a true vintage icon, and honestly? she still slays πŸ’…βœ¨πŸ¦‹