

				EField v.1.0 by Del Miglio Andrea, 1999


EField is a library useful for students concerning with exams as Electromangetic
Fields.


1)Installation:


Download EFieldLib.prg in you HP with Kermit or XModem.
Put on the stack the port number you want to store the lib in.
Execute EField.prg: the library is uncompressed (BZ compression is used) and
stored in the port you choose. Is NOT necessary to reset your HP with ON+C.
Installation is powered by SEAAL (Self Extracring Auto-Attaching Library)



2)Command usage:


CFG is the only visible command of the library. It creates a directory named
TLA (Trasmission Lines Analysis) in your HOME directory with a CST menu from
which you can use all the lib features. I decided to create a folder because
some progs store their result in variabiles so that you can recall them. I prefer
keep all this variabiles in a close environment.

The CST menu is divided in four submenu:

Lines: progs concerning with transmission lines analysis
Waves: progs concerning with e-waves propagation
WG: progs concerning with propagation in wave guides
Other: some useful marginal progs



3)Lines menu:

- TLSolver is the Transmission Lines Solver. I use it to solve particular adaptation
problems without using Smith Chart. You have to enter load and line impedance
(no dissipative lines!) and the final normalized value you need for load
impedance or admittance (RE or IM part). Then you are asked to entr if you
want to work with impedance or admittance, an then the part to choose (RE or IM)
The results are in the form [norm distance (Rl,Xl)]. You get all the result
in the interval 0-0.5 wavelenght.
For example: I have a load 50+j100 Ohm connected to a line of 50 Ohm and I want
to know how long the line has to be to have the real part of the admittance
with value 0.5 (normalized). So I enter: Rl=50 Xl=100 Z0=50 Vf=0.5, then I choose
Admittance and then RE. After a few seconds I get:

S2:			(.40874331798 (.499999999999,-1.32287565553))
S1:			(.21625668202 (.500000000002,1.32287565553))

The first real number is the distance normalized to wavelenght you have to
run along to have desired value of RE or IM part of Impedance or admittance.
The second number (complex) is the value of normalized impedance or admittance
(as choosed) seen after the distance calculated. The program tries to find
all the solution in the interval 0-0.5 using internal ROOT program, and works
fine.


- TLINES is the program from Davide Valenti to analyze transmission lines and
to plot Smith Charts. Read TLines21.txt for further informations.

- Stub gives you the parameters to adapt a load to a line using a stub. You 
have to put on the stack the normalized impedance or admittance you want to
adapt. Then you'll be asked to choose between series or parallel method.
If you choose series you need load impedance on the stack. If you choose
parallel you need to have load admittance on the stack. The program uses TLSolver
to determine the normalized distance of the stub from the load (ls) and stub
reactance (Xs).

- TLeq is a fast TLINES replacement which works only with normalized values
of impedance and distance. You have to put on the stack load start normalized
impedance and normalized distance from the load. The result is normalized impedance
seen after the distance entered.

- Neutr is a program which performs neutralization of a load. You have to enter
a load impedance and you'll get the list of nomalized distances with you can
use to perform neutralization.

- DStub performs double stub adaptation: you have to enter impedance or admittance
seen from first stub and the distance between the two stubs. Then you have to choose
if perform Series-Series or Parallel-Parallel adaptation. If you choose the first
you need an impedance on the stack. If you choose the second you need an admittance.
The results are stubs reactance (stub 1 is the one closer to load).

- StubLenght calculates the lenght of a stub with a given reactance.
You put the reactance (normalized) on the stack, then press StubL and choose
between SCC/PCA (series-short-circuit/parallel-open-circuit) and SCA/PCC 
(series-open-circuit/parallel-short-circuit) and get normalized stub lenght.

- LEQ simply returns you lossless transmission lines equation. You need a
normalized impedance on the stack, and you get the equation decribing
impedance seen after a distance x.

- CLEAN wipes your TLA directory from all the variabiles created by the programs.



4)Waves menu:

- Thetab is the program wich gives you Brewster angle given relative dielectric
constants of means 2 and 1 (in this sequence). Result always given in degrees.

- HzDip gives you the expression of far field of a dipole. You have to enter
in GUI form all the parameters asked. The program uses EXEC Erable command, so
it doesn't work if Erable is not installed.

The two following menu keys are dielectric and magnetic void constants.

- Epsilonr->Eta gives you characteristic impedance of a mean with given relative
dielectric constant. It needs the constant on the stack and returns the result in Ohm.

- Snell uses Snell law to calculate transmission angle. You have to enter incidence
angle (in degrees) and relative constants of means 1 and 2 (in this sequence).



5)WG menu:

- WGSolver gives you all important values related to a wave giude given its 
dimensions and dielectric constant. It uses GUI input form. I think the program
is self-explanatory. NewParam is useful to change work frequency or relative
dielecrtic constant when working with the same guide more than once.

- ff->F returns SQRT(1-(fc/f0)^2) given fc and f0 (in this sequence). Useful 
to calc many WG important values.

- Lambdac->fc returns critic frequency given critic wavelenght (in cm) and relative
dielectric constant (in this sequence). This feature is also included in WGSolver,
but if you need only critic freq this program is faster.

6)Other menu:

-R->C is the internal R->C command to build complex numbers. In the same way
ABS, RE, IM are the internal complex number commands. I put them here to recall
them quickly, as I use them very much when I work with lines.

-f->Lambda0 gives you wavelenght in void given the frequency in Hz.

-Gamma->Pd returns (1-ABS(Gamma)^2). Useful to calc power dissipated by a load
when not adapted.

-Z->Gamma returns reflection coeff. given normalized impedance of load.

-Z->ROS returns standing waves ratio (SWR, ROS in italian) given normalized 
impedance of load.





I don't think I'll support this lib, as I've passed my exam and I have no 
more interest in it. Anyway most of the lib is written in simple UserRpl
(converted in lib only to store it in a port), so anyone can correct bugs.
As I used this lib I found no bug and the results given were always right.
Only a few times happened to have not results although a result was there.
The problem in this cases concernes with ROOT internal prog. Root finding
is powred with AllRoots program written by John H. Meyers.
TLines program is written by Davide Valenti and can be found in a single
library (number 977) in Eric's site.


For question, suggestions or anything else (except support) email me:
delman@tin.it