# aitmahfoud-rahma/seuratdeepexplorer architecture

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

- Interactive diagram: https://gitdiagram.com/aitmahfoud-rahma/seuratdeepexplorer
- Repository: https://github.com/aitmahfoud-rahma/seuratdeepexplorer

## Overview

Seurat Explorer is a modular Shiny application for uploading a Seurat `.rds` object and exploring its clusters, expression, metadata, differential markers, and functional enrichment. The documented workflow runs from upload and validation to visual exploration or marker analysis; marker genes can then be sent to enrichment. The README describes the modules and application structure, but no source excerpts were provided, so the relationships below are limited to those documented there.

Main entry points: [`app.R`](https://github.com/aitmahfoud-rahma/seuratdeepexplorer/blob/main/app.R) (Shiny app), [`R/mod_data_upload.R`](https://github.com/aitmahfoud-rahma/seuratdeepexplorer/blob/main/R/mod_data_upload.R) (Data upload), [`R/mod_markers.R`](https://github.com/aitmahfoud-rahma/seuratdeepexplorer/blob/main/R/mod_markers.R) (Differential markers), [`R/mod_dimplot.R`](https://github.com/aitmahfoud-rahma/seuratdeepexplorer/blob/main/R/mod_dimplot.R) (Cluster plots)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_application["Application shell"]
  node_app["Shiny app<br/>[app.R]"]
  node_global["Theme and modules<br/>[global.R]"]
end

subgraph group_data["Data and controls"]
  node_upload["Data upload<br/>[mod_data_upload.R]"]
  node_controls["Shared selectors<br/>[mod_controls.R]"]
  node_utils["Shared helpers<br/>[utils.R]"]
end

subgraph group_exploration["Seurat exploration"]
  node_dimplot["Cluster plots<br/>[mod_dimplot.R]"]
  node_featureplot["Feature plots<br/>[mod_featureplot.R]"]
  node_vlnplot["Violin plots<br/>[mod_vlnplot.R]"]
  node_dotplot["Dot plots<br/>[mod_dotplot.R]"]
  node_metadata["Metadata view<br/>[mod_metadata.R]"]
end

subgraph group_analysis["Marker analysis"]
  node_markers["Differential markers<br/>[mod_markers.R]"]
  node_enrichment["Functional enrichment<br/>[mod_enrichment.R]"]
end

node_user(("User"))

node_user -->|"uses"| node_app
node_app -->|"assembles with"| node_global
node_app -->|"presents"| node_upload
node_app -->|"presents"| node_controls
node_app -->|"presents"| node_dimplot
node_app -->|"presents"| node_featureplot
node_app -->|"presents"| node_vlnplot
node_app -->|"presents"| node_dotplot
node_app -->|"presents"| node_metadata
node_app -->|"presents"| node_markers
node_app -->|"presents"| node_enrichment
node_user -->|"uploads Seurat"| node_upload
node_upload -->|"supplies object"| node_dimplot
node_upload -->|"supplies object"| node_featureplot
node_upload -->|"supplies object"| node_vlnplot
node_upload -->|"supplies object"| node_dotplot
node_upload -->|"supplies object"| node_metadata
node_upload -->|"supplies object"| node_markers
node_markers -->|"sends gene list"| node_enrichment

click node_app "https://github.com/aitmahfoud-rahma/seuratdeepexplorer/blob/main/app.R"
click node_global "https://github.com/aitmahfoud-rahma/seuratdeepexplorer/blob/main/global.R"
click node_upload "https://github.com/aitmahfoud-rahma/seuratdeepexplorer/blob/main/R/mod_data_upload.R"
click node_controls "https://github.com/aitmahfoud-rahma/seuratdeepexplorer/blob/main/R/mod_controls.R"
click node_dimplot "https://github.com/aitmahfoud-rahma/seuratdeepexplorer/blob/main/R/mod_dimplot.R"
click node_featureplot "https://github.com/aitmahfoud-rahma/seuratdeepexplorer/blob/main/R/mod_featureplot.R"
click node_vlnplot "https://github.com/aitmahfoud-rahma/seuratdeepexplorer/blob/main/R/mod_vlnplot.R"
click node_dotplot "https://github.com/aitmahfoud-rahma/seuratdeepexplorer/blob/main/R/mod_dotplot.R"
click node_metadata "https://github.com/aitmahfoud-rahma/seuratdeepexplorer/blob/main/R/mod_metadata.R"
click node_utils "https://github.com/aitmahfoud-rahma/seuratdeepexplorer/blob/main/R/utils.R"
click node_markers "https://github.com/aitmahfoud-rahma/seuratdeepexplorer/blob/main/R/mod_markers.R"
click node_enrichment "https://github.com/aitmahfoud-rahma/seuratdeepexplorer/blob/main/R/mod_enrichment.R"

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_app,node_global,node_user toneBlue
class node_upload,node_controls,node_utils toneAmber
class node_dimplot,node_featureplot,node_vlnplot,node_dotplot,node_metadata toneMint
class node_markers,node_enrichment toneRose
```

## Components

### Application shell

- [Shiny app](https://github.com/aitmahfoud-rahma/seuratdeepexplorer/blob/main/app.R): `app.R`
- [Theme and modules](https://github.com/aitmahfoud-rahma/seuratdeepexplorer/blob/main/global.R): `global.R`

### Data and controls

- [Data upload](https://github.com/aitmahfoud-rahma/seuratdeepexplorer/blob/main/R/mod_data_upload.R): `R/mod_data_upload.R`
- [Shared selectors](https://github.com/aitmahfoud-rahma/seuratdeepexplorer/blob/main/R/mod_controls.R): `R/mod_controls.R`
- [Shared helpers](https://github.com/aitmahfoud-rahma/seuratdeepexplorer/blob/main/R/utils.R): `R/utils.R`

### Seurat exploration

- [Cluster plots](https://github.com/aitmahfoud-rahma/seuratdeepexplorer/blob/main/R/mod_dimplot.R): `R/mod_dimplot.R`
- [Feature plots](https://github.com/aitmahfoud-rahma/seuratdeepexplorer/blob/main/R/mod_featureplot.R): `R/mod_featureplot.R`
- [Violin plots](https://github.com/aitmahfoud-rahma/seuratdeepexplorer/blob/main/R/mod_vlnplot.R): `R/mod_vlnplot.R`
- [Dot plots](https://github.com/aitmahfoud-rahma/seuratdeepexplorer/blob/main/R/mod_dotplot.R): `R/mod_dotplot.R`
- [Metadata view](https://github.com/aitmahfoud-rahma/seuratdeepexplorer/blob/main/R/mod_metadata.R): `R/mod_metadata.R`

### Marker analysis

- [Differential markers](https://github.com/aitmahfoud-rahma/seuratdeepexplorer/blob/main/R/mod_markers.R): `R/mod_markers.R`
- [Functional enrichment](https://github.com/aitmahfoud-rahma/seuratdeepexplorer/blob/main/R/mod_enrichment.R): `R/mod_enrichment.R`

### Other components

- **User**

## Connections

- User → Shiny app: uses (evidence: `README.md`)
- Shiny app → Theme and modules: assembles with (evidence: `README.md`)
- Shiny app → Data upload: presents (evidence: `README.md`)
- Shiny app → Shared selectors: presents (evidence: `README.md`)
- Shiny app → Cluster plots: presents (evidence: `README.md`)
- Shiny app → Feature plots: presents (evidence: `README.md`)
- Shiny app → Violin plots: presents (evidence: `README.md`)
- Shiny app → Dot plots: presents (evidence: `README.md`)
- Shiny app → Metadata view: presents (evidence: `README.md`)
- Shiny app → Differential markers: presents (evidence: `README.md`)
- Shiny app → Functional enrichment: presents (evidence: `README.md`)
- User → Data upload: uploads Seurat (evidence: `README.md`)
- Data upload → Cluster plots: supplies object (evidence: `README.md`)
- Data upload → Feature plots: supplies object (evidence: `README.md`)
- Data upload → Violin plots: supplies object (evidence: `README.md`)
- Data upload → Dot plots: supplies object (evidence: `README.md`)
- Data upload → Metadata view: supplies object (evidence: `README.md`)
- Data upload → Differential markers: supplies object (evidence: `README.md`)
- Differential markers → Functional enrichment: sends gene list (evidence: `README.md`)
