20
20
<H2>WARNING</H2><PRE>
21
This man page is not a complete set of documentation. See
22
the html files for more complete information. So far, I've
23
not managed to install the html files into /usr/local, so
24
you will have to look into the atlc-2.X.Y.Z/docs/html-docs
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
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.
29
38
<H2>DESCRIPTION</H2><PRE>
30
39
<B>create_bmp_for_rect_cen_in_rect</B> is a pre-processor for <B>atlc</B>,
31
the finite difference programme that is used to calculate
32
the properties of a two-conductor electrical transmission
33
line of arbitrary cross section. The programme
40
the finite difference program that is used to calculate the
41
properties of a two-conductor electrical transmission line
42
of arbitrary cross section. The program
34
43
<B>create_bmp_for_rect_cen_in_rect</B> is used as a fast way of
35
44
generating bitmaps (there is no need to use a graphics pro-
36
gramme), for a rectangular conductor placed centrally inside
45
gram), for a rectangular conductor placed centrally inside
37
46
another rectangular conductor, like this:
39
48
----------------------------------------------------- ^
75
84
that permittivity will be set according to the colours
76
85
defined in COLOURS below. If Er is not one of those permit-
77
86
tivities, the region of permittivity Er will be set to the
78
colour 0xCAFF00. The programme <B>atlc</B> does not know what these
87
colour 0xCAFF00. The program <B>atlc</B> does not know what these
79
88
permittivites are, so they <B>atlc</B>, must be told with the
80
89
comand line option -d, as in example 4 below.
109
118
total of 256*256*256=16777216 colours. Every one of the pos-
110
119
sible 16777216 colours can be defined precisely by the stat-
111
120
ing the exact amount of red, green and blue, as in:
113
121
red = 255,000,000 or 0xff0000
114
122
green = 000,255,000 or 0x00ff00
115
123
blue = 000,000,255 or 0x0000ff
118
126
Brown = 255,000,255 or 0xff00ff
119
127
gray = 142,142,142 or 0x8e8e8e
121
Some colours, such as pink, turquiose, sandy, brown, gray
129
Some colours, such as pink, turquoise, sandy, brown, gray
122
130
etc may mean slightly different things to different people.
123
This is not so with <B>atlc</B>, as the programme expects the
124
colours below to be EXACTLY defined as given. Whether you
125
feel the colour is sandy or yellow is up to you, but if you
126
use it in your bitmap, then it either needs to be a colour
127
recognised by atlc, <B>or</B> you must define it with a command
128
line option (see OPTIONS and example 5 below).
131
This is not so with <B>atlc</B>, as the program expects the colours
132
below to be EXACTLY defined as given. Whether you feel the
133
colour is sandy or yellow is up to you, but if you use it in
134
your bitmap, then it either needs to be a colour recognised
135
by atlc, <B>or</B> you must define it with a command line option
136
(see OPTIONS and example 5 below).
129
137
The following conductors are recognised by atlc:
130
138
red = 255,000,000 or 0xff0000 is the live conductor.
131
139
green = 000,255,000 or 0x00ff00 is the grounded conductor.
134
142
All bitmaps <B>must</B> have the live (red) and grounded (green)
135
143
conductor. The blue conductor is not currently supported,
136
144
but it will be used to indicate a negative conductor, which
137
will be needed if/when the programme gets extended to
138
analyse directional couplers.
145
will be needed if/when the program gets extended to analyse
146
directional couplers.
140
148
The following dielectrics are recognised by atlc <B>and</B> <B>so</B> <B>are</B>
141
149
<B>produced</B> <B>by</B> create_bmp_for_rect_cen_in_rect<B>.</B>
150
158
sandy 239,203,027 or 0xEFCC1A as Er=3.3 (PVC)
151
159
brown 188,127,096 or 0xBC7F60 as Er=3.335 (epoxy resin)
152
Terquoise 026,239,179 or 0x1AEFB3 as Er=4.8 (glass PCB)
160
Turquoise 026,239,179 or 0x1AEFB3 as Er=4.8 (glass PCB)
153
161
Dark gray 142,142,142 or ox696969 as Er=6.15 (duroid 6006)
154
162
L. gray 240,240,240 or 0xDCDCDC as Er=10.2 (duroid 6010)
155
163
D. orange 213,130,067 or 0xD5A04D as Er=100.0 (mainly for
164
172
<B>create_bmp_for_rect_cen_in_rect</B>. Again, see the html docu-
165
173
mentation in atlc-X.Y.Z/docs/html-doc/index.html for more
168
175
1) In the first example, there is just a vacuum dielectric,
169
176
so Er=1.0. The inner of 1x1 inches (or mm, miles etc) is
170
177
placed centrally in an outer with dimensions 3.3 x 3.9
173
180
<B>%</B> <B>create_bmp_for_rect_cen_in_rect</B> <B>3.3</B> <B>3.9</B> <B>1</B> <B>1</B> <B>1</B> <B>></B> <B>1.bmp</B>
174
181
<B>%</B> <B>atlc</B> <B>1.bmp</B>
175
183
2) In this second example, an inner of 15.0 mm x 5.0 mm is
176
184
surrounded by an outer with internal dimensions of 71.5 x
177
185
60.0 mm. There is a material with permittivity 2.1 (Er of
214
222
atlc-X.Y.Z/docs/html-docs/index.html - HTML docs
215
223
atlc-X.Y.Z/docs/qex-december-1996/atlc.pdf - theory paper
216
224
atlc-X.Y.Z/examples - examples
217
http://www.david-kirkby.co.uk - my home page
218
http://www.david-kirkby.co.uk/ham - ham radio pages