1. PROGRAMS, COPYRIGHT
===================
You have installed the programs
DATAN version 2.1
from the CD-ROM accompanying the text book
Siegmund Brandt
Data Analysis
Statistical and Computational Methods for Scientists an Engineers
3rd ed.
Springer-Verlag, New York 1998
Copyright for the programs:
COPYRIGHT 1998 BY SIEGMUND BRANDT AND SPRINGER-VERLAG NEW YORK,
INC.
This electronic component package is protected by federal copyright
law
and international treaty. The copyright holder retains title to and
ownership of the package. US copyright law prohibits you from making
any
copy of the CD-ROM for any reason, without the written permission of
Springer-Verlag, except that you may download and copy the README and
text files for your own research, teaching, and personal
communications
use. Commercial use without the written consent of Springer-Verlag is
strictly prohibited. Springer-Verlag, or its designee, has the right
to audit your computer and electronic component usage to determine
whether any unauthorized copies of this package have been made. The
printed book with which this electronic component is packaged may not
be
translated or copied in whole or in part without the written
permission
of Springer-Verlag except for brief excerpts in connection with
reviews
or scholarly analysis. Use in connection with any form of information
storage and retrieval, electronic adaptation, computer software or by
similar or dissimilar methodology now known or hereafter developed is
forbidden. Springer-Verlag or the author(s) make no warranty or
representation, either express or implied, with respect to this CD-ROM
or book, including their quality, merchantability, or fitness for a
particular purpose. In no event will Springer-Verlag or the author(s)
be liable for direct, indirect, special, incidental, or consequential
damages arising out of the use or inability to use the CD-ROM or book,
even if Springer-Verlag or the author(s) has been advised of the
possibility of such damages.
Mistakes in the text or in the programs which will be recognized after
the
printing of this book is completed will be announced on the web
document
http://alephwww.physik.uni-siegen.de/~brandt/datan
in the INTERNET.
2. COMPILER
========
During installation you have chosen source programs and libraries
which will work with the compiler
##1##
(##2##requiring a mathematical coprocessor).
3. OPERATING SYSTEM
================
During installation you have chosen a Graphics Library which will
work with the compiler chosen (Section 2) under the operating system
##3##
Even though you may have chosen WINDOWS as operating system,
compilation
and linking of your programs may be done under DOS
(usually in a window opened by clicking on the "DOS prompt" icon).
In Sections 8 and 9 below we assume that you do that.
(If you wish to compile and link directly under WINDOWS, for
instance using the development environment provided with your
compiler, then consult the relevant manuals.)
4. SETTING OF SEARCH PATH
======================
We suggest that in the file AUTOEXEC.BAT on your computer you
insert the line
PATH C:\DATAN;%PATH%
(Here C: stands for the name of the hard disk on which \DATAN
resides.)
You have to reboot your computer for this path setting to become
effective after the change in AUTOEXEC.BAT.
With this path setting you can address the batch files mentioned
in Sections 8 and 9 directly by their file names (e.g. DACOMP).
Otherwise you have to give the full path name (e.g. \DATAN\DACOMP).
Moreover, this path setting is necessary to locate the dynamic
link library \DATAN\DATANDLL.DLL.
5. CHANGE TO ANOTHER COMPILER AND/OR OPERATING SYSTEM
==================================================
If you want to perform such a change you must
(a) delete (or rename) the directory \DATAN,
(b) redo the installation from the CD-ROM.
6. THE DIRECTORY \DATAN AND ITS SUBDIRECTORIES
===========================================
The directory \DATAN contains
- the file README.DOC which you are reading at present,
- the graphics initialization file GRINIT.DAT,
- the dynamic link library DATANDLL.DLL (if you have chosen graphics
under
WINDOWS and not the QuickWin facility),
- files helping with compilation and linking (cf. Sect. 9 below),
- possibly include files needed for some compilers and/or operating
systems,
- the subdirectories mentioned below.
The subdirectory \DATAN\DATSRC contains
- the source files of the data analysis programs.
The subdirectory \DATAN\EXASRC contains
- the source files of the example programs,
- an executable file for each example program
which can be directly run as demonstration.
The subdirectory \DATAN\SOLSRC contains
- the source files of programs
which are solutions to the programming problems,
- an executable file for each solution program
which can be directly run as demonstration,
The subdirectory \DATAN\DLIB contains
- the Data Analysis Library
(it is a library file in which all object programs which are
produced by
compiling the source programs in the subdirectory \DATAN\DATSRC are
combined),
- files helping with the rebuilding of the Data Analysis Library
if changes are performed on the source programs
in the subdirectory \DATAN\DATSRC.
The subdirectory \DATAN\GLIB contains
- the Graphics Library
(a library file containing the graphics programs).
If you have chosen graphics under WINDOWS (and not the QuickWin
facility)
the Graphics Library consists of the Dynamic Link Library
\DATAN\DATANDLL.DLL and a conventional library file.
7. RUNNING A DEMONSTRATION
=======================
You may run demonstration programs by working in the directories
\DATAN\EXASRC or \DATAN\SOLSRC
and running any of the program files named *.EXE
(i.e. files with the extension EXE).
These programs are explained in the text book.
To run any of these programs
(a) under DOS: type the file name (without the extension .EXE),
e.g. type E1GR
(b) under WINDOWS: double click on the file name as displayed
by the EXPLORER or FILE MANAGER,
e.g. double click on E1GR.EXE
8. MODIFYING THE DATA ANALYSIS LIBRARY
===================================
If you want to change programs from the Data Analysis Library, e.g.
because of the array size limitations mentioned in Sect. G.9
of the text book, you first have to change the source programs in the
subdirectory \DATAN\DATSRC. Then you have to compile
the modified source programs. To ensure that the changed programs are
used in your application you must give the names of the resulting
object files during linking, cf. Sect. 9 below, or include the
new object files into the library so that they replace the original
ones.
Consult the handbook of your compiler and of the corresponding
library manager on how to replace parts of a library. It may be
simpler
for you to generate a completely new Data Analysis Library after
having
changed one or several files in the subdirectory \DATAN\DATSRC. For
this
you have to work in the subdirectory \DATAN\DLIB.
8a COMPILATION AND LIBRARY BUILDING IN TWO STEPS
---------------------------------------------Enter the command
COMPILE
(which makes your computer work through the batch file COMPILE.BAT
and recompile all source programs in the subdirectory \DATAN\DATSRC
and place all object programs in the subdirectory \DATAN\DLIB)
followed by the command
MAKELIB
(The batch file MAKELIB.BAT makes a library out of the object files.)
8b COMBINED COMPILATION AND LIBRARY BUILDING
----------------------------------------If you have a MAKE facility on your computer (which is provided
with many compilers) simply type the command
NMAKE or MAKE
(the MAKE program will work through the statements contained in the
file MAKEFILE and the result will be the recompilation of
all source programs in the subdirectory \DATAN\DATSRC and the
creation of a new Data Analysis Library.)
9. COMPILING, LINKING, AND EXECUTING PROGRAMS
=========================================
After the installation has successfully been completed you
can write any program, compile it, link it with the Data Analysis
Library
and - if needed - with the Graphics Library, and finally execute it.
We
demonstrate here compiling, linking and execution of two example
programs.
9a CREATING YOUR OWN WORKING DIRECTORY
----------------------------------We suggest that for every problem you are working on you create
a separate subdirectory. For all examples you might, for instance,
create
the directory \EXAMPLES and for the two examples of this section the
subdirectories \EXAMPLES\EX1 and \EXAMPLES\EX2.
This is done under DOS by the commands
md \EXAMPLES
md \EXAMPLES\EX1
md \EXAMPLES\EX2
or under WINDOWS by using the appropriate tools (e.g. EXPLORER).
Now choose the subdirectory \EXAMPLES\EX1 as your working directory
and copy the source file of the Example Program E2LSQ from the
subdirectory \DATAN\EXASRC into your working directory.
If you want to use the MAKE facility (Section 9d) copy the file
MAKEFILE
from the directory \DATAN to your working directory.
9b COMPILATION
----------To compile the program E2LSQ type the command
DACOMP E2LSQ
(The batch file DACOMP.BAT located in the directory \DATAN is used to
initiate the compilation. In the above example it takes the argument
E2LSQ.)
9c LINKING
------To link the object file resulting from the compilation of the
program E2LSQ to the Data Analysis Library and to the Graphics
Library type the command
DALINK E2LSQ
(The batch file DALINK.BAT which is located in the
directory \DATAN is used to initiate the linking process. In the
above example it takes the argument E2LSQ. It can take up
to 10 arguments at a time, i.e. initiate the linking of
up to 10 object files with the libraries to yield an executable
program.)
9d COMBINED COMPILATION AND LINKING
-------------------------------If you have a MAKE facility on your computer (which is provided
with many compilers) simply type the command
MAKE E2LSQ.EXE or NMAKE E2LSQ.EXE
(The file MAKEFILE in the directory \DATAN then successively
initiates compilation and linking. It takes only one argument.
The use of MAKE with an argument as in the above example
requires that no executable file exists when MAKE is started.
Therefore, if you want to run MAKE another time (possibly
after having made changes to the source program of E2LSQ)
you have to delete the file E2LSQ.EXE.
For projects requiring the compilation of more than one file
the MAKEFILE has to be adapted to the particular project. In that case
study the MAKE facility or equivalent tools provided with your
compiler.)
9e EXECUTION
--------As a result of compilation and linking a file with the name E2LSQ.EXE
containing the executable program now exists in your working
directory.
Under DOS you can execute it by simply entering
E2LSQ
Under WINDOWS you can execute it for instance by double clicking
on the file name E2LSQ.EXE as displayed by the WINDOWS EXPLORER.
NOTE
---The program E2LSQ used as example above does not use graphics.
During execution alphanumeric text is displayed on the screen.
Its meaning is explained in the text book.
As a simple example of a main program with graphics you may take E1GR.
Use \EXAMPLES\EX2 as working directory. Copy the source program E1GR
into it and repeat all steps of this section (replacing E2LSQ by
E1GR).
10. ACTION IN CASE OF DIFFICULTIES
==============================
10a ERRORS WITH COMPILATION, LINKING OR LIBRARY BUILDING
---------------------------------------------------Please check:
- whether the particular compiler which you selected during
installation is available on your computer,
- whether your version of the compiler is invoked
with exactly those keywords used in the files
\DATAN\DACOMP.BAT and \DATAN\DALINK.BAT or in the file
\DATAN\MAKEFILE
or in the case of library building in the files
\DATAN\DLIB\COMPILE and \DATAN\DLIB\MAKELIB or in the file
\DATAN\DLIB\MAKEFILE,
- whether the compiler environment is set up properly, in particular
whether the search path conventions of Section 11 are fulfilled.
You may possibly have to install the compiler, repeat the installation
(cf. Section 5 above) or change the batch files mentioned above.
10b ERRORS WITH THE GRAPHICS
-----------------------Please check:
- whether the file GRERR.LIS contains explicit error messages,
- whether your computer really has the type of graphics workstation
you selected,
- whether the graphics initialization file GRINIT.DAT exists and
whether it describes correctly the graphics workstation you
selected.
Note: The file GRINIT.DAT is first searched for in you working
directory.
If not found there it is searched for in the directory \DATAN.
If necessary, you must select a different workstation and/or change
the
contents of the file GRINIT.DAT.
11. PATH NAMES OF COMPILERS AND THEIR LIBRARIES
===========================================
The files COMPILE.BAT, MAKELIB.BAT, DACOMP.BAT and DALINK.BAT
and the files of type MAKEFILE contain references to your compiler,
its
library manager and linker, and to the compiler libraries.
These programs and libraries are located in directories with names
that were
defined during the installation of the compiler on your computer. Most
probably, these names are identical to the default names suggested by
the
producers of your compiler and used by us. It is possible, however,
that the
directory names are different from the defaults. The commands to
invoke the compiler, library manager and linker in the batch files
mentioned above are independent of the name of the directory in which
they
are found. It is required, however, that the name of that directory be
entered into the search path using the DOS command PATH. Please make
sure
that the directory name of your compiler is mentioned in the PATH
command
within the file AUTOEXEC.BAT, which is used when your computer is
switched on.
The compiler libraries are referred to by their absolute path names in
the
batch file DALINK.BAT, i.e. the explicit directory names are used.
If different path names are used on your computer, you have to
change the batch file. Note also that the path name in DALINK.BAT does
not contain a reference to the hard disk drive. Such a reference is
necessary if your working directory and the compiler libraries reside
on
different disk drives.