FisPro: Fuzzy Inference System Design and Learning
==================================================

This is FisPro, a software for designing interpretable fuzzy inference systems from expert knowledge and data.

This software is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

Availability
============
This is FisPro version 3.5. FisPro is distributed under the Cecil
Licence, available on line at http://www.cecill.info/licences/Licence_CeCILL_V2-en.html.
FisPro uses GSL, the GNU Scientific Library.
GSL is open source software, you can redistribute it and/or modify it under
the terms of the License included in the distribution.

Installation
============

A Win32 binary of FisPro is available, as well as several binary pre-compiled packages for many Linux distributions, as rpm or debian packages.
These packages were built using the OpenSuse on line build service, and they are available at:

http://download.opensuse.org/repositories/home:/mistea/
 
If there is no available binary package for your distribution of Linux, or to use FisPro on Unix,  the C++ sources will have to be compiled to create the shared library needed by the Java interface. The java interface is distributed as a jar file, usable on any platform with a java virtual machine (jvm) >= 1.6.

See the INSTALL file for instructions. 
See the README-building-MacOSX for installing on a MacOs X computer.

Documentation
=============
FisPro has an integrated help system, including a quickstart guide, a reference manual and an introductory manual to learning with FisPro. The programmer documentation is available on FisPro web site.

Data
====
The DATA subdirectory contains sample data, configuration files and a sample script to try out FisPro.

Working directory
================
1- The first time FisPro is run after installation, a .fispro directory is created in the user home directory, to hold the configuration files. 

2- FisPro interface also creates files at runtime, as documented in the help system. These files are created in the directory where data files are selected from. If no data file is opened in the FisPro interface , the runtime files will be created in the FisPro bin directory for Windows users.
For Linux/Unix users, they will be created in the user HOME directory if FisPro is run from a menu or a desktop shortcut, and in the current directory if FisPro is run from a terminal. 

3- The C++ binaries create files in the directory they are run from.

Learning
========

The EXAMPLES subdirectory (help/en/learning/EXAMPLES) contains result files corresponding to the FisPro learning documentation.

Bug Report
==========
Please report bugs to 

fispro@supagro.inra.fr

Known Problems
==============
1-FisPro is available in four languages: English, French, Spanish and Portuguese (from Brasil), but Spanish and portuguese helps are not available yet. 
In the main window, select the English language Option to consult help files in English.

2-In case of trouble, test the FisPro installation by running the steps described in the TEST file, and follow the advices given in that file. Common problems are due to the decimal separator choice (. or ,) and to java3d.

Web Site
========
Detailed information and update is available on the FisPro website
http://www.inra.fr/bia/M/fispro/
