# vitormgou/fdipa-ann architecture

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

- Interactive diagram: https://gitdiagram.com/vitormgou/fdipa-ann
- Repository: https://github.com/vitormgou/fdipa-ann

## Overview

##### Project type and purpose
- This is a research-oriented analytical pipeline for a dissertation (“Algoritmo Dissertação”).
- It uses Jupyter notebooks to run experiments with variations of an algorithm (SGD, step‐size η, number of iterations, radius) and then produces CSV tables and plots.

##### File structure
Top-level items:
- FDIPA_com_DE.ipynb – main experiment notebook that implements the core algorithm
- filtragem_resultados.ipynb – notebook for filtering and post-processing raw results
- Untitled-1.ipynb – likely exploratory or auxiliary analysis
- plot_style.txt – shared plotting style definitions
Directories:
- TabelasSGD, TabelasVariacaoEta, TabelasVariacaoIteracao, TabelasVariacaoRaio
- each contains CSVs: acuracia_treino, acuracia_teste, norma_peso, perda_treino, perda_teste
- Plots_SGD, Plots_VariacaoEta, Plots_VariacaoIteracao, Plots_VariacaoRaio
- each will contain the charts generated from the corresponding tables

##### README for additional insights
- The README is minimal, only stating the high-level project name.
- We infer from file names that the focus is on comparing algorithmic hyperparameters and reporting training/test metrics.

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Notebooks
    ER["Experiment Runner Notebook"]:::notebook
    RF["Result Filter Notebook"]:::notebook
    AUX["Auxiliary Analysis Notebook"]:::notebook
    CFG["plot_style.txt"]:::config

    %% Variation Subgraphs
    subgraph "SGD Variation"
        direction TB
        TSGD["TabelasSGD/"]:::data
        PSGD["Plots_SGD/"]:::plot
    end

    subgraph "Variação η"
        direction TB
        TETA["TabelasVariacaoEta/"]:::data
        PETA["Plots_VariacaoEta/"]:::plot
    end

    subgraph "Variação Iteração"
        direction TB
        TITE["TabelasVariacaoIteracao/"]:::data
        PITE["Plots_VariacaoIteracao/"]:::plot
    end

    subgraph "Variação Raio"
        direction TB
        TRAI["TabelasVariacaoRaio/"]:::data
        PRAI["Plots_VariacaoRaio/"]:::plot
    end

    %% Main Flow
    ER -->|"runs experiments"| RF
    RF -->|"writes tables"| TSGD
    RF -->|"writes tables"| TETA
    RF -->|"writes tables"| TITE
    RF -->|"writes tables"| TRAI

    TSGD -->|"generates plots"| PSGD
    TETA -->|"generates plots"| PETA
    TITE -->|"generates plots"| PITE
    TRAI -->|"generates plots"| PRAI

    %% Shared references
    ER -->|"uses style"| CFG
    RF -->|"uses style"| CFG
    AUX -->|"uses style"| CFG
    AUX -->|"exploratory analyses"| TSGD
    AUX -->|"exploratory analyses"| PSGD

    %% Click Events
    click ER "https://github.com/vitormgou/fdipa-ann/blob/main/FDIPA_com_DE.ipynb"
    click RF "https://github.com/vitormgou/fdipa-ann/blob/main/filtragem_resultados.ipynb"
    click AUX "https://github.com/vitormgou/fdipa-ann/blob/main/Untitled-1.ipynb"
    click CFG "https://github.com/vitormgou/fdipa-ann/blob/main/plot_style.txt"
    click TSGD "https://github.com/vitormgou/fdipa-ann/tree/main/TabelasSGD/"
    click TETA "https://github.com/vitormgou/fdipa-ann/tree/main/TabelasVariacaoEta/"
    click TITE "https://github.com/vitormgou/fdipa-ann/tree/main/TabelasVariacaoIteracao/"
    click TRAI "https://github.com/vitormgou/fdipa-ann/tree/main/TabelasVariacaoRaio/"
    click PSGD "https://github.com/vitormgou/fdipa-ann/tree/main/Plots_SGD/"
    click PETA "https://github.com/vitormgou/fdipa-ann/tree/main/Plots_VariacaoEta/"
    click PITE "https://github.com/vitormgou/fdipa-ann/tree/main/Plots_VariacaoIteracao/"
    click PRAI "https://github.com/vitormgou/fdipa-ann/tree/main/Plots_VariacaoRaio/"

    %% Styles
    classDef notebook fill:#ADD8E6,stroke:#333,stroke-width:1px;
    classDef data fill:#D3D3D3,stroke:#333,stroke-width:1px;
    classDef plot fill:#90EE90,stroke:#333,stroke-width:1px;
    classDef config fill:#FFFACD,stroke:#333,stroke-width:1px;
```
