Library to perform explainable AI using fuzzy logic.
Project description
Ex-Fuzzy
ex-Fuzzy is a fuzzy toolbox library for Python with special focus in its accesibility to use and visualization of results. In this way, we focus on the ex(-Fuzzy)plainable capacities of approximate reasoning.
Some of the tools available in this library include:
- Support for approximate reasoning using fuzzy association rules, for both classification and regression problems. This includes rule base optimization using genetic algorithms and rule visualization.
- Precomputed and optimized fuzzy variables and their correspondent linguistic variables (i.e low, medium, high).
- Support for various kinds of fuzzy sets, including classic fuzzy sets, IV-fuzzy sets and General Type 2 fuzzy sets.
Main Characteristics
Easy to use
ex-Fuzzy is designed to be easy to use. Linguistic variables can be precomputed and optimized without any understading of its implementation. Choosing one kind of fuzzy set only requires to set one flag.
Reusable code
Code is designed so that some parts can be easily extendable, so that some use cases, like research, can be also supported. The rule base optimization is done using a Genetic Algorithm, but almost any other pymoo search algorithm will do. Fuzzy sets can be extended with ease, just as the kind of partitions, membership functions, etc.
Sci-py like interface
ex-Fuzzy is built taking into account the actual machine-learing frameworks used in Python. Training amd sing a rule base classifier works exactly as sci-kit learn classifier. Parameters such as the number of rules or antecedents are also built
Visualization
Use plots to visualize any kind of fuzzy sets, and use graphs to visualize rules or print them on screen.
Dependencies
- Numpy
- Pandas
- Matplotlib
- Networkx
- Pymoo
Installation
You can install ex-Fuzzy using pip, from the PyPi repository, with the following command:
pip install ex-fuzzy
Home Page
Find all the information about ex-fuzzy in the github repository page:
https://github.com/Fuminides/ex-fuzzy
Try the demos
The Demos folder contains a series of demos to try different features of the ex-fuzzy library. These are presented in two different formats: jupyter notebooks and python modules, which are stored under the demos_module folder. You dont need to install the library to execute them.
The list of demos is the following:
- iris_demo: shows a simple classification example. It shows how to train a classifier, how to save checkpoints, how to show the rules in latex tabular format and to save them into a text file.
- iris_demo_custom_loss: a classification example where the predefined loss is changed by other function.
- iris_demo_persistence: a classification example where the rules are saved into a file and then imported for another classifier.
- precandidate_rules_demo: a classification example where we first fit a fuzzy classifier as usual, and then, we look for the optimal subset of those rules.
- regression_demo: an example of a regression problem using inerval-type 2 fuzzy sets.
- occupancy_demo_temporal: an example of the use of temporal fuzzy sets.
Contributors
Javier Fumanal Idocin, Javier Andreu-Perez
All rights reserved, 2021-2024
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.