# dhlab-tseng/heterogeneity-in-sad-paper architecture

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

- Interactive diagram: https://gitdiagram.com/dhlab-tseng/heterogeneity-in-sad-paper
- Repository: https://github.com/dhlab-tseng/heterogeneity-in-sad-paper

## Overview

##### Project type and purpose
- This is an R‐based data‐analysis and reproducibility pipeline for a scientific paper: “Identifying Heterogeneous Subgroups of Systemic Autoimmune Diseases…”
- Its primary goal is to take raw immunomarker data (CSV), perform data wrangling, dimension reduction, clustering, and clinical‐implication analyses, and generate figures/markdown reports.

##### File structure
- Top‐level scripts (.Rmd/.md):
- Data_Wrangling.Rmd / .md – raw data processing
- Cluster_Analysis.Rmd / .md – clustering & profiling
- Clinical_Implication_Analysis.Rmd / .md – post‐clustering clinical analysis
- Reproducibility_Analysis.Rmd – checks for reproducibility
- Dataset directory: contains exam_table.csv (raw data)
- External_R_Functions: custom helper functions (e.g., cramerV matrix, ggRadar2)
- Heterogeneity-in-SAD-paper.Rproj: RStudio project file
- Output folders (*.Rmd_files, .pdf/.html figures): rendered outputs

##### README
- Confirms the three main analysis stages and points to the corresponding .md files for details.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Data Pipeline
    RawData["Raw Data\nexam_table.csv"]:::datastore
    RawData -->|".csv"| DataWrangle

    DataWrangle["Data Wrangling\nData_Wrangling.Rmd"]:::process
    click RawData "https://github.com/dhlab-tseng/heterogeneity-in-sad-paper/blob/main/Dataset/exam_table.csv"
    click DataWrangle "https://github.com/dhlab-tseng/heterogeneity-in-sad-paper/blob/main/Data_Wrangling.Rmd"
    DataWrangle -->|"cleaned .RData"| CleanedData

    CleanedData["Cleaned Data"]:::datastore

    %% External Functions Library
    ExternalLib["External R Functions\n(cramerV, ggRadar2)"]:::library
    click ExternalLib "https://github.com/dhlab-tseng/heterogeneity-in-sad-paper/tree/main/External_R_Functions/"

    ExternalLib --> DataWrangle
    ExternalLib --> ClusterAnalysis
    ExternalLib --> ClinicalAnalysis
    ExternalLib --> ReprodAnalysis

    %% Cluster Analysis Stage
    CleanedData -->|input| ClusterAnalysis
    ClusterAnalysis["Cluster Analysis\nCluster_Analysis.Rmd"]:::process
    click ClusterAnalysis "https://github.com/dhlab-tseng/heterogeneity-in-sad-paper/blob/main/Cluster_Analysis.Rmd"
    ClusterAnalysis -->|"cluster results"| ClusterOutputs
    ClusterOutputs["Cluster Outputs"]:::output
    click ClusterOutputs "https://github.com/dhlab-tseng/heterogeneity-in-sad-paper/tree/main/Cluster_Analysis_files/"

    %% Clinical Implication Stage
    CleanedData -->|input| ClinicalAnalysis
    ClusterOutputs -->|input| ClinicalAnalysis
    ClinicalAnalysis["Clinical Implication Analysis\nClinical_Implication_Analysis.Rmd"]:::process
    click ClinicalAnalysis "https://github.com/dhlab-tseng/heterogeneity-in-sad-paper/blob/main/Clinical_Implication_Analysis.Rmd"
    ClinicalAnalysis -->|"reports & figures"| ClinicalOutputs
    ClinicalOutputs["Clinical Reports"]:::output
    click ClinicalOutputs "https://github.com/dhlab-tseng/heterogeneity-in-sad-paper/tree/main/Clinical_Implication_Analysis_files/"

    %% Reproducibility Check
    RawData --> ReprodAnalysis
    DataWrangle --> ReprodAnalysis
    ClusterAnalysis --> ReprodAnalysis
    ClinicalAnalysis --> ReprodAnalysis
    ExternalLib --> ReprodAnalysis

    ReprodAnalysis["Reproducibility Analysis\nReproducibility_Analysis.Rmd"]:::process
    click ReprodAnalysis "https://github.com/dhlab-tseng/heterogeneity-in-sad-paper/blob/main/Reproducibility_Analysis.Rmd"
    ReprodAnalysis -->|"validation reports"| RepValReports
    RepValReports["Validation Reports"]:::output
    click RepValReports "https://github.com/dhlab-tseng/heterogeneity-in-sad-paper/tree/main/Reproducibility_Analysis_files/"

    %% Render Engine
    DataWrangle --> RenderEngine
    ClusterAnalysis --> RenderEngine
    ClinicalAnalysis --> RenderEngine
    ReprodAnalysis --> RenderEngine

    RenderEngine["Render Engine\nHeterogeneity-in-SAD-paper.Rproj"]:::process
    click RenderEngine "https://github.com/dhlab-tseng/heterogeneity-in-sad-paper/blob/main/Heterogeneity-in-SAD-paper.Rproj"

    %% Class Definitions
    classDef datastore fill:#bbefff,stroke:#333,stroke-width:1px;
    classDef process fill:#bfffbf,stroke:#333,stroke-width:1px;
    classDef output fill:#ffd699,stroke:#333,stroke-width:1px;
    classDef library fill:#e0b3ff,stroke:#333,stroke-width:1px;
```
