# fentouxungui/seuratexplorer architecture

> Architecture diagram of the GitHub repository fentouxungui/seuratexplorer, 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/fentouxungui/seuratexplorer
- Repository: https://github.com/fentouxungui/seuratexplorer

## Overview

SeuratExplorer is a Shiny dashboard for non-programmers to explore processed Seurat single-cell data. Users launch the app locally or access a server deployment, provide an RDS or QS2 object, then use interactive visualizations and analysis tools; results can be downloaded as plots or CSV. The README documents these capabilities, but no source excerpts were provided, so internal feature links reflect documented behavior rather than verified calls.

Main entry points: [`R`](https://github.com/fentouxungui/seuratexplorer/tree/main/R) (Shiny dashboard), [`R/launch.R`](https://github.com/fentouxungui/seuratexplorer/blob/main/R/launch.R) (Launch app)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["App entry"]
  node_launch["Launch app<br/>[launch.R]"]
  node_dashboard["Shiny dashboard"]
end

subgraph group_explore["Exploration and analysis"]
  node_visualize["Visualizations"]
  node_assays["Assay switching"]
  node_markers["Marker analysis"]
  node_correlations["Correlations"]
  node_summaries["Feature summaries"]
  node_annotations["Cluster annotation"]
  node_module_scores["Module scores"]
  node_batch["Batch analysis"]
end

subgraph group_results["Results and export"]
  node_plot_download["Plot download"]
  node_csv_export["CSV export"]
end

node_user(("User"))
node_seurat_file["Seurat object"]
node_pdf["PDF figures"]
node_csv["CSV results"]

node_user -->|"launches"| node_launch
node_launch -->|"starts"| node_dashboard
node_user -->|"provides"| node_seurat_file
node_dashboard -->|"explores"| node_seurat_file
node_dashboard -.->|"offers"| node_visualize
node_dashboard -.->|"offers"| node_assays
node_dashboard -.->|"offers"| node_markers
node_dashboard -.->|"offers"| node_correlations
node_dashboard -.->|"offers"| node_summaries
node_dashboard -.->|"offers"| node_annotations
node_dashboard -.->|"offers"| node_module_scores
node_dashboard -.->|"offers"| node_batch
node_dashboard -.->|"offers"| node_plot_download
node_dashboard -.->|"offers"| node_csv_export
node_plot_download -->|"downloads"| node_pdf
node_csv_export -->|"exports"| node_csv

click node_launch "https://github.com/fentouxungui/seuratexplorer/blob/main/R/launch.R"
click node_dashboard "https://github.com/fentouxungui/seuratexplorer/tree/main/R"
click node_visualize "https://github.com/fentouxungui/seuratexplorer/tree/main/R"
click node_assays "https://github.com/fentouxungui/seuratexplorer/tree/main/R"
click node_markers "https://github.com/fentouxungui/seuratexplorer/tree/main/R"
click node_correlations "https://github.com/fentouxungui/seuratexplorer/tree/main/R"
click node_summaries "https://github.com/fentouxungui/seuratexplorer/tree/main/R"
click node_annotations "https://github.com/fentouxungui/seuratexplorer/tree/main/R"
click node_module_scores "https://github.com/fentouxungui/seuratexplorer/tree/main/R"
click node_batch "https://github.com/fentouxungui/seuratexplorer/tree/main/R"
click node_plot_download "https://github.com/fentouxungui/seuratexplorer/tree/main/R"
click node_csv_export "https://github.com/fentouxungui/seuratexplorer/tree/main/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_launch,node_dashboard,node_user toneBlue
class node_visualize,node_assays,node_markers,node_correlations,node_summaries,node_annotations,node_module_scores,node_batch toneAmber
class node_plot_download,node_csv_export toneMint
class node_seurat_file,node_pdf,node_csv toneIndigo
```

## Components

### App entry

- [Launch app](https://github.com/fentouxungui/seuratexplorer/blob/main/R/launch.R): `R/launch.R`
- [Shiny dashboard](https://github.com/fentouxungui/seuratexplorer/tree/main/R): `R`

### Exploration and analysis

- [Visualizations](https://github.com/fentouxungui/seuratexplorer/tree/main/R): `R`
- [Assay switching](https://github.com/fentouxungui/seuratexplorer/tree/main/R): `R`
- [Marker analysis](https://github.com/fentouxungui/seuratexplorer/tree/main/R): `R`
- [Correlations](https://github.com/fentouxungui/seuratexplorer/tree/main/R): `R`
- [Feature summaries](https://github.com/fentouxungui/seuratexplorer/tree/main/R): `R`
- [Cluster annotation](https://github.com/fentouxungui/seuratexplorer/tree/main/R): `R`
- [Module scores](https://github.com/fentouxungui/seuratexplorer/tree/main/R): `R`
- [Batch analysis](https://github.com/fentouxungui/seuratexplorer/tree/main/R): `R`

### Results and export

- [Plot download](https://github.com/fentouxungui/seuratexplorer/tree/main/R): `R`
- [CSV export](https://github.com/fentouxungui/seuratexplorer/tree/main/R): `R`

### Other components

- **User**
- **Seurat object**
- **PDF figures**
- **CSV results**

## Connections

- User → Launch app: launches (evidence: `README.md`)
- Launch app → Shiny dashboard: starts (evidence: `README.md`)
- User → Seurat object: provides (evidence: `README.md`)
- Shiny dashboard → Seurat object: explores (evidence: `README.md`)
- Shiny dashboard → Visualizations: offers
- Shiny dashboard → Assay switching: offers
- Shiny dashboard → Marker analysis: offers
- Shiny dashboard → Correlations: offers
- Shiny dashboard → Feature summaries: offers
- Shiny dashboard → Cluster annotation: offers
- Shiny dashboard → Module scores: offers
- Shiny dashboard → Batch analysis: offers
- Shiny dashboard → Plot download: offers
- Shiny dashboard → CSV export: offers
- Plot download → PDF figures: downloads (evidence: `README.md`)
- CSV export → CSV results: exports (evidence: `README.md`)
