# ecological-complexity-lab/mira architecture

> Architecture diagram of the GitHub repository ecological-complexity-lab/mira, 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/ecological-complexity-lab/mira
- Repository: https://github.com/ecological-complexity-lab/mira

## Overview

MiRA is a browser-based multilayer-network exploration app. The main workflow is to load example or user data, parse it into a network model and derived metrics, then explore it through visualization modes, analytics, filtering, and export. The graph includes the documented modes and core calculation modules; some mode wiring is supported only by the README or SOURCE INDEX, so unsampled implementation details are not inferred.

Main entry points: [`js/app.js`](https://github.com/ecological-complexity-lab/mira/blob/main/js/app.js) (App controller), [`js/dataParser.js`](https://github.com/ecological-complexity-lab/mira/blob/main/js/dataParser.js) (Network parser), [`js/renderer.js`](https://github.com/ecological-complexity-lab/mira/blob/main/js/renderer.js) (Network renderer), [`js/metaNetwork.js`](https://github.com/ecological-complexity-lab/mira/blob/main/js/metaNetwork.js) (Meta-network view)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["App and data"]
  node_app["App controller<br/>[app.js]"]
  node_examples["Example datasets<br/>[demoDatasets.js]"]
  node_csv["CSV importer<br/>[csvImporter.js]"]
  node_parser["Network parser<br/>[dataParser.js]"]
  node_datafiles["Bundled networks"]
end

subgraph group_visual["Network views"]
  node_network["Network renderer<br/>[renderer.js]"]
  node_layout["Network layout<br/>[layout.js]"]
  node_interaction["Network interaction<br/>[interaction.js]"]
  node_grid["Grid view<br/>[gridView.js]"]
  node_layers["Layer view<br/>[layerView.js]"]
  node_metaview["Meta-network view<br/>[metaNetwork.js]"]
  node_map["Map mode<br/>[app.js]"]
  node_color["Color mapping<br/>[colorMapper.js]"]
end

subgraph group_analysis["Analytics"]
  node_dashboard["Dashboard<br/>[dashboard.js]"]
  node_data_mode["Data mode<br/>[dataMode.js]"]
  node_metrics["Node metrics<br/>[nodeMetrics.js]"]
  node_layer_metrics["Layer metrics<br/>[layerMetrics.js]"]
  node_similarity["Layer similarity<br/>[similarity.js]"]
  node_aggregation["Meta aggregation<br/>[metaAggregation.js]"]
end

subgraph group_tools["Interaction and output"]
  node_export["Image export<br/>[exportManager.js]"]
  node_session["Session management<br/>[sessionManager.js]"]
  node_tour["Guided tour<br/>[tourManager.js]"]
  node_feedback["Feedback<br/>[feedback.js]"]
end

node_user(("Researcher"))

node_user -->|"uses"| node_app
node_app -->|"loads examples"| node_examples
node_app -->|"imports CSV"| node_csv
node_app -->|"parses network"| node_parser
node_datafiles -.->|"supplies datasets"| node_examples
node_parser -->|"computes metrics"| node_metrics
node_metrics -.->|"provides model attributes"| node_network
node_app -->|"creates renderer"| node_network
node_app -->|"selects layouts"| node_layout
node_app -->|"handles interaction"| node_interaction
node_app -->|"switches views"| node_grid
node_app -->|"switches views"| node_layers
node_app -->|"switches views"| node_metaview
node_app -->|"provides map mode"| node_map
node_app -->|"switches views"| node_dashboard
node_app -->|"switches views"| node_data_mode
node_app -->|"saves and loads"| node_session
node_app -->|"exports views"| node_export
node_app -->|"offers tour"| node_tour
node_app -->|"offers feedback"| node_feedback
node_dashboard -->|"uses statistics"| node_layer_metrics
node_dashboard -->|"uses similarity"| node_similarity
node_metaview -->|"aggregates network"| node_aggregation
node_metaview -->|"uses colors"| node_color
node_network -->|"uses colors"| node_color
node_network -->|"uses filtering state"| node_data_mode
node_layers -->|"uses filtering state"| node_data_mode
node_parser -->|"calculates via index"| node_layer_metrics
node_parser -->|"calculates via index"| node_similarity
node_parser -->|"calculates via index"| node_aggregation

click node_app "https://github.com/ecological-complexity-lab/mira/blob/main/js/app.js"
click node_examples "https://github.com/ecological-complexity-lab/mira/blob/main/js/demoDatasets.js"
click node_csv "https://github.com/ecological-complexity-lab/mira/blob/main/js/csvImporter.js"
click node_parser "https://github.com/ecological-complexity-lab/mira/blob/main/js/dataParser.js"
click node_datafiles "https://github.com/ecological-complexity-lab/mira/tree/main/data"
click node_network "https://github.com/ecological-complexity-lab/mira/blob/main/js/renderer.js"
click node_layout "https://github.com/ecological-complexity-lab/mira/blob/main/js/layout.js"
click node_interaction "https://github.com/ecological-complexity-lab/mira/blob/main/js/interaction.js"
click node_grid "https://github.com/ecological-complexity-lab/mira/blob/main/js/gridView.js"
click node_layers "https://github.com/ecological-complexity-lab/mira/blob/main/js/layerView.js"
click node_metaview "https://github.com/ecological-complexity-lab/mira/blob/main/js/metaNetwork.js"
click node_map "https://github.com/ecological-complexity-lab/mira/blob/main/js/app.js"
click node_dashboard "https://github.com/ecological-complexity-lab/mira/blob/main/js/dashboard.js"
click node_data_mode "https://github.com/ecological-complexity-lab/mira/blob/main/js/dataMode.js"
click node_metrics "https://github.com/ecological-complexity-lab/mira/blob/main/js/calc/nodeMetrics.js"
click node_layer_metrics "https://github.com/ecological-complexity-lab/mira/blob/main/js/calc/layerMetrics.js"
click node_similarity "https://github.com/ecological-complexity-lab/mira/blob/main/js/calc/similarity.js"
click node_aggregation "https://github.com/ecological-complexity-lab/mira/blob/main/js/calc/metaAggregation.js"
click node_color "https://github.com/ecological-complexity-lab/mira/blob/main/js/colorMapper.js"
click node_export "https://github.com/ecological-complexity-lab/mira/blob/main/js/exportManager.js"
click node_session "https://github.com/ecological-complexity-lab/mira/blob/main/js/sessionManager.js"
click node_tour "https://github.com/ecological-complexity-lab/mira/blob/main/js/tourManager.js"
click node_feedback "https://github.com/ecological-complexity-lab/mira/blob/main/js/feedback.js"

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_examples,node_csv,node_parser,node_datafiles toneBlue
class node_network,node_layout,node_interaction,node_grid,node_layers,node_metaview,node_map,node_color toneAmber
class node_dashboard,node_data_mode,node_metrics,node_layer_metrics,node_similarity,node_aggregation toneMint
class node_export,node_session,node_tour,node_feedback toneRose
class node_user toneIndigo
```

## Components

### App and data

- [App controller](https://github.com/ecological-complexity-lab/mira/blob/main/js/app.js): `js/app.js`
- [Example datasets](https://github.com/ecological-complexity-lab/mira/blob/main/js/demoDatasets.js): `js/demoDatasets.js`
- [CSV importer](https://github.com/ecological-complexity-lab/mira/blob/main/js/csvImporter.js): `js/csvImporter.js`
- [Network parser](https://github.com/ecological-complexity-lab/mira/blob/main/js/dataParser.js): `js/dataParser.js`
- [Bundled networks](https://github.com/ecological-complexity-lab/mira/tree/main/data): `data`

### Network views

- [Network renderer](https://github.com/ecological-complexity-lab/mira/blob/main/js/renderer.js): `js/renderer.js`
- [Network layout](https://github.com/ecological-complexity-lab/mira/blob/main/js/layout.js): `js/layout.js`
- [Network interaction](https://github.com/ecological-complexity-lab/mira/blob/main/js/interaction.js): `js/interaction.js`
- [Grid view](https://github.com/ecological-complexity-lab/mira/blob/main/js/gridView.js): `js/gridView.js`
- [Layer view](https://github.com/ecological-complexity-lab/mira/blob/main/js/layerView.js): `js/layerView.js`
- [Meta-network view](https://github.com/ecological-complexity-lab/mira/blob/main/js/metaNetwork.js): `js/metaNetwork.js`
- [Map mode](https://github.com/ecological-complexity-lab/mira/blob/main/js/app.js): `js/app.js`
- [Color mapping](https://github.com/ecological-complexity-lab/mira/blob/main/js/colorMapper.js): `js/colorMapper.js`

### Analytics

- [Dashboard](https://github.com/ecological-complexity-lab/mira/blob/main/js/dashboard.js): `js/dashboard.js`
- [Data mode](https://github.com/ecological-complexity-lab/mira/blob/main/js/dataMode.js): `js/dataMode.js`
- [Node metrics](https://github.com/ecological-complexity-lab/mira/blob/main/js/calc/nodeMetrics.js): `js/calc/nodeMetrics.js`
- [Layer metrics](https://github.com/ecological-complexity-lab/mira/blob/main/js/calc/layerMetrics.js): `js/calc/layerMetrics.js`
- [Layer similarity](https://github.com/ecological-complexity-lab/mira/blob/main/js/calc/similarity.js): `js/calc/similarity.js`
- [Meta aggregation](https://github.com/ecological-complexity-lab/mira/blob/main/js/calc/metaAggregation.js): `js/calc/metaAggregation.js`

### Interaction and output

- [Image export](https://github.com/ecological-complexity-lab/mira/blob/main/js/exportManager.js): `js/exportManager.js`
- [Session management](https://github.com/ecological-complexity-lab/mira/blob/main/js/sessionManager.js): `js/sessionManager.js`
- [Guided tour](https://github.com/ecological-complexity-lab/mira/blob/main/js/tourManager.js): `js/tourManager.js`
- [Feedback](https://github.com/ecological-complexity-lab/mira/blob/main/js/feedback.js): `js/feedback.js`

### Other components

- **Researcher**

## Connections

- Researcher → App controller: uses (evidence: `README.md`)
- App controller → Example datasets: loads examples (evidence: `js/app.js`)
- App controller → CSV importer: imports CSV (evidence: `js/app.js`)
- App controller → Network parser: parses network (evidence: `js/app.js`)
- Bundled networks → Example datasets: supplies datasets (evidence: `README.md`)
- Network parser → Node metrics: computes metrics (evidence: `js/dataParser.js`)
- Node metrics → Network renderer: provides model attributes
- App controller → Network renderer: creates renderer (evidence: `js/app.js`)
- App controller → Network layout: selects layouts (evidence: `js/app.js`)
- App controller → Network interaction: handles interaction (evidence: `js/app.js`)
- App controller → Grid view: switches views (evidence: `js/app.js`)
- App controller → Layer view: switches views (evidence: `js/app.js`)
- App controller → Meta-network view: switches views (evidence: `js/app.js`)
- App controller → Map mode: provides map mode (evidence: `README.md`)
- App controller → Dashboard: switches views (evidence: `js/app.js`)
- App controller → Data mode: switches views (evidence: `js/app.js`)
- App controller → Session management: saves and loads (evidence: `js/app.js`)
- App controller → Image export: exports views (evidence: `js/app.js`)
- App controller → Guided tour: offers tour (evidence: `js/app.js`)
- App controller → Feedback: offers feedback (evidence: `js/app.js`)
- Dashboard → Layer metrics: uses statistics (evidence: `js/dashboard.js`)
- Dashboard → Layer similarity: uses similarity (evidence: `js/dashboard.js`)
- Meta-network view → Meta aggregation: aggregates network (evidence: `js/metaNetwork.js`)
- Meta-network view → Color mapping: uses colors (evidence: `js/metaNetwork.js`)
- Network renderer → Color mapping: uses colors (evidence: `js/renderer.js`)
- Network renderer → Data mode: uses filtering state (evidence: `js/renderer.js`)
- Layer view → Data mode: uses filtering state (evidence: `js/layerView.js`)
- Network parser → Layer metrics: calculates via index
- Network parser → Layer similarity: calculates via index
- Network parser → Meta aggregation: calculates via index
