# instituto-milenio-de-datos/modelamiento-covid architecture

> Architecture diagram of the GitHub repository instituto-milenio-de-datos/modelamiento-covid, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-09-15). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/instituto-milenio-de-datos/modelamiento-covid
- Repository: https://github.com/instituto-milenio-de-datos/modelamiento-covid

## Overview

##### Project type and purpose
- This is an open-source repository (“Grupo Modelación Covid-19”) that centralizes code for multiple epidemiological models, raw datasets, model parameters, and generated deliverables (reports, presentations). Its purpose is to allow collaborators to compare model code and results, share parameter sets, and archive outputs in a structured way.

##### File structure
- Top-level directories:
- modelos/ – model code, organized into subfolders per research group (e.g., SEIHD_Benavides_et_al, SIRD_Lima)
- datos/ – raw data files used as inputs
- parametros/ – text/PDF files listing model parameters by model family
- presentaciones/ – PDFs of slide decks and workshop minutes
- reportes/ – PDF outputs of model runs and summary reports, also sub-organized by group
- literatura/ – reference papers (PDFs) and reading lists
- There are no runtime services or web frontends—this is a code and document repository, with R scripts in modelos/ subfolders as the only “executable” bits.

##### README for additional insights
- The README confirms the repository’s purpose: “compartir modelos/datos/parámetros…centralizado…comparar modelos y resultados.”
- It establishes collaboration via GitHub issues and PRs, but does not describe any microservices or deployment.

##### Detail
- Break “Model Engines” into sub-components if needed (e.g., SEIHD and SIRD modules)
- File formats (CSV, TXT, PDF) where relevant
- Feedback loops: e.g., modelers adjust parameters and submit PRs back into parametros/ or modelos/

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Collaboration Platform
    GitHub["GitHub Collaboration<br/>(README.md, .gitignore)"]:::collab

    %% Data Sources
    subgraph "Data Sources"
        direction TB
        RawData["Raw Data<br/>(datos/)"]:::storage
        ParameterStore["Parameters<br/>(parametros/)"]:::storage
        Literature["Literature<br/>(literatura/)"]:::storage
    end

    %% Model Engines
    subgraph "Model Engines" 
        direction TB
        SEIHD["SEIHD Model<br/>(modelos/SEIHD_Benavides_et_al/)"]:::code
        SIRD["SIRD Model<br/>(modelos/SIRD_Lima/)"]:::code
    end

    %% Execution Environment
    ExecEnv["Execution Environment<br/>(R interpreter & Libraries)"]:::infra

    %% Output Archive
    subgraph "Outputs"
        direction TB
        Reports["Reports<br/>(reportes/)"]:::output
        subgraph "  Reports Subfolders"
            direction TB
            CMMReports["CMM Reports<br/>(reportes/CMM/)"]:::output
            SIRDReports["SIRD Lima Reports<br/>(reportes/SIRD_Lima/)"]:::output
        end
        Presentations["Presentations<br/>(presentaciones/)"]:::output
    end

    %% Relationships
    GitHub -->|manages code & docs| RawData
    GitHub -->|manages code & docs| ParameterStore
    GitHub -->|manages code & docs| Literature
    GitHub -->|manages code & docs| SEIHD
    GitHub -->|manages code & docs| SIRD
    GitHub -->|manages code & docs| ExecEnv
    GitHub -->|manages code & docs| Reports
    GitHub -->|manages code & docs| Presentations

    RawData -->|feeds into| SEIHD
    RawData -->|feeds into| SIRD
    ParameterStore -->|feeds into| SEIHD
    ParameterStore -->|feeds into| SIRD
    Literature -->|reference for| SEIHD
    Literature -->|reference for| SIRD

    SEIHD -->|executes on| ExecEnv
    SIRD -->|executes on| ExecEnv

    ExecEnv -->|generates| CMMReports
    ExecEnv -->|generates| SIRDReports
    ExecEnv -->|generates| Presentations

    CMMReports -->|aggregated in| Reports
    SIRDReports -->|aggregated in| Reports

    %% Click Events
    click RawData "https://github.com/instituto-milenio-de-datos/modelamiento-covid/tree/master/datos/"
    click ParameterStore "https://github.com/instituto-milenio-de-datos/modelamiento-covid/tree/master/parametros/"
    click Literature "https://github.com/instituto-milenio-de-datos/modelamiento-covid/tree/master/literatura/"
    click SEIHD "https://github.com/instituto-milenio-de-datos/modelamiento-covid/tree/master/modelos/SEIHD_Benavides_et_al/"
    click SIRD "https://github.com/instituto-milenio-de-datos/modelamiento-covid/tree/master/modelos/SIRD_Lima/"
    click ExecEnv "https://github.com/instituto-milenio-de-datos/modelamiento-covid/blob/master/modelos/Readme.md"
    click Reports "https://github.com/instituto-milenio-de-datos/modelamiento-covid/tree/master/reportes/"
    click CMMReports "https://github.com/instituto-milenio-de-datos/modelamiento-covid/tree/master/reportes/CMM/"
    click SIRDReports "https://github.com/instituto-milenio-de-datos/modelamiento-covid/tree/master/reportes/SIRD_Lima/"
    click Presentations "https://github.com/instituto-milenio-de-datos/modelamiento-covid/tree/master/presentaciones/"
    click GitHub "https://github.com/instituto-milenio-de-datos/modelamiento-covid/blob/master/README.md"
    click GitHub "https://github.com/instituto-milenio-de-datos/modelamiento-covid/blob/master/.gitignore"

    %% Styles
    classDef storage fill:#cce5ff,stroke:#3399ff,color:#000;
    classDef code fill:#ccffcc,stroke:#33cc33,color:#000;
    classDef output fill:#ffe0b3,stroke:#ff9933,color:#000;
    classDef infra fill:#e6e6e6,stroke:#a6a6a6,color:#000;
    classDef collab fill:#f2ccff,stroke:#d966ff,color:#000;
```
