# jvtarss/ema-2026 architecture

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

- Interactive diagram: https://gitdiagram.com/jvtarss/ema-2026
- Repository: https://github.com/jvtarss/ema-2026

## Overview

EMA is a curated *Eucalyptus grandis* microRNA archive: researchers use its locus-resolved catalog and study-level evidence, with expression, differential-expression, target, and network data as supporting capabilities. The SQLite database is documented as the source of truth for the exported data. Network scripts also process PPI edges and add functional groupings. The tree does not contain the documented webapp or export script, and sampled source does not show the full analysis pipeline, so those relationships are not inferred.

Main entry points: [`db/ema-v1.db`](https://github.com/jvtarss/ema-2026/blob/main/db/ema-v1.db) (EMA SQLite), [`data/network-nodes.csv`](https://github.com/jvtarss/ema-2026/blob/main/data/network-nodes.csv) (Network nodes), [`scripts/network/build-network.py`](https://github.com/jvtarss/ema-2026/blob/main/scripts/network/build-network.py) (Network builder), [`data/catalog.csv`](https://github.com/jvtarss/ema-2026/blob/main/data/catalog.csv) (miRNA catalog)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_archive["Archive data"]
  node_database[("EMA SQLite<br/>[ema-v1.db]")]
  node_catalog["miRNA catalog<br/>[catalog.csv]"]
  node_evidence["Study evidence<br/>[evidence-table.csv]"]
end

subgraph group_expression["Expression evidence"]
  node_metadata["Sample metadata"]
  node_matrix["Expression matrix"]
  node_de["Differential expression"]
end

subgraph group_targets["Targets and network"]
  node_predictions["Target predictions"]
  node_networkedges["miRNA-target edges"]
  node_networknodes["Network nodes<br/>[network-nodes.csv]"]
  node_ppi["PPI harmonization<br/>[process-ppi.py]"]
  node_networkbuild["Network builder<br/>[build-network.py]"]
  node_functional["Functional categories<br/>[functional.py]"]
  node_grouping["GO-based grouping<br/>[grouping.py]"]
end

subgraph group_analysis["Analysis views"]
  node_upset["Study overlap figure<br/>[figure-2a-upset.py]"]
  node_trend["Read-count trend"]
  node_locations["miRNA locations figure"]
end

node_researcher(("Researcher"))

node_researcher -->|"consults"| node_catalog
node_researcher -->|"checks evidence"| node_evidence
node_database -->|"source for"| node_catalog
node_database -->|"source for"| node_evidence
node_database -->|"source for"| node_metadata
node_database -->|"source for"| node_matrix
node_database -->|"source for"| node_de
node_database -->|"source for"| node_predictions
node_database -->|"source for"| node_networknodes
node_database -->|"source for"| node_networkedges
node_ppi -->|"provides PPI edges"| node_networkbuild
node_networkbuild -->|"writes edges"| node_networkedges
node_networkbuild -->|"writes attributes"| node_networknodes
node_functional -->|"adds categories"| node_networknodes
node_grouping -->|"adds GO groups"| node_networknodes
node_upset -->|"queries samples and expression"| node_database
node_trend -->|"queries read counts"| node_database
node_locations -->|"queries miRNA loci"| node_database

click node_database "https://github.com/jvtarss/ema-2026/blob/main/db/ema-v1.db"
click node_catalog "https://github.com/jvtarss/ema-2026/blob/main/data/catalog.csv"
click node_evidence "https://github.com/jvtarss/ema-2026/blob/main/data/evidence-table.csv"
click node_metadata "https://github.com/jvtarss/ema-2026/blob/main/data/sample-metadata.csv"
click node_matrix "https://github.com/jvtarss/ema-2026/blob/main/data/expression-matrix.csv"
click node_de "https://github.com/jvtarss/ema-2026/blob/main/data/differential-expression-results.csv"
click node_predictions "https://github.com/jvtarss/ema-2026/blob/main/data/target-predictions.csv"
click node_networkedges "https://github.com/jvtarss/ema-2026/blob/main/data/network-edges-mirna-target.csv"
click node_networknodes "https://github.com/jvtarss/ema-2026/blob/main/data/network-nodes.csv"
click node_ppi "https://github.com/jvtarss/ema-2026/blob/main/scripts/network/process-ppi.py"
click node_networkbuild "https://github.com/jvtarss/ema-2026/blob/main/scripts/network/build-network.py"
click node_functional "https://github.com/jvtarss/ema-2026/blob/main/scripts/network/functional.py"
click node_grouping "https://github.com/jvtarss/ema-2026/blob/main/scripts/network/grouping.py"
click node_upset "https://github.com/jvtarss/ema-2026/blob/main/scripts/figures/figure-2a-upset.py"
click node_trend "https://github.com/jvtarss/ema-2026/blob/main/scripts/figures/figure-3c-star-mature-trend.py"
click node_locations "https://github.com/jvtarss/ema-2026/blob/main/scripts/figures/figure-unidentified.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_database,node_catalog,node_evidence toneBlue
class node_metadata,node_matrix,node_de toneAmber
class node_predictions,node_networkedges,node_networknodes,node_ppi,node_networkbuild,node_functional,node_grouping toneMint
class node_upset,node_trend,node_locations toneRose
class node_researcher toneIndigo
```

## Components

### Archive data

- [EMA SQLite](https://github.com/jvtarss/ema-2026/blob/main/db/ema-v1.db): `db/ema-v1.db`
- [miRNA catalog](https://github.com/jvtarss/ema-2026/blob/main/data/catalog.csv): `data/catalog.csv`
- [Study evidence](https://github.com/jvtarss/ema-2026/blob/main/data/evidence-table.csv): `data/evidence-table.csv`

### Expression evidence

- [Sample metadata](https://github.com/jvtarss/ema-2026/blob/main/data/sample-metadata.csv): `data/sample-metadata.csv`
- [Expression matrix](https://github.com/jvtarss/ema-2026/blob/main/data/expression-matrix.csv): `data/expression-matrix.csv`
- [Differential expression](https://github.com/jvtarss/ema-2026/blob/main/data/differential-expression-results.csv): `data/differential-expression-results.csv`

### Targets and network

- [Target predictions](https://github.com/jvtarss/ema-2026/blob/main/data/target-predictions.csv): `data/target-predictions.csv`
- [miRNA-target edges](https://github.com/jvtarss/ema-2026/blob/main/data/network-edges-mirna-target.csv): `data/network-edges-mirna-target.csv`
- [Network nodes](https://github.com/jvtarss/ema-2026/blob/main/data/network-nodes.csv): `data/network-nodes.csv`
- [PPI harmonization](https://github.com/jvtarss/ema-2026/blob/main/scripts/network/process-ppi.py): `scripts/network/process-ppi.py`
- [Network builder](https://github.com/jvtarss/ema-2026/blob/main/scripts/network/build-network.py): `scripts/network/build-network.py`
- [Functional categories](https://github.com/jvtarss/ema-2026/blob/main/scripts/network/functional.py): `scripts/network/functional.py`
- [GO-based grouping](https://github.com/jvtarss/ema-2026/blob/main/scripts/network/grouping.py): `scripts/network/grouping.py`

### Analysis views

- [Study overlap figure](https://github.com/jvtarss/ema-2026/blob/main/scripts/figures/figure-2a-upset.py): `scripts/figures/figure-2a-upset.py`
- [Read-count trend](https://github.com/jvtarss/ema-2026/blob/main/scripts/figures/figure-3c-star-mature-trend.py): `scripts/figures/figure-3c-star-mature-trend.py`
- [miRNA locations figure](https://github.com/jvtarss/ema-2026/blob/main/scripts/figures/figure-unidentified.py): `scripts/figures/figure-unidentified.py`

### Other components

- **Researcher**

## Connections

- Researcher → miRNA catalog: consults (evidence: `README.md`)
- Researcher → Study evidence: checks evidence (evidence: `README.md`)
- EMA SQLite → miRNA catalog: source for (evidence: `README.md`)
- EMA SQLite → Study evidence: source for (evidence: `README.md`)
- EMA SQLite → Sample metadata: source for (evidence: `README.md`)
- EMA SQLite → Expression matrix: source for (evidence: `README.md`)
- EMA SQLite → Differential expression: source for (evidence: `README.md`)
- EMA SQLite → Target predictions: source for (evidence: `README.md`)
- EMA SQLite → Network nodes: source for (evidence: `README.md`)
- EMA SQLite → miRNA-target edges: source for (evidence: `README.md`)
- PPI harmonization → Network builder: provides PPI edges (evidence: `scripts/network/build-network.py`)
- Network builder → miRNA-target edges: writes edges (evidence: `scripts/network/build-network.py`)
- Network builder → Network nodes: writes attributes (evidence: `scripts/network/build-network.py`)
- Functional categories → Network nodes: adds categories (evidence: `scripts/network/functional.py`)
- GO-based grouping → Network nodes: adds GO groups (evidence: `scripts/network/grouping.py`)
- Study overlap figure → EMA SQLite: queries samples and expression (evidence: `scripts/figures/figure-2a-upset.py`)
- Read-count trend → EMA SQLite: queries read counts (evidence: `scripts/figures/figure-3c-star-mature-trend.py`)
- miRNA locations figure → EMA SQLite: queries miRNA loci (evidence: `scripts/figures/figure-unidentified.py`)
