Pablo/FuzzyLibrary

This is the top-level directory for the Pablo fuzzy logic library release,
distributed as part of the Autopilot component of the Pablo Performance
Analysis Environment.  The Autopilot toolkit provides a flexible set of 
performance sensors, decision procedures, and policy actuators to realize 
adaptive control of application and resource management policies in a 
distributed environment.

Autopilot sensors provide a stream of information that can be used as input to
Autopilot fuzzy logic decision servers which select new policies and enact 
them via Autopilot actuators.   The Autopilot fuzzy logic decision 
infrastructure utilizes a fuzzy rules to C++ translator from the ComNets Class 
Library to generate the C++ classes used by the decision processes from 
text format fuzzy rule base files written by the user.   The generated C++ 
classes are integrated into the Autopilot decision servers through the 
ApDecisionProcedure class and methods.

The code contained in this distribution is the subset of the ComNets Class 
Library (CNCL) used by the Autopilot decision procedures.  The entire CNCL
library is available from:

       o http://www.comnets.rwth-aachen.de/doc/cncl.html 
       o ftp://ftp.comnets.rwth-aachen.de/pub6/comnets/CNCL/ 

The file "CNCL.README" is the README file from the CNCL distribution.
The file "CNCL.LICENSE" is the GNU LIBRARY GENERAL PUBLIC LICENSE included
with the CNCL distribution.
   
------------------------------------------------------------------------------

Targeted Platforms: 
        Unix (Linux, Solaris, SGI) 

Software/Hardware Requirements: 
        C++ compiler with IOstreams library, GNU bison and flex 

Documentation:
	The "Doc/html" directory contains manual pages for the fuzzy
	library classes in HTML format. You can view these files
	with a browser starting with the file fuzzylib_toc.html.

        The original CNCL library does not provide any form of 
        documentation for the fuzzy rules to C++ translator.
	This translator, named FuzzyLibFRC in this distribution, is a
	utility that generates fuzzy rule base (FlFRuleBase) C++
	classes from rule base files written in text form. The only
	documentation available about the syntax of these rule base 
	files are the original parser definition files "fuzzylex.l" and
	"fuzzyparse.y" in the FuzzyLibFRC source directory. 

	An application that shows sample rule base files is provided 
        with the main Autopilot distribution. 

Building the library:
	Edit the file "Makefile.defines" in this directory to set site-specific
        parameters.   After this file has been edited, type
	 	gnumake
        to build the library and executable and
		gnumake install
	to install them in the directories you specified in Makefile.defines.

Contacting the Pablo Autopilot group:
 
	Comments and questions can be emailed to:
         	autopilot-support@cs.uiuc.edu
          
	General information about the Pablo Research Group is available 
	through our web site:
         	http://www-pablo.cs.uiuc.edu
                   
Thanks for your interest in Autopilot!

