# diwash17/5cs037-final-portfolio-whr-2024- architecture

> Architecture diagram of the GitHub repository diwash17/5cs037-final-portfolio-whr-2024-, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-05-11). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/diwash17/5cs037-final-portfolio-whr-2024-
- Repository: https://github.com/diwash17/5cs037-final-portfolio-whr-2024-

## Overview

##### Project type and purpose
- This is a data‐analysis/portfolio project centered on “WHR 2024” (World Happiness Report 2024) implemented as a Jupyter notebook.

##### File structure
- Top level:
- 2407736_DiwashAdhikari.ipynb – the main analysis notebook
- WHR-2024.csv – raw data source
- Readme.md – project title/description
- No separate “src” or “scripts” directories—everything lives in the notebook.
- No deployment or build scripts—this is a standalone, exploratory data project.

##### README for additional insights
- It confirms this is a final‐portfolio submission for a data analysis course.
- No further architectural notes; all logic and visualization are in the notebook.

a. Main components
1) Data Source: WHR-2024.csv
2) Compute Environment: Jupyter Notebook server & Python runtime
3) Processing Modules (inside notebook): pandas for cleaning & transformation, numpy for computation
4) Visualization Modules (inside notebook): matplotlib/seaborn/plotly for charts
5) Output: rendered notebook with tables, plots, insights (HTML/Slides or GitHub host)
b. Relationships and data flow
c. Architectural patterns or design principles
- Single-page well‐documented exploratory workflow (no microservices or multi‐tier separation)
d. Relevant technologies
- Python 3.x environment (Anaconda/venv)
- Jupyter Notebook
- pandas, numpy for data processing
- matplotlib, seaborn (or plotly) for visualization
- Git (optional) for version control of .ipynb and .csv

- Processing inside notebook in another
- Output/Visualization in a third

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Data Source and Documentation
    CSV["CSV Dataset\n(WHR-2024.csv)"]:::data
    README["Project Documentation\n(Readme.md)"]:::docs

    %% Jupyter Notebook Environment Container
    subgraph "Jupyter Notebook Environment"
        direction TB
        Notebook["Main Analysis Notebook\n(2407736_DiwashAdhikari.ipynb)"]:::env

        subgraph "Data Processing Pipeline"
            direction TB
            Ingest["Data Ingestion\nread_csv()"]:::proc
            Clean["Data Cleaning/Transformation\ndropna(), filter"]:::proc
            Analyze["Analysis/Computation\ngroupby(), agg"]:::proc
            Visual["Visualization\nplot(), seaborn, plotly"]:::viz
            Output["Notebook Output\nRendered Tables & Charts"]:::output
        end
    end

    %% Flow Connections
    CSV -->|"read_csv()"| Ingest
    Ingest -->|"dropna(), filter"| Clean
    Clean -->|"groupby(), agg"| Analyze
    Analyze -->|"plot()"| Visual
    Visual -->|"render"| Output

    %% External Documentation Link
    README -.-> Notebook

    %% Click Events
    click CSV "https://github.com/diwash17/5cs037-final-portfolio-whr-2024-/blob/main/WHR-2024.csv"
    click Notebook "https://github.com/diwash17/5cs037-final-portfolio-whr-2024-/blob/main/2407736_DiwashAdhikari.ipynb"
    click README "https://github.com/diwash17/5cs037-final-portfolio-whr-2024-/blob/main/Readme.md"

    %% Styles
    classDef data fill:#D0E8FF,stroke:#037FFF,color:#000;
    classDef docs fill:#F0F0F0,stroke:#666,color:#000,stroke-dasharray: 2 2;
    classDef env fill:#E8FFE8,stroke:#2ECC71,color:#000;
    classDef proc fill:#FFF5CC,stroke:#FFAA00,color:#000;
    classDef viz fill:#FFE0CC,stroke:#FF6B00,color:#000;
    classDef output fill:#FFF0F0,stroke:#FF0000,color:#000;
```
