Congratulations
===============

               you hold an extremely cheap and extremely powerful processor
for experimental data analysis. The program is called <DataProc> and it is
available for any Amiga as well as for MS-DOS and UNIX machines. Requests
for ports to other systems may be requested from the author.

Getting started
===============

               First of all you must install <DataProc> to your system.
A useable enviroment might be installed on a floppy disk easily, but I
would recommend a HardDisk. If you double-click the <Install> icon and
accept all defaults (which is assumed in this <Read.Me> file) you'll
get a running installation in any case. Expert users may change the
installation process to the most possible extend, but will have to know
what they are doing.

NOTE: if you do not have the <Installer> program, which is part of the
new Amiga OS and free software from Commodore Inc., double clicking the
icon will lead to an error. You will have to install the package yourself
then or if you're not familiar with such installations, get the
<Installer> software from Commodore Inc. <Installer> runs with OS 1.3
and higher.

               If you are new to <DataProc> and Computers, this will be a
great deal of work. If you are familiar with <GNUPLOT> and <TeX>, there
should be no problem. Simply `cd' the directory you've installed <DataProc>
to and type:

       "DataProc demo"

At the beginning you will be asked which language you prefer. All texts
in the demo will be in the language you select. Note that on Amigas you
won't be asked for a language. DataProc checks locale.library for the
phone code and estimates your preferred language from that. If you run
OS 2.05 or lower and thus have no locale.library, replace the first

       #if -Amiga

line in "demo.tst" by

       #if 10

and you are asked for your preferred language. It should run the same
from then on.

If you do not know how to `cd' a directory, you have hopefully installed
the <DataProc> icon. So click through your drawers to the drawer you
have installed <DataProc> to and double-click the "DataProc" icon. It
looks like the "Shell" icon in your main partition.

If you do not have <GNUPLOT> installed, answer "N" to the question
<DataProc> will ask you about that - unfortunately you will miss
several pretty plots. If you got through the demo and have <GNUPLOT>
installed, you might watch another demo by typing

       "DataProc v15"

NOTE: This demo won't run without a proper installation of <GNUPLOT>.
<GNUPLOT> and <TeX> are both free software being available on any good
FTP site and on some FIDO FReq places. You may contact me, if you don't
know how to get those packages.

Further note that v15.tst and its associated files are mainly in the state
I wrote them for my physics practice - meaning made for the Amiga and in
German. They should however run on MS-DOS machines as well.

               After you're done with the demos - or if you're already
familiar with <DataProc>, click into the "Docs" drawer. This should be
located where <DataProc> itself is located, if you did not install it
elsewhere. Double-click the "DataProc.guide" icon to view the AmigaGuideŠ
hypertext documentation for <DataProc>. This assumes that you have
installed <AmigaGuide> on your system. Don't worry, if you have an
operating system (WorkBench) version higher than 2.1. In any other case
get the <AmigaGuide> package, which meanwhile became free software, too.
If you can't get <AmigaGuide>, you may contact me.

               Finally try to read the demo files "demo.tst" and "v15.tst"
together with the manual to get the feel for <DataProc> scripts. I'm going
to put this into a tutorial during the next releases. Now you should be
ready to write your own scripts.

NOTE: Don't try to understand deeply what is done in the demos, just how
it is done. The first demo is the analysis of an experiment with weired
circuits using operational amplifiers. So you won't have a real chance to
understand it. The second one analyzes an experiment to proove the
violation of parity in beta decay using `Mott-scattering'. If you know
enough physics you might come to a certain understanding. I will care for
obvious demos, as soon as I find the time necessary.

Shareware and Distribution
==========================

               Other than the products mentioned above <DataProc> is
SHAREWARE, meaning you MUST PAY it, if you decide to use it beyond a
short test phase. See the documentation chapter "Politics" especially the
sections "License" and "Registration" for information about the registration
procedure.

               The UNREGISTERED version cannot be run from remote paths. In
this case you will have to copy all scripts to the drawer <DataProc> is
located in. The installation program should have taken care of that, when
installing the demos.

               You are encouraged to include <DataProc> in any PD series as
long as prices keep comparable to the "AmigaLibDisks", better known as
"Fred Fish PD". I may cancel this permission at will.


Files installed
===============

               The <Installer> will have installed <DataProc> and <SCalc> as
executables. <DataProc> is the program described in the documentation.
<SCalc> is <DataProc's> math processor with a very simple interface. You may
use it as a scientific calculator (see chapter "Mathematics" in the
documentation) and to get familiar with the <DataProc> maths expressions.
Simply type:

       "SCalc"

and an

       Enter line>

prompt will appear. You may then enter any valid <DataProc> math expression
and immediately watch the result. All variable and function definitions as
well as all predifined variables are supported. Try:

       Enter line> 3+4 5
       23
       Enter line> a:=exp(3)
       Enter line> ln(a)
       3

and so on.

               The demos are either installed in the same drawer <DataProc>
is located or in another drawer, just how you told <Installer> to do. All
files ending with <.dat> and <.tst> are needed to run the demo. Files ending
with <.tab>, <.gnu>, <.eep>, <.log> and <.tag> are created by the demos.

               The documentation is placed into the "Docs" drawer (or
whereever you told <Installer> to place it). <DataProc.Guide> the AmigaGuide
hypertext documentation is always installed. In addition you may request
<DataProc.dvi> the printable <TeX> output file and <DataProc.texinfo>
(without icon) the source file of both, which you might convert to your
favorite format.

               Finally there might be installed <Most> and some changes to
your `S:' directory. See the <Installer> script for how it is done. If you
do not understand it, better do not change anythig.

Contact
=======

               If the package should be damaged or there is something else
wrong with it or you do not understand the docs or you cannot get the
additional software packages or you have enhancement requests, bug reports,
registration requests, ... contact:

   MGR, Asgard
   Lars Hanke
   Schlachthofstr. 67
   44649 Herne

   FIDO: Lars Hanke 2:243/4802.22
 UseNet: mgr@asgard.bo.open.de

Aloha,
       Lars.

