
              Netica API Install for Mac OSX, version 2.15
              --------------------------------------------

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

libnetica.a --------------- The Netica library (binary file)
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.

Build Details
-------------
  This version of the Netica API for Mac OSX was built using Apple's
gcc-934.3 (which is based on gcc 2.95.2).


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

To check your installation, it is best to first get the program Demo.c
working.  First, you may need to run ranlib on your copy of libnetica.a.
(It would seem that you need to run ranlib like this, every time you move
libnetica.a to a new directory.  This has to do with ensuring the file's
date/time stamp matches the librarie internal date/time stamp.)

    ranlib libnetica.a

Next, compile Demo.c and NeticaEx.c:

    gcc -c NeticaEx.c Demo.c

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

Finally, link them all together with Netica and the Standard C math library
to create an executable program called netdemo:

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

The -L. means tlook for libraries in the current directory (as well as the 
system library directory), the -lnetica means link in libnetica.a, and the 
-lm means link in libm.a (the math library).

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



