# inria-asclepios/medinria-public architecture

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

- Interactive diagram: https://gitdiagram.com/inria-asclepios/medinria-public
- Repository: https://github.com/inria-asclepios/medinria-public

## Overview

medInria is a medical-imaging application for browsing and managing imaging data, viewing it in workspaces, and extending workflows through plugins. The principal user journey is to choose a data source, browse or import studies, open an item, then inspect or process it in a workspace. The tree also shows PACS access, diffusion and visualization workspaces, image/mesh support, registration and a plugin generator. The README only describes compilation; several workflow links below are therefore marked unverified rather than presented as inspected call paths.

Main entry points: [`src/app/medInria/areas/workspaces/visualization/medVisualizationWorkspace.cpp`](https://github.com/inria-asclepios/medinria-public/blob/master/src/app/medInria/areas/workspaces/visualization/medVisualizationWorkspace.cpp) (Visualization workspace), [`src/app/medInria/medDataSourceManager.cpp`](https://github.com/inria-asclepios/medinria-public/blob/master/src/app/medInria/medDataSourceManager.cpp) (Source manager), [`src/layers/legacy/medCoreLegacy/database/medDatabasePersistentController.cpp`](https://github.com/inria-asclepios/medinria-public/blob/master/src/layers/legacy/medCoreLegacy/database/medDatabasePersistentController.cpp) (Persistent database), [`src/app/medInria/areas/browser/medBrowserArea.cpp`](https://github.com/inria-asclepios/medinria-public/blob/master/src/app/medInria/areas/browser/medBrowserArea.cpp) (Data browser)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application UI"]
  node_app_entry["Application startup<br/>[main.cpp]"]
  node_main_window["Main window<br/>[medMainWindow.cpp]"]
  node_browser["Data browser<br/>[medBrowserArea.cpp]"]
  node_workspace_area["Workspace area"]
  node_visual_workspace["Visualization workspace"]
  node_diffusion_workspace["Diffusion workspace"]
  node_preview["Data preview"]
end

subgraph group_data["Data Management"]
  node_source_manager["Source manager"]
  node_database_source["Database source UI"]
  node_filesystem_source["Filesystem source"]
  node_pacs_source["PACS source"]
  node_database_controller[("Persistent database")]
  node_data_manager["Data manager<br/>[medDataManager.cpp]"]
  node_importer["Database importer"]
  node_remover["Database remover"]
  node_local_store[("Local data storage<br/>[medStorage.cpp]")]
end

subgraph group_core["Imaging Core"]
  node_image_data["Image data types"]
  node_plugin_manager["Plugin manager"]
end

subgraph group_plugins["Plugins"]
  node_mesh_io["Mesh reader/writer"]
  node_vector_visualization["Vector visualization"]
  node_registration["Landmark registration"]
end

subgraph group_extension["Extension Tools"]
  node_plugin_generator["Plugin generator"]
end

node_user(("Imaging user"))
node_pacs_service{{"PACS service"}}

node_user -.->|"launches"| node_app_entry
node_app_entry -.->|"opens"| node_main_window
node_user -.->|"browses"| node_browser
node_browser -.->|"selects source"| node_source_manager
node_source_manager -.->|"offers"| node_database_source
node_source_manager -.->|"offers"| node_filesystem_source
node_source_manager -.->|"offers"| node_pacs_source
node_database_source -.->|"queries"| node_database_controller
node_database_controller -->|"starts import"| node_importer
node_database_controller -->|"starts removal"| node_remover
node_database_controller -->|"uses storage"| node_local_store
node_browser -.->|"previews items"| node_preview
node_preview -->|"loads thumbnails"| node_data_manager
node_user -.->|"opens item"| node_workspace_area
node_workspace_area -.->|"selects workspace"| node_visual_workspace
node_workspace_area -.->|"selects workspace"| node_diffusion_workspace
node_visual_workspace -.->|"views data"| node_image_data
node_diffusion_workspace -.->|"processes data"| node_image_data
node_visual_workspace -.->|"renders vectors"| node_vector_visualization
node_visual_workspace -.->|"uses mesh I/O"| node_mesh_io
node_user -.->|"starts registration"| node_registration
node_registration -->|"reports errors"| node_main_window
node_main_window -.->|"loads extensions"| node_plugin_manager
node_user -.->|"creates plugin"| node_plugin_generator
node_pacs_source -.->|"transfers data"| node_pacs_service

click node_app_entry "https://github.com/inria-asclepios/medinria-public/blob/master/src/app/medInria/main.cpp"
click node_main_window "https://github.com/inria-asclepios/medinria-public/blob/master/src/app/medInria/medMainWindow.cpp"
click node_browser "https://github.com/inria-asclepios/medinria-public/blob/master/src/app/medInria/areas/browser/medBrowserArea.cpp"
click node_workspace_area "https://github.com/inria-asclepios/medinria-public/blob/master/src/app/medInria/areas/workspaces/medWorkspaceArea.cpp"
click node_visual_workspace "https://github.com/inria-asclepios/medinria-public/blob/master/src/app/medInria/areas/workspaces/visualization/medVisualizationWorkspace.cpp"
click node_diffusion_workspace "https://github.com/inria-asclepios/medinria-public/blob/master/src/app/medInria/areas/workspaces/diffusion/medDiffusionWorkspace.cpp"
click node_source_manager "https://github.com/inria-asclepios/medinria-public/blob/master/src/app/medInria/medDataSourceManager.cpp"
click node_database_source "https://github.com/inria-asclepios/medinria-public/blob/master/src/app/medInria/medDatabaseDataSource.cpp"
click node_filesystem_source "https://github.com/inria-asclepios/medinria-public/blob/master/src/app/medInria/medFileSystemDataSource.cpp"
click node_pacs_source "https://github.com/inria-asclepios/medinria-public/blob/master/src/app/medInria/medPacsDataSource.cpp"
click node_database_controller "https://github.com/inria-asclepios/medinria-public/blob/master/src/layers/legacy/medCoreLegacy/database/medDatabasePersistentController.cpp"
click node_data_manager "https://github.com/inria-asclepios/medinria-public/blob/master/src/layers/legacy/medCoreLegacy/database/medDataManager.cpp"
click node_importer "https://github.com/inria-asclepios/medinria-public/blob/master/src/layers/legacy/medCoreLegacy/database/medDatabaseImporter.h"
click node_remover "https://github.com/inria-asclepios/medinria-public/blob/master/src/layers/legacy/medCoreLegacy/database/medDatabaseRemover.h"
click node_preview "https://github.com/inria-asclepios/medinria-public/blob/master/src/layers/legacy/medCoreLegacy/gui/database/medDatabasePreview.cpp"
click node_image_data "https://github.com/inria-asclepios/medinria-public/blob/master/src/layers/legacy/medCoreLegacy/data/medAbstractImageData.cpp"
click node_mesh_io "https://github.com/inria-asclepios/medinria-public/blob/master/src/plugins/legacy/vtkDataMesh/readers/vtkDataManagerReader.h"
click node_vector_visualization "https://github.com/inria-asclepios/medinria-public/blob/master/src/plugins/legacy/itkDataImage/manager/vtkVectorVisuManager.h"
click node_registration "https://github.com/inria-asclepios/medinria-public/blob/master/src/plugins/legacy/manualRegistration/manualRegistrationLandmarkController.cpp"
click node_plugin_manager "https://github.com/inria-asclepios/medinria-public/blob/master/src/layers/legacy/medCoreLegacy/medPluginManager.cpp"
click node_plugin_generator "https://github.com/inria-asclepios/medinria-public/blob/master/src/app/medPluginGenerator/medPluginGenerator.cpp"
click node_local_store "https://github.com/inria-asclepios/medinria-public/blob/master/src/layers/legacy/medCoreLegacy/database/medStorage.cpp"

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_entry,node_main_window,node_browser,node_workspace_area,node_visual_workspace,node_diffusion_workspace,node_preview,node_user toneBlue
class node_source_manager,node_database_source,node_filesystem_source,node_pacs_source,node_database_controller,node_data_manager,node_importer,node_remover,node_local_store toneAmber
class node_image_data,node_plugin_manager toneMint
class node_mesh_io,node_vector_visualization,node_registration toneRose
class node_plugin_generator,node_pacs_service toneIndigo
```

## Components

### Application UI

- [Application startup](https://github.com/inria-asclepios/medinria-public/blob/master/src/app/medInria/main.cpp): `src/app/medInria/main.cpp`
- [Main window](https://github.com/inria-asclepios/medinria-public/blob/master/src/app/medInria/medMainWindow.cpp): `src/app/medInria/medMainWindow.cpp`
- [Data browser](https://github.com/inria-asclepios/medinria-public/blob/master/src/app/medInria/areas/browser/medBrowserArea.cpp): `src/app/medInria/areas/browser/medBrowserArea.cpp`
- [Workspace area](https://github.com/inria-asclepios/medinria-public/blob/master/src/app/medInria/areas/workspaces/medWorkspaceArea.cpp): `src/app/medInria/areas/workspaces/medWorkspaceArea.cpp`
- [Visualization workspace](https://github.com/inria-asclepios/medinria-public/blob/master/src/app/medInria/areas/workspaces/visualization/medVisualizationWorkspace.cpp): `src/app/medInria/areas/workspaces/visualization/medVisualizationWorkspace.cpp`
- [Diffusion workspace](https://github.com/inria-asclepios/medinria-public/blob/master/src/app/medInria/areas/workspaces/diffusion/medDiffusionWorkspace.cpp): `src/app/medInria/areas/workspaces/diffusion/medDiffusionWorkspace.cpp`
- [Data preview](https://github.com/inria-asclepios/medinria-public/blob/master/src/layers/legacy/medCoreLegacy/gui/database/medDatabasePreview.cpp): `src/layers/legacy/medCoreLegacy/gui/database/medDatabasePreview.cpp`

### Data Management

- [Source manager](https://github.com/inria-asclepios/medinria-public/blob/master/src/app/medInria/medDataSourceManager.cpp): `src/app/medInria/medDataSourceManager.cpp`
- [Database source UI](https://github.com/inria-asclepios/medinria-public/blob/master/src/app/medInria/medDatabaseDataSource.cpp): `src/app/medInria/medDatabaseDataSource.cpp`
- [Filesystem source](https://github.com/inria-asclepios/medinria-public/blob/master/src/app/medInria/medFileSystemDataSource.cpp): `src/app/medInria/medFileSystemDataSource.cpp`
- [PACS source](https://github.com/inria-asclepios/medinria-public/blob/master/src/app/medInria/medPacsDataSource.cpp): `src/app/medInria/medPacsDataSource.cpp`
- [Persistent database](https://github.com/inria-asclepios/medinria-public/blob/master/src/layers/legacy/medCoreLegacy/database/medDatabasePersistentController.cpp): `src/layers/legacy/medCoreLegacy/database/medDatabasePersistentController.cpp`
- [Data manager](https://github.com/inria-asclepios/medinria-public/blob/master/src/layers/legacy/medCoreLegacy/database/medDataManager.cpp): `src/layers/legacy/medCoreLegacy/database/medDataManager.cpp`
- [Database importer](https://github.com/inria-asclepios/medinria-public/blob/master/src/layers/legacy/medCoreLegacy/database/medDatabaseImporter.h): `src/layers/legacy/medCoreLegacy/database/medDatabaseImporter.h`
- [Database remover](https://github.com/inria-asclepios/medinria-public/blob/master/src/layers/legacy/medCoreLegacy/database/medDatabaseRemover.h): `src/layers/legacy/medCoreLegacy/database/medDatabaseRemover.h`
- [Local data storage](https://github.com/inria-asclepios/medinria-public/blob/master/src/layers/legacy/medCoreLegacy/database/medStorage.cpp): `src/layers/legacy/medCoreLegacy/database/medStorage.cpp`

### Imaging Core

- [Image data types](https://github.com/inria-asclepios/medinria-public/blob/master/src/layers/legacy/medCoreLegacy/data/medAbstractImageData.cpp): `src/layers/legacy/medCoreLegacy/data/medAbstractImageData.cpp`
- [Plugin manager](https://github.com/inria-asclepios/medinria-public/blob/master/src/layers/legacy/medCoreLegacy/medPluginManager.cpp): `src/layers/legacy/medCoreLegacy/medPluginManager.cpp`

### Plugins

- [Mesh reader/writer](https://github.com/inria-asclepios/medinria-public/blob/master/src/plugins/legacy/vtkDataMesh/readers/vtkDataManagerReader.h): `src/plugins/legacy/vtkDataMesh/readers/vtkDataManagerReader.h`
- [Vector visualization](https://github.com/inria-asclepios/medinria-public/blob/master/src/plugins/legacy/itkDataImage/manager/vtkVectorVisuManager.h): `src/plugins/legacy/itkDataImage/manager/vtkVectorVisuManager.h`
- [Landmark registration](https://github.com/inria-asclepios/medinria-public/blob/master/src/plugins/legacy/manualRegistration/manualRegistrationLandmarkController.cpp): `src/plugins/legacy/manualRegistration/manualRegistrationLandmarkController.cpp`

### Extension Tools

- [Plugin generator](https://github.com/inria-asclepios/medinria-public/blob/master/src/app/medPluginGenerator/medPluginGenerator.cpp): `src/app/medPluginGenerator/medPluginGenerator.cpp`

### Other components

- **Imaging user**
- **PACS service**

## Connections

- Imaging user → Application startup: launches
- Application startup → Main window: opens
- Imaging user → Data browser: browses
- Data browser → Source manager: selects source
- Source manager → Database source UI: offers
- Source manager → Filesystem source: offers
- Source manager → PACS source: offers
- Database source UI → Persistent database: queries
- Persistent database → Database importer: starts import (evidence: `src/layers/legacy/medCoreLegacy/database/medDatabasePersistentController.cpp`)
- Persistent database → Database remover: starts removal (evidence: `src/layers/legacy/medCoreLegacy/database/medDatabasePersistentController.cpp`)
- Persistent database → Local data storage: uses storage (evidence: `src/layers/legacy/medCoreLegacy/database/medDatabasePersistentController.cpp`)
- Data browser → Data preview: previews items
- Data preview → Data manager: loads thumbnails (evidence: `src/layers/legacy/medCoreLegacy/gui/database/medDatabasePreview.cpp`)
- Imaging user → Workspace area: opens item
- Workspace area → Visualization workspace: selects workspace
- Workspace area → Diffusion workspace: selects workspace
- Visualization workspace → Image data types: views data
- Diffusion workspace → Image data types: processes data
- Visualization workspace → Vector visualization: renders vectors
- Visualization workspace → Mesh reader/writer: uses mesh I/O
- Imaging user → Landmark registration: starts registration
- Landmark registration → Main window: reports errors (evidence: `src/plugins/legacy/manualRegistration/manualRegistrationLandmarkController.cpp`)
- Main window → Plugin manager: loads extensions
- Imaging user → Plugin generator: creates plugin
- PACS source → PACS service: transfers data
