# mohamednhassan/sat_atlas architecture

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

- Interactive diagram: https://gitdiagram.com/mohamednhassan/sat_atlas
- Repository: https://github.com/mohamednhassan/sat_atlas

## Overview

##### Project Type and Purpose
- This repository is an open-source single-cell transcriptomics analysis pipeline targeting the vascular niche of human adipose tissue.
- It combines R and Python scripts (RMarkdown & Jupyter notebooks) to reproduce data processing, integration, differential expression, functional annotation, compositional analyses, cell–cell communication inference, cross-species mapping, and pseudotime trajectory inference.

##### File Structure
Top-level directories map to major pipeline stages:
- Data_processing – RMarkdown pipelines for QC, normalization, integration, cell‐type annotation.
- Analysis – DE analysis, gene ontology, scoring, regulatory network inference (pySCENIC, scDRS).
- CompositionalAnalysis – scCODA compositional shifts.
- Connectome – cell–cell communication (NicheNet automation, LIANA+).
- Cross-species – cell mapping and variational integration (scMAP, scVI for mouse & pig).
- Pseudotime_trajectory – multiple trajectory tools (CellRank, PAGA, Palantir).

##### README Insights
- Confirms use of both R and Python.
- Focuses on reproducibility via literate programming (Rmd & notebooks).
- No dedicated frontend/backend—entire repository is a modular computational pipeline.

##### Main Components and Their Relationships
a. Raw Input Data
– Single‐cell count matrices (human SAT samples) stored externally or in data folder.
b. Compute Environment
– R (Seurat, scCODA, CellRank, etc.), Python (scanpy, scVI, pySCENIC, etc.), Jupyter, RStudio.
c. Data Processing Module
– Sequential RMarkdown scripts → produce processed Seurat/AnnData objects.
d. Analysis Branches (all consume processed objects)
– Differential Expression & Functional Annotation (Analysis/)
– Compositional shifts (CompositionalAnalysis/)
– Connectome inference (Connectome/)
– Cross‐species mapping (Cross-species/)
– Pseudotime trajectories (Pseudotime_trajectory/)
e. Outputs
– Figures, tables, processed RDS/AnnData files, interactive notebooks.
f. Version Control & Collaboration
– GitHub repository, LICENSE.

##### Architectural Patterns & Design Principles
- Modular pipeline: each stage is self-contained under its directory.
- Data artifact passing: standardized Seurat/AnnData objects flow between stages.
- Polyglot environment: explicit separation of R vs. Python workflows.
- Reproducibility via literate programming: RMarkdown & Jupyter.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% External Raw Data
    RawData["Raw Single-cell Data"]:::external

    %% Compute Environment
    ComputeEnv[/"Compute Environment: R & Python\n(Jupyter, RStudio)"/]:::env

    %% Data Processing Stage
    subgraph "Data Processing (RMarkdown)" 
        DP1["01. SAT_Atlas_Integration_and_Annotation.Rmd"]:::dataProc
        DP2["02. Vascular_subset_processing_and_Integration.Rmd"]:::dataProc
        DP3["03. SubECs_subset_processing_and_Integration.Rmd"]:::dataProc
        DP4["Mouse_data_processing.Rmd"]:::dataProc
        DP5["Pig_data_processing.Rmd"]:::dataProc
    end

    %% Processed Data Artifact
    Processed[(Processed Seurat/AnnData Objects)]:::artifact

    %% Analysis Branches
    subgraph "Differential Expression & Functional Annotation" 
        A1["Differential_Expression_Analysis_Vascular.Rmd"]:::analysis
        A2["GeneOntology_analysis.R"]:::analysis
        A3["common_GO_Radar_Plots.R"]:::analysis
        A4["EndMT score.R"]:::analysis
        A5["Druggable_targets.R"]:::analysis
        A6["Drug2cell.ipynb"]:::analysis
        A7["pySCENIC_Vascular.ipynb"]:::analysis
        A8["scDRS.ipynb"]:::analysis
        A9["scIB.ipynb"]:::analysis
    end

    subgraph "Compositional Shift Analysis" 
        C1["scCODA_Compositional_Analysis.ipynb"]:::compositional
    end

    subgraph "Cell–Cell Communication Inference" 
        CC1["Automating_NicheNet.R"]:::connectome
        CC2["Liana+.ipynb"]:::connectome
    end

    subgraph "Cross-Species Mapping & Integration" 
        CS1["scMAP/"]:::crossSpecies
        CS2["sysVI_Mouse.ipynb"]:::crossSpecies
        CS3["sysVI_Pig.ipynb"]:::crossSpecies
    end

    subgraph "Pseudotime Trajectory Inference" 
        P1["Pseudotime_analysis.Rmd"]:::pseudotime
        P2["CellRank.ipynb"]:::pseudotime
        P3["PAGA.ipynb"]:::pseudotime
        P4["Palantir.ipynb"]:::pseudotime
    end

    %% Final Outputs
    Outputs[(Figures, Tables, Processed Files)]:::artifact

    %% Version Control
    VC["README.md & LICENSE"]:::external

    %% Flow Connections
    RawData -->|input to| ComputeEnv
    ComputeEnv -->|runs| DP1 & DP2 & DP3 & DP4 & DP5
    DP1 & DP2 & DP3 & DP4 & DP5 -->|produce| Processed

    Processed -->|consume| A1 & A2 & A3 & A4 & A5 & A6 & A7 & A8 & A9
    Processed -->|consume| C1
    Processed -->|consume| CC1 & CC2
    Processed -->|consume| CS1 & CS2 & CS3
    Processed -->|consume| P1 & P2 & P3 & P4

    A1 & A2 & A3 & A4 & A5 & A6 & A7 & A8 & A9 -->|output| Outputs
    C1 -->|output| Outputs
    CC1 & CC2 -->|output| Outputs
    CS1 & CS2 & CS3 -->|output| Outputs
    P1 & P2 & P3 & P4 -->|output| Outputs

    ComputeEnv -->|version controlled| VC

    %% Click Events
    click DP1 "https://github.com/mohamednhassan/sat_atlas/blob/main/Data_processing/01. SAT_Atlas_Integration_and_Annotation.Rmd"
    click DP2 "https://github.com/mohamednhassan/sat_atlas/blob/main/Data_processing/02. Vascular_subset_processing_and_Integration.Rmd"
    click DP3 "https://github.com/mohamednhassan/sat_atlas/blob/main/Data_processing/03. SubECs_subset_processing_and_Integration.Rmd"
    click DP4 "https://github.com/mohamednhassan/sat_atlas/blob/main/Data_processing/Mouse_data_processing.Rmd"
    click DP5 "https://github.com/mohamednhassan/sat_atlas/blob/main/Data_processing/Pig_data_processing.Rmd"

    click A1 "https://github.com/mohamednhassan/sat_atlas/blob/main/Analysis/Differential_Expression_Analysis_Vascular.Rmd"
    click A2 "https://github.com/mohamednhassan/sat_atlas/blob/main/Analysis/GeneOntology_analysis.R"
    click A3 "https://github.com/mohamednhassan/sat_atlas/blob/main/Analysis/common_GO_Radar_Plots.R"
    click A4 "https://github.com/mohamednhassan/sat_atlas/blob/main/Analysis/EndMT score.R"
    click A5 "https://github.com/mohamednhassan/sat_atlas/blob/main/Analysis/Druggable_targets.R"
    click A6 "https://github.com/mohamednhassan/sat_atlas/blob/main/Analysis/Drug2cell.ipynb"
    click A7 "https://github.com/mohamednhassan/sat_atlas/blob/main/Analysis/pySCENIC_Vascular.ipynb"
    click A8 "https://github.com/mohamednhassan/sat_atlas/blob/main/Analysis/scDRS.ipynb"
    click A9 "https://github.com/mohamednhassan/sat_atlas/blob/main/Analysis/scIB.ipynb"

    click C1 "https://github.com/mohamednhassan/sat_atlas/blob/main/CompositionalAnalysis/scCODA_Compositional_Analysis.ipynb"

    click CC1 "https://github.com/mohamednhassan/sat_atlas/blob/main/Connectome/Automating_NicheNet.R"
    click CC2 "https://github.com/mohamednhassan/sat_atlas/blob/main/Connectome/Liana+.ipynb"

    click CS1 "https://github.com/mohamednhassan/sat_atlas/tree/main/Cross-species/scMAP/"
    click CS2 "https://github.com/mohamednhassan/sat_atlas/blob/main/Cross-species/sysVI_Mouse.ipynb"
    click CS3 "https://github.com/mohamednhassan/sat_atlas/blob/main/Cross-species/sysVI_Pig.ipynb"

    click P1 "https://github.com/mohamednhassan/sat_atlas/blob/main/Pseudotime_trajectory/Pseudotime_analysis.Rmd"
    click P2 "https://github.com/mohamednhassan/sat_atlas/blob/main/Pseudotime_trajectory/CellRank.ipynb"
    click P3 "https://github.com/mohamednhassan/sat_atlas/blob/main/Pseudotime_trajectory/PAGA.ipynb"
    click P4 "https://github.com/mohamednhassan/sat_atlas/blob/main/Pseudotime_trajectory/Palantir.ipynb"

    %% Styles
    classDef external fill:#D3D3D3,stroke:#000,stroke-width:1px
    classDef env fill:#f0f0f0,stroke:#666,stroke-width:1px,stroke-dasharray: 5 5
    classDef dataProc fill:#AED6F1,stroke:#2980B9,stroke-width:1px
    classDef analysis fill:#ABEBC6,stroke:#27AE60,stroke-width:1px
    classDef compositional fill:#D7BDE2,stroke:#8E44AD,stroke-width:1px
    classDef connectome fill:#F9E79F,stroke:#B7950B,stroke-width:1px
    classDef crossSpecies fill:#A3E4D7,stroke:#117A65,stroke-width:1px
    classDef pseudotime fill:#F5B7B1,stroke:#C0392B,stroke-width:1px
    classDef artifact fill:#EDBB99,stroke:#D35400,stroke-width:1px
```
