Version: 0.5 Date: Aug 01, 2025

Zuffy - Fuzzy Pattern Trees induced by Genetic Programming

An Open Source sci-kit compatible classifier.

This package is part of an academic research exercise and it is designed to help a Machine Learning developer to explore Fuzzy Pattern Trees (FPT).

FPTs are models that have high explainability and they help the researcher explore a dataset where vague or ambiguous data may be present.

This kit will analyse a dataset and fuzzify the input features to generate a collection of fuzzy sets. These sets become new features which are combined with fuzzy operators to build a pattern tree.

The package uses Genetic Programming to induce the tree and it requires the SymbolicClassifer from the open source gplearn package to support the genetic evolution process.

Contents:

• Zuffy Classifier
  • ZuffyClassifier
    • ZuffyClassifier._parameter_constraints
    • ZuffyClassifier.default_function_set
    • ZuffyClassifier.fit()
    • ZuffyClassifier.predict()
    • ZuffyClassifier.predict_proba()
    • ZuffyClassifier.set_score_request()
• Zuffy Fit Iterator
  • ZuffyFitIterator
    • ZuffyFitIterator._parameter_constraints
    • ZuffyFitIterator._perform_single_fit_job()
    • ZuffyFitIterator._verbose_out()
    • ZuffyFitIterator.fit()
    • ZuffyFitIterator.get_best_class_accuracy()
    • ZuffyFitIterator.set_fit_request()
• Fuzzy Transformer
  • FuzzyTransformer
    • FuzzyTransformer._parameter_constraints
    • FuzzyTransformer._sklearn_auto_wrap_output_keys
    • FuzzyTransformer.fit()
    • FuzzyTransformer.transform()
  • convert_to_numeric()
  • trimf()
• Visuals
  • _add_importance()
  • _output_node()
  • graph_tree_class()
  • graphviz_tree()
  • plot_evolution()
  • plot_evolution_consolidated()
  • plot_iteration_performance()
  • sanitise_names()
  • show_feature_importance()
• Visual Color Assigments
  • ColorAssigner
    • ColorAssigner.get_color()
  • FeatureColorAssigner
    • FeatureColorAssigner._DEFAULT_FEATURE_COLORS
  • OperatorColorAssigner
    • OperatorColorAssigner._DEFAULT_OPERATOR_COLORS
• _fpt_operators
  • _complement()
  • _concentrator()
  • _concentrator_power()
  • _diffuser()
  • _diluter()
  • _diluter_power()
  • _fuzzy_and()
  • _fuzzy_or()
  • _generate_owa_operator()
  • _generate_wa_operator()
  • _hamacher_t_norm()
  • _if_gte()
  • _if_gte_else()
  • _if_lt()
  • _if_lt_else()
  • _intensifier()
  • _lukasiewicz_t_conorm()
  • _lukasiewicz_t_norm()
  • _maximum()
  • _minimum()
  • _ordered_weighted_average()
  • _product_t_norm()
  • _weighted_average()
• Sample Programs
  • Example 1 - Minimal
  • Example 2 - Categoricals
  • Example 3 - GridSearchCV
  • Example 4 - Pipeline
  • Example 5 - Full Visuals