# victorsepulveda1994/minor-machine-learning architecture

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

- Interactive diagram: https://gitdiagram.com/victorsepulveda1994/minor-machine-learning
- Repository: https://github.com/victorsepulveda1994/minor-machine-learning

## Overview

##### Project Components
- Core Pipeline (Proyecto_Final): This is organized into several structured stages:
- Etapa01-Obtain: Data ingestion—retrieving and loading raw human activity data.
- Etapa02-Scrub: Data cleaning and preprocessing—removing inconsistencies.
- Etapa03-Explore: Exploratory Data Analysis (EDA)—visualizing patterns and trends.
- Etapa04-Model: Training and evaluating models for human activity recognition.
- Etapa05-Interpret: Model interpretation and results explanation.
- Additional Learning Modules and Experiments:
- S07-Linear-Models contains a notebook focused on linear regression techniques.
- Tarea-Algebra appears to be an algebra-related exercise.
- Validación Cruzada includes a notebook and dataset for cross-validation, using the penguins dataset.
- The notebooks directory holds various exploratory notebooks on topics such as Support Vector Machines, transitioning from machine learning to deep learning, PyTorch usage, and an adaptation of OpenAI Whisper.

##### Out Architectural Relationships
-> Data Collection (Etapa01-Obtain) → Data Cleaning (Etapa02-Scrub) → EDA (Etapa03-Explore) → Modeling (Etapa04-Model) → Interpretation (Etapa05-Interpret)
- Experimental and Educational Paths:
- A branch denoting separate experimental notebooks (S07-Linear-Models, Validación Cruzada, and Tarea-Algebra) which, while not part of the main pipeline, represent complementary learning exercises.
- The general notebooks directory can be visualized as a side branch covering advanced topics (SVMs, PyTorch, deep learning strategies) that supplement the central narrative.

##### Architectural Patterns and Design Principles
- Pipeline-based Structure: The core structure of Proyecto_Final follows the archetypal ML workflow—a chain of distinct yet interconnected stages.
- Modular Organization: Each “Etapa” (stage) is modular and independent, making it easier to update, extend, or reuse components.
- Separation of Concerns: The experimental notebooks (e.g., algebra tasks, regression models, cross-validation) are maintained separately, emphasizing the educational purpose and allowing focused exploration of individual topics.

##### Relevant Technologies
Although explicit details on libraries or frameworks aren’t provided in the README, the content (Jupyter notebooks on diverse ML topics) implies usage of Python-based data science stacks such as:
- Data Processing/EDA: pandas, numpy, matplotlib, seaborn.
- Machine Learning/Deep Learning Frameworks: scikit-learn, PyTorch.
- Signal Processing/Specialized Models: Possibly libraries related to human activity recognition.

- Annotations as necessary to reflect the primary technology or tool being employed, even if abstractly inferred (e.g., “Jupyter Notebook-based analysis”).

## Diagram (Mermaid)

```mermaid
graph TD
    %% Core Pipeline Subgraph
    subgraph "Core Pipeline: Human Activity Recognition"
        A1["Obtain Data (Etapa01-Obtain)\nData Ingestion: Raw data loading"]:::core
        A2["Data Cleaning (Etapa02-Scrub)\nPreprocessing and cleanup"]:::core
        A3["Exploratory Analysis (Etapa03-Explore)\nEDA and Visualization"]:::core
        A4["Modeling (Etapa04-Model)\nTraining and Evaluation"]:::core
        A5["Interpretation (Etapa05-Interpret)\nResults Explanation"]:::core
    end

    A1 -->|"processes"| A2
    A2 -->|"processes"| A3
    A3 -->|"processes"| A4
    A4 -->|"processes"| A5

    %% Additional Modules and Experiments Subgraph
    subgraph "Additional Modules and Experiments"
        B1["Linear Models Experiment\nRegression Techniques"]:::supplementary
        B2["Algebra Exercise\nFundamental Concepts"]:::supplementary
        B3["Cross-Validation Experiment\nPenguin Dataset Analysis"]:::supplementary
        B4["Advanced Notebooks\nSVM, Deep Learning, PyTorch, Whisper"]:::supplementary
    end

    A4 -->|"inspires"| B1
    A3 -->|"inspires"| B2
    A4 -->|"inspires"| B3
    A3 -->|"supplements"| B4

    %% Click Events for Core Pipeline Components
    click A1 "https://github.com/victorsepulveda1994/minor-machine-learning/blob/main/Proyecto_Final/Etapa01-Obtain/Obtain-Human_Activity_Recognition.ipynb"
    click A2 "https://github.com/victorsepulveda1994/minor-machine-learning/blob/main/Proyecto_Final/Etapa02-Scrub/Scrub-Human_Activity_Recognition.ipynb"
    click A3 "https://github.com/victorsepulveda1994/minor-machine-learning/blob/main/Proyecto_Final/Etapa03-Explore/Explore-Human_Activity_Recognition.ipynb"
    click A4 "https://github.com/victorsepulveda1994/minor-machine-learning/blob/main/Proyecto_Final/Etapa04-Model/Model-Human_Activity_Recognition.ipynb"
    click A5 "https://github.com/victorsepulveda1994/minor-machine-learning/blob/main/Proyecto_Final/Etapa05-Interpret/Model-Human_Activity_Recognition.ipynb"

    %% Click Events for Additional Modules
    click B1 "https://github.com/victorsepulveda1994/minor-machine-learning/blob/main/S07-Linear-Models/Tarea_regresion_lineal.ipynb"
    click B2 "https://github.com/victorsepulveda1994/minor-machine-learning/blob/main/Tarea-Algebra/Tarea_Corta_Algebra.ipynb"
    click B3 "https://github.com/victorsepulveda1994/minor-machine-learning/blob/main/Validación Cruzada/Cross_Validation_Penguin_Dataset.ipynb"
    click B4 "https://github.com/victorsepulveda1994/minor-machine-learning/tree/main/notebooks"

    %% Styles
    classDef core fill:#AEDFF7,stroke:#1F77B4,stroke-width:2px;
    classDef supplementary fill:#F7E2AE,stroke:#D2691E,stroke-width:2px;
```
