SciAn README file
Eric Pepke
June 19, 1992

You have successfully found the SciAn distribution.  This file contains some
information on how to retrieve and install SciAn on your Silicon Graphics or
IBM workstation.  

IMPORTANT!  At the end of this file is a section containing answers to 
common problems.  If you have a problem while installing or printing the
manual, please look at this section first.

**********************************Files*************************************

There are several files in the SciAn directory:

  README               This document
  scianXXX.tar.Z       A compressed tar file containing the SciAn package 
                       version X.XX.  For example, 'scian040.tar.Z' contains 
                       SciAn version 0.40.
  scianmanXXX.sit.hqx  A Binhexed Stuffit-compressed Microsoft Word 4 file
                       containing the manual for SciAn version X.XX

***************************System Requirements******************************

SciAn will run on the Silicon Graphics 4D and Personal Iris series of
workstations.  It will also run on IBM RS/6000 workstations with the GL 
library installed.  (WARNING: Not all IBM RS/6000 workstations have the 
GL library.  Check with your system manager or IBM representative if you 
are unsure before going through the lengthy installation procedure.

SciAn requires a Z-buffer.  It is better if the workstation has lots of 
bitplanes, double buffer, and alpha planes, but these aren't required in the 
minimAL configuration.

The more central memory and swap space you have, of course, the better.
A comfortable minimum for smallish data sets would be about 16 MB.

SciAn doesn't yet run on the Indigo, mostly because we haven't had an 
opportunity to spend much time with those systems.

The same source code is used to compile both versions.  A pre-installation
process (make INSTALL) controls how the code is compiled.

******************************Installation**********************************

Get the desired version of SciAn using ftp in image or binary mode.  Let's
assume that it is scian040.tar.Z.  Put the file in the directory where you
want the SciAn source to reside.  You will need a few megabytes of disk 
space to complete the installation.

Uncompress the file by entering

uncompress scian040.tar

Extract the files from the tar file by entering one of the following commands,
depending on whether you are running on an IBM or an IRIS.

IRIS:
tar xvof scian040.tar

IBM:
tar xvf scian040.tar

Many files will be extracted from the SciAn tar file.  Files ending in .c,
.h, and .f are the source files of SciAn.  (Currently, you don't need the
FORTRAN compiler to compile SciAn.)  File 'Makefile' and files ending in
.make are for the make program.  There is also a directory called 'demo' 
which contains demonstration files for SciAn.  Put this directory where
it can easily be found and tell all your users where it is.  The manual 
refers to this directory in the tour section.

There may also be a file called RELEASE.NOTES.  Look in this file to 
determine special features of this version.

Most of the parameters of the installation are controlled by the 'machine.h'
include file, which contains many #defines.  Look at this file first and
try to determine if the defined constants are consistent with your system.
The file attempts to guess your machine type by seeing what constants are
defined at compile time, but there are several options, such as the linking
of the fast malloc and the NCSA HDF libraries, which must be controlled by
hand.

A program called ScianPreInstall includes 'machine.h' and checks to see if
all the libraries can be found.  To run ScianPreInstall, enter

make INSTALL

ScianPreInstall may tell you to make some changes to 'machine.h.'  Make the
changes and try make INSTALL again.  When everything is set up correctly, 
you can go on to the next step, making SciAn.

To make SciAn, enter

make scian

SciAn will be compiled into a single executable called 'scian' which you can
then copy to any accessible place, such as /usr/local/bin.

There will also be a directory called demo.  Move this directory to some
easily accessible place and tell all your SciAn users where it is.  It is this
directory that holds the demo files referred to in the manual.

We hope you enjoy SciAn.  Please send bug reports and suggestions for features
to scian-bugs.scri.fsu.edu.

**********************************Manual**************************************

The manual is in Word 4 (Macintosh) format and has been compressed and
encoded with Stuffit. Use BinHex4 or StuffIt to decode the file and then
use StuffIt to extract the archive. When printing the manual BE SURE TO
CHECK "BLACK & WHITE" in the print dialog (it comes up with
"Color/Greyscale" as the default). Also, we have had trouble with the
figures not printing correctly when using background printing.  It is 
safest to print with background printing turned off.

If you do not have access to Macintoshes, you may order a printed copy of
the manual from:

        Target Copy
        635 W. Tennessee Street
        Tallahassee, FL 32304

The price, including shipping, is $19 in U.S., $29 overseas. Payment may be
by Visa, MasterCard, check, or money order. If paying by credit card, order
may be faxed to (904)224-5014. Questions about manual orders or payments
should be taken up with Richard Bruce of Target Copy, at (904)224-3007.

We are not at all involved with the exchange of money between the copy shop
and anybody else.

***************************** Common Problems *******************************

This section contains some problems that a few people have had during 
installation or printing of the manual.

PROBLEM: When I link, I get a message saying that "libdf.a" can't be found!

SOLUTION: This message means that the HDF library cannot be found.  Enter
"make INSTALL" and follow the directions.


PROBLEM: When I print the manual, the figures come out funny!

SOLUTION: Make sure you are using the latest version of the Apple laser
printer drivers, and turn background printing off.


PROBLEM: It compiles fine on the IBM, but when I run it, I get an error 
and nothing else happens.

SOLUTION: Unfortunately, in most cases this means that you don't have the
required graphics hardware to do 3-D GL calls.  The first thing to do is
check with your system manager or IBM representative to see if you do.  
However, this problem can also be caused if you have multiple copies of X
(this particular difficulty bit us).  If that's the case, you may have to 
reorder the link directories in the file lfiles.ibm6k.make.  Another 
possibility is that SciAn was compiled under one version of AIX and was
run under another.  Binaries compiled under 3.1.5 won't run under 3.2 and
vice-versa.  (Also see MENUSFROM0 in machine.h.)  


PROBLEM: When I try to run it on the IBM, the wrong menus appear to highlight,
and the fonts don't work.

SOLUTION: This probably means that you have compiled under AIX 3.1.5 without
defining MENUSFROM0 in machine.h.  Take a look at machine.h, run "make INSTALL"
again, and try to make again.
