SCIENTIFIC and ENGINEERING TOOL
For LOTUS(R) 1-2-3
Copyright K.I.T.A.L. Software 1988, All rights reserved.


* * * * * * * * * * * * * * * * * *
* *
* K.I.T.A.L's Licence Statement *
* SHAREWARE VERSION *
* *
* * * * * * * * * * * * * * * * * *


K.I.T.A.L. Software grants you without charge the right to reproduce
and distribute copies of the "SHAREWARE" version of The SCIENTIFIC and
ENGINEERING TOOL For LOTUS(R) 1-2-3 software package on the express
conditions:

1. NO fee other than a disk and handling charge (of up to $10) may be
charged).
2. NO change will be made to this license agreement or the copyright
notice. The rights to receive any such financial or other benefit
are reserved exclusively by K.I.T.A.L. Software i.e. Israel and
Tsipora Kehaty.

This software package is a Copyrighted software and "IS NOT" a PUBLIC
DOMAIN software, but a SHAREWARE software package. Which means that
you can copy and distribute this software freely for the sole purpuse
of evaluation and testing before purchasing. To use this software
legaly you need to be registered with us.

If you like this software and you USE it you are asked to be registered
with us.

Support from users enables us to develop additional features and
future versions of The SCIENTIFIC & ENGIEERING TOOL.

Your payment of $40.00 would be greatly appreciated.

* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
* Please, help us to help you and other users to keep and reserve the *
* SHAREWARE idea. *
* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *

By sending in your payment, together with your Company name, mailing
address, telephone number and Version number; your copy of this
software will be registered with us, thereby enabling you to receive:

(1) Technical support
(2) Announcements of possible later releases

Such a payment of $40 should be sent to:

K.I.T.A.L. Software
P. O. Box 748
Karmiel 20100
ISRAEL
Telephone 972-4-987255

Please feel free to add comments and improvements that you would like
to see included in future versions.


WELCOME


This program is an easy to use, completely menu driven template
program designed for the use of the Lotus 1-2-3 user who deals with
number crunching and likes the way Lotus works. If you know Lotus
1-2-3 you already know this program. Because this tool operates with
1-2-3 style command, menus, formulas, etc., you can start working
without having to learn a new program, so your investment in 1-2-3
training is preserved and enhanced.

The program includes a sophisticated programmable calculator and
solver which can do:

1. Simple arithmetic
2. Functions editing (programming) and functions calculations
3. Physical units definition and conversion
4. Integration and Differentiation of analytic functions and data
tables
5. Editing and calculating statistic functions on list of numbers
6. Frequency distribution and normal distribution of data
7. Curve fitting (4 types)
8. Root finding (non-linear equations)
9. Matrix and vector operations
10. Simultaneous linear equation solving

Statistical functions and any other functions and units are user
programmable. Therefore this program can become the user's custom
scientific handbook. The user can program thousands of functions:
from one variable functions to seven variables functions, and by
splitting functions of higher number of variables to groups of
functions of seven variables and less, to solve more complicated
problems.

Integration and differentiation is done on functions inserted from
the keyboard or on data tables imported as a text file. The program
enables a graph of the function before and after integration or
differentiation and allows saving the numeric data tables and the
graphs for later use.

The distribution functions are build-in with the program and are
working on a list of numbers inserted from the keyboard or imported
as a text file. These function produce a graph of the distribution
and allows the saving of the graph as a .PIC file and the data as a
text file for later use.

The program already includes a large number of common used functions
and units and the user can edit them or add as much as he likes. The
user can use this program to keep track of his spreadsheets, and by
using a keyword instead of a function he can activate a whole
spreadsheet.

Since this program was written in LOTUS macro language, when the user
retrieves another program this program erases itself and leaves the
full memory for the new spreadsheet. The user can create a small
macro in his spreadsheets which will retrieve this program
automatically when quitting.


INSTALATION


IMPORTANT: Make a backup/s of this diskette and store the original in
a safe place.

Set Lotus 1-2-3 to the 80x25 screen mode (use the INSTALL program in
Lotus 1-2-3 system disk).

If you are using the program from a floppy disk, make sure to set
the default directory in Lotus 1-2-3 to the floppy (because the
program looks for the files in the diskette).

If you like to use the program from a hard disk (RECOMMENDED), make
a directory for this program and copy all the files to the directory.
Make sure to set the default directory in Lotus 1-2-3 to the new
direcory (because the program looks for the files in that directory).


GETTING STARTED


To start the program, start Lotus 1-2-3 and then RETRIEVE the file
ATOOL.WK1. The program will start to run automatically.


VARIABLE NAMES CONVENTION


As a LOTUS user you probably know that instead of variables LOTUS uses
cell address or range names. Therefore when you are prompt to input a
function or a formula or when you build a new functions or edit a
function REMEMBER that LOTUS expect to get range names as variables.
The range names are already defined in the program and MUST be used
when you build or type a function:

The rules are:

WHEN YOU ARE IN THE SOLVER (Integration, Differentiation,
Root finding):

The variable name is "VAR" or "R".

Example: @SIN(VAR)-VAR or @SIN(R)-R

WHEN YOU ARE IN THE CALCULATOR FUNCTIONS MODE (EDIT):

The variable names are "RG1", "RG2", "RG3", "RG4", "RG5", "RG6", "RG7"
or "A", "B", "C", "D", "E", "F", "G" respectively. As you can see
there are seven variables to allow the user to program up to seven
variable functions.

Example: @SIN(RG1)-RG2^2+RG3^5...... or @SIN(A)-B^2+C^5

WHEN YOU ARE EDITING A ONE VARIABLE FUNCTION (1_func):

The variable name is "OUT" or "T"

Example: @SIN(OUT) or @SIN(T)


GETTING HELP


Almost every menu includes a Help option, every time you see the help
menu item and you are using this menu the first time, take the time to
look at the help document, it will save you from making errors. To get
back to the program press the ESC key.


SCROLLING


Sometimes in the program you need to scroll to highlight the FUNCTION
or the UNIT you want to calculate. Use the menu items DOWN, UP, NEXT,
PREVIOUS, RIGHT and LEFT. you can't use the arrow keys because they
are used by LOTUS to move the highlight in the BAR MENU.


LOTUS "EDIT" MODE


Sometimes the program enters the LOTUS "EDIT" mode. This is done to
help you insert and calculate (integrate, differentiate and solve) 240
characters long functions. In this case all LOTUS keys and functions
are operative BUT you are WARNED not to take advantage of this and
only type the function and press the ENTER key. Trying to mess up with
the program MAY result in destroying the template code. If by mistake
you "have managed" to exit the "EDIT" mode (see indicator) press the
F2 function key to get back to "EDIT" mode. But be sure that the
HIGHLIGHT is on the right cell. If when you have exited the "EDIT"
mode you have moved the highlight too, use the arrow keys to move it
back to the right place and press the F2 function key to enter the
"EDIT" mode.


ERROR HANDLING


If you make an error that the program can't tolerate the program will
prompt you to press any key and the program will switch to the main
menu, so you can start all over again.


IF YOU NEED TO BE RESCUED!


Press the ENTER KEY once or few times until you are back in one of
the menus and than continue.


STATUS INDICATOR


Most of the time the program prompts the user at the main screen and
gives a message like "Working... Please wait" some other times the
status prompt appears in the indicator cell (upper right corner of
the screen).


SAVED FILES FORMAT


- Graphs are saved as *.PIC files

- The units and functions are saved with the FORMULAS.WK1 file

- The matrices and linear equations are saved as *.WK1 files

- All other (integration, differentiation, curvefit etc. ) are
saved as text files (ASCII) with the .PRN extension


SYSTEM REQUIREMENTS


IBM(R) PC, XT, AT, PS2 or compatibles
DOS 2.0 or higher
LOTUS 1-2-3 Version 2.01
Hard disk is recommended


* * * * * * * * * * * * * * * * * * *


Information in this software is subject to change without notice and
does not represent a commitment on the part of K.I.T.A.L. Software.
It is against the law to copy this software on magnetic tape, disk,
or any other medium for any purpose other than the purchaser's
personal use.


Lotus and 1-2-3 are registered trademarks of Lotus Development
Corporation.
IBM is a registered trademark of International Business Machines
Corporation,


WARRANTY


SCIENTIFIC AND ENGINEERING TOOL AND ACCOMPANYING MATERIALS ARE
PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND. THE ENTIRE RISK AS TO
THE RESULTS AND PERFORMANCE OF SCIENTIFIC AND ENGINEERING TOOL IS
ASSUMED BY YOU.

With respect to the physical diskettes and/or physical documentation
enclosed herein, K.I.T.A.L. Software Warrants the same to be free of
defects in material and workmanship for a period of 30 days from the
date of purchase. In the event of notification within the warranty
period of defects in materials or workmanship, K.I.T.A.L. Software's
entire liability and your exclusive remedy for this warranty shall be
limited, at K.I.T.A.L. Software's option, either (a) return of the
purchase price or (b) replacement of the disk and/or of the
documentation, and shall not encompass any other damages, including
but not limited to loss of profit, special, incidental, consequential,
or other similar claims.

K.I.T.A.L. Software, SPECIFICALLY DISCLAIMS ALL OTHER WARRANTIES,
EXPRESSED OR IMPLIED, INCLUDING BUT NOT LIMITED TO, IMPLIED
WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A DOCUMENTATION, AND
THE PROGRAM LICENCE GRANTED HEREIN. IN PARTICULAR, AND WITHOUT
LIMITING OPERATION OF THE USE, OR PURPOSE. IN NO EVENT SHALL
K.I.T.A.L. SOFTWARE BE LIABLE FOR ANY LOSS OF PROFIT OR ANY OTHER
COMMERCIAL DAMAGE, INCLUDING BUT NOT LIMITED TO SPECIAL, INCIDENTAL,
CONSEQUENTIAL, OR OTHER DAMAGE.