Title: Symbolic Current Finder - SCF
Author: Roberto Perez-Franco - HPlus!
Version: 1.0
Released: March 3, 1999
Library #: 988
Size: Less than 6KB
Comment: Requires Alg48.

INTRODUCTION
This is a very useful program: a symbolic circuit simulator. It works perfectly with DC and AC. No transient analysis is allowed. I used my SVF 1.2 as a starting point. 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 'SCFVars' 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 [EndSCF].
[EndSVF] - Erases the whole 'SCFVars' 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 impedance symbolic matrix (A) and voltage symbolic matrix (B).
3) Solve for current symbolic matrix (C) using this formula: I=V/Z => 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), Voltage Sources (Vs), a couple made of Current Source in parallel with an Impedance (Iz+Z),  Voltage Controled Voltage Sources (VcVs) and Current Controled Voltage Sources (IcVs). 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 nets in the circuit. The circuit must be plane. In the paper diagram of the circuit you are solving, draw inside each net a circular arrow moving clockwise. Number nets as 1, 2, 3... etc. Then, give your HP the greatest net number. If your problem, for example, have 3 nets then the number you must enter to the HP is 3.

2) After that, you'll have to choose the kind of element you want to enter as device 1. What the hell is device one? Well, in the paper diagram of the circuit you are solving, label each device (this is each element) with - let's say - a number from one to as many devices as you have. Now that you have labeled them, you know what the hell is device one. Press the softkey that matches the element you want to describe as device 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 nets that this device touches. Enter a two digit number corresponding to the two nets beside the device in this form: #.# For example, if your device is an impedance which is part of both net 2 and net 3, write 3.2 or 2.3, and if it is just part of net 4, write 4.0 or 0.4 or 4 or .4 for they are equivalent. If you are describing any Vs or (Is+Z) be aware that the way you enter the nets number is important. Remember you drawed a circular arrow inside each net? Well, suppose you have a voltage source in net 1. Well, if the circular arrow of net 1 enters the voltage source through its negative node, the net number of the source is 1. If the arrow enters the source through its positive node, the net number of the source is 0.1. I am not completelly sure on how to describe a source between two nets, so you better redraw the circuit in order to have it just in one net. Ok? I'll let you know when I find out. Hehehe!

5) When you've entered all the elements, just press the [Solve] softkey and watch SCF 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!