# inteligenciaia1021-ai/leakage-lab architecture

> Architecture diagram of the GitHub repository inteligenciaia1021-ai/leakage-lab, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-18). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/inteligenciaia1021-ai/leakage-lab
- Repository: https://github.com/inteligenciaia1021-ai/leakage-lab

## Overview

Leakage Lab demonstrates how feature selection before cross-validation inflates scores on random data, contrasts it with selection inside a cross-validation pipeline, repeats both experiments, and presents the saved results in a web page. The source excerpts show the experiment and browser data flow; the README documents the page and result format. The HTML implementation was not sampled, so its wiring is not inferred.

Main entry points: [`src/experimento.py`](https://github.com/inteligenciaia1021-ai/leakage-lab/blob/main/src/experimento.py) (Experiment runner), [`src/aula2.py`](https://github.com/inteligenciaia1021-ai/leakage-lab/blob/main/src/aula2.py) (Leakage comparison demo), [`site/index.html`](https://github.com/inteligenciaia1021-ai/leakage-lab/blob/main/site/index.html) (Results page), [`site/app.js`](https://github.com/inteligenciaia1021-ai/leakage-lab/blob/main/site/app.js) (Page script)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experiment["Experiment"]
  node_runner["Experiment runner<br/>[experimento.py]"]
  node_synthetic["Synthetic data<br/>[experimento.py]"]
  node_leaky["Leaky selection<br/>[experimento.py]"]
  node_safe["Fold-local pipeline<br/>[experimento.py]"]
  node_scoring["Cross-validation scores<br/>[experimento.py]"]
  node_summary["Score summaries<br/>[experimento.py]"]
end

subgraph group_results["Results presentation"]
  node_resultfile["Results JSON<br/>[resultados.json]"]
  node_page["Results page<br/>[index.html]"]
  node_browser["Page script<br/>[app.js]"]
end

subgraph group_lessons["Teaching examples"]
  node_intro["Train-test demo<br/>[aula1.py]"]
  node_comparison["Leakage comparison demo<br/>[aula2.py]"]
end

node_reader(("Page reader"))

node_runner -->|"generates data"| node_synthetic
node_runner -->|"runs"| node_leaky
node_runner -->|"runs"| node_safe
node_leaky -->|"scores selected data"| node_scoring
node_safe -->|"scores pipeline"| node_scoring
node_runner -->|"summarizes scores"| node_summary
node_runner -->|"writes results"| node_resultfile
node_reader -.->|"opens"| node_page
node_page -.->|"loads script"| node_browser
node_browser -->|"fetches results"| node_resultfile
node_intro -->|"generates data"| node_synthetic
node_comparison -->|"demonstrates"| node_leaky
node_comparison -->|"demonstrates"| node_safe

click node_runner "https://github.com/inteligenciaia1021-ai/leakage-lab/blob/main/src/experimento.py"
click node_synthetic "https://github.com/inteligenciaia1021-ai/leakage-lab/blob/main/src/experimento.py"
click node_leaky "https://github.com/inteligenciaia1021-ai/leakage-lab/blob/main/src/experimento.py"
click node_safe "https://github.com/inteligenciaia1021-ai/leakage-lab/blob/main/src/experimento.py"
click node_scoring "https://github.com/inteligenciaia1021-ai/leakage-lab/blob/main/src/experimento.py"
click node_summary "https://github.com/inteligenciaia1021-ai/leakage-lab/blob/main/src/experimento.py"
click node_resultfile "https://github.com/inteligenciaia1021-ai/leakage-lab/blob/main/site/resultados.json"
click node_page "https://github.com/inteligenciaia1021-ai/leakage-lab/blob/main/site/index.html"
click node_browser "https://github.com/inteligenciaia1021-ai/leakage-lab/blob/main/site/app.js"
click node_intro "https://github.com/inteligenciaia1021-ai/leakage-lab/blob/main/src/aula1.py"
click node_comparison "https://github.com/inteligenciaia1021-ai/leakage-lab/blob/main/src/aula2.py"

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_runner,node_synthetic,node_leaky,node_safe,node_scoring,node_summary toneBlue
class node_resultfile,node_page,node_browser toneAmber
class node_intro,node_comparison toneMint
class node_reader toneIndigo
```

## Components

### Experiment

- [Experiment runner](https://github.com/inteligenciaia1021-ai/leakage-lab/blob/main/src/experimento.py): `src/experimento.py`
- [Synthetic data](https://github.com/inteligenciaia1021-ai/leakage-lab/blob/main/src/experimento.py): `src/experimento.py`
- [Leaky selection](https://github.com/inteligenciaia1021-ai/leakage-lab/blob/main/src/experimento.py): `src/experimento.py`
- [Fold-local pipeline](https://github.com/inteligenciaia1021-ai/leakage-lab/blob/main/src/experimento.py): `src/experimento.py`
- [Cross-validation scores](https://github.com/inteligenciaia1021-ai/leakage-lab/blob/main/src/experimento.py): `src/experimento.py`
- [Score summaries](https://github.com/inteligenciaia1021-ai/leakage-lab/blob/main/src/experimento.py): `src/experimento.py`

### Results presentation

- [Results JSON](https://github.com/inteligenciaia1021-ai/leakage-lab/blob/main/site/resultados.json): `site/resultados.json`
- [Results page](https://github.com/inteligenciaia1021-ai/leakage-lab/blob/main/site/index.html): `site/index.html`
- [Page script](https://github.com/inteligenciaia1021-ai/leakage-lab/blob/main/site/app.js): `site/app.js`

### Teaching examples

- [Train-test demo](https://github.com/inteligenciaia1021-ai/leakage-lab/blob/main/src/aula1.py): `src/aula1.py`
- [Leakage comparison demo](https://github.com/inteligenciaia1021-ai/leakage-lab/blob/main/src/aula2.py): `src/aula2.py`

### Other components

- **Page reader**

## Connections

- Experiment runner → Synthetic data: generates data (evidence: `src/experimento.py`)
- Experiment runner → Leaky selection: runs (evidence: `src/experimento.py`)
- Experiment runner → Fold-local pipeline: runs (evidence: `src/experimento.py`)
- Leaky selection → Cross-validation scores: scores selected data (evidence: `src/experimento.py`)
- Fold-local pipeline → Cross-validation scores: scores pipeline (evidence: `src/experimento.py`)
- Experiment runner → Score summaries: summarizes scores (evidence: `src/experimento.py`)
- Experiment runner → Results JSON: writes results (evidence: `src/experimento.py`)
- Page reader → Results page: opens
- Results page → Page script: loads script
- Page script → Results JSON: fetches results (evidence: `site/app.js`)
- Train-test demo → Synthetic data: generates data (evidence: `src/aula1.py`)
- Leakage comparison demo → Leaky selection: demonstrates (evidence: `src/aula2.py`)
- Leakage comparison demo → Fold-local pipeline: demonstrates (evidence: `src/aula2.py`)
