# putriimnida/seurat_scrnaseq_pbmc architecture

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

- Interactive diagram: https://gitdiagram.com/putriimnida/seurat_scrnaseq_pbmc
- Repository: https://github.com/putriimnida/seurat_scrnaseq_pbmc

## Overview

##### Project type and purpose
- This is an R-based single-cell RNA-seq data‐analysis pipeline (not a web service).
- Purpose: demonstrate scRNA-seq preprocessing, QC, dimensionality reduction, clustering, and visualization on a 2,700-cell PBMC dataset using Seurat v5.

##### File structure
Top-level components:
- Seurat_scRNAseq_PBMC.Rproj – RStudio project file
- data/ – raw and filtered 10X Genomics matrix files
- seurat_scrnaseq_pbmc.Rmd – RMarkdown analysis script (the core pipeline)
- results/ – serialized R objects (.rds) containing final data and UMAP projection
- README.md – project description and tutorial reference

##### Extract further insights from README
- Confirms use of Seurat v5 and the 10X PBMC 3k dataset.

##### Main components
a. Data Inputs
- Raw 10X files (barcodes.tsv, genes.tsv, matrix.mtx) in data/filtered_gene_bc_matrices/hg19
- Optional compressed archive (pbmc3k_filtered_gene_bc_matrices.tar.gz)
b. Processing Engine
- R session orchestrated by seurat_scrnaseq_pbmc.Rmd
- Seurat v5 library functions (Read10X, CreateSeuratObject, NormalizeData, FindVariableFeatures, RunPCA, RunUMAP, FindClusters, etc.)
c. Intermediate Storage
- In-memory Seurat objects (e.g., your PBMC Seurat object)
d. Output Artifacts
- RDS files in results/ (pbmc3k_final.rds, pbmc_tutorial_umap.rds)
- Plots (embedded in the Rmd or exported separately)
e. Environment/Tools
- RStudio or R CLI
- R versions and package dependencies (not explicit in tree, but can be added)

##### Relationships and interactions
- Optionally, a feedback loop (e.g., parameter tuning) between the script and processing modules.

##### Architectural patterns/design principles
- Pipeline pattern (stepwise transformation of data).
- Separation of concerns: data storage vs. processing code vs. results.
- Reproducibility: use of Rmd ensures documentation + execution in one place.

## Diagram (Mermaid)

```mermaid
flowchart TB
    subgraph "Raw Data Inputs"
        DataDir["data/"]:::dataStore
        Barcodes["barcodes.tsv"]:::dataStore
        Genes["genes.tsv"]:::dataStore
        Matrix["matrix.mtx"]:::dataStore
        Archive["pbmc3k_filtered_gene_bc_matrices.tar.gz"]:::dataStore
    end

    DataDir --> Barcodes
    DataDir --> Genes
    DataDir --> Matrix
    DataDir --> Archive
    DataDir --> RMD

    RMD["seurat_scrnaseq_pbmc.Rmd"]:::process

    subgraph "Seurat v5 Pipeline"
        QC["QC & Filtering"]:::process
        Norm["NormalizeData"]:::process
        Var["Feature Selection"]:::process
        PCA["RunPCA"]:::process
        UMAPStep["RunUMAP"]:::process
        Cluster["FindClusters"]:::process
        Visual["Visualization"]:::process
    end

    RMD --> QC --> Norm --> Var --> PCA --> UMAPStep --> Cluster --> Visual
    Visual --> ResultsDir

    subgraph "Results"
        ResultsDir["results/"]:::dataStore
        FinalObj["pbmc3k_final.rds"]:::dataStore
        UMAPObj["pbmc_tutorial_umap.rds"]:::dataStore
    end

    ResultsDir --> FinalObj
    ResultsDir --> UMAPObj

    subgraph "Environment & Documentation"
        RProj["Seurat_scRNAseq_PBMC.Rproj"]:::tool
        Readme["README.md"]:::tool
    end

    classDef dataStore fill:#cce5ff,stroke:#333,stroke-width:1px
    classDef process fill:#c2f0c2,stroke:#333,stroke-width:1px
    classDef tool fill:#e0e0e0,stroke:#333,stroke-width:1px

    click Barcodes "https://github.com/putriimnida/seurat_scrnaseq_pbmc/blob/main/data/filtered_gene_bc_matrices/hg19/barcodes.tsv"
    click Genes "https://github.com/putriimnida/seurat_scrnaseq_pbmc/blob/main/data/filtered_gene_bc_matrices/hg19/genes.tsv"
    click Matrix "https://github.com/putriimnida/seurat_scrnaseq_pbmc/blob/main/data/filtered_gene_bc_matrices/hg19/matrix.mtx"
    click Archive "https://github.com/putriimnida/seurat_scrnaseq_pbmc/blob/main/data/pbmc3k_filtered_gene_bc_matrices.tar.gz"
    click DataDir "https://github.com/putriimnida/seurat_scrnaseq_pbmc/tree/main/data/"
    click RMD "https://github.com/putriimnida/seurat_scrnaseq_pbmc/blob/main/seurat_scrnaseq_pbmc.Rmd"
    click RProj "https://github.com/putriimnida/seurat_scrnaseq_pbmc/blob/main/Seurat_scRNAseq_PBMC.Rproj"
    click Readme "https://github.com/putriimnida/seurat_scrnaseq_pbmc/blob/main/README.md"
    click ResultsDir "https://github.com/putriimnida/seurat_scrnaseq_pbmc/tree/main/results/"
    click FinalObj "https://github.com/putriimnida/seurat_scrnaseq_pbmc/blob/main/results/pbmc3k_final.rds"
    click UMAPObj "https://github.com/putriimnida/seurat_scrnaseq_pbmc/blob/main/results/pbmc_tutorial_umap.rds"
```
