# charlesgwellem/gse178381_scrnaseq_eda architecture

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

- Interactive diagram: https://gitdiagram.com/charlesgwellem/gse178381_scrnaseq_eda
- Repository: https://github.com/charlesgwellem/gse178381_scrnaseq_eda

## Overview

This repository is a single-cell RNA-seq analysis of GSE178318, aimed at characterizing the tumor microenvironment and lymphotoxin expression across CRC, liver metastasis (LM), and PBMC samples. Its documented workflow prepares a Seurat object, performs quality control and filtering, normalizes and integrates samples, clusters cells, then identifies tissue-specific markers and enriched pathways. Analysis code is concentrated in one R Markdown file; the graph separates its documented domain stages while reusing that exact path. Source excerpts were not provided, so relationships are based on README statements, and internal call details are not inferred.

Main entry points: [`scripts/QC_clustering_DEA.Rmd`](https://github.com/charlesgwellem/gse178381_scrnaseq_eda/blob/master/scripts/QC_clustering_DEA.Rmd) (UMAP and clustering), [`figures`](https://github.com/charlesgwellem/gse178381_scrnaseq_eda/tree/master/figures) (Analysis figures), [`results`](https://github.com/charlesgwellem/gse178381_scrnaseq_eda/tree/master/results) (Pathway workbooks), [`report/QC_clustering_DEA.html`](https://github.com/charlesgwellem/gse178381_scrnaseq_eda/blob/master/report/QC_clustering_DEA.html) (HTML report)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_prep["Data preparation"]
  node_load["Load count data"]
  node_seurat["Seurat object"]
  node_qc["Quality control"]
  node_filter["Cell and gene filtering"]
end

subgraph group_analysis["Cell analysis"]
  node_normalize["Normalization"]
  node_cycle["Cell cycle scoring"]
  node_pca["PCA"]
  node_integration["Data integration"]
  node_cluster["UMAP and clustering"]
end

subgraph group_biology["Biological interpretation"]
  node_dea["Differential expression"]
  node_markers["Tissue-specific markers"]
  node_enrichment["Functional enrichment"]
end

subgraph group_outputs["Analysis outputs"]
  node_figures["Analysis figures"]
  node_pathways["Pathway workbooks"]
  node_report["HTML report"]
end

node_researcher(("Researcher"))
node_dataset[("GSE178318 data")]

node_researcher -->|"starts analysis"| node_load
node_dataset -->|"provides counts"| node_load
node_load -->|"creates object"| node_seurat
node_seurat -->|"assesses cells"| node_qc
node_qc -->|"guides filtering"| node_filter
node_filter -->|"precedes normalization"| node_normalize
node_normalize -->|"scores phases"| node_cycle
node_cycle -->|"examines variability"| node_pca
node_pca -->|"motivates integration"| node_integration
node_integration -->|"supports clustering"| node_cluster
node_cluster -->|"identifies groups"| node_dea
node_dea -->|"identifies markers"| node_markers
node_markers -->|"supplies marker genes"| node_enrichment
node_markers -->|"visualizes markers"| node_figures
node_enrichment -->|"records pathways"| node_pathways
node_cluster -->|"visualizes analysis"| node_figures
node_dea -.->|"reports analysis"| node_report

click node_load "https://github.com/charlesgwellem/gse178381_scrnaseq_eda/blob/master/scripts/QC_clustering_DEA.Rmd"
click node_seurat "https://github.com/charlesgwellem/gse178381_scrnaseq_eda/blob/master/scripts/QC_clustering_DEA.Rmd"
click node_qc "https://github.com/charlesgwellem/gse178381_scrnaseq_eda/blob/master/scripts/QC_clustering_DEA.Rmd"
click node_filter "https://github.com/charlesgwellem/gse178381_scrnaseq_eda/blob/master/scripts/QC_clustering_DEA.Rmd"
click node_normalize "https://github.com/charlesgwellem/gse178381_scrnaseq_eda/blob/master/scripts/QC_clustering_DEA.Rmd"
click node_cycle "https://github.com/charlesgwellem/gse178381_scrnaseq_eda/blob/master/scripts/QC_clustering_DEA.Rmd"
click node_pca "https://github.com/charlesgwellem/gse178381_scrnaseq_eda/blob/master/scripts/QC_clustering_DEA.Rmd"
click node_integration "https://github.com/charlesgwellem/gse178381_scrnaseq_eda/blob/master/scripts/QC_clustering_DEA.Rmd"
click node_cluster "https://github.com/charlesgwellem/gse178381_scrnaseq_eda/blob/master/scripts/QC_clustering_DEA.Rmd"
click node_dea "https://github.com/charlesgwellem/gse178381_scrnaseq_eda/blob/master/scripts/QC_clustering_DEA.Rmd"
click node_markers "https://github.com/charlesgwellem/gse178381_scrnaseq_eda/blob/master/scripts/QC_clustering_DEA.Rmd"
click node_enrichment "https://github.com/charlesgwellem/gse178381_scrnaseq_eda/blob/master/scripts/QC_clustering_DEA.Rmd"
click node_figures "https://github.com/charlesgwellem/gse178381_scrnaseq_eda/tree/master/figures"
click node_pathways "https://github.com/charlesgwellem/gse178381_scrnaseq_eda/tree/master/results"
click node_report "https://github.com/charlesgwellem/gse178381_scrnaseq_eda/blob/master/report/QC_clustering_DEA.html"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_load,node_seurat,node_qc,node_filter toneBlue
class node_normalize,node_cycle,node_pca,node_integration,node_cluster,node_dataset toneAmber
class node_dea,node_markers,node_enrichment toneMint
class node_figures,node_pathways,node_report toneRose
class node_researcher toneIndigo
```

## Components

### Data preparation

- [Load count data](https://github.com/charlesgwellem/gse178381_scrnaseq_eda/blob/master/scripts/QC_clustering_DEA.Rmd): `scripts/QC_clustering_DEA.Rmd`
- [Seurat object](https://github.com/charlesgwellem/gse178381_scrnaseq_eda/blob/master/scripts/QC_clustering_DEA.Rmd): `scripts/QC_clustering_DEA.Rmd`
- [Quality control](https://github.com/charlesgwellem/gse178381_scrnaseq_eda/blob/master/scripts/QC_clustering_DEA.Rmd): `scripts/QC_clustering_DEA.Rmd`
- [Cell and gene filtering](https://github.com/charlesgwellem/gse178381_scrnaseq_eda/blob/master/scripts/QC_clustering_DEA.Rmd): `scripts/QC_clustering_DEA.Rmd`

### Cell analysis

- [Normalization](https://github.com/charlesgwellem/gse178381_scrnaseq_eda/blob/master/scripts/QC_clustering_DEA.Rmd): `scripts/QC_clustering_DEA.Rmd`
- [Cell cycle scoring](https://github.com/charlesgwellem/gse178381_scrnaseq_eda/blob/master/scripts/QC_clustering_DEA.Rmd): `scripts/QC_clustering_DEA.Rmd`
- [PCA](https://github.com/charlesgwellem/gse178381_scrnaseq_eda/blob/master/scripts/QC_clustering_DEA.Rmd): `scripts/QC_clustering_DEA.Rmd`
- [Data integration](https://github.com/charlesgwellem/gse178381_scrnaseq_eda/blob/master/scripts/QC_clustering_DEA.Rmd): `scripts/QC_clustering_DEA.Rmd`
- [UMAP and clustering](https://github.com/charlesgwellem/gse178381_scrnaseq_eda/blob/master/scripts/QC_clustering_DEA.Rmd): `scripts/QC_clustering_DEA.Rmd`

### Biological interpretation

- [Differential expression](https://github.com/charlesgwellem/gse178381_scrnaseq_eda/blob/master/scripts/QC_clustering_DEA.Rmd): `scripts/QC_clustering_DEA.Rmd`
- [Tissue-specific markers](https://github.com/charlesgwellem/gse178381_scrnaseq_eda/blob/master/scripts/QC_clustering_DEA.Rmd): `scripts/QC_clustering_DEA.Rmd`
- [Functional enrichment](https://github.com/charlesgwellem/gse178381_scrnaseq_eda/blob/master/scripts/QC_clustering_DEA.Rmd): `scripts/QC_clustering_DEA.Rmd`

### Analysis outputs

- [Analysis figures](https://github.com/charlesgwellem/gse178381_scrnaseq_eda/tree/master/figures): `figures`
- [Pathway workbooks](https://github.com/charlesgwellem/gse178381_scrnaseq_eda/tree/master/results): `results`
- [HTML report](https://github.com/charlesgwellem/gse178381_scrnaseq_eda/blob/master/report/QC_clustering_DEA.html): `report/QC_clustering_DEA.html`

### Other components

- **Researcher**
- **GSE178318 data**

## Connections

- Researcher → Load count data: starts analysis (evidence: `README.md`)
- GSE178318 data → Load count data: provides counts (evidence: `README.md`)
- Load count data → Seurat object: creates object (evidence: `README.md`)
- Seurat object → Quality control: assesses cells (evidence: `README.md`)
- Quality control → Cell and gene filtering: guides filtering (evidence: `README.md`)
- Cell and gene filtering → Normalization: precedes normalization (evidence: `README.md`)
- Normalization → Cell cycle scoring: scores phases (evidence: `README.md`)
- Cell cycle scoring → PCA: examines variability (evidence: `README.md`)
- PCA → Data integration: motivates integration (evidence: `README.md`)
- Data integration → UMAP and clustering: supports clustering (evidence: `README.md`)
- UMAP and clustering → Differential expression: identifies groups (evidence: `README.md`)
- Differential expression → Tissue-specific markers: identifies markers (evidence: `README.md`)
- Tissue-specific markers → Functional enrichment: supplies marker genes (evidence: `README.md`)
- Tissue-specific markers → Analysis figures: visualizes markers (evidence: `README.md`)
- Functional enrichment → Pathway workbooks: records pathways (evidence: `README.md`)
- UMAP and clustering → Analysis figures: visualizes analysis (evidence: `README.md`)
- Differential expression → HTML report: reports analysis
