# marimar4/projet-python architecture

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

- Interactive diagram: https://gitdiagram.com/marimar4/projet-python
- Repository: https://github.com/marimar4/projet-python

## Overview

##### Project Type and Purpose
- This is a Python-based data-science workflow (not a web app or microservice).
- Goal: Empirically verify the Law of Okun by collecting, preparing, analyzing, and modeling socio-economic time-series data in Jupyter notebooks.

##### Key Components (to show
a. External Data Sources
- World Bank ZIP files:
– “GemDataEXTR.zip” (Unemployment, GDP deflator)
– “HNP_Stats_EXCEL.zip” (Demographic & health indicators)
b. Data Storage
- monmodule/bases (raw .zip archives, extracted Excel files, final_data.csv)
c. Data Ingestion & Preprocessing
- Notebook: Préparation_données.ipynb
- Python module: monmodule/declarations.py (utility functions, constants)
d. Exploratory Data Analysis (EDA)
- Notebook: EDA.ipynb
- Visualization libs: Pandas, Matplotlib, Seaborn, GeoPandas, Plotly (plotly.express)
e. Modeling
- Notebook: Modélisation.ipynb
- Statsmodels (time-series, transfer functions, ARDL)
f. Runtime Environment
- Jupyter Notebook server
- Python virtualenv defined by requirements.txt
g. Outputs
- Charts, statistical reports, model diagnostics
- final_data.csv

##### Interactions and Data Flow
- Data Storage → Data Ingestion & Preprocessing (reads raw files, cleans/merges data)
- Preprocessing → final_data.csv (intermediate artifact)
- final_data.csv & declarations → EDA (visualizations, descriptive stats)
- EDA → insights (charts)
- final_data.csv & declarations → Modeling (fit econometric models)
- Modeling → results (coefficients, validation plots)

##### Architectural Patterns and Design Principles
- Pipeline Pattern: sequential stages (Ingestion → EDA → Modeling)
- Modularization: utility functions in monmodule/declarations.py reused across notebooks
- Single Source of Truth: final_data.csv drives both EDA and Modeling
- Reproducibility: requirements.txt captures environment; notebooks document each step

##### Technologies and Frameworks
- Core: Python 3.x, Jupyter Notebook
- Data Handling: Pandas, NumPy
- Visualization: Matplotlib, Seaborn, Plotly, GeoPandas
- Modeling: Statsmodels
- Environment: requirements.txt, pipreqs

## Diagram (Mermaid)

```mermaid
graph TB
    %% Environment
    JupyterServer["Jupyter Notebook Server"]:::env
    Requirements["requirements.txt"]:::env

    %% External Data Sources
    subgraph "External Data Sources"
        GemZIP["GemDataEXTR.zip"]:::data
        HNPZIP["HNP_Stats_EXCEL.zip"]:::data
    end

    %% Data Storage Layer
    subgraph "Data Storage Layer"
        BasesDir["monmodule/bases/"]:::data
        FinalCSV["final_data.csv"]:::data
    end

    %% Processing Layer
    subgraph "Processing Layer"
        Prep["Préparation_données.ipynb"]:::process
        Decl["declarations.py"]:::process
        EDA["EDA.ipynb"]:::process
        Model["Modélisation.ipynb"]:::process
    end

    %% Outputs
    subgraph "Outputs"
        Charts["Charts & Reports"]:::output
        Results["Model Results"]:::output
    end

    %% Data Flow
    Requirements --> JupyterServer
    JupyterServer --> Prep
    JupyterServer --> EDA
    JupyterServer --> Model

    GemZIP -->|"raw ZIPs"| BasesDir
    HNPZIP -->|"raw ZIPs"| BasesDir

    BasesDir -->|"reads raw files"| Prep
    Decl --> Prep
    Prep -->|"produces final_data.csv"| FinalCSV

    FinalCSV -->|"provides data"| EDA
    Decl --> EDA
    EDA -->|"generates charts"| Charts

    FinalCSV -->|"provides data"| Model
    Decl --> Model
    Model -->|"generates diagnostics"| Results

    %% Click Events
    click GemZIP "https://github.com/marimar4/projet-python/blob/main/monmodule/bases/GemDataEXTR.zip"
    click HNPZIP "https://github.com/marimar4/projet-python/blob/main/monmodule/bases/HNP_Stats_EXCEL.zip"
    click BasesDir "https://github.com/marimar4/projet-python/tree/main/monmodule/bases/"
    click FinalCSV "https://github.com/marimar4/projet-python/blob/main/monmodule/bases/final_data.csv"
    click Prep "https://github.com/marimar4/projet-python/blob/main/monmodule/Préparation_données.ipynb"
    click Decl "https://github.com/marimar4/projet-python/blob/main/monmodule/declarations.py"
    click EDA "https://github.com/marimar4/projet-python/blob/main/monmodule/EDA.ipynb"
    click Model "https://github.com/marimar4/projet-python/blob/main/monmodule/Modélisation.ipynb"
    click Requirements "https://github.com/marimar4/projet-python/blob/main/requirements.txt"

    %% Styles
    classDef data fill:#1f78b4,stroke:#000,color:#fff
    classDef process fill:#33a02c,stroke:#000,color:#fff
    classDef output fill:#ff7f00,stroke:#000,color:#fff
    classDef env fill:#b2b2b2,stroke:#000,color:#000
```
