# nahuelcedres/machine-learning-nahuel architecture

> Architecture diagram of the GitHub repository nahuelcedres/machine-learning-nahuel, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-08-14). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/nahuelcedres/machine-learning-nahuel
- Repository: https://github.com/nahuelcedres/machine-learning-nahuel

## Overview

##### Project type and purpose
- This is a personal data-science project portfolio containing two Jupyter-notebook analyses:
a. “Customer Clustering – No supervisado” (unsupervised learning / clustering)
b. “My Personal Movie DataSet – Supervisado” (supervised learning / classification or regression)
- Purpose: Showcase data ingestion, preprocessing, modeling, evaluation, and reporting in notebook form.

##### File structure
- Top-level:
- “Customer Clustering – No supervisado” directory
- “My Personal Movie DataSet – Supervisado” directory
- README.md (portfolio overview)
- Each project directory has:
- Raw data files (.csv, .xlsx)
- Jupyter notebooks (.ipynb)
- Generated HTML reports (.html)
- Checkpoint folders (.ipynb_checkpoints)

##### README for additional insights
- README.md simply states that this is a personal portfolio of projects and ideas.
- No detailed architecture notes, so rely on the folder structure and standard data-science workflow.

a. Main components:
1. Data Storage
– Raw data files (.csv, .xlsx)
2. Processing & Analysis
– Jupyter notebook environment
– Python libraries (e.g., pandas, scikit-learn, matplotlib)
3. Model Artifacts
– In-memory models (within notebooks)
– No persisted serialized models in this structure
4. Reporting
– HTML exports of notebooks
5. Version Control / Portfolio Layer
– README.md
– Folder hierarchy managed in Git
b. Relationships / interactions:
- Data files → loaded by notebooks
- Notebooks → perform preprocessing → modeling → evaluation
- Notebooks → export results to HTML
- README.md → links to each HTML report for presentation
c. Architectural patterns / design principles:
- Linear data-science pipeline: ingestion → transform → model → report
- Separation of concerns by directory/project
- Reproducibility via notebooks and data files co-located
d. Relevant technologies:
- Jupyter Notebook
- Python ecosystem (pandas, numpy, scikit-learn, seaborn/matplotlib)
- Excel/CSV data sources
- Markdown/HTML for report rendering

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Top-level portfolio README
    README["README.md"]:::docs

    %% Customer Clustering Project
    subgraph "Customer Clustering – No supervisado"
        direction TB
        CC_Data1["segmentation data.csv"]:::data
        CC_Data2["segmentation data legend.xlsx"]:::data
        CC_Ancillary["README.txt"]:::docs
        CC_Checkpoint[".ipynb_checkpoints/Customer Clustering - Project-checkpoint.ipynb"]:::docs
        CC_Notebook["Jupyter Notebook\npreprocessing → modeling → evaluation"]:::compute
        CC_Report["HTML Report"]:::report
    end

    %% My Personal Movie DataSet Project
    subgraph "My Personal Movie DataSet – Supervisado"
        direction TB
        MM_Data["data.xlsx"]:::data
        MM_Ancillary["context.txt"]:::docs
        MM_Checkpoint[".ipynb_checkpoints/My Personal Movies - Project-checkpoint.ipynb"]:::docs
        MM_Notebook["Jupyter Notebook\npreprocessing → modeling → evaluation"]:::compute
        MM_Report["HTML Report"]:::report
    end

    %% Connections for Customer Clustering
    CC_Data1 -->|"load data"| CC_Notebook
    CC_Data2 -->|"load data"| CC_Notebook
    CC_Notebook -->|"export report"| CC_Report

    %% Connections for My Personal Movie DataSet
    MM_Data -->|"load data"| MM_Notebook
    MM_Notebook -->|"export report"| MM_Report

    %% Portfolio README links to reports
    README -->|"link to report"| CC_Report
    README -->|"link to report"| MM_Report

    %% Click Events for Customer Clustering
    click README "https://github.com/nahuelcedres/machine-learning-nahuel/blob/main/README.md"
    click CC_Data1 "https://github.com/nahuelcedres/machine-learning-nahuel/blob/main/Customer Clustering - No supervisado/segmentation data.csv"
    click CC_Data2 "https://github.com/nahuelcedres/machine-learning-nahuel/blob/main/Customer Clustering - No supervisado/segmentation data legend.xlsx"
    click CC_Notebook "https://github.com/nahuelcedres/machine-learning-nahuel/blob/main/Customer Clustering - No supervisado/Customer Clustering - Project.ipynb"
    click CC_Report "https://github.com/nahuelcedres/machine-learning-nahuel/blob/main/Customer Clustering - No supervisado/Customer Clustering - Project (6).html"
    click CC_Ancillary "https://github.com/nahuelcedres/machine-learning-nahuel/blob/main/Customer Clustering - No supervisado/README.txt"
    click CC_Checkpoint "https://github.com/nahuelcedres/machine-learning-nahuel/blob/main/Customer Clustering - No supervisado/.ipynb_checkpoints/Customer Clustering - Project-checkpoint.ipynb"

    %% Click Events for My Personal Movie DataSet
    click MM_Data "https://github.com/nahuelcedres/machine-learning-nahuel/blob/main/My Personal Movie DataSet - Supervisado/data.xlsx"
    click MM_Notebook "https://github.com/nahuelcedres/machine-learning-nahuel/blob/main/My Personal Movie DataSet - Supervisado/My Personal Movies - Project.ipynb"
    click MM_Report "https://github.com/nahuelcedres/machine-learning-nahuel/blob/main/My Personal Movie DataSet - Supervisado/My Personal Movies - Project (14).html"
    click MM_Ancillary "https://github.com/nahuelcedres/machine-learning-nahuel/blob/main/My Personal Movie DataSet - Supervisado/context.txt"
    click MM_Checkpoint "https://github.com/nahuelcedres/machine-learning-nahuel/blob/main/My Personal Movie DataSet - Supervisado/.ipynb_checkpoints/My Personal Movies - Project-checkpoint.ipynb"

    %% Styles
    classDef data fill:#cce5ff,stroke:#339,stroke-width:2px
    classDef compute fill:#d4edda,stroke:#3a763d,stroke-width:2px
    classDef report fill:#ffe5b4,stroke:#cc8400,stroke-width:2px
    classDef docs fill:#e2e3e5,stroke:#6c757d,stroke-width:2px,stroke-dasharray: 5 5
```
