ARGUS by Volker Erb                                         *GIFTWARE*

*REQUIRES* the Tool Library from Jim Donnelly's ToolKit.

Hi Folks, it's time to give back something to you, after having so
much fun with your programs.
I wrote this 15,238.5 byte application to learn to handle this HP48SX.
The routines I created are pretty hard to follow; take it as
labyrinth and have fun.
If you like to use this program more than one time, then I
would like to get a small acknowledgement for the four months of
work that it took.  Please ship 15$, a postcard or whatever you think
it's worth.  I'm working hard on a new version of ARGUS and registered
users, who send a minimum of 6$, will get one of these, when it is
ready. Thanks.

My Address:

Volker Erb
Ernst-Reuter-Str.31
D-W6508 Germany
Tel: 01149/6731-8167

This program is dedicated to my girl-friend Daniela, who was
so patient of me even when I took more time for this 
calculator than for her.

**** You need James Donnelly's TOOL LIBRARY *****
I'm really sorry about this, but the very first version I 
wrote, was before this TOOL KIT was available and was about 
6 kB without any data analysis. Anyway the Programmer's Tool
Kit is a nice thing to work with.

ARGUS 3.02 (CHECKSUM: # 63833d)

1. Copy ARGUS302 into memory.

2. You need about 22kB free Memory to run it.

3. After the transfer press the <ARGU> key to run ARGUS

4. Explanation of the prompts:

	a) " Type Name of Function and press <CONT>"
		Type the part of the equation which is before
		the  '='; e.g. F(x)=a*x+b, Type: F <CONT>

	b) " Type Equation like ...  ... "
		Type the part of the equation which is behind
		the  '='; !!! USE QUOTATION MARKS !!!
		e.g. F(x)=a+x+b, Type: 'a+x+b' <CONT>
				 or
				 If you like to use the 
				 Equation writer:
		Type: leftshift ENTER ... <EVAL> <CONT>

	c) " Simplified Error equation?
	     Takes Time ! "
		<YES>: a COLECT routine will simplify the error
		       equation;
		       choose it, if you need an easy-to-read 
		       error eq
		<NO>:  no simplification

	d) " Give Number of Datas ... ..."
		If you like to solve a number of data sets with 
        ARGUS, type this number; if you prefer to
		quit ARGUS and save the equation expressions,
        press <QUIT>

	e) " Give Mode of Numberdisplay ... ... "
        Choose your preference.

    f) " Do you wish to use Units with your Data-values ?"
		I'm a little bit proud of this application, 
		because, if you want to use Units, this 
		application needs the units only for the first 
		data set (So what, the solver application does 
		the same!) and it produces the units for the 
		tolerances by itself. As long as your first 
		input and the equation were correct, the are no 
		more errors possible, if you follow the online
        instructions.
		If you have chosen <NO>, ARGUS uses a modified
		solver routine. It separates the inputs of data
		values and the inputs of their tolerances values.
		Unit objects will be transformed to real numbers.

	g) " Do you want to keep some variables constant ?"
        If you choose <YES>, you will be asked about each
		variable and if you have chosen <YES> for a 
		variable this variable will be constant for the 
		whole data input.
        With <NO> you will be asked for a value for each
        data input. This application is only offered for
        the first data set run.

	h) " See Results ?"
        <NO> : show no further results
        <YES> : You will see a menu with keys like
			<CONT> <SCN1> SCN2> ... <EEQ1> <EQN1>
			<EEQ2> <EQN2>	...
			<SCNx> stands for "scan results of the 
			x-th  data analysis" Press this key to see
			every single result with absolute and 
			relative error.
			<EEQx> shows  the x-th error equation
			(press the cursers to see the whole 
			equation and <ON> to quit to the normal
			display)
		<CONT> : If you want to go further, press this key

	i) " Next Data Analysis ? "
		<YES> : You can calculate a new error analysis 
			without going through the initial part of 
			the program.
        <NO>  : Go to the end of ARGUS

	j) " Delete Everything or save Results ? "
        <Save> : saves the results and recalls the
			 calculator's status before using ARGUS
		<DELET>: Deletes everything (results, too !) and 
			 recalls calculator's status


Last comments:

	First you will be asked to save your last results in a
	directory NOT called RESULTS. This is only for your 
	security, because ARGUS creates a directory RESULTS,
	in which other directories, called RES1, RES2, ... are
	stored. However, don't run ARGUS, if there is a RESULTS
	directory in the ARGUS directory.



So far, so good!
Be patient, this was my first attempt of a real program.

Sorry, I know that my English is not without any mistakes. I'm
working on this, too.

Bye, Volker