# vianamp/mitograph architecture

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

- Interactive diagram: https://gitdiagram.com/vianamp/mitograph
- Repository: https://github.com/vianamp/mitograph

## Overview

MitoGraph is a command-line image-processing application for quantifying mitochondrial network morphology. Its principal workflow takes image data and spatial calibration, performs segmentation and skeletonization, derives network measurements, and exports graph, image, text, and VTK results. The README documents input modes, adaptive thresholding, connected-component analysis, and output formats; the main implementation is not excerpted, so internal stage connections are shown as unverified. The repository also includes standalone conversion utilities. Those utility paths are visible in the tree, but their complete behavior was not sampled.

Main entry points: [`MitoGraph.cxx`](https://github.com/vianamp/mitograph/blob/master/MitoGraph.cxx) (MitoGraph CLI), [`MitoThinning.cxx`](https://github.com/vianamp/mitograph/blob/master/MitoThinning.cxx) (3D thinning), [`GraphAnalyzer.R`](https://github.com/vianamp/mitograph/blob/master/GraphAnalyzer.R) (Component analysis), [`tools/seg2para/seg2para.cpp`](https://github.com/vianamp/mitograph/blob/master/tools/seg2para/seg2para.cpp) (Segmentation converter)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workflow["Analysis workflow"]
  node_mitograph["MitoGraph CLI<br/>[MitoGraph.cxx]"]
  node_image_input["Image input<br/>[MitoGraph.cxx]"]
end

subgraph group_core["Image and skeleton processing"]
  node_segmentation["Segmentation<br/>[MitoGraph.cxx]"]
  node_thinning["3D thinning<br/>[MitoThinning.cxx]"]
  node_thinning_api["Thinning API<br/>[MitoThinning.h]"]
  node_skeleton_rules["Skeleton rules<br/>[ssThinning.h]"]
  node_shared_types["Shared data types<br/>[includes.h]"]
end

subgraph group_results["Measurements and outputs"]
  node_network_graph["Network graph<br/>[MitoGraph.cxx]"]
  node_morphology_stats["Morphology statistics<br/>[MitoGraph.cxx]"]
  node_component_analysis["Component analysis<br/>[GraphAnalyzer.R]"]
  node_result_files["Analysis files<br/>[MitoGraph.cxx]"]
  node_vtk_exports["VTK exports<br/>[MitoGraph.cxx]"]
end

subgraph group_utilities["Standalone utilities"]
  node_seg2para["Segmentation converter<br/>[seg2para.cpp]"]
  node_skeleton_image["Skeleton image tool<br/>[skell2img.cxx]"]
end

node_researcher(("Researcher"))
node_r_runtime(("R runtime"))

node_researcher -->|"runs"| node_mitograph
node_mitograph -.->|"loads images"| node_image_input
node_image_input -.->|"segments"| node_segmentation
node_segmentation -.->|"skeletonizes"| node_thinning
node_thinning -.->|"forms graph"| node_network_graph
node_network_graph -.->|"measures"| node_morphology_stats
node_mitograph -->|"exports results"| node_result_files
node_mitograph -->|"exports VTK"| node_vtk_exports
node_mitograph -->|"invokes analysis"| node_component_analysis
node_component_analysis -->|"requires"| node_r_runtime
node_thinning -.->|"implements"| node_thinning_api
node_thinning -.->|"uses rules"| node_skeleton_rules
node_mitograph -->|"uses types"| node_shared_types
node_seg2para -.->|"processes images"| node_seg2para
node_skeleton_image -.->|"converts skeletons"| node_skeleton_image

click node_mitograph "https://github.com/vianamp/mitograph/blob/master/MitoGraph.cxx"
click node_image_input "https://github.com/vianamp/mitograph/blob/master/MitoGraph.cxx"
click node_segmentation "https://github.com/vianamp/mitograph/blob/master/MitoGraph.cxx"
click node_thinning "https://github.com/vianamp/mitograph/blob/master/MitoThinning.cxx"
click node_thinning_api "https://github.com/vianamp/mitograph/blob/master/MitoThinning.h"
click node_skeleton_rules "https://github.com/vianamp/mitograph/blob/master/ssThinning.h"
click node_shared_types "https://github.com/vianamp/mitograph/blob/master/includes.h"
click node_network_graph "https://github.com/vianamp/mitograph/blob/master/MitoGraph.cxx"
click node_morphology_stats "https://github.com/vianamp/mitograph/blob/master/MitoGraph.cxx"
click node_component_analysis "https://github.com/vianamp/mitograph/blob/master/GraphAnalyzer.R"
click node_result_files "https://github.com/vianamp/mitograph/blob/master/MitoGraph.cxx"
click node_vtk_exports "https://github.com/vianamp/mitograph/blob/master/MitoGraph.cxx"
click node_seg2para "https://github.com/vianamp/mitograph/blob/master/tools/seg2para/seg2para.cpp"
click node_skeleton_image "https://github.com/vianamp/mitograph/blob/master/tools/skell2img/skell2img.cxx"

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_mitograph,node_image_input toneBlue
class node_segmentation,node_thinning,node_thinning_api,node_skeleton_rules,node_shared_types toneAmber
class node_network_graph,node_morphology_stats,node_component_analysis,node_result_files,node_vtk_exports toneMint
class node_seg2para,node_skeleton_image toneRose
class node_researcher,node_r_runtime toneIndigo
```

## Components

### Analysis workflow

- [MitoGraph CLI](https://github.com/vianamp/mitograph/blob/master/MitoGraph.cxx): `MitoGraph.cxx`
- [Image input](https://github.com/vianamp/mitograph/blob/master/MitoGraph.cxx): `MitoGraph.cxx`

### Image and skeleton processing

- [Segmentation](https://github.com/vianamp/mitograph/blob/master/MitoGraph.cxx): `MitoGraph.cxx`
- [3D thinning](https://github.com/vianamp/mitograph/blob/master/MitoThinning.cxx): `MitoThinning.cxx`
- [Thinning API](https://github.com/vianamp/mitograph/blob/master/MitoThinning.h): `MitoThinning.h`
- [Skeleton rules](https://github.com/vianamp/mitograph/blob/master/ssThinning.h): `ssThinning.h`
- [Shared data types](https://github.com/vianamp/mitograph/blob/master/includes.h): `includes.h`

### Measurements and outputs

- [Network graph](https://github.com/vianamp/mitograph/blob/master/MitoGraph.cxx): `MitoGraph.cxx`
- [Morphology statistics](https://github.com/vianamp/mitograph/blob/master/MitoGraph.cxx): `MitoGraph.cxx`
- [Component analysis](https://github.com/vianamp/mitograph/blob/master/GraphAnalyzer.R): `GraphAnalyzer.R`
- [Analysis files](https://github.com/vianamp/mitograph/blob/master/MitoGraph.cxx): `MitoGraph.cxx`
- [VTK exports](https://github.com/vianamp/mitograph/blob/master/MitoGraph.cxx): `MitoGraph.cxx`

### Standalone utilities

- [Segmentation converter](https://github.com/vianamp/mitograph/blob/master/tools/seg2para/seg2para.cpp): `tools/seg2para/seg2para.cpp`
- [Skeleton image tool](https://github.com/vianamp/mitograph/blob/master/tools/skell2img/skell2img.cxx): `tools/skell2img/skell2img.cxx`

### Other components

- **Researcher**
- **R runtime**

## Connections

- Researcher → MitoGraph CLI: runs (evidence: `README.md`)
- MitoGraph CLI → Image input: loads images
- Image input → Segmentation: segments
- Segmentation → 3D thinning: skeletonizes
- 3D thinning → Network graph: forms graph
- Network graph → Morphology statistics: measures
- MitoGraph CLI → Analysis files: exports results (evidence: `README.md`)
- MitoGraph CLI → VTK exports: exports VTK (evidence: `README.md`)
- MitoGraph CLI → Component analysis: invokes analysis (evidence: `README.md`)
- Component analysis → R runtime: requires (evidence: `README.md`)
- 3D thinning → Thinning API: implements
- 3D thinning → Skeleton rules: uses rules
- MitoGraph CLI → Shared data types: uses types (evidence: `includes.h`)
- Segmentation converter → Segmentation converter: processes images (evidence: `tools/seg2para/seg2para.cpp`)
- Skeleton image tool → Skeleton image tool: converts skeletons
