# liryc-ihu/medinriaweb architecture

> Architecture diagram of the GitHub repository liryc-ihu/medinriaweb, 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/liryc-ihu/medinriaweb
- Repository: https://github.com/liryc-ihu/medinriaweb

## Overview

GirderMedViewer is a Trame/VTK medical visualization application for browsing medical files in Girder, loading them into a scene, and exploring or editing them in slice and 3D views. The principal flow runs from the app UI and Girder browser through file loading and scene object management to VTK views. The README also documents filters, interactive segmentation tools, and an optional Girder plugin for direct assetstore access. Edges reflect explicit README statements or references in the supplied source index; unsampled feature wiring is not inferred.

Main entry points: [`girdermedviewer/app/widgets/logic/scene/scene_logic.py`](https://github.com/liryc-ihu/medinriaweb/blob/main/girdermedviewer/app/widgets/logic/scene/scene_logic.py) (Scene orchestration), [`girdermedviewer/app/widgets/ui/app_ui.py`](https://github.com/liryc-ihu/medinriaweb/blob/main/girdermedviewer/app/widgets/ui/app_ui.py) (App layout), [`girdermedviewer/app/widgets/logic/scene/handlers/mesh_handler.py`](https://github.com/liryc-ihu/medinriaweb/blob/main/girdermedviewer/app/widgets/logic/scene/handlers/mesh_handler.py) (Mesh handler), [`girdermedviewer/app/widgets/logic/vtk/views_logic.py`](https://github.com/liryc-ihu/medinriaweb/blob/main/girdermedviewer/app/widgets/logic/vtk/views_logic.py) (Views coordinator)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Application runtime"]
  node_app["Trame app<br/>[core.py]"]
  node_app_logic["App logic<br/>[app_logic.py]"]
end

subgraph group_girder["Girder access"]
  node_girder_logic["Girder logic<br/>[girder_logic.py]"]
  node_girder_load["File loading"]
  node_girder_service[("Girder service")]
  node_plugin["Assetstore plugin"]
end

subgraph group_scene["Scene and data"]
  node_scene_logic["Scene orchestration<br/>[scene_logic.py]"]
  node_scene_objects["Scene object model"]
  node_volume_object["Volume objects"]
  node_object_handlers["Object handlers<br/>[object_handler.py]"]
  node_mesh_handler["Mesh handler<br/>[mesh_handler.py]"]
  node_volume_handler["Volume handler<br/>[volume_handler.py]"]
  node_segmentation_handler["Segmentation handler"]
  node_filters["Scene filters"]
end

subgraph group_visualization["Visualization and tools"]
  node_views_logic["Views coordinator<br/>[views_logic.py]"]
  node_slice_view["Slice views"]
  node_three_d_view["3D view"]
  node_vtk_utils["VTK operations<br/>[vtk_utils.py]"]
  node_tool_logic["Interaction tools<br/>[tool_logic.py]"]
  node_segmentation_effect["Segmentation effects"]
end

subgraph group_interface["User interface"]
  node_app_ui["App layout<br/>[app_ui.py]"]
  node_girder_ui["Girder browser UI"]
  node_connection_ui["Connection UI"]
  node_scene_ui["Scene UI<br/>[scene_ui.py]"]
  node_views_ui["Views UI<br/>[views_ui.py]"]
  node_tool_ui["Tools UI<br/>[tool_ui.py]"]
  node_segmentation_ui["Segmentation UI"]
end

node_user(("Viewer user"))

node_user -->|"uses"| node_app_ui
node_app -->|"creates"| node_app_logic
node_app_logic -->|"configures"| node_app_ui
node_app_ui -->|"presents"| node_girder_ui
node_app_ui -->|"presents"| node_connection_ui
node_app_ui -->|"presents"| node_scene_ui
node_app_ui -->|"presents"| node_views_ui
node_app_ui -->|"presents"| node_tool_ui
node_girder_ui -.->|"browses"| node_girder_logic
node_connection_ui -.->|"configures"| node_girder_logic
node_girder_logic -.->|"accesses"| node_girder_service
node_girder_load -->|"adds data"| node_scene_logic
node_girder_load -.->|"fetches files"| node_girder_service
node_plugin -->|"extends access"| node_girder_service
node_scene_logic -->|"manages"| node_scene_objects
node_scene_logic -->|"uses"| node_object_handlers
node_scene_logic -->|"dispatches"| node_mesh_handler
node_scene_logic -->|"dispatches"| node_volume_handler
node_scene_logic -->|"dispatches"| node_segmentation_handler
node_scene_logic -->|"creates"| node_filters
node_scene_logic -->|"updates views"| node_views_logic
node_scene_logic -->|"binds events"| node_scene_ui
node_volume_object -->|"specializes"| node_scene_objects
node_mesh_handler -->|"uses"| node_scene_objects
node_mesh_handler -->|"renders with"| node_vtk_utils
node_volume_handler -->|"renders with"| node_vtk_utils
node_views_logic -->|"creates"| node_slice_view
node_views_logic -->|"creates"| node_three_d_view
node_slice_view -->|"uses"| node_mesh_handler
node_slice_view -->|"uses"| node_volume_handler
node_views_ui -.->|"shows views"| node_user
node_tool_ui -.->|"controls"| node_tool_logic
node_segmentation_ui -.->|"controls"| node_segmentation_effect
node_segmentation_effect -.->|"uses"| node_vtk_utils

click node_app "https://github.com/liryc-ihu/medinriaweb/blob/main/girdermedviewer/app/core.py"
click node_app_logic "https://github.com/liryc-ihu/medinriaweb/blob/main/girdermedviewer/app/widgets/logic/app_logic.py"
click node_app_ui "https://github.com/liryc-ihu/medinriaweb/blob/main/girdermedviewer/app/widgets/ui/app_ui.py"
click node_girder_ui "https://github.com/liryc-ihu/medinriaweb/blob/main/girdermedviewer/app/widgets/ui/girder/girder_browser_ui.py"
click node_connection_ui "https://github.com/liryc-ihu/medinriaweb/blob/main/girdermedviewer/app/widgets/ui/girder/girder_connection_ui.py"
click node_girder_logic "https://github.com/liryc-ihu/medinriaweb/blob/main/girdermedviewer/app/widgets/logic/girder/girder_logic.py"
click node_girder_load "https://github.com/liryc-ihu/medinriaweb/blob/main/girdermedviewer/app/widgets/logic/girder/girder_load_logic.py"
click node_plugin "https://github.com/liryc-ihu/medinriaweb/tree/main/utils/girdermedviewer_plugin"
click node_scene_logic "https://github.com/liryc-ihu/medinriaweb/blob/main/girdermedviewer/app/widgets/logic/scene/scene_logic.py"
click node_scene_objects "https://github.com/liryc-ihu/medinriaweb/blob/main/girdermedviewer/app/widgets/logic/scene/objects/scene_object_logic.py"
click node_volume_object "https://github.com/liryc-ihu/medinriaweb/blob/main/girdermedviewer/app/widgets/logic/scene/objects/volume_object_logic.py"
click node_object_handlers "https://github.com/liryc-ihu/medinriaweb/blob/main/girdermedviewer/app/widgets/logic/scene/handlers/object_handler.py"
click node_mesh_handler "https://github.com/liryc-ihu/medinriaweb/blob/main/girdermedviewer/app/widgets/logic/scene/handlers/mesh_handler.py"
click node_volume_handler "https://github.com/liryc-ihu/medinriaweb/blob/main/girdermedviewer/app/widgets/logic/scene/handlers/volume_handler.py"
click node_segmentation_handler "https://github.com/liryc-ihu/medinriaweb/blob/main/girdermedviewer/app/widgets/logic/scene/handlers/segmentation_handler.py"
click node_filters "https://github.com/liryc-ihu/medinriaweb/tree/main/girdermedviewer/app/widgets/logic/scene/filters"
click node_scene_ui "https://github.com/liryc-ihu/medinriaweb/blob/main/girdermedviewer/app/widgets/ui/scene/scene_ui.py"
click node_views_logic "https://github.com/liryc-ihu/medinriaweb/blob/main/girdermedviewer/app/widgets/logic/vtk/views_logic.py"
click node_slice_view "https://github.com/liryc-ihu/medinriaweb/blob/main/girdermedviewer/app/widgets/logic/vtk/views/slice_view_logic.py"
click node_three_d_view "https://github.com/liryc-ihu/medinriaweb/blob/main/girdermedviewer/app/widgets/logic/vtk/views/threed_view_logic.py"
click node_vtk_utils "https://github.com/liryc-ihu/medinriaweb/blob/main/girdermedviewer/app/widgets/utils/vtk/vtk_utils.py"
click node_tool_logic "https://github.com/liryc-ihu/medinriaweb/blob/main/girdermedviewer/app/widgets/logic/vtk/tool_logic.py"
click node_segmentation_effect "https://github.com/liryc-ihu/medinriaweb/blob/main/girdermedviewer/app/widgets/logic/vtk/tools/segmentation_effect_logic.py"
click node_views_ui "https://github.com/liryc-ihu/medinriaweb/blob/main/girdermedviewer/app/widgets/ui/vtk/views_ui.py"
click node_tool_ui "https://github.com/liryc-ihu/medinriaweb/blob/main/girdermedviewer/app/widgets/ui/vtk/tool_ui.py"
click node_segmentation_ui "https://github.com/liryc-ihu/medinriaweb/blob/main/girdermedviewer/app/widgets/ui/vtk/tools/segmentation_effect_ui.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_app,node_app_logic,node_user toneBlue
class node_girder_logic,node_girder_load,node_girder_service,node_plugin toneAmber
class node_scene_logic,node_scene_objects,node_volume_object,node_object_handlers,node_mesh_handler,node_volume_handler,node_segmentation_handler,node_filters toneMint
class node_views_logic,node_slice_view,node_three_d_view,node_vtk_utils,node_tool_logic,node_segmentation_effect toneRose
class node_app_ui,node_girder_ui,node_connection_ui,node_scene_ui,node_views_ui,node_tool_ui,node_segmentation_ui toneIndigo
```

## Components

### Application runtime

- [Trame app](https://github.com/liryc-ihu/medinriaweb/blob/main/girdermedviewer/app/core.py): `girdermedviewer/app/core.py`
- [App logic](https://github.com/liryc-ihu/medinriaweb/blob/main/girdermedviewer/app/widgets/logic/app_logic.py): `girdermedviewer/app/widgets/logic/app_logic.py`

### Girder access

- [Girder logic](https://github.com/liryc-ihu/medinriaweb/blob/main/girdermedviewer/app/widgets/logic/girder/girder_logic.py): `girdermedviewer/app/widgets/logic/girder/girder_logic.py`
- [File loading](https://github.com/liryc-ihu/medinriaweb/blob/main/girdermedviewer/app/widgets/logic/girder/girder_load_logic.py): `girdermedviewer/app/widgets/logic/girder/girder_load_logic.py`
- **Girder service**
- [Assetstore plugin](https://github.com/liryc-ihu/medinriaweb/tree/main/utils/girdermedviewer_plugin): `utils/girdermedviewer_plugin`

### Scene and data

- [Scene orchestration](https://github.com/liryc-ihu/medinriaweb/blob/main/girdermedviewer/app/widgets/logic/scene/scene_logic.py): `girdermedviewer/app/widgets/logic/scene/scene_logic.py`
- [Scene object model](https://github.com/liryc-ihu/medinriaweb/blob/main/girdermedviewer/app/widgets/logic/scene/objects/scene_object_logic.py): `girdermedviewer/app/widgets/logic/scene/objects/scene_object_logic.py`
- [Volume objects](https://github.com/liryc-ihu/medinriaweb/blob/main/girdermedviewer/app/widgets/logic/scene/objects/volume_object_logic.py): `girdermedviewer/app/widgets/logic/scene/objects/volume_object_logic.py`
- [Object handlers](https://github.com/liryc-ihu/medinriaweb/blob/main/girdermedviewer/app/widgets/logic/scene/handlers/object_handler.py): `girdermedviewer/app/widgets/logic/scene/handlers/object_handler.py`
- [Mesh handler](https://github.com/liryc-ihu/medinriaweb/blob/main/girdermedviewer/app/widgets/logic/scene/handlers/mesh_handler.py): `girdermedviewer/app/widgets/logic/scene/handlers/mesh_handler.py`
- [Volume handler](https://github.com/liryc-ihu/medinriaweb/blob/main/girdermedviewer/app/widgets/logic/scene/handlers/volume_handler.py): `girdermedviewer/app/widgets/logic/scene/handlers/volume_handler.py`
- [Segmentation handler](https://github.com/liryc-ihu/medinriaweb/blob/main/girdermedviewer/app/widgets/logic/scene/handlers/segmentation_handler.py): `girdermedviewer/app/widgets/logic/scene/handlers/segmentation_handler.py`
- [Scene filters](https://github.com/liryc-ihu/medinriaweb/tree/main/girdermedviewer/app/widgets/logic/scene/filters): `girdermedviewer/app/widgets/logic/scene/filters`

### Visualization and tools

- [Views coordinator](https://github.com/liryc-ihu/medinriaweb/blob/main/girdermedviewer/app/widgets/logic/vtk/views_logic.py): `girdermedviewer/app/widgets/logic/vtk/views_logic.py`
- [Slice views](https://github.com/liryc-ihu/medinriaweb/blob/main/girdermedviewer/app/widgets/logic/vtk/views/slice_view_logic.py): `girdermedviewer/app/widgets/logic/vtk/views/slice_view_logic.py`
- [3D view](https://github.com/liryc-ihu/medinriaweb/blob/main/girdermedviewer/app/widgets/logic/vtk/views/threed_view_logic.py): `girdermedviewer/app/widgets/logic/vtk/views/threed_view_logic.py`
- [VTK operations](https://github.com/liryc-ihu/medinriaweb/blob/main/girdermedviewer/app/widgets/utils/vtk/vtk_utils.py): `girdermedviewer/app/widgets/utils/vtk/vtk_utils.py`
- [Interaction tools](https://github.com/liryc-ihu/medinriaweb/blob/main/girdermedviewer/app/widgets/logic/vtk/tool_logic.py): `girdermedviewer/app/widgets/logic/vtk/tool_logic.py`
- [Segmentation effects](https://github.com/liryc-ihu/medinriaweb/blob/main/girdermedviewer/app/widgets/logic/vtk/tools/segmentation_effect_logic.py): `girdermedviewer/app/widgets/logic/vtk/tools/segmentation_effect_logic.py`

### User interface

- [App layout](https://github.com/liryc-ihu/medinriaweb/blob/main/girdermedviewer/app/widgets/ui/app_ui.py): `girdermedviewer/app/widgets/ui/app_ui.py`
- [Girder browser UI](https://github.com/liryc-ihu/medinriaweb/blob/main/girdermedviewer/app/widgets/ui/girder/girder_browser_ui.py): `girdermedviewer/app/widgets/ui/girder/girder_browser_ui.py`
- [Connection UI](https://github.com/liryc-ihu/medinriaweb/blob/main/girdermedviewer/app/widgets/ui/girder/girder_connection_ui.py): `girdermedviewer/app/widgets/ui/girder/girder_connection_ui.py`
- [Scene UI](https://github.com/liryc-ihu/medinriaweb/blob/main/girdermedviewer/app/widgets/ui/scene/scene_ui.py): `girdermedviewer/app/widgets/ui/scene/scene_ui.py`
- [Views UI](https://github.com/liryc-ihu/medinriaweb/blob/main/girdermedviewer/app/widgets/ui/vtk/views_ui.py): `girdermedviewer/app/widgets/ui/vtk/views_ui.py`
- [Tools UI](https://github.com/liryc-ihu/medinriaweb/blob/main/girdermedviewer/app/widgets/ui/vtk/tool_ui.py): `girdermedviewer/app/widgets/ui/vtk/tool_ui.py`
- [Segmentation UI](https://github.com/liryc-ihu/medinriaweb/blob/main/girdermedviewer/app/widgets/ui/vtk/tools/segmentation_effect_ui.py): `girdermedviewer/app/widgets/ui/vtk/tools/segmentation_effect_ui.py`

### Other components

- **Viewer user**

## Connections

- Viewer user → App layout: uses (evidence: `girdermedviewer/app/widgets/ui/app_ui.py`)
- Trame app → App logic: creates (evidence: `girdermedviewer/app/core.py`)
- App logic → App layout: configures (evidence: `girdermedviewer/app/widgets/logic/app_logic.py`)
- App layout → Girder browser UI: presents (evidence: `girdermedviewer/app/widgets/ui/app_ui.py`)
- App layout → Connection UI: presents (evidence: `girdermedviewer/app/widgets/ui/app_ui.py`)
- App layout → Scene UI: presents (evidence: `girdermedviewer/app/widgets/ui/app_ui.py`)
- App layout → Views UI: presents (evidence: `girdermedviewer/app/widgets/ui/app_ui.py`)
- App layout → Tools UI: presents (evidence: `girdermedviewer/app/widgets/ui/app_ui.py`)
- Girder browser UI → Girder logic: browses
- Connection UI → Girder logic: configures
- Girder logic → Girder service: accesses
- File loading → Scene orchestration: adds data (evidence: `girdermedviewer/app/widgets/logic/girder/girder_load_logic.py`)
- File loading → Girder service: fetches files
- Assetstore plugin → Girder service: extends access (evidence: `README.md`)
- Scene orchestration → Scene object model: manages (evidence: `girdermedviewer/app/widgets/logic/scene/scene_logic.py`)
- Scene orchestration → Object handlers: uses (evidence: `girdermedviewer/app/widgets/logic/scene/scene_logic.py`)
- Scene orchestration → Mesh handler: dispatches (evidence: `girdermedviewer/app/widgets/logic/scene/scene_logic.py`)
- Scene orchestration → Volume handler: dispatches (evidence: `girdermedviewer/app/widgets/logic/scene/scene_logic.py`)
- Scene orchestration → Segmentation handler: dispatches (evidence: `girdermedviewer/app/widgets/logic/scene/scene_logic.py`)
- Scene orchestration → Scene filters: creates (evidence: `girdermedviewer/app/widgets/logic/scene/scene_logic.py`)
- Scene orchestration → Views coordinator: updates views (evidence: `girdermedviewer/app/widgets/logic/scene/scene_logic.py`)
- Scene orchestration → Scene UI: binds events (evidence: `girdermedviewer/app/widgets/logic/scene/scene_logic.py`)
- Volume objects → Scene object model: specializes (evidence: `girdermedviewer/app/widgets/logic/scene/objects/volume_object_logic.py`)
- Mesh handler → Scene object model: uses (evidence: `girdermedviewer/app/widgets/logic/scene/handlers/mesh_handler.py`)
- Mesh handler → VTK operations: renders with
- Volume handler → VTK operations: renders with
- Views coordinator → Slice views: creates (evidence: `girdermedviewer/app/widgets/logic/vtk/views_logic.py`)
- Views coordinator → 3D view: creates (evidence: `girdermedviewer/app/widgets/logic/vtk/views_logic.py`)
- Slice views → Mesh handler: uses (evidence: `girdermedviewer/app/widgets/logic/vtk/views/slice_view_logic.py`)
- Slice views → Volume handler: uses (evidence: `girdermedviewer/app/widgets/logic/vtk/views/slice_view_logic.py`)
- Views UI → Viewer user: shows views
- Tools UI → Interaction tools: controls
- Segmentation UI → Segmentation effects: controls
- Segmentation effects → VTK operations: uses
