                                  Netica-C API for iOS
                                  ====================
                                  Netica Version: 5.04
					
   	                     Release Date:  October 25, 2012




LICENSE AGREEMENT
-----------------
Before using Netica, make sure you accept the license agreement,
which is included with this package.  If not, return Netica unused for a refund.


MANUAL and ONSCREEN HELP
------------------------
For Netica-C API issues, please use the standard manual and documentation provided
in the doc/ directory of this distribution.
 

BUILD DETAILS
-------------
Built on iOS 10.8 (Mountain Lion).
For the simulator, libnetica386.a was built with gcc 4.2.1
For ARM devices, libnetica_armv6. and libnetica_armv7.a were built with clang 4.1


INSTALL INSTRUCTIONS
--------------------
Note: In order to develop on the iOS Simulator, you or your organization does not need to be a registered
Apple iOS Developer person/site.   However, to test with a real device, you will need to register.
Please refer to the Apple iOS Developer documentation.

A. iOS Simulator
----------------
1. Install Xcode 4.5 or later
2. Using the Apple File Manager, navigate to the projects/NeticaIOSDemo_for_Simulator/ folder and click on NeticaIOSDemo.xcodeproj.
   This will load the project into Xcode.
3. Within Xcode, display the "Project Navigator" pane, if it is not already displayed.  It should have the project
   name (NeticaIOSDemo) at the top, followed by dependent libraries, source files, etc.
4. Correct the reference to libnetica386.a (which should displayed in red) by first deleting that file from the build (right-button-click=>Delete) and add a reference to the lib/libnetica386.a included in this archive.
5. Likewise, refresh the reference to libstc++.dylib.  You may find the i386 version of this library in /usr/lib.
6. Likewise, refresh the reference to the src/ directory so that it correctly points to the src/ directory in this archive.
7. Edit MyLib.c and replace the path to ChestClinic.dne by the correct path on your filesystem.
8. Probably it is a good idea to do a "make-clean" (Product=>Clean).
9. Click on the Xcode "Run" button.  After a minute, the iOS Simulator should display along with the Netica
   Demo app.  Click on the "Run Netica Demo" button.  The demo program reads ChestClinic.dne,
   does some inferences, and displays the results.

B. iOS Device (iPhone, iPad, etc.)
----------------------------------
1. Install Xcode 4.5 or later
2. Using the Apple File Manager, navigate to the projects/NeticaIOSDemo_for_iPad/ folder and click on NeticaIOSDemo.xcodeproj.
   This will load the project into Xcode.
3. Within Xcode, display the "Project Navigator" pane, if it is not already displayed.  It should have the project
   name (NeticaIOSDemo) at the top, followed by dependent libraries, source files, etc.                                      
4. Correct the reference to libnetica_armv7.a (which should displayed in red) by first deleting that file from the build
   (right-button-click=>Delete) and add a reference to the lib/libnetica_armv7.a (or ..v6.a, if you have an older iOS device, or arm64.a, if you want to restrict your App to the newer 64bit devices)
   included in this archive.                   
5. Likewise, refresh the reference to libstc++.dylib.  You may find the arm version of this library at:
   /Applications/Xcode.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS6.0.sdk/usr/lib/libstdc++.dylib
   If it is not there, try using the UNIX "locate" command to find it.
6. Likewise, refresh the reference to the src/ directory so that it correctly points to the src/ directory in this archive.
7. Provision your iOS device for the NeticaIOSDemo app.  How to provision your device is beyond the scope of this help file.
   It can be a frustrating process for first time Apple iOS developers.  Please refer to the documentation at the Apple iOS Developer
   website for how to do this.  
8. Using the Xcode "Organizer" (Window->Organizer), upload the the test/ directory (which contains ChestClinic.dne) into
   the sandbox of the NeticaIOSDemo app.  For me, this step created the test/ directory at the same level of the Documents/
   directory as displayed in the Organizer.  You may wish to place it in another Apple sanctioned directory, as desired,
   but you will then need to modify ViewController.m and MyLib.c accordingly.
9. Probably it is a good idea to do a "make-clean" (Product=>Clean).
10. Click on the Xcode "Run" button.  After a few seconds, your iOS device should load the Netica            
   Demo app.  Click on the "Run Netica Demo" button.  The demo program copies test/ from the sandbox to the Documents/ directory,
   reads ChestClinic.dne, does some inferences, and displays the results.  


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

Norsys Software Corp.
www.norsys.com

==================================================================================                                                                                                                   
                                 
