# `atlc's` Frequently asked questions

1. What is `atlc`?
2. Formulas for transmission line properties can be found in any decent book, so why would I want to use `atlc`?
3. When would using `atlc` not be a good idea?
4. Can `atlc` calculate the loss of a transmission line?
5. What are the hardware and software requirements for using `atlc`?
6. Who wrote `atlc`?
7. Under what license conditions is `atlc` released?
8. Where can I download the latest version of `atlc`?
9. How do I build `atlc`?
10. Can `atlc` calculate the impedance of any transmission line?
11. I wish to find the impedance of a microstrip line, on a printed circuit board, which is enclosed in a box. Can `atlc` calculate the impedance of such a transmission line, with the two dielectrics - vacuum and the fibreglass PCB.
12. Is it possible to calculate the properties of two coupled transmission lines, which form a directional coupler, with a view to calculate the properties of a directional coupler?
13. Given one can determine the odd and even mode impedances of a directional coupler, is it possible to perform the reverse and find the required impedances for a directional coupler of a reqired specification?
14. How accurate is `atlc`?
15. How does one enter the transmission lines structure into `atlc`?
16. Does `atlc` need to know the dimensions of transmission lines?
17. Bitmap files are large, can I use JPEG instead?
18. I want to try a number of different transmission lines, all with rectangular cross sections. Drawing them as bitmaps is a bit tedious. Is there a simpler way?
19. I ran create_bmp_for_rect_in_rect with the -v option, so that it produced some extra information to stderr. create_bmp_for_rect_in_rect indicated that it would create a grid of 615 x 201, yet the bitmap was larger at 625 x 211 pixels. Why is this ?
20. What are the 12 programs, that form the atlc package?

1. - Question: What is `atlc`?
   - Answer: `atlc` is a set of around 10 computer programmes designed for finding the properties (characteristic impedance, inductance per m, capacitance per metre, velocity factor, electric field distribution) of any transmission line with 2 or 3 conductors (i.e. a normal line or coupler). Some programs are used for design, other for analysis. The main program, which is called `atlc` itseelf, uses the finite difference method to determine these properties, so while slower than other methods, `atlc` can handle any cross section.
2. - Question: Formulas for transmission line properties can be found in any decent book, so why would I want to use `atlc`?
   - Answer: Formulas can be found for many simple cases, but often no analytical formula is known for more complex, but useful cases.
     For example, many amateur radio valve amplifiers have a stripline transmission line, mounted above a chassis. The impedance of such a line can be calculated from published formula. However, these assume there is no metallic side walls for the amplifier, or a lid on top. Once these are added, there is no known analytical formula.
     You may wish to make a transmission line out of available materials. For example, assume you have some U-section brass that you would like to use for the inner of a transmission line, with the outer being rectangular section brass. See the figure below, where the inner is shown red, the outer green and white is just vacuum.
     The programme gives the following information about this transmission line.

     Electrical characteristics L=145.5810 nH/m C=76.4283 pF/m Zo= 43.6441Ohms v= 299792458.010503 m/s |  |  |
     | Total electric field (white is higher) | x-directed E-field, Red in +x direction, blue in -x direction. | y-directed E-field. Red in +y direction, blue in -y direction.

     Note, in the above images, it should not be assumed that somewhere that is twice as bright as someone else has twice the electric field. The perceived brightness depends on the non-linear characteristics of the human eye and the non-linear characteristics of how the CRT's brightness depends on the voltage levels applied to it. Quantitative data on electric field strengths are saved as binary files. See the HTML page on the file format if interested in using this data.
3. - Question: When would using `atlc` not be a good idea?
   - Answer: If the geometry is simple and there are known analytical formula, it would generally be preferable to calculate them analystically. The only exceptions would be cases where analytical evaluation is possible, but difficult. But generally, atlc is designed for the cases where there are no analytical methods available.
4. - Question: Can `atlc` calculate the loss of a transmission line?
   - Answer: No it can not. Someone hinted at a way it could perhaps be done, but this is highly speculative and I have no plans to attempt it.
5. - Question: What are the hardware and software requirements for using `atlc`?
   - Answer:A UNIX computer, with a gcc or other C compiler is needed to run `atlc`. Floating point support in hardware is strongly recommended. Hence a 486 or better PC is really needed, or perhaps a 386 with 387 floating point processor. Given the programme is fairlly CPU intensive, I would suggest at least a 300 MHz machine, preferably a lot more. The programme should compile easily. If you have multiple processors, you can add multi-threaded support. If you wish to do this, you will need to have a POSIX compatable thread library. In the unlikely event your system does not have such as a library pth can be installed.
     RAM requirements should not be excessive by today's standards, with 64 MB sufficient for most problems. Using a very fine grid can push this into a few hundred MB, but cpu speed will generally limit you before RAM
     You will also need some graphics package such as Gimp, Photoshop, Windows Paint, CorelDraw etc, that can save images at bitmap (.BMP or .bmp) files. I would suggest using Gimp on the UNIX machine, but the Gimp graphics programme can run under Windows, UNIX, OS2, DOS, VMS or whatever operating system you like.
6. - Question:Who wrote `atlc` ?
   - Answer: `atlc` was written and is maintained by Dr. David Kirkby. A few others have also contributed to the project too. Mark Chun KH6HPQ has compiled the Windows binaries, helping change the source where necessary to support Windows. Randall DuCharme helped in the port of an earlier vesion to Windoze. Numerous people have contributed useful information that has made atlc possible. In particular Eric Sosman suggested changes that would allow the code to run on the ~Cray Y-MP, on which all data types are 8 bytes long (including shoort).
7. - Question: Under what license conditions is `atlc` released ?
   - Answer: It it issued under the GNU General Public License
8. - Question: Where can I download the latest version of `atlc`?
   - Answer: Please download from SourceForge
9. - Question: How do I build `atlc` ?
   - Answer: Building can be simple, basically requiring you to type

         % gzip -d atlc-X.Y.Z.tar.gz

     Where X.Y.Z is the version

         % tar xf atlc-X.Y.Z.tar
         % cd atlc-X.Y.Z
         % ./configure
         % make
         % make check
         % su
         # make install

     However, there are several complications that arise, so check here for a more detailed descriptoin of building the program.
10. - Question: Can `atlc` calculate the impedance of any transmission line?
    - Answer: No. It can calculate the impedance of any transmission line with 2 or 3 conductors, but it can not calculate the impedance of fibre optic cables, metallic waveguides or a stucture with more than 3 conductors.
11. - Question: I wish to find the impedance of a microstrip line, on a printed circuit board, which is enclosed in a box. Can `atlc` calculate the impedance of the transmission line with the two dielectrics - vacuum and the fibreglass PCB.
    - Answer: Yes, this is no problem, although I must admit the results of this have not been checked very much. `atlc` is conveniently configured for the following dielectric constants - 1.0, 1.000 (air) 2.1 (PTFE), 2.2 (RT Duroid 5880), 2.33 (Polyethylene), 2.5 (polystyrene), 3.3 (PVC), 3.335 (epoxy resin), 4.8 (fibreglass), 6.15 (duriod 6006) and 10.2 (duroid 6010). Any other permittivity can be defined, but needs slightly more effort in doing so. For more information on this, see here.
12. - Question: Is it possible to calculate the properties of two coupled transmission lines, which form a directional coupler, with a view to calculate the properties of a directional coupler?
    - Answer:When there are two coupled transmission lines, there is not a single characteristic impedance Zo, but instead an even-mode impedance Zeven and an odd-mode impedance Zodd. An odd-mode impedance is calculated when the two lines are driven out of phase and an even-mode impedance when they are driven in phase. Versions of `atlc` from 4.0.0 onwards are able to calculate an even-mode impedance Zeven and an odd-mode impedance Zodd Also calculated are the common mode impedance Zcomm and the differential mode impedance Zdiff.
13. - Question: Given one can determine the odd and even mode impedances of a directional coupler, is it possible to reverse this and find the required impedances given a specification for the coupler?
    - Answer:Yes it is. One can easily determine with the aid of the program `design_coupler` Zeven and Zodd. For one particular configuration, it is possible to determine the dimensions of a coupler that will meet those specifications. For other geometries, it will be necessary to find suitable dimensions by trial and error with atlc, which will be quite time-consuming.
14. - Question: How accurate is `atlc`?
    - Answer:The basic method by which `atlc` works is very accurate. Errors of less than 0.3% are typical, and largest error every recorded is under 1%. The problem is that achieving such accuracy is very time consuming. Few people need results more accurate than 1%, in which case the run-times should be only a few minutes at most. The accurary of the program `atlc` has not been properly evaluated for open-structures, such as twin-wire, where the fields theoretically extend to infinity. Initail results suggest `atlc` is not very accuate in such cases, but this has not been fully investigated.
15. - Question: How does `atlc` work?
    - Answer: `atlc` uses a method known as finite differences. A paper describing the theory of this was published in the amateur radio journal QEX See: Finding the characteristics of Arbitrary transmission lines, D. Kirkby, QEX, December 1996, page 3-10. You can download a copy if you wish, or there should be a local copy. Note this is an old paper, so `atlc` has been much improved since that paper was written.
16. - Question: Does `atlc` need to know the dimensions of transmission lines?
    - Answer: `atlc` does not need to know the absolute dimensions (in mm or inches), but it does need to know the relative sizes of all the conductors.
17. - Question: Bitmap files are large, can I use JPEG instead?
    - Answer: No. JPEG files use a compression method that is not lossless -i.e. data is lost from which you can never recover. As such JPEG is not suitable for this application. TIFF could in principle be used, but there are no plans to add support for files other than .bmp. I might add support for the FITs data file format, but this is not a priority
18. - Question: I want to try a number of different transmission lines, all with rectangular cross sections. Drawing them as bitmaps is a bit tedious. Is there a simpler way?
    - Answer: Yes, there is. The programme `create_bmp_for_rect_in_rect` is for this purpose, as it can automatically draw bitmaps for a rectangular conductor inside another rectangular conductor, like the following transmission line.
      You need to supply as command line arguments the dimensions of the structure (in mm, inches, miles or whatever you want, as long as the same unit is used throughout), and of course the permittivities of the dielectrics. See the section Automatic Bitmap Generators for more information on `create_bmp_for_rect_in_rect`.
19. - Question: I ran create_bmp_for_rect_in_rect with the -v option, so that it produced some extra information to stderr. create_bmp_for_rect_in_rect indicated that it would create a grid of 615 x 201, yet the bitmap was larger at 625 x 211 pixels. Why is this ?
    - Answer: The dimensions you enter on create_bmp_for_rect_in_rect's command line are the inside dimensions of the outer conductor, which you enter as floating point numbers. create_bmp_for_rect_in_rect will convert those to the best integer fit it can, but it least have at least a 1 pixel border all the way around for the outer conductor. By default, the border is made 5 pixels, so it can be seen easily on a bitmap without needing to zoom in too far. Hence the bimap is 10 pixels wider and 10 pixel higher than expected.
20. - Question: What are the 12 programs, that form the atlc package?
    - Answer:See the web page describing the manual pages

atlc is written and supported by Dr. David Kirkby (G8WRB) It it issued under the GNU General Public License

Return to the atlc homepage