
              Netica API Install for SUN Sparc Solaris, version 2.15
              ------------------------------------------------------

After unpacking, you should have a directory called "NeticaAPI_Sun_215" with
the following files in it:

libnetica.so -------------- The Netica library (archive of object files)
Netica.h ------------------ Header file for Netica API
NeticaEx.c ---------------- Extra C source code for Netica API
NeticaEx.h ---------------- Header file for NeticaEx.c
Demo.c -------------------- Source code to get Netica API working
LicAgree.txt -------------- License agreement
README.txt ---------------- This file

If you haven't read the license agreement yet, read it now, and if you
don't agree to it, delete all the Netica files.

NOTICE:
    This version of Netica API was built using SunOS 5.6,
    and gcc version egcs-2.95.1 19990816 (release).
    The previous release, 2.00, of NeticaAPI for Solaris is
    available for both gcc 2.91 and gcc 2.81.
    Because of the way gcc works, Netica API built with one
    version of gcc, may not work with another version of gcc.
    Older versions of Netica API are available from 
    ftp://ftp.norsys.com/dl/old_versions
    If your particular gcc and Solaris combination does not work
    with this version of Netica API, contact us.

DEMO PROJECT
------------

To check your installation, it is best to first get the program Demo.c
working.  First compile Demo.c and NeticaEx.c:

    gcc -c Demo.c NeticaEx.c

This will put the resulting object code in Demo.o and NeticaEx.o.

Next, ensure that libnetica.so is on your LD_LIBRARY_PATH.
You can add it with the following commands, depending on your variety of shell:
  csh/tcsh:  setenv LD_LIBRARY_PATH <path to libnetica.so>
  ksh/bash:  LD_LIBRARY_PATH=<path to libnetica.so>
             export LD_LIBRARY_PATH
  For example, with csh you might type:   setenv LD_LIBRARY_PATH .
assuming that libnetica.so is in your current working directory (".").

Then link them together with Netica and the Standard C math library:

    g++ -o netdemo Demo.o NeticaEx.o -L. -lnetica -lm

The -L. means look for libraries in the current directory (as well as the 
system library directory), the -lnetica means link in libnetica.so, and the 
-lm means link in libm.a (the math library).  In some environments, you
may be able to type "gcc" instead of "g++", but in others you will get link
errors for the missing exception handling routines.

This creates an executable called 'netdemo', which you can run by 
typing "./netdemo" without the quotes (which means run netdemo from
the current directory).  If it prints out a welcome 
message, and prints out the probability of tuberculosis as 0.0104, 
0.0924109, 0.337716, and 0.05 under various conditions, and doesn't 
print any error messages, your installation is good.


LICENSE PASSWORD
----------------

If you have a license password, the next step is to make sure it works.
In Demo.c, change the line that says:

    env = NewNeticaEnviron_ns (NULL,NULL,NULL);

to one that says:

    env = NewNeticaEnviron_ns ("xxx",NULL,NULL);

where xxx is the license password that has been emailed to you, or appears 
on your invoice.  Then recompile, relink and run it again.
If you get the same message as before (except without the "Netica operating 
without a password ..." line), then your password is working properly.

Now you can replace the Demo.c file with your own source files that
use Netica, and generate your own executables.  


MANUAL
------

To use the Netica API, you will need the reference manual.  If the CD-ROM
was shipped to you, then the manual will be included with it.
Otherwise, you can download the manual as a postscript file from the Norsys 
web site.  It is okay if the manual has an earlier version number.

Be sure to try the online HTML function reference for Netica API, available 
from the Norsys website and on Netica API CD-ROMs.  We recommend that you
install a copy of this HTML reference on your local harddrive, as this will
give you the quickest browser response.


PROGRAMMING LANGUAGES
---------------------

Netica API is available for programming in Java, Visual Basic, C and C++.
For more information on Netica API for different languages, see the
Norsys web site.


FUTURE VERSIONS
---------------

Your purchase price includes all version 2.xx releases of Netica, so your 
license password will work on all of them.  They may be downloaded from 
the Norsys web site.


SPECIAL BUILDS
--------------

Versions of the Netica API library built with different options,
or for different compilers or operating systems, may be purchased from 
Norsys.  Contact Norsys with your request.


PROBLEMS
--------

If you have problems, contact Norsys at:    support@norsys.com


Norsys Software Corp.
www.norsys.com


