=========
Examples
=========

Welcome to the Ex-Fuzzy examples gallery! Here you'll find practical examples demonstrating how to use Ex-Fuzzy for various machine learning tasks.

.. grid:: 1
    :gutter: 3

    .. grid-item-card:: 🌸 Classification Examples
        :link: classification
        :link-type: doc

        Learn fuzzy classification with practical examples using the Iris dataset and other scenarios.

.. toctree::
   :maxdepth: 2
   :hidden:

   classification

Working Examples
===============

The Ex-Fuzzy repository includes several working Jupyter notebooks. You can run these examples directly in Google Colab:

.. list-table:: Interactive Examples
   :header-rows: 1
   :widths: 30 50 20

   * - Topic
     - Description
     - Colab Link
   * - **Basic Classification**
     - Introduction to fuzzy classification with the Iris dataset
     - `Open in Colab <https://drive.google.com/file/d/1nEIcHEH-FqhJWK-ngPew_gqe82n1Dr2v/view?usp=sharing>`_
   * - **Custom Loss Functions**
     - Advanced optimization techniques
     - `Open in Colab <https://drive.google.com/file/d/1ciajhHTK0PACgT2bGdfpcisCL8MRgiHa/view?usp=sharing>`_
   * - **Rule File Loading**
     - Working with text-based rule files
     - `Open in Colab <https://drive.google.com/file/d/1vNAXfQDnLOdTktQ1gyrtEKwjSmNIlSUc/view?usp=sharing>`_
   * - **Advanced Rules**
     - Using pre-computed rule populations
     - `Open in Colab <https://drive.google.com/file/d/1jsjCcBDR9ZE-qEOJcCYCHmtNmwdrYvPh/view?usp=sharing>`_
   * - **Temporal Fuzzy Sets**
     - Time-aware fuzzy reasoning
     - `Open in Colab <https://drive.google.com/file/d/1J6T44KBIOdY06BbsO8AvE-X3gRohohIR/view?usp=sharing>`_
   * - **Rule Mining**
     - Automatic rule discovery
     - `Open in Colab <https://drive.google.com/file/d/1qWlL-A_B21FpdtplMDHzg1M7r5tjbN6g/view?usp=sharing>`_

Local Examples
=============

The repository also contains local Jupyter notebooks in the `Demos/` directory:

- **iris_demo.ipynb**: Basic classification with the Iris dataset
- **iris_demo_advanced_classifiers.ipynb**: Comparison of different classifier types
- **iris_demo_persistence.ipynb**: Saving and loading trained models
- **heart_attack.ipynb**: Medical diagnosis classification
- **occupancy_demo_temporal.ipynb**: Time-series occupancy detection
- **regression_demo.ipynb**: Fuzzy regression examples
- **pattern_analysis_demo.ipynb**: Pattern stability analysis

These notebooks provide complete, working examples that demonstrate real-world applications of the ex-fuzzy library.
   financial-risk-assessment
   image-classification
   time-series-prediction

Domain-Specific Examples
========================

.. toctree::
   :maxdepth: 1

   bioinformatics
   environmental-monitoring
   quality-control
   recommendation-systems

Interactive Notebooks
=====================

All examples are available as interactive Jupyter notebooks:

- 📓 Download Notebooks or use Colab with previous links.
- `🏗️ Open in Binder <https://mybinder.org/v2/gh/Fuminides/ex-fuzzy/HEAD?urlpath=%2Fdoc%2Ftree%2FDemos>`_

Example Categories
==================

**Beginner Examples**
  - Basic iris classification
  - Simple pattern analysis
  - Visualization basics

**Intermediate Examples**  
  - Custom fuzzy sets
  - Multi-objective optimization
  - Performance comparison

**Advanced Examples**
  - Large-scale datasets
  - Real-time inference
  - Integration with other ML libraries

Contributing Examples
=====================

We welcome contributions of new examples! If you have an interesting use case or application of Ex-Fuzzy:

1. Create a clear, well-documented notebook
2. Include explanations and visualizations  
3. Test with sample data
4. Submit a pull request

See our :doc:`../contributing` guide for more details.