Documentation for Root Locus Plotter and Information

This program was written enirely by Jason Frandsen and no routines 
were copied off of anyone or used as source code.  

DISCLAIMER
I am in no way responsible for your calculator crashing, erasing, or 
any type of wrong answer that my program gives.  I have tried the 
program with over 30 different problems and have NEVER had any 
problems with it whatsoever.

Introduction
This is a root locus plotter and information program.  I know its a 
little big but when I tried the root locus plotters available on the 
internet they were so slow that I had to write my own.  My verson is 
faster and also provides alot of information such as angles of 
departure, angles of assymptotes, location of assymptotes, etc.

Instructions:
Basic
The program is basically really easy to use.  Move into the directory 
and press CST to get the custom menu to come up.  Don't even bother 
looking through the  directory to find what you need as there are tons 
of programs in it.  Here are a summary of the commands.  Note that 
they may not be in the same order as in the custom menu due to my 
laziness

ERASE - erases the current PICT

AUTOS - Press to toggle autoscale On/Off .  A string will be put on 
the stack to tell you whether it is on or off after the press.  NOTE:  
I recommend using Autoscale because problems can result causing the 
program to crash if the graph is off the screen.

RLOCUSFINDER - Plots the root locus with the top in KT and the bottom 
in B.  Will use Autoscale if it is on.  Again I recommend you use 
autoscale if you don't know much about programming the HP

B - coefficients of the bottom polynomial
    i.e. s^2+6s+5  =>  [1 6 5]    store values by using left shift

KT - coeffients of the top polynomial
     i.e. K(s+9)  =>  [1 9]     store values by using left shift

NUMBERS - will produce a text file using KT and B that will provide 
the following information:
	Angles of Assymptotes
	Location of Assymptotes
	All Breakpoints
	Valid Breakpoints
	Angles of Departure
once this has been run and you drop the results from the stack, you 
can see the results again quickly by pressing the RECALL command.  
This will save alot of time over running NUMBERS again because it 
doesn't recalculate everything

PMUL - multiplies 2 plynomials together  (s+1)(s+2)=(s^2+3s+2)
		{1 1}
		{1 2}
		PMUL
		{ 1 3 2 }
also works with complex numbers   NOTE:  same routine as my partial 
fractions library, so you can save some space by erasing it from this 
directory if you also use my partial fractions library.

SPD<UP ARROW>	Increase speed ( decrease resolution )
SPD<DOWN ARROW> Decrease speed ( increase resolution )
SPEED  Shows current speed  0 slowest..highest resolution... never use 
unless you have an hour to kill.  I usually set it at around 3 to 5
if you right shift you can set value to what you want without using 
speed up or down

XRNG sets x axis range.  As I have mentioned before  DO NOT TOUCH 
unless you know what you are doing.  If for some reason you 
"accidentally"  set the range wrong, putting autoscale back on will 
fix the problem.  Also note that if autoscale is on, this is useless.  
Autoscale will reset it anyways.

YRNG sets y axis range.  As I have mentioned before  DO NOT TOUCH 
unless you know what you are doing.  If for some reason you 
"accidentally"  set the range wrong, putting autoscale back on will 
fix the problem.  Also note that if autoscale is on, this is useless.  
Autoscale will reset it anyways.

LA=>A  Takes a list or array in and returns an array

PROOT  HP's built in PROOT.. or the program PROOT for SX users... if 
you are an SX user you must get this program.

OBJ=>  HP's object expansion.  I think this isn't even a command on 
the SX.  Although it doesn't matter.  It is only there for convenience 
sake.

RECALL  Recalls the last computed numbers from NUMBERS

These instructions should be enough to plot any graphs and get the 
numbers with zero amount of effort.



Advanced Instructions(if you don't know how to program or don't want 
to risk damaging the program, don't even read this):

If you went "poking" around the directories you probably noticed some 
variables named L1 through L5 and S1 through S6.  The ones named L1 
through L5 are used to determine when to step up the increments of K 
and S1 through S6 are used to determine what these increments are.
Default values are as follows( reset back to these if you make a 
mistake - they work in most cases )

		L1	1		S1	.1
		L2	5		S2	.5
		L3	15		S3	1
		L4	50		S4	2
		L5	100		S5	5
		over 100		S6	10

There is also a variable called TrangeUpper and TrangeLower that is 
the upper and lower limit of K.

You can also set the x and y ranges yourself.  Make sure none of the 
poles or zeroes are out of the plot range or even near the side of the 
plot or else the program will crash.  I have plans to fix this, but 
since I always use autoscale there isn't much need for me to fix it 
for myself...  If you would like me to fix it email me with a good 
reason why and I'll see what I can do.




If you have any other questions about the program or bugs to report or 
you feel that I deserve some money:) ( as I spent a great deal of time 
on these routines) my email addresses are as follows:
	jfrandsen@shaw.wave.ca
	jbfrands@acs.ucalgary.ca
	frandsen@enel.ucalgary.ca


NEW!!!!! New functions for root locus.... previous instructions are 
still valid. Since I'm at school I am just posting the directory file 
with now instruction... I will post the added instructions soon. I 
added the ability to find a value of K for a certain damping ratio. At 
the end of CST there are 3 new variables.. DAMP SQUIG and PLSQ. You 
enter in a value for the damping ratio in SQUIG then press PLSQ which 
plots a straight line on the plot. Go to the plot... find 2 x values 
that are close to the intersection. Lets say they are -2.4 -2.8, you 
enter in 2.4 on level 2 and 2.8 on level 1, then run DAMP. It will 
return either the value of K for the damping ratio and the actual 
point on the plot where it crosses or it will stell you that there is 
no K in that range. I know these instructions aren't that useful but 
its all i have time for... version 1.03 is included.