# ohif/viewers architecture

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

- Interactive diagram: https://gitdiagram.com/ohif/viewers
- Repository: https://github.com/ohif/viewers

## Overview

OHIF is an extensible, zero-footprint medical imaging viewer. Its central workflow is selecting a study, retrieving imaging data, organizing it into display sets and viewports, then rendering and interacting with it. The graph also preserves documented modality and workflow capabilities and the platform’s extension, command, and service layers. Several subsystem links reflect README-level capabilities rather than inspected calls; unsampled implementation details are not inferred.

Main entry points: [`extensions/cornerstone/src/Viewport/OHIFCornerstoneViewport.tsx`](https://github.com/ohif/viewers/blob/master/extensions/cornerstone/src/Viewport/OHIFCornerstoneViewport.tsx) (Image viewports), [`platform/core/src/extensions/ExtensionManager.ts`](https://github.com/ohif/viewers/blob/master/platform/core/src/extensions/ExtensionManager.ts) (Extension manager), [`extensions/cornerstone/src/services/SegmentationService/SegmentationService.ts`](https://github.com/ohif/viewers/blob/master/extensions/cornerstone/src/services/SegmentationService/SegmentationService.ts) (Segmentation service), [`extensions/default/src/getSopClassHandlerModule.js`](https://github.com/ohif/viewers/blob/master/extensions/default/src/getSopClassHandlerModule.js) (Display sets)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Viewer application"]
  node_app["Viewer application<br/>[App.tsx]"]
  node_studysearch["Study search"]
end

subgraph group_platform["Platform runtime"]
  node_extensionmanager["Extension manager"]
  node_servicesmanager["Services manager<br/>[ServicesManager.ts]"]
  node_commands["Command manager<br/>[CommandsManager.ts]"]
  node_contextmenu["Context menus"]
  node_contextbuilder["Menu item builder"]
  node_applog["Application logging<br/>[log.js]"]
  node_apptypes["App type contracts<br/>[AppTypes.ts]"]
end

subgraph group_imaging["Imaging and interaction"]
  node_displaysets["Display sets"]
  node_viewport["Image viewports"]
  node_cornerstone["Cornerstone tools"]
  node_viewportservice["Viewport service"]
  node_segmentation["Segmentation service"]
  node_measurement["Measurement service"]
  node_measurementmappings["Measurement mappings"]
  node_nextviewports["Viewport transitions<br/>[nextViewports.ts]"]
  node_transitions["Transition utilities<br/>[transitions.ts]"]
  node_protocol["Hanging protocols<br/>[ProtocolEngine.js]"]
end

subgraph group_modalities["Modality extensions"]
  node_rt["RT structure<br/>[loadRTStruct.js]"]
  node_seg["DICOM segmentation"]
  node_sr["Structured reports"]
  node_srdata["Renderable SR data"]
  node_pmap["Parametric maps"]
  node_pdf["PDF documents"]
  node_pdfhandler["PDF display handler"]
  node_video["DICOM video"]
  node_microscopy["Slide microscopy"]
  node_micview["Microscopy viewer<br/>[viewerManager.js]"]
  node_micstyles["Microscopy styles<br/>[styles.js]"]
end

subgraph group_workflow["Specialized workflows"]
  node_tracking[("Measurement tracking")]
  node_dynamic["Dynamic volume"]
end

node_user(("Viewer user"))
node_datasource[("DICOMweb archive")]

node_user -.->|"opens"| node_app
node_app -.->|"searches studies"| node_studysearch
node_studysearch -->|"queries studies"| node_datasource
node_datasource -.->|"provides images"| node_displaysets
node_displaysets -.->|"displays studies"| node_viewport
node_viewport -.->|"renders and interacts"| node_cornerstone
node_viewport -.->|"uses viewport services"| node_viewportservice
node_viewport -.->|"applies layouts"| node_protocol
node_cornerstone -->|"registers measurements"| node_measurement
node_measurement -->|"registers mappings"| node_measurementmappings
node_segmentation -.->|"renders segmentations"| node_viewport
node_segmentation -->|"uses viewport transitions"| node_nextviewports
node_segmentation -->|"uses transitions"| node_transitions
node_app -.->|"loads extensions"| node_extensionmanager
node_extensionmanager -->|"receives manager"| node_commands
node_extensionmanager -->|"receives manager"| node_servicesmanager
node_contextmenu -->|"builds menu items"| node_contextbuilder
node_contextmenu -->|"runs commands"| node_commands
node_commands -->|"logs commands"| node_applog
node_extensionmanager -->|"uses app contracts"| node_apptypes
node_rt -.->|"loads RT data"| node_displaysets
node_seg -->|"creates segmentation"| node_segmentation
node_sr -.->|"resolves renderable data"| node_srdata
node_sr -.->|"handles report sets"| node_displaysets
node_pmap -.->|"renders parametric maps"| node_viewport
node_pdfhandler -->|"loads documents"| node_pdf
node_pdf -.->|"renders documents"| node_viewport
node_video -.->|"renders video"| node_viewport
node_microscopy -->|"manages viewer"| node_micview
node_micview -->|"uses styles"| node_micstyles
node_tracking -.->|"tracks observations"| node_measurement
node_dynamic -.->|"supports 4D viewing"| node_viewport

click node_app "https://github.com/ohif/viewers/blob/master/platform/app/src/App.tsx"
click node_studysearch "https://github.com/ohif/viewers/blob/master/platform/app/src/hooks/useStudyListQuery.tsx"
click node_displaysets "https://github.com/ohif/viewers/blob/master/extensions/default/src/getSopClassHandlerModule.js"
click node_viewport "https://github.com/ohif/viewers/blob/master/extensions/cornerstone/src/Viewport/OHIFCornerstoneViewport.tsx"
click node_cornerstone "https://github.com/ohif/viewers/blob/master/extensions/cornerstone/src/initCornerstoneTools.js"
click node_viewportservice "https://github.com/ohif/viewers/tree/master/extensions/cornerstone/src/services/ViewportService"
click node_segmentation "https://github.com/ohif/viewers/blob/master/extensions/cornerstone/src/services/SegmentationService/SegmentationService.ts"
click node_measurement "https://github.com/ohif/viewers/blob/master/extensions/cornerstone/src/initMeasurementService.ts"
click node_measurementmappings "https://github.com/ohif/viewers/blob/master/extensions/cornerstone/src/utils/measurementServiceMappings/measurementServiceMappingsFactory.ts"
click node_nextviewports "https://github.com/ohif/viewers/blob/master/extensions/cornerstone/src/utils/nextViewports.ts"
click node_transitions "https://github.com/ohif/viewers/blob/master/extensions/cornerstone/src/utils/transitions.ts"
click node_protocol "https://github.com/ohif/viewers/blob/master/platform/core/src/services/HangingProtocolService/ProtocolEngine.js"
click node_extensionmanager "https://github.com/ohif/viewers/blob/master/platform/core/src/extensions/ExtensionManager.ts"
click node_servicesmanager "https://github.com/ohif/viewers/blob/master/platform/core/src/services/ServicesManager.ts"
click node_commands "https://github.com/ohif/viewers/blob/master/platform/core/src/classes/CommandsManager.ts"
click node_contextmenu "https://github.com/ohif/viewers/blob/master/extensions/default/src/CustomizableContextMenu/ContextMenuController.tsx"
click node_contextbuilder "https://github.com/ohif/viewers/blob/master/extensions/default/src/CustomizableContextMenu/ContextMenuItemsBuilder.ts"
click node_applog "https://github.com/ohif/viewers/blob/master/platform/core/src/log.js"
click node_apptypes "https://github.com/ohif/viewers/blob/master/platform/core/src/types/AppTypes.ts"
click node_rt "https://github.com/ohif/viewers/blob/master/extensions/cornerstone-dicom-rt/src/loadRTStruct.js"
click node_seg "https://github.com/ohif/viewers/blob/master/extensions/cornerstone-dicom-seg/src/getSopClassHandlerModule.ts"
click node_sr "https://github.com/ohif/viewers/blob/master/extensions/cornerstone-dicom-sr/src/getSopClassHandlerModule.ts"
click node_srdata "https://github.com/ohif/viewers/blob/master/extensions/cornerstone-dicom-sr/src/utils/getRenderableData.ts"
click node_pmap "https://github.com/ohif/viewers/blob/master/extensions/cornerstone-dicom-pmap/src/getSopClassHandlerModule.ts"
click node_pdf "https://github.com/ohif/viewers/blob/master/extensions/dicom-pdf/src/utils/loadDisplayableDocument.ts"
click node_pdfhandler "https://github.com/ohif/viewers/blob/master/extensions/dicom-pdf/src/utils/displayableDocumentTypes.ts"
click node_video "https://github.com/ohif/viewers/blob/master/extensions/dicom-video/src/getSopClassHandlerModule.js"
click node_microscopy "https://github.com/ohif/viewers/blob/master/extensions/dicom-microscopy/src/services/MicroscopyService.ts"
click node_micview "https://github.com/ohif/viewers/blob/master/extensions/dicom-microscopy/src/tools/viewerManager.js"
click node_micstyles "https://github.com/ohif/viewers/blob/master/extensions/dicom-microscopy/src/utils/styles.js"
click node_tracking "https://github.com/ohif/viewers/blob/master/extensions/measurement-tracking/src/services/TrackedMeasurementsService/TrackedMeasurementsService.ts"
click node_dynamic "https://github.com/ohif/viewers/blob/master/extensions/cornerstone-dynamic-volume/src/panels/DynamicVolumeControls.tsx"

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_studysearch,node_user toneBlue
class node_extensionmanager,node_servicesmanager,node_commands,node_contextmenu,node_contextbuilder,node_applog,node_apptypes,node_datasource toneAmber
class node_displaysets,node_viewport,node_cornerstone,node_viewportservice,node_segmentation,node_measurement,node_measurementmappings,node_nextviewports,node_transitions,node_protocol toneMint
class node_rt,node_seg,node_sr,node_srdata,node_pmap,node_pdf,node_pdfhandler,node_video,node_microscopy,node_micview,node_micstyles toneRose
class node_tracking,node_dynamic toneIndigo
```

## Components

### Viewer application

- [Viewer application](https://github.com/ohif/viewers/blob/master/platform/app/src/App.tsx): `platform/app/src/App.tsx`
- [Study search](https://github.com/ohif/viewers/blob/master/platform/app/src/hooks/useStudyListQuery.tsx): `platform/app/src/hooks/useStudyListQuery.tsx`

### Platform runtime

- [Extension manager](https://github.com/ohif/viewers/blob/master/platform/core/src/extensions/ExtensionManager.ts): `platform/core/src/extensions/ExtensionManager.ts`
- [Services manager](https://github.com/ohif/viewers/blob/master/platform/core/src/services/ServicesManager.ts): `platform/core/src/services/ServicesManager.ts`
- [Command manager](https://github.com/ohif/viewers/blob/master/platform/core/src/classes/CommandsManager.ts): `platform/core/src/classes/CommandsManager.ts`
- [Context menus](https://github.com/ohif/viewers/blob/master/extensions/default/src/CustomizableContextMenu/ContextMenuController.tsx): `extensions/default/src/CustomizableContextMenu/ContextMenuController.tsx`
- [Menu item builder](https://github.com/ohif/viewers/blob/master/extensions/default/src/CustomizableContextMenu/ContextMenuItemsBuilder.ts): `extensions/default/src/CustomizableContextMenu/ContextMenuItemsBuilder.ts`
- [Application logging](https://github.com/ohif/viewers/blob/master/platform/core/src/log.js): `platform/core/src/log.js`
- [App type contracts](https://github.com/ohif/viewers/blob/master/platform/core/src/types/AppTypes.ts): `platform/core/src/types/AppTypes.ts`

### Imaging and interaction

- [Display sets](https://github.com/ohif/viewers/blob/master/extensions/default/src/getSopClassHandlerModule.js): `extensions/default/src/getSopClassHandlerModule.js`
- [Image viewports](https://github.com/ohif/viewers/blob/master/extensions/cornerstone/src/Viewport/OHIFCornerstoneViewport.tsx): `extensions/cornerstone/src/Viewport/OHIFCornerstoneViewport.tsx`
- [Cornerstone tools](https://github.com/ohif/viewers/blob/master/extensions/cornerstone/src/initCornerstoneTools.js): `extensions/cornerstone/src/initCornerstoneTools.js`
- [Viewport service](https://github.com/ohif/viewers/tree/master/extensions/cornerstone/src/services/ViewportService): `extensions/cornerstone/src/services/ViewportService`
- [Segmentation service](https://github.com/ohif/viewers/blob/master/extensions/cornerstone/src/services/SegmentationService/SegmentationService.ts): `extensions/cornerstone/src/services/SegmentationService/SegmentationService.ts`
- [Measurement service](https://github.com/ohif/viewers/blob/master/extensions/cornerstone/src/initMeasurementService.ts): `extensions/cornerstone/src/initMeasurementService.ts`
- [Measurement mappings](https://github.com/ohif/viewers/blob/master/extensions/cornerstone/src/utils/measurementServiceMappings/measurementServiceMappingsFactory.ts): `extensions/cornerstone/src/utils/measurementServiceMappings/measurementServiceMappingsFactory.ts`
- [Viewport transitions](https://github.com/ohif/viewers/blob/master/extensions/cornerstone/src/utils/nextViewports.ts): `extensions/cornerstone/src/utils/nextViewports.ts`
- [Transition utilities](https://github.com/ohif/viewers/blob/master/extensions/cornerstone/src/utils/transitions.ts): `extensions/cornerstone/src/utils/transitions.ts`
- [Hanging protocols](https://github.com/ohif/viewers/blob/master/platform/core/src/services/HangingProtocolService/ProtocolEngine.js): `platform/core/src/services/HangingProtocolService/ProtocolEngine.js`

### Modality extensions

- [RT structure](https://github.com/ohif/viewers/blob/master/extensions/cornerstone-dicom-rt/src/loadRTStruct.js): `extensions/cornerstone-dicom-rt/src/loadRTStruct.js`
- [DICOM segmentation](https://github.com/ohif/viewers/blob/master/extensions/cornerstone-dicom-seg/src/getSopClassHandlerModule.ts): `extensions/cornerstone-dicom-seg/src/getSopClassHandlerModule.ts`
- [Structured reports](https://github.com/ohif/viewers/blob/master/extensions/cornerstone-dicom-sr/src/getSopClassHandlerModule.ts): `extensions/cornerstone-dicom-sr/src/getSopClassHandlerModule.ts`
- [Renderable SR data](https://github.com/ohif/viewers/blob/master/extensions/cornerstone-dicom-sr/src/utils/getRenderableData.ts): `extensions/cornerstone-dicom-sr/src/utils/getRenderableData.ts`
- [Parametric maps](https://github.com/ohif/viewers/blob/master/extensions/cornerstone-dicom-pmap/src/getSopClassHandlerModule.ts): `extensions/cornerstone-dicom-pmap/src/getSopClassHandlerModule.ts`
- [PDF documents](https://github.com/ohif/viewers/blob/master/extensions/dicom-pdf/src/utils/loadDisplayableDocument.ts): `extensions/dicom-pdf/src/utils/loadDisplayableDocument.ts`
- [PDF display handler](https://github.com/ohif/viewers/blob/master/extensions/dicom-pdf/src/utils/displayableDocumentTypes.ts): `extensions/dicom-pdf/src/utils/displayableDocumentTypes.ts`
- [DICOM video](https://github.com/ohif/viewers/blob/master/extensions/dicom-video/src/getSopClassHandlerModule.js): `extensions/dicom-video/src/getSopClassHandlerModule.js`
- [Slide microscopy](https://github.com/ohif/viewers/blob/master/extensions/dicom-microscopy/src/services/MicroscopyService.ts): `extensions/dicom-microscopy/src/services/MicroscopyService.ts`
- [Microscopy viewer](https://github.com/ohif/viewers/blob/master/extensions/dicom-microscopy/src/tools/viewerManager.js): `extensions/dicom-microscopy/src/tools/viewerManager.js`
- [Microscopy styles](https://github.com/ohif/viewers/blob/master/extensions/dicom-microscopy/src/utils/styles.js): `extensions/dicom-microscopy/src/utils/styles.js`

### Specialized workflows

- [Measurement tracking](https://github.com/ohif/viewers/blob/master/extensions/measurement-tracking/src/services/TrackedMeasurementsService/TrackedMeasurementsService.ts): `extensions/measurement-tracking/src/services/TrackedMeasurementsService/TrackedMeasurementsService.ts`
- [Dynamic volume](https://github.com/ohif/viewers/blob/master/extensions/cornerstone-dynamic-volume/src/panels/DynamicVolumeControls.tsx): `extensions/cornerstone-dynamic-volume/src/panels/DynamicVolumeControls.tsx`

### Other components

- **Viewer user**
- **DICOMweb archive**

## Connections

- Viewer user → Viewer application: opens
- Viewer application → Study search: searches studies
- Study search → DICOMweb archive: queries studies (evidence: `platform/app/src/hooks/useStudyListQuery.tsx`)
- DICOMweb archive → Display sets: provides images
- Display sets → Image viewports: displays studies
- Image viewports → Cornerstone tools: renders and interacts
- Image viewports → Viewport service: uses viewport services
- Image viewports → Hanging protocols: applies layouts
- Cornerstone tools → Measurement service: registers measurements (evidence: `extensions/cornerstone/src/initMeasurementService.ts`)
- Measurement service → Measurement mappings: registers mappings (evidence: `extensions/cornerstone/src/initMeasurementService.ts`)
- Segmentation service → Image viewports: renders segmentations
- Segmentation service → Viewport transitions: uses viewport transitions (evidence: `extensions/cornerstone/src/services/SegmentationService/SegmentationService.ts`)
- Segmentation service → Transition utilities: uses transitions (evidence: `extensions/cornerstone/src/services/SegmentationService/SegmentationService.ts`)
- Viewer application → Extension manager: loads extensions
- Extension manager → Command manager: receives manager (evidence: `platform/core/src/extensions/ExtensionManager.ts`)
- Extension manager → Services manager: receives manager (evidence: `platform/core/src/extensions/ExtensionManager.ts`)
- Context menus → Menu item builder: builds menu items (evidence: `extensions/default/src/CustomizableContextMenu/ContextMenuController.tsx`)
- Context menus → Command manager: runs commands (evidence: `extensions/default/src/CustomizableContextMenu/ContextMenuController.tsx`)
- Command manager → Application logging: logs commands (evidence: `platform/core/src/classes/CommandsManager.ts`)
- Extension manager → App type contracts: uses app contracts (evidence: `platform/core/src/extensions/ExtensionManager.ts`)
- RT structure → Display sets: loads RT data
- DICOM segmentation → Segmentation service: creates segmentation (evidence: `extensions/cornerstone-dicom-seg/src/getSopClassHandlerModule.ts`)
- Structured reports → Renderable SR data: resolves renderable data
- Structured reports → Display sets: handles report sets
- Parametric maps → Image viewports: renders parametric maps
- PDF display handler → PDF documents: loads documents (evidence: `extensions/dicom-pdf/src/getSopClassHandlerModule.js`)
- PDF documents → Image viewports: renders documents
- DICOM video → Image viewports: renders video
- Slide microscopy → Microscopy viewer: manages viewer (evidence: `extensions/dicom-microscopy/src/services/MicroscopyService.ts`)
- Microscopy viewer → Microscopy styles: uses styles (evidence: `extensions/dicom-microscopy/src/tools/viewerManager.js`)
- Measurement tracking → Measurement service: tracks observations
- Dynamic volume → Image viewports: supports 4D viewing
