Title: Symbolic Voltage Finder - SVF
Author: Roberto Perez-Franco - HPlus!
Version: 1.2
Released: March 3, 1999
Library #: 987
Size: Less than 6KB
Comment: Requires Alg48.

INTRODUCTION
This is a very useful program: a symbolic circuit simulator. It is, as far as I know, the first symbolic circuit simulator for HP48. It works perfectly with DC and AC. No transient analysis is allowed. I used the 1990 software NAFP of Don Robinson as a starting point (Thanks, Don!), then wrote some nice lists matrix utilities to emulate GET, PUT, RDM and other array commands, and finally reshaped all the numeric stuff to symbolic stuff in a way Alg48 could handle it. All the complicated symbolic operations are made by Alg48 commands like AINV, ASIM and ADIV. That's why you need to have it installed. 

COMMANDS
[Begin] - Starts the program. Creates a directory called 'SVFVars' where some important variables (such as symbolic matrices you would like your teacher to read in your exam's sheet of paper ;o) will be stored until you press [EndSVF].
[EndSVF] - Erases the whole 'SVFVars' directory and all the variables inside it.

NOTICE: FOR EE STUDENTS ONLY!
This software is not made for amateur circuit solvers. It is made for serious EE students that clearly understand how AC circuits are analized. If you are an amateur, please leave this program aside and try out CSim Assistant (available where you found this file, whether http://i.am/hplus or http://www.hpcalc.org sites) for it will help you describe the circuit, analize it and will translate the answer from an ugly array to a natural language sentence.

METHOD USED
This program uses the nodal format analysis. What this program really does is this:
1) Receive the circuit description from you.
2) Create admitance symbolic matrix (A) and current symbolic matrix (B).
3) Solve for voltage symbolic matrix (C) using this formula: V=I/Y => C=B/A
4) Give you the voltages from this C matrix tagged in the stack.

CIRCUIT ELEMENTS ALLOWED
This program allows you to use eight circuit elements: Impedances (Z), Admitances (Y), Inductors (L), Capacitors (C), Current Sources (Is), a couple made of Voltage Source + Impedance (Vz+Z),  Current Controled Current Sources (IcIs) and Voltage Controled Current Sources (VcIs). As you know, at a given frequency (F), Resistors (R), Capacitors (C) and Inductors (L) can be perfectly expressed as Impedances (Z) or Admitances (Y). Also, as you know, a voltage source conected in a serie with an impedance can be translated to the equivalent I=V/Z current source conected in parallel with the same impedance. So, the eight circuit elements the program allows you to use are enough to make DC and AC analysis of huge circuits made of simple elements, like those used in Power System Analysis.

STEPS TO SOLVE A CIRCUIT USING SVF

1) Once you've pressed [Begin], you'll be asked to intro the number of nodes in the circuit. In the paper diagram of the circuit you are solving, choose one node as ground and label it with zero. Then number the rest as 1, 2, 3... etc. Then, give your HP the number of the greatest node. If your problem, for example, have 3 nodes then the number you must enter to the HP is 2, for one of the nodes will be node 0 and is not counted.

2) After that, you'll have to choose the kind of element you want to enter in branch 1. What the hell is branch one? Well, in the paper diagram of the circuit you are solving, label each branch (this is each element) with - let's say - a number from one to as many branches as you have. Now that you have labeled them, you know what the hell is branch one. Press the softkey that matches the element you want to describe as branch one.

3) Now, you'll see that you are asked to enter the value of this element. I'll explain how to do this below.

4) Then, you are asked to enter the nodes of the branch. Enter a two digit number corresponding to the two nodes in the extremes of the branch in this form: #.# For example, if your branch is an impedance between nodes 2 and 3, write 3.2 or 2.3, and if it is between nodes 0 and 4, write 4.0 or 0.4 or 4 or .4 for they are equivalent. If you are describing any Is or (Vs+Z) be aware that the first node of any Is is the node from which the current departs and first node of (Vs+Z) is the positive node. It's easy!

5) When you've entered all the elements, just press the [Solve] softkey and watch SVF calculate what you'd have had to calculate alone... ufff! Done? Great! Now, just read the answers in the stack and if they require it, simplify them by pressing the [ASIM] softkey. Got a new problem to solve? Press [NEW] softkey. And that's it...


ENTERING THE VALUE OF ELEMENTS
Remember that the whole program runs thanks to Alg48 mathematical power (Thanks, Mika and Claude!) so it will always try to get exact answers with round numbers. All decimal numbers will be rationaliazed.There are three ways in which you can enter the value of elements:

1) As an algebraic. This is the recomended way to enter all element values. Why? Because this is a symbolic program and it hates floating point numbers... :o) In this case, SVF will just store it in the matrix that way. Example: You enter '2.5*i+K*Z-1' and SVF understands just that.

2) As a NUMBER. In this case, a special program inside SVF will convert your number to an algebraic rational number in order to have it in a symbolic way and then store it in the matrix. Example: You enter 2.5 and SVF understands '5/2'.

3) As a COMPLEX NUMBER. To enter the complex number, you must erase the ' ' that automatically appear in the entry line. In this case, a special program inside SVF will convert your number to an algebraic rational number in order to have it in a symbolic way and then store it in the matrix. Example: You enter (0,2.5) and SVF understands '5*i/2'.

Some examples will be solved soon and added to this info file.

QUESTIONS?
Hey, if you use this program, you are the only responsible for what happens, ok?
Any question can be asked to me at hplus@i.am and you can visit my site in http://i.am/hplus

ENJOY!