Imported Upstream version 4.6.0
[debian/atlc] / docs / html-docs / create_bmp_for_stripline_coupler.1.html
1 <HTML>
2 <BODY>
3 <PRE>
4 <!-- Manpage converted by man2html 3.0.1 -->
5
6 </PRE>
7 <H2>NAME</H2><PRE>
8      <B>create_bmp_for_stripline_coupler</B>  -  bitmap  generator   for
9      coupler  with  thin  striplines  between two infinitely wide
10      groundplanes (part of <B>atlc</B>)
11
12
13 </PRE>
14 <H2>SYNOPSIS</H2><PRE>
15      <B>create_bmp_for_stripline_coupler</B> <B>[-C]</B> <B>[-b</B> <B>bitmapsize]</B> <B>[-v]</B> <B>H</B>
16      <B>w</B> <B>s</B> <B>Er</B> <B>outputfile</B>
17
18
19 </PRE>
20 <H2>WARNING</H2><PRE>
21      This man page is not a complete set of documentation  -  the
22      complexity  of the atlc project makes man pages not an ideal
23      way to document it, although out of completeness, man  pages
24      are produced. The best documentation that was current at the
25      time the version was produced should be found on  your  hard
26      drive, usually at
27      /usr/local/share/atlc/docs/html-docs/index.html
28      although it might be elsewhere if your system  administrator
29      chose  to  install  the package elsewhere. Sometimes, errors
30      are  corrected  in   the   documentation   and   placed   at
31      http://atlc.sourceforge.net/ before a new release of atlc is
32      released.  Please, if you notice a problem with the documen-
33      tation - even spelling errors and typos, please let me know.
34
35
36
37 </PRE>
38 <H2>DESCRIPTION</H2><PRE>
39      <B>create_bmp_for_stripline_coupler</B>  is  a  pre-processor   for
40      <B>atlc</B>,  the  finite difference program that is used to calcu-
41      late the properties of a two and three conductor  electrical
42      transmission  lines  of arbitrary cross section. The program
43      <B>create_bmp_for_stripline_coupler</B> is used as a  fast  way  of
44      generating  bitmaps (there is no need to use a graphics pro-
45      gram), for a pair of 1 pixel thick conductors  of  width  w,
46      spaced  a distance s apart, inside a pair of groundplanes of
47      separation H. This has an exact analytical answer, when  the
48      inner  is  infinitely thin and the overall width W is infin-
49      itely wide. This theoretical  impedance  is  calculated  and
50      printed   to   stderr   if   the   -v  option  is  given  on
51      create_bmp_for_stripline_coupler's command line.
52
53      -----------------------------------------------------  ^
54      |                                                   |  |
55      |                  Er                               |  |
56      |                                                   |  |
57      |            -----------       -----------          |  H
58      |            &lt;----w----&gt;&lt;--s--&gt;&lt;----w----&gt;          |  |
59      |                                                   |  |
60      |                                                   |  |
61      |                                                   |  |
62      -----------------------------------------------------  v
63      &lt;-------------------------W-------------------------&gt;
64
65      The overall width W is calculated  internally  to  be  large
66      enough that making it any larger will have negligible effect
67      on the results.  The dielectric is assumed that of vacuum.
68
69      The bitmaps produced by <B>create_bmp_for_stripline_coupler</B> are
70      24-bit bit colour bitmaps, as are required by <B>atlc</B>.
71
72
73
74 </PRE>
75 <H2>OPTIONS</H2><PRE>
76      <B>-C</B>
77      Print the full copyright information and exit.
78
79      <B>-b</B> <B>bitmapsize</B>
80      is used to set the size of the bitmap, and so  the  accuracy
81      to which atlc is able to calculate the coupler's properties.
82      The default value for 'bitmapsize' is normally  18  although
83      this     can     be    set    at    compile    time.    (see
84      'DEFAULT_COUPLER_BITMAP_SIZE' in definitions.h).  The  value
85      can  be  set  anywhere from 6 to 28. The size of bitmap pro-
86      duced will be between 2^(bitmapsize-1) and 2^(bitmapsize+1),
87      so  if  its  set to 28 the bitmap could be as big as 512 Mb,
88      which would take an eternity to compute.
89
90      <B>-v</B>
91      Print some extra data to stdout on the theoretical impedance
92      of the structure. This is useful to compare with the numeri-
93      cal result from <B>atlc</B>
94
95
96 </PRE>
97 <H2>EXAMPLES</H2><PRE>
98      In the first example, a standard coupler is  created,  where
99      the
100
101
102      eg1.  create_bmp_for_stripline_coupler   1.23  0.7  1.2  1.0
103      coupler.bmp
104      eg2. create_bmp_for_stripline_coupler  -b  8  1.23  0.7  3.3
105      small.bmp
106      eg3. create_bmp_for_stripline_coupler -v  12  1.23  0.7  4.8
107      theory.bmp
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122 </PRE>
123 <H2>SEE ALSO</H2><PRE>
124      <B>atlc(1)</B>                       <B>create_bmp_for_circ_in_circ(1)</B>
125      <B>create_bmp_for_circ_in_rect(1)</B>
126      <B>create_bmp_for_microstrip_coupler(1)</B>
127      <B>create_bmp_for_rect_cen_in_rect(1)</B>
128      <B>create_bmp_for_rect_cen_in_rect_coupler(1)</B>
129      <B>create_bmp_for_rect_in_circ(1)</B>
130      <B>create_bmp_for_rect_in_rect(1)</B>
131      <B>create_bmp_for_symmetrical_stripline(1)</B>    <B>design_coupler(1)</B>
132      <B>find_optimal_dimensions_for_microstrip_coupler(1)</B> <B>readbin(1)</B>
133
134      http://atlc.sourceforge.net                - Home page
135      http://sourceforge.net/projects/atlc       - Download area
136      atlc-X.Y.Z/docs/html-docs/index.html       - HTML docs
137      atlc-X.Y.Z/docs/qex-december-1996/atlc.pdf - theory paper
138      atlc-X.Y.Z/examples                        - examples
139
140
141 </PRE>
142 <H2>AUTHOR</H2><PRE>
143      Dr. David Kirkby PhD, drkirkby at ntlworld.com
144
145
146 </PRE>
147 <H2>COPYRIGHT</H2><PRE>
148      Copyright (c) 2002 Dr. David Kirkby.
149
150      This program is  free  software;  you  can  redistribute  it
151      and/or  modify  it under the terms of the GNU General Public
152      License as published by the Free Software Foundation; either
153      version 2 of the License, or (at your option) any later ver-
154      sion.  This program is distributed in the hope that it  will
155      be  useful,  but  WITHOUT  ANY  WARRANTY;  without  even the
156      implied warranty of MERCHANTABILITY or FITNESS FOR A PARTIC-
157      ULAR  PURPOSE.   See the GNU General Public License for more
158      details.  You should have received a copy of the GNU General
159      Public  License  (in  the file COPYING) along with this pro-
160      gram. You may get a full copy of it by running  the  program
161      with  the  -C  option.  Otherwise  you can write to the Free
162      Software Foundation, Inc., 59 Temple Place - Suite 330, Bos-
163      ton, MA  02111-1307, USA.
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179 </PRE>
180 <HR>
181 <ADDRESS>
182 Man(1) output converted with
183 <a href="http://www.oac.uci.edu/indiv/ehood/man2html.html">man2html</a>
184 </ADDRESS>
185 </BODY>
186 </HTML>