PREREQUISITES
-------------

- Linux
- C and C++ API 
  * GCC
  * glpk-4.49 (http://www.gnu.org/software/glpk/#introduction), a package 
intended for solving large-scale linear programming (LP), mixed integer 
programming (MIP), and other related problems
  * ARMADILLO 3.4.3 (http://sourceforge.net/projects/arma/files/), a C++ 
linear algebra library
  * nlopt-2.3 (http://ab-initio.mit.edu/wiki/index.php/NLopt), a library 
for non-linear optimization

- Matlab (for visualize the analysis results)
  * requires the PLOTREGION function
	http://www.mathworks.com/matlabcentral/fileexchange/9261






Compiling the library NLTOOLBOX
-----------------------------

Uncompressing the archive "NLToolBox.1.0.zip" will create a directory, 
called NLToolBox.

1. In a console, type "cd NLToolBox.1.0"
2. Open the file "Makefile" in an editor, then define the parameters 
specifying the locations of the libraries required by NLTOOLBOX
3. Type "make && make lib", which will create the library "libnltoolbox.a"



Using the library NLTOOLBOX
-----------------------------

Uncompressing the archive "nltoolbox.zip" will create a directory, called 
NLToolBox_Examples that contains two example programs illustrating how to 
use NLToolBox. To compile and run these programs,
1. Open the file "Makefile" in an editor, then define the parameters 
specifying the locations of the required libraries.
2. Type "make all"
3. To run, type "./example1" (or "./example2"). 
When the execution terminates, one can visualize the results by executing the 
generated file "dictyos_hybridi_x4x6.m" (or "dictyos_bern_x4x6.m") in MATLAB 
(the program "plotregion" should be installed in the same directory). It is 
important to note that the locations of all the libraries needed to be 
specified in LD_LIBRARY_PATH