# naforoutan/relafis architecture

> Architecture diagram of the GitHub repository naforoutan/relafis, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/naforoutan/relafis
- Repository: https://github.com/naforoutan/relafis

## Overview

ReLaFIS is a differentiable neuro-fuzzy classification framework. The principal workflow takes feature vectors through learned relational fuzzy terms, forms and normalizes rule activations, then produces class logits and a reconstruction used by an auxiliary loss. The repository also contains related neuro-fuzzy model implementations, dataset adapters, and a shared linguistic-richness/ARE utility. The README documents capabilities beyond the excerpts; those are represented where their implementation path is supported. Unsampled dataset-adapter wiring is not inferred.

Main entry points: [`model/ReLaFIS.py`](https://github.com/naforoutan/relafis/blob/main/model/ReLaFIS.py) (GIFT relations), [`utils/linguistic_richness.py`](https://github.com/naforoutan/relafis/blob/main/utils/linguistic_richness.py) (ARE and richness), [`model/litanfis.py`](https://github.com/naforoutan/relafis/blob/main/model/litanfis.py) (LitANFIS model), [`model/griffin.py`](https://github.com/naforoutan/relafis/blob/main/model/griffin.py) (GRIFFIN model)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_relafis["ReLaFIS inference"]
  node_gift["GIFT relations<br/>[ReLaFIS.py]"]
  node_activations["Rule activations<br/>[ReLaFIS.py]"]
  node_reconstruction["Input reconstruction<br/>[ReLaFIS.py]"]
  node_consequents["Local consequents<br/>[ReLaFIS.py]"]
  node_prediction["Class logits<br/>[ReLaFIS.py]"]
end

subgraph group_alternatives["Related models"]
  node_anfis["ANFIS baseline<br/>[anfis.py]"]
  node_unfis["UNFIS model<br/>[unfis.py]"]
  node_litanfis["LitANFIS model<br/>[litanfis.py]"]
  node_griffin["GRIFFIN model<br/>[griffin.py]"]
end

subgraph group_analysis["Linguistic analysis"]
  node_are["ARE and richness"]
end

subgraph group_experiments["Experiment support"]
  node_datasets["Dataset adapters"]
end

node_user(("Feature input"))

node_user -->|"provides features"| node_gift
node_gift -->|"forms rules"| node_activations
node_activations -->|"reconstructs input"| node_reconstruction
node_activations -->|"weights consequents"| node_consequents
node_consequents -->|"produces logits"| node_prediction
node_gift -->|"measures relations"| node_are
node_litanfis -->|"uses categories"| node_are
node_griffin -->|"uses categories"| node_are

click node_gift "https://github.com/naforoutan/relafis/blob/main/model/ReLaFIS.py"
click node_activations "https://github.com/naforoutan/relafis/blob/main/model/ReLaFIS.py"
click node_reconstruction "https://github.com/naforoutan/relafis/blob/main/model/ReLaFIS.py"
click node_consequents "https://github.com/naforoutan/relafis/blob/main/model/ReLaFIS.py"
click node_prediction "https://github.com/naforoutan/relafis/blob/main/model/ReLaFIS.py"
click node_anfis "https://github.com/naforoutan/relafis/blob/main/model/anfis.py"
click node_unfis "https://github.com/naforoutan/relafis/blob/main/model/unfis.py"
click node_litanfis "https://github.com/naforoutan/relafis/blob/main/model/litanfis.py"
click node_griffin "https://github.com/naforoutan/relafis/blob/main/model/griffin.py"
click node_are "https://github.com/naforoutan/relafis/blob/main/utils/linguistic_richness.py"
click node_datasets "https://github.com/naforoutan/relafis/tree/main/tests"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_gift,node_activations,node_reconstruction,node_consequents,node_prediction toneBlue
class node_anfis,node_unfis,node_litanfis,node_griffin toneAmber
class node_are toneMint
class node_datasets toneRose
class node_user toneIndigo
```

## Components

### ReLaFIS inference

- [GIFT relations](https://github.com/naforoutan/relafis/blob/main/model/ReLaFIS.py): `model/ReLaFIS.py`
- [Rule activations](https://github.com/naforoutan/relafis/blob/main/model/ReLaFIS.py): `model/ReLaFIS.py`
- [Input reconstruction](https://github.com/naforoutan/relafis/blob/main/model/ReLaFIS.py): `model/ReLaFIS.py`
- [Local consequents](https://github.com/naforoutan/relafis/blob/main/model/ReLaFIS.py): `model/ReLaFIS.py`
- [Class logits](https://github.com/naforoutan/relafis/blob/main/model/ReLaFIS.py): `model/ReLaFIS.py`

### Related models

- [ANFIS baseline](https://github.com/naforoutan/relafis/blob/main/model/anfis.py): `model/anfis.py`
- [UNFIS model](https://github.com/naforoutan/relafis/blob/main/model/unfis.py): `model/unfis.py`
- [LitANFIS model](https://github.com/naforoutan/relafis/blob/main/model/litanfis.py): `model/litanfis.py`
- [GRIFFIN model](https://github.com/naforoutan/relafis/blob/main/model/griffin.py): `model/griffin.py`

### Linguistic analysis

- [ARE and richness](https://github.com/naforoutan/relafis/blob/main/utils/linguistic_richness.py): `utils/linguistic_richness.py`

### Experiment support

- [Dataset adapters](https://github.com/naforoutan/relafis/tree/main/tests): `tests`

### Other components

- **Feature input**

## Connections

- Feature input → GIFT relations: provides features (evidence: `README.md`)
- GIFT relations → Rule activations: forms rules (evidence: `model/ReLaFIS.py`)
- Rule activations → Input reconstruction: reconstructs input (evidence: `model/ReLaFIS.py`)
- Rule activations → Local consequents: weights consequents (evidence: `model/ReLaFIS.py`)
- Local consequents → Class logits: produces logits (evidence: `model/ReLaFIS.py`)
- GIFT relations → ARE and richness: measures relations (evidence: `model/ReLaFIS.py`)
- LitANFIS model → ARE and richness: uses categories (evidence: `model/litanfis.py`)
- GRIFFIN model → ARE and richness: uses categories (evidence: `model/griffin.py`)
