create_bmp...ne_coupler(1)

📦 version 4.6.1, in debian bookworm, debian trixie, ubuntu jammy, ubuntu noble, ubuntu resolute, ubuntu stonking

💖 create_bmp_for_stripline_coupler 💖

okay bestie, welcome to the General Commands Manual, section 1, and no cap this page is a whole vibe. it's the manual for create_bmp_for_stripline_coupler and we're gonna get you fully caught up. 🦋

✨ NAME ✨

create_bmp_for_stripline_coupler — a bitmap generator for a coupler with thin striplines between two infinitely wide groundplanes (it's part of atlc, iykyk 💅)

🌸 SYNOPSIS 🌸

create_bmp_for_stripline_coupler [-C] [-b bitmapsize] [-v] H w s Er outputfile

🚨 WARNING 🚨

so real talk: this man page is not a complete set of documentation, bestie. the atlc project is genuinely so complex that man pages just aren't an ideal way to document it — but out of completeness, man pages got produced anyway. 🙈

the best documentation that was current at the time this version was produced should be living on your hard drive, usually right here:

/usr/local/share/atlc/docs/html-docs/index.html

…although it might be somewhere else entirely if your system administrator chose to install the package in a different place. no judgment, sysadmins do what they do. 💜

sometimes errors get corrected in the documentation and dropped at http://atlc.sourceforge.net/ before a new release of atlc ships out. and please — if you notice a problem with the documentation, even spelling errors and typos, please let me know. fr fr, every little thing helps. 🫶

🎀 DESCRIPTION 🎀

create_bmp_for_stripline_coupler is a pre-processor for atlc, the finite difference program that's used to calculate the properties of a two and three conductor electrical transmission lines of arbitrary cross section. iconic behaviour honestly.

the program create_bmp_for_stripline_coupler is used as a fast way of generating bitmaps (there is no need to use a graphics program, we love a shortcut ✨), for a pair of 1 pixel thick conductors of width w, spaced a distance s apart, inside a pair of groundplanes of separation H.

this has an exact analytical answer, when the inner is infinitely thin and the overall width W is infinitely wide. that theoretical impedance is calculated and printed to stderr if the -v option is given on create_bmp_for_stripline_coupler's command line. 🧚

-----------------------------------------------------  ^
|                                                   |  |
|                  Er                               |  |
|                                                   |  |
|            -----------       -----------          |  H
|            <----w----><--s--><----w---->          |  |
|                                                   |  |
|                                                   |  |
|                                                   |  |
-----------------------------------------------------  v
<-------------------------W------------------------->

the overall width W is calculated internally to be large enough that making it any larger will have negligible effect on the results. the dielectric is assumed to be that of vacuum.

the bitmaps produced by create_bmp_for_stripline_coupler are 24-bit bit colour bitmaps, as are required by atlc. slay. 🎨

👑 OPTIONS 👑

  • -C — prints the full copyright information and exits. a lil mic drop, then peace out. 💅
  • -b bitmapsize — this one sets the size of the bitmap, and therefore the accuracy to which atlc is able to calculate the coupler's properties. the default value for bitmapsize is normally 18, although this can be set at compile time (peep DEFAULT_COUPLER_BITMAP_SIZE in definitions.h). the value can be set anywhere from 6 to 28. the size of bitmap produced will be between 2^(bitmapsize-1) and 2^(bitmapsize+1), so if it's set to 28 the bitmap could be as big as 512 Mb, which would take an eternity to compute. 😭⏳
  • -v — print some extra data to stdout on the theoretical impedance of the structure. this is useful to compare with the numerical result from atlc. very "trust but verify" of you. 🔥

🌈 EXAMPLES 🌈

in the first example, a standard coupler is created, where the:

eg1. create_bmp_for_stripline_coupler  1.23 0.7 1.2 1.0  coupler.bmp
eg2. create_bmp_for_stripline_coupler -b 8 1.23 0.7 3.3  small.bmp
eg3. create_bmp_for_stripline_coupler -v 12 1.23 0.7 4.8  theory.bmp

look at those three serving absolute looks. eg1 is the classic, eg2 is the tiny one, eg3 is the theory girlie. 💖

🦋 SEE ALSO 🦋

and the linkies, bestie — go click around, it's giving research era:

🫶 AUTHOR 🫶

Dr. David Kirkby PhD, drkirkby at ntlworld.com

Copyright (c) 2002 Dr. David Kirkby.

this program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

this program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. see the GNU General Public License for more details.

you should have received a copy of the GNU General Public License (in the file COPYING) along with this program. you may get a full copy of it by running the program with the -C option. otherwise you can write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.

no warranty bestie, we're just out here doing electromagnetics. 💀

okay that's the whole page!! this one's brought to you by Dr. David Kirkby, it's from atlc-.4.6.0, dated the 6th Dec 2003, and it lives at create_bmp...ne_coupler(1). go forth and generate bitmaps, you absolute icon. 👑✨💖

📦 where this page comes from