Imported Upstream version 4.6.0
[debian/atlc] / docs / html-docs / index2.html
1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 TRANSITIONAL//EN">
2 <HTML>
3 <HEAD>
4 <TITLE>Homepage of atlc - Arbitrary Transmission Line Calculator</TITLE>
5 <META name="generator" content="Mostly bluefish and vi. Sometimes netscape">
6 <META http-equiv="CONTENT-TYPE" content="text/html; charset=iso-8859-1">
7 <meta name="author" content="Dr. David Kirkby">
8 <META name="DESCRIPTION" content="Transmission lines, transmission line, atlc, calculator, transmission-lines, transmission-line">
9 <META name="KEYWORDS" content="atlc, transmission lines,  tranmission line, calculator, finite difference">
10 </HEAD>
11 <BODY>
12
13 <H1><CODE>atlc</CODE> - Arbitrary Transmission Line Calculator (for electrical transmission lines)</H1>
14 <p>
15 <EM>atlc</EM> is a computer aided design (CAD) package for the design and analysis of electrical transmission lines and directional couplers of totally arbitrary cross section and an arbitrary number of different dielectrics.  By analysis, it is assumed one requires finding the electrical properties of transmission lines or couplers, where the physical dimensions are known. By design, it is assumed one requires a transmission line or coupler to have certain electrical properties and one wishes to find how to physically realise such a structure.</p>
16 <P><EM>atlc</EM>  likely to be of use to radio amateurs, professional RF engineers, students and academics.</P> 
17
18
19
20 <p>Great effort has been put into making <em>atlc</em> portable. Whilst written under UNIX, <em>atlc's</em> portability means pre-compiled command-line Windows binaries have been produced by Mark Chun KH6HPQ and others from the source code without any changes at all. A port to <a href="http://www.openvms.org">OpenVMS</a> in a possibility, although the main development is aimed very much at UNIX. </p>
21
22 <p> In addition to the the commmon Linux PC, <em>atlc</em> has been tested on a <a href="http://wuarchive.wustl.edu/mirrors/NetBSD/NetBSD-current/pkgsrc/cad/atlc/README.html">Sony Playstation 2</a> as well as the <a href="http://www.cray-cyber.org/systems/yel.php">Cray YMP-EL</a> supercomputer, which is available for free public access at <a href="http://www.cray-cyber.org/general/start.php">Cray-Cyber network</a>. 
23
24 It has also been tested on <a href="http://www.debian.org/">Debian</a> Linux, <a href="http://www.slackware.com/">Slackware</a> Linux, <a href="http://www.gentoo.org/">Gentoo</a> Linux, <a href="http://www.redhat.com">Redhat </a> Linux, <a href="http://www.suse.com">Suse</a> Linux, IBM's <a href="http://www.ibm.com/servers/aix/">AIX</a>, Apples's <a href="http://www.apple.com/macosx/">OS X for Mac</a>, 
25
26 HP's <a href="http://www.hp.com/products1/UNIX/operating/">HP-UX</A> (both PA-RISC and Itanium), SGI's <a href="http://www.sgi.com/">IRIX</a>, Sun's <a href="http://www.sun.com/solaris/">Solaris</a>, SCO's <a href="http://www.caldera.com/products/UNIXware/">UNIXWare</a>, HP's <a href="http://h30097.www3.hp.com/">Tru64</a>, Cray's <a href="http://www.cray.com/products/software/unicos.html">UNICOS</a>, <a href="http://www.netbsd.org/">NetBSD</a>, <a href="http://www.openbsd.org/">OpenBSD</a> and <a href="http://www.freebsd.org/">FreeBSD</a>. If you run <em>atlc</em> on any other operating system, please let me know. </p>
27 <p>Previous version of <em>atlc</em> could use multiple-processors if present, to reduce execution time. This has been temporarily disabled, as the algorithm had some intermittent problems on IBM's. Careful checking showed the problem that only seemed to affect AIX, was a real bug with the potential to occur on other operating systems, although it only ever showed up under AIX. Hence the current release has disabled the support for multiple processors - <em>atlc</em> will fun fine on multi-processor machines, but it will only use one of them. A revised method of computation has been determined, which will re-enable the use of multiple processors. It is hoped to release this by early February 2004 at the latest - probably some time in January 2004.</p>
28
29 <TABLE>
30 <TR>
31 <TD><img src="jpgs/coax2.jpg" ALT="round coax" > </TD>
32 <TD><img src="jpgs/very-odd.jpg" ALT="very odd line" ></TD>
33 <TD><img src="jpgs/cop1.jpg" ALT="directional coupler" width="128" height="128"></TD>
34 <TD><img src="jpgs/coupler9.jpg" ALT="directional coupler" height="128"></TD>
35 </TR>
36 <TR>
37 <TD>Coaxial cable<br>Zo= 70.0215 Ohms<BR>C=47.637 pF/m<BR>L=233.557 nH/m<BR></TD>
38 <TD>Really odd!!!<br>Zo= 56.020  Ohms<br> C= 59.544 pF/m <br>L= 186.862 nH/m</TD>
39 <TD>Directional coupler<br>Zo= 64.7449  Ohms<br> Zeven=65.3682 Ohms<br>Zodd= 64.1275 Ohms<br></TD>
40 <TD>Microstrip coupler on double-sided PCB<br>Zodd=  35.10 Ohms Zeven=  50.93 Ohms<br>Zdiff=  70.21 Ohms Zcomm=  25.46 Ohms</td>
41 </TR>
42 </TABLE>
43 There are 12 programs that comprise the package <EM>atlc</EM>. One of the programs is called <CODE>atlc</CODE>; the other 11  have different names. Using the programs comprising the package <EM>atlc</EM> one is able to:.
44 <OL>
45         <LI>Calculate the characteristic impedance and other properties of two conductor transmission lines, like coaxial cable (far left above), but the cross section can be of any shape whatsoever, including that second from the left. A technique known as finite difference is used for this. There can be an arbitrary number of different dielectrics. Note the inner conductor is shown red, the outer green and a vacuum dielectric is shown as white - for all practical purposes, the permittivity of a vacuum (1.0 by definition) dielectric is the same as that of air (approximately 1.0006)</LI>
46         <LI>Calculate the impedance's for both the odd-mode and even-mode, along with many other properties of <a href="couplers.html">directional couplers</a> of arbitrary cross section, like that third from the left below. Note, with couplers, there is two inner conductors, with - one red as before, but another one blue, in addition to the green outer conductor.  The finite difference technique is used for this too. Analysis extends to couplers with multiple dielectrics, such as the microstrip coupler on the PCB on the right below. </LI>
47         <LI>Compute the common-mode impedance Zcomm and differential-mode impdance Zdiff of arbitrary directional couplers. </LI>
48         <LI><a href="examples.html">Compute the values of electric field, voltage, energy stored etc</a> in 2 and 3 conductor transmission lines and save this data to binary files, as well as bitmaps which can be viewed in a graphics package. </LI>
49         <LI> <a href="generators.html">Automatically create bitmaps</a> for some common transmission lines, to save the user having to create them in a graphics package, which would soon become tedious.</LI>
50         <LI>Compute the odd and even mode impedances required of an arbitrary directional coupler to satisfy a given frequency response and coupling factor.</LI>
51         <LI>In the case of a coupled stripline with thin conductors, the program <code>design_coupler</code> can fairly quickly (within a few minutes) compute the dimensions of a directional coupler to satisfy your requirements of frequency response, coupling factor and optionally length. If you wish to implement the design on a double-sided printed circuit board like that on the right below, the program <code>find_optimal_dimensions_for_microstrip_coupler</code> will do this for you, but it takes several hours (perhaps a couple of days) to find a solution, although some well-timed and sensible human intervention can reduce this considerably.</LI>
52         <LI>Since the program <code>atlc</code> can save quantitative data on the x and y components of electric field, energy, voltage etc to binary files, there is a program <code>readbin</code> that can read the binary files and tell you something about the data saved in them. This information is for debugging only - it is not expected the user will use <code>readbin</code>. The user is expected to write their own programs to read this binary information, in the very unlikely event they wish to use the information. It is likely to be of academic interest only. The normal output from <code>atlc</code> is in simply text. 
53 </OL>
54
55 <p>In any example which has been checked against exact analytical solutions, the <a href="accuracy.html">errors</a> in <code>atlc</code> are under 1% and usually under 0.4%</p>
56 In order to perform 1, 2, 3 or 4 above, the programme  <COde>atlc</code> needs to know shape of the transmission line's cross section. This cross section is stored in a data file, which happens to be a Windows bitmap file. The  bitmap file is read by <COde>atlc</code>, following which the  programme performs the analysis. <br><br>There are two ways to generate the bitmap for <COde>atlc</code>. 
57 <OL>
58         <LI> As you might expect, you can draw the transmission line's cross-section in a graphics programme such as <A HREF="http://www.gimp.org">Gimp</A>, <A HREF="http://www.adobe.com/products/photoshop/main.html">Photoshop</A>, Windows <A HREF="http://www.microsoft.com">Paint</A>, Corel Photopaint etc. The programme must be able to save images as bitmap (.BMP or .bmp) files, in 24-bit (true colour) mode. The graphics programme can run under whatever operating system you like.  If for example you have some U-section brass and some hollow rectangular tube, and wanted to know the properties of a transmission line formed from these, you might draw something like this, and save it as a file, which we might call <CODE>ushape.bmp</CODE><br><br><img src="jpgs/ushape.jpg" ALT="U-section" > </LI>
59         <LI> In the case of simple cross-sections, the bitmaps can be generated automatically. Currently 7 such programmes have been written:
60         <OL>
61 <LI><CODE>create_bmp_for_circ_in_circ</CODE></LI>
62 <LI><CODE>create_bmp_for_circ_in_rect</CODE></LI>
63 <LI><CODE>create_bmp_for_rect_cen_in_rect</CODE></LI>
64 <LI><CODE>create_bmp_for_rect_in_rect</CODE></LI>
65 <LI><CODE>create_bmp_for_symmetrical_stripline</CODE></LI>
66 <LI><CODE>create_bmp_for_stripline_coupler</CODE></LI>
67 <LI><CODE>create_bmp_for_microstrip_coupler</CODE></LI>
68 </OL>
69         to quickly generate bitmaps for transmission lines. The first five are for two-conductor transmission lines, whereas the last two are for directional couplers. See the section <a href="generators.html">Automatic Bitmap Generators</a> for information about what cross sections these programs generate. Using these programs to create bitmaps is very fast - much faster than creating them with a graphics programme. </LI>
70 </OL>
71 A UNIX computer, with a <A HREF="http://www.gnu.org/software/gcc/gcc.html">gcc</A> or other C compiler, is needed  to build <EM>atlc</EM>. The programme should compile very easily and quickly. Being rather CPU intensive, <COde>atlc</code> has been written to support multiple processors if available. Here is an example of using atlc, with the file <CODE>ushape.bmp</CODE>, which was drawn by a graphics programme. <br>
72
73 <br>
74 <pre>
75 sparrow % atlc -v ushape.bmp
76 ushape.bmp 2 Er= 1.00 Zo= 43.55 Ohms C= 76.6 pF/m L= 145.3 nH/m v= 2.998e+08 m/s v_f= 1.000 VERSION= 4.2.2
77 ushape.bmp 2 Er= 1.00 Zo= 43.64 Ohms C= 76.4 pF/m L= 145.6 nH/m v= 2.998e+08 m/s v_f= 1.000 VERSION= 4.2.2
78 ushape.bmp 2 Er= 1.00 Zo= 43.64 Ohms C= 76.4 pF/m L= 145.6 nH/m v= 2.998e+08 m/s v_f= 1.000 VERSION= 4.2.2
79 </pre>
80 It will be seen that <CODE>atlc</CODE> makes several estimates of the transmission line's properties, each subsequent one being closer to the true values (normally only the final result is shown, but the -v option added above causes <CODE>atlc</CODE> to print intermediate results).
81 <br><br>
82 <CODE>atlc</CODE> produces numberous bitmap and binary files, in addition to the text shown above. Hopefully some of the text output is comprehensible, but the exact format of all of atlc's outputs is disucced in the <a href="fileformat.html">fileformat</a> section. <br><br>
83 Here's an example of using <CODE>create_bmp_for_circ_in_circ</CODE> to create a bitmap, following which is it analysed using <CODE>atlc</CODE>. The programme <CODE>create_bmp_for_circ_in_circ</CODE> creates a bitmap (.bmp file) for a cicular conductor inside another circular conductor - like coaxial cable. The program takes takes 5 command line arguments which (in order) are:
84 <OL>
85         <LI>D - The inner diameter of the outer conductor.</LI>
86         <LI>d  - The outer diameter of the inner conductor</LI>
87         <LI>O - The offset between the inner and outer conductors (this is zero for standard coax)</LI>
88         <LI>Er - The relative permittivity of the dielectric between the conductors</LI>
89         <LI>filename - The filename to write the bitmap file to, which would normally end in .bmp</LI>
90 </OL>
91
92
93 <pre>
94 sparrow % create_bmp_for_circ_in_circ 500 100 100 1 x.bmp
95 sparrow % atlc  x.bmp
96 x.bmp 2 Er=1.00 Zo= 85.44 Ohms C= 39.0 pF/m L= 285.0 nH/m v= 2.998e+08 m/s v_f= 1.000 VERSION= 4.2 2
97 </pre>
98
99 How to use  <CODE>create_bmp_for_circ_in_circ</CODE> (or any other program) is best determined by reading the UNIX man page, seeing an <a href="generators.html">example</a> or by running the program with no arguments, where it will print a usage message. An html version of the  <a href="create_bmp_for_circ_in_circ.1.html">man page for <CODE>create_bmp_for_circ_in_circ</CODE> </a> is available, but the all-important diagram is not clear. <br>
100 <br>
101 <a href="http://atlc.sourceforge.net">Return to the atlc homepage</a>
102
103 <br><br>
104 atlc is written and supported by <a href="jpgs/home-email.jpg">Dr. David Kirkby (G8WRB)</A> It it issued under the <a href="http://www.gnu.org/copyleft/gpl.html">GNU General Public License</A>
105 <br>
106 <BR>
107 <BR>
108
109 <A href="http://sourceforge.net"> <IMG
110 src="http://sourceforge.net/sflogo.php?group_id=25836&amp;type=5"
111 width="210" height="62" border="0" alt="SourceForge.net
112 Logo"></A><a href="http://validator.w3.org/check/referer"><img border="0"
113 src="valid-html40.gif"
114 alt="Valid HTML 4.01!" height="31" width="88"></a>
115 <a href="http://bluefish.openoffice.nl/"><img SRC="jpgs/bluefish.jpg" WIDTH="88" HEIGHT="31" ALT="Bluefish"></a>
116 <p><a href="http://homepage.ntlworld.com/drkirkby/list1.html">.</a>
117 <a href="http://homepage.ntlworld.com/drkirkby/list2.html">.</a>
118 <a href="http://homepage.ntlworld.com/drkirkby/list3.html">.</a>
119 <a href="http://homepage.ntlworld.com/drkirkby/list4.html">.</a>
120 <a href="http://homepage.ntlworld.com/drkirkby/list5.html">.</a>
121 <a href="http://homepage.ntlworld.com/drkirkby/list6.html">.</a>
122 <a href="http://homepage.ntlworld.com/drkirkby/list7.html">.</a>
123 </BODY>
124 </HTML>