although it might be elsewhere if your system administrator chose to install the package elsewhere. Sometimes, errors are corrected in the documentation and placed at http://atlc.sourceforge.net/ before a new release of atlc is released. Please, if you notice a problem with the documentation - even spelling errors and typos, please let me know.
The parameters 'W' and 'H' and the inner dimensions of the outer conductor. The inner conductor has a diameter of 'd' and is offset from the centre of the outer conductor by an amount 'x' horizontally and 'y' vertically. The space between the inner and outer conductors is a dielectric of relative permittivity 'Er'. If there is just a vacuum dielectric, then 'Er' should be set to 1.0
The bitmap is printed to standard output, which MUST be re-directed to either a file in one of the following two ways.
create_bmp_for_circ_in_rect d W H x y Er > filename.bmp
The bitmaps produced by create_bmp_for_circ_in_rect are 24-bit bit colour bitmaps, as are required by atlc.
The permittivities of the bitmap, set by 'Er', determine the colours in the bitmap. If Er1 is 1.0, 1.006, 2.1, 2.2, 2.33, 2.5, 3.3, 3.335, 3.7, 4.8, 10.2 or 100 then the colour corresponding to that permittivity will be set according to the colours defined in COLOURS below. If Er is not one of those permittivities, the region of permittivity Er will be set to the colour 0xCAFF00. The program atlc does not know what these permittivites are, so atlc, must be told with the -d command line option, as in example 4 below.
is used to set the size of the bitmap, and so the accuracy to which atlc is able to calculate the transmission line's properties. The default value for 'bitmapsize' is normally 4, although this is set at compile time. The value can be set anywhere from 1 to 15, but more than 8 is probably not sensible.
red = 255,000,000 or 0xff0000
Some colours, such as pink, turquoise, sandy, brown, gray etc may
mean slightly different things to different people. This is not so with
atlc, as the program expects the colours below to be EXACTLY defined
as given. Whether you feel the colour is sandy or yellow is up to you, but
if you use it in your bitmap, then it either needs to be a colour recognised
by atlc, or you must define it with a command line option (see
OPTIONS and example 5 below).
All bitmaps must have the live (red) and grounded (green) conductor. The black conductor is not currently supported, but it will be used to indicate a negative conductor, which will be needed if/when the program gets extended to analyse directional couplers.
The following dielectrics are recognised by atlc and so are produced by create_bmp_for_circ_in_rect.
white 255,255,255 or 0xFFFFFF as Er=1.0 (vacuum)
In the first example, there is just an air dielectric, so Er1=Er2=1.0. The inner of 1x1 inches (or mm, miles etc) is placed centrally in an outer with dimensions 3 x 3 inches.
The exact place where the dielectric starts (a) and its width (d) are unimportant, but they must still be entered.
% create_bmp_for_circ_in_rect 3 3 1 1 1 1 1 1 > ex1.bmp
In this second example, an inner of 15.0 mm x 0.5 mm is surrounded by an outer with internal dimensions of 61.5 x 20.1 mm. There is a material with permittivity 2.1 (Er of PTFE) below the inner conductor. The output from create_bmp_for_circ_in_rect is sent to a file ex1.bmp, which is then processed by atlc
% create_bmp_for_circ_in_rect 61.5 20.1 5 22 0.5 50 15 5 1.0
2.1 > ex2.bmp
In example 3, the bitmap is made larger, to increase accuracy, but
otherwise this is identical to the second example. %
create_bmp_for_circ_in_rect -b7 61.5 20.1 5 22 0.5 50 15 5 1.0 2.1 >
In the fourth example, instead of re-directing
create_bmp_for_circ_in_rect's output to a file with the > sign, it
is done using the -f option.
In the fifth example, materials with permittivites 2.78 and 7.89 are used. While there is no change in how to use create_bmp_for_circ_in_rect, since these permittivities are not known, we must tell atlc what they are. % create_bmp_for_circ_in_rect 61 20 1 4 22 0.5 50 15 5 2.78 7.89 > ex5.bmp % atlc -d CAFF00=2.78 -d AC82AC=7.89 ex5.bmp In the sixth and final example, the -v option is used to print some extra data to stderr from create_bmp_for_circ_in_rect.
http://atlc.sourceforge.net - Home page