# chenliu-1996/figures4papers architecture

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

- Interactive diagram: https://gitdiagram.com/chenliu-1996/figures4papers
- Repository: https://github.com/chenliu-1996/figures4papers

## Overview

This repository is a collection of Python scripts that create publication-quality research figures, plus a scientific-figure-making skill for AI coding agents. The main workflow is an author or agent consulting the skill, creating or adapting a project-specific plotting script, running it, and checking the exported figure. Project scripts cover comparison, ablation, distributions, manifolds, trends, and other visualizations; most embed their data, while ImmunoStruct separates data from plotting. Edges reflect README-described workflow or visible source relationships; unsampled project scripts are grouped by directory, so their internal calls are not inferred.

Main entry points: [`figure_ImmunoStruct/plot_bars.py`](https://github.com/chenliu-1996/figures4papers/blob/main/figure_ImmunoStruct/plot_bars.py) (ImmunoStruct Bar Plots), [`figure_Brainteaser`](https://github.com/chenliu-1996/figures4papers/tree/main/figure_Brainteaser) (Brainteaser Plots), [`figure_CellSpliceNet`](https://github.com/chenliu-1996/figures4papers/tree/main/figure_CellSpliceNet) (CellSpliceNet Plots), [`figure_VIGIL`](https://github.com/chenliu-1996/figures4papers/tree/main/figure_VIGIL) (VIGIL Plots)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_guidance["Authoring Guidance"]
  node_skill["Figure-Making Skill<br/>[SKILL.md]"]
  node_skill_refs["Skill References"]
  node_scripts["Project Plot Scripts"]
end

subgraph group_evaluation["Evaluation Figures"]
  node_brain["Brainteaser Plots"]
  node_cell["CellSpliceNet Plots"]
  node_immuno_plot["ImmunoStruct Bar Plots<br/>[plot_bars.py]"]
  node_immuno_data["ImmunoStruct Data<br/>[raw_data.py]"]
  node_vigil["VIGIL Plots"]
end

subgraph group_methods["Methods Figures"]
  node_cflows["Cflows Plots"]
  node_dispersion["Dispersion Plots"]
  node_rna["RNAGenScape Plots"]
end

subgraph group_surveys["Survey Figures"]
  node_ophthal_trend["Publication Trends<br/>[plot_trend.py]"]
  node_ophthal_comp["Clinical Composition"]
end

node_author(("Author or Agent"))
node_rendered["Exported Figures"]

node_author -->|"consults"| node_skill
node_author -->|"consults"| node_skill_refs
node_author -->|"creates or adapts"| node_scripts
node_scripts -->|"exports figures"| node_rendered
node_immuno_plot -->|"imports data"| node_immuno_data
node_brain -.->|"exports figures"| node_rendered
node_cell -.->|"exports figures"| node_rendered
node_immuno_plot -.->|"exports figures"| node_rendered
node_vigil -.->|"exports figures"| node_rendered
node_cflows -.->|"exports figures"| node_rendered
node_dispersion -.->|"exports figures"| node_rendered
node_rna -.->|"exports figures"| node_rendered
node_ophthal_trend -->|"exports figure"| node_rendered
node_ophthal_comp -->|"exports figure"| node_rendered

click node_skill "https://github.com/chenliu-1996/figures4papers/blob/main/scientific-figure-making/SKILL.md"
click node_skill_refs "https://github.com/chenliu-1996/figures4papers/tree/main/scientific-figure-making/references"
click node_brain "https://github.com/chenliu-1996/figures4papers/tree/main/figure_Brainteaser"
click node_cell "https://github.com/chenliu-1996/figures4papers/tree/main/figure_CellSpliceNet"
click node_immuno_plot "https://github.com/chenliu-1996/figures4papers/blob/main/figure_ImmunoStruct/plot_bars.py"
click node_immuno_data "https://github.com/chenliu-1996/figures4papers/blob/main/figure_ImmunoStruct/raw_data.py"
click node_vigil "https://github.com/chenliu-1996/figures4papers/tree/main/figure_VIGIL"
click node_cflows "https://github.com/chenliu-1996/figures4papers/tree/main/figure_Cflows"
click node_dispersion "https://github.com/chenliu-1996/figures4papers/tree/main/figure_Dispersion"
click node_rna "https://github.com/chenliu-1996/figures4papers/tree/main/figure_RNAGenScape"
click node_ophthal_trend "https://github.com/chenliu-1996/figures4papers/blob/main/figure_ophthal_review/plot_trend.py"
click node_ophthal_comp "https://github.com/chenliu-1996/figures4papers/blob/main/figure_ophthal_review/plot_composition.py"

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_skill,node_skill_refs,node_scripts toneBlue
class node_brain,node_cell,node_immuno_plot,node_immuno_data,node_vigil toneAmber
class node_cflows,node_dispersion,node_rna toneMint
class node_ophthal_trend,node_ophthal_comp toneRose
class node_author,node_rendered toneIndigo
```

## Components

### Authoring Guidance

- [Figure-Making Skill](https://github.com/chenliu-1996/figures4papers/blob/main/scientific-figure-making/SKILL.md): `scientific-figure-making/SKILL.md`
- [Skill References](https://github.com/chenliu-1996/figures4papers/tree/main/scientific-figure-making/references): `scientific-figure-making/references`
- **Project Plot Scripts**

### Evaluation Figures

- [Brainteaser Plots](https://github.com/chenliu-1996/figures4papers/tree/main/figure_Brainteaser): `figure_Brainteaser`
- [CellSpliceNet Plots](https://github.com/chenliu-1996/figures4papers/tree/main/figure_CellSpliceNet): `figure_CellSpliceNet`
- [ImmunoStruct Bar Plots](https://github.com/chenliu-1996/figures4papers/blob/main/figure_ImmunoStruct/plot_bars.py): `figure_ImmunoStruct/plot_bars.py`
- [ImmunoStruct Data](https://github.com/chenliu-1996/figures4papers/blob/main/figure_ImmunoStruct/raw_data.py): `figure_ImmunoStruct/raw_data.py`
- [VIGIL Plots](https://github.com/chenliu-1996/figures4papers/tree/main/figure_VIGIL): `figure_VIGIL`

### Methods Figures

- [Cflows Plots](https://github.com/chenliu-1996/figures4papers/tree/main/figure_Cflows): `figure_Cflows`
- [Dispersion Plots](https://github.com/chenliu-1996/figures4papers/tree/main/figure_Dispersion): `figure_Dispersion`
- [RNAGenScape Plots](https://github.com/chenliu-1996/figures4papers/tree/main/figure_RNAGenScape): `figure_RNAGenScape`

### Survey Figures

- [Publication Trends](https://github.com/chenliu-1996/figures4papers/blob/main/figure_ophthal_review/plot_trend.py): `figure_ophthal_review/plot_trend.py`
- [Clinical Composition](https://github.com/chenliu-1996/figures4papers/blob/main/figure_ophthal_review/plot_composition.py): `figure_ophthal_review/plot_composition.py`

### Other components

- **Author or Agent**
- **Exported Figures**

## Connections

- Author or Agent → Figure-Making Skill: consults (evidence: `README.md`)
- Author or Agent → Skill References: consults (evidence: `README.md`)
- Author or Agent → Project Plot Scripts: creates or adapts (evidence: `README.md`)
- Project Plot Scripts → Exported Figures: exports figures (evidence: `README.md`)
- ImmunoStruct Bar Plots → ImmunoStruct Data: imports data (evidence: `figure_ImmunoStruct/plot_bars.py`)
- Brainteaser Plots → Exported Figures: exports figures
- CellSpliceNet Plots → Exported Figures: exports figures
- ImmunoStruct Bar Plots → Exported Figures: exports figures
- VIGIL Plots → Exported Figures: exports figures
- Cflows Plots → Exported Figures: exports figures
- Dispersion Plots → Exported Figures: exports figures
- RNAGenScape Plots → Exported Figures: exports figures
- Publication Trends → Exported Figures: exports figure (evidence: `figure_ophthal_review/plot_trend.py`)
- Clinical Composition → Exported Figures: exports figure (evidence: `figure_ophthal_review/plot_composition.py`)
