# dhwanikaneria/dengueprediction architecture

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

- Interactive diagram: https://gitdiagram.com/dhwanikaneria/dengueprediction
- Repository: https://github.com/dhwanikaneria/dengueprediction

## Overview

##### Project type and purpose
- This is a machine‑learning batch‑processing pipeline whose goal is to predict dengue outbreaks in San Juan and Iquitos.
- Key indicators: a single Jupyter notebook (`DenguePrediction.ipynb`), a `Data` folder full of CSVs, and a final report.

##### File structure
- Top‑level items:
- Data/ (contains raw and submission‑format CSVs)
- DenguePrediction.ipynb (the interactive analysis and modeling script)
- Project_Final_Report.pdf (documentation of findings)
- README.txt (project description and setup)
- No separate “src” or “backend” folders – all logic lives in the notebook.
- No deployment or service configuration files – this is a research pipeline, not a running service.

##### README for additional insights
- Purpose: predict next‐week dengue cases using climate/vegetation features.
- Workflow:
- Load CSVs with Pandas
- Shift features by 1–3 weeks to capture incubation lag
- Train models in the notebook
- Evaluate via Mean Absolute Error (MAE)
- Dependencies: Python, Anaconda, Jupyter; likely Pandas, NumPy, scikit‑learn.

## Diagram (Mermaid)

```mermaid
graph TB
    %% Data Ingestion Layer
    subgraph "Data Ingestion Layer"
        direction TB
        RawData["Raw CSV Files"]:::data
    end

    %% Preprocessing & Feature Engineering
    Preprocessing["Preprocessing & Feature Engineering"]:::compute

    %% Modeling
    Modeling["Model Training (RandomForest, XGBoost)"]:::compute

    %% Validation & Evaluation
    Validation["Validation & Evaluation (MAE)"]:::compute

    %% Output / Submission
    Output["Generate Submission CSV"]:::data

    %% Notebook Controller
    Notebook["DenguePrediction.ipynb"]:::notebook

    %% Documentation
    subgraph "Documentation"
        direction TB
        Report["Project_Final_Report.pdf"]:::doc
        Setup["README.txt"]:::doc
    end

    %% Flow
    RawData -->|loads into| Preprocessing
    Preprocessing -->|features to| Modeling
    Modeling -->|predictions to| Validation
    Validation -->|results to| Output
    Notebook -->|orchestrates| RawData
    Notebook -->|orchestrates| Preprocessing
    Notebook -->|orchestrates| Modeling
    Notebook -->|orchestrates| Validation
    Notebook -->|orchestrates| Output
    Validation -.->|hyperparameter tuning loop| Modeling

    %% Click Events
    click RawData "https://github.com/dhwanikaneria/dengueprediction/tree/master/Data/"
    click Output "https://github.com/dhwanikaneria/dengueprediction/blob/master/Data/DengAI_Predicting_Disease_Spread_-_Submission_Format.csv"
    click Notebook "https://github.com/dhwanikaneria/dengueprediction/blob/master/DenguePrediction.ipynb"
    click Report "https://github.com/dhwanikaneria/dengueprediction/blob/master/Project_Final_Report.pdf"
    click Setup "https://github.com/dhwanikaneria/dengueprediction/blob/master/README.txt"

    %% Styles
    classDef data fill:#D0E6F6,stroke:#3B7EA1,color:#000
    classDef compute fill:#DFF0D8,stroke:#3C763D,color:#000
    classDef notebook fill:#FCF8E3,stroke:#8A6D3B,color:#000
    classDef doc fill:#F2DEDE,stroke:#A94442,color:#000
```
