How ohif/viewers works
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: OHIFCornerstoneViewport.tsx Image viewports · ExtensionManager.ts Extension manager · SegmentationService.ts Segmentation service · getSopClassHandlerModule.js Display sets
Components 34
Viewer application
- Viewer application
platform/app/src/App.tsx - Study search
platform/app/src/hooks/useStudyListQuery.tsx
Platform runtime
- Extension manager
platform/core/src/extensions/ExtensionManager.ts - Services manager
platform/core/src/services/ServicesManager.ts - Command manager
platform/core/src/classes/CommandsManager.ts - Context menus
extensions/default/src/CustomizableContextMenu/ContextMenuController.tsx - Menu item builder
extensions/default/src/CustomizableContextMenu/ContextMenuItemsBuilder.ts - Application logging
platform/core/src/log.js - App type contracts
platform/core/src/types/AppTypes.ts
Imaging and interaction
- Display sets
extensions/default/src/getSopClassHandlerModule.js - Image viewports
extensions/cornerstone/src/Viewport/OHIFCornerstoneViewport.tsx - Cornerstone tools
extensions/cornerstone/src/initCornerstoneTools.js - Viewport service
extensions/cornerstone/src/services/ViewportService - Segmentation service
extensions/cornerstone/src/services/SegmentationService/SegmentationService.ts - Measurement service
extensions/cornerstone/src/initMeasurementService.ts - Measurement mappings
extensions/cornerstone/src/utils/measurementServiceMappings/measurementServiceMappingsFactory.ts - Viewport transitions
extensions/cornerstone/src/utils/nextViewports.ts - Transition utilities
extensions/cornerstone/src/utils/transitions.ts - Hanging protocols
platform/core/src/services/HangingProtocolService/ProtocolEngine.js
Modality extensions
- RT structure
extensions/cornerstone-dicom-rt/src/loadRTStruct.js - DICOM segmentation
extensions/cornerstone-dicom-seg/src/getSopClassHandlerModule.ts - Structured reports
extensions/cornerstone-dicom-sr/src/getSopClassHandlerModule.ts - Renderable SR data
extensions/cornerstone-dicom-sr/src/utils/getRenderableData.ts - Parametric maps
extensions/cornerstone-dicom-pmap/src/getSopClassHandlerModule.ts - PDF documents
extensions/dicom-pdf/src/utils/loadDisplayableDocument.ts - PDF display handler
extensions/dicom-pdf/src/utils/displayableDocumentTypes.ts - DICOM video
extensions/dicom-video/src/getSopClassHandlerModule.js - Slide microscopy
extensions/dicom-microscopy/src/services/MicroscopyService.ts - Microscopy viewer
extensions/dicom-microscopy/src/tools/viewerManager.js - Microscopy styles
extensions/dicom-microscopy/src/utils/styles.js
Specialized workflows
- Measurement tracking
extensions/measurement-tracking/src/services/TrackedMeasurementsService/TrackedMeasurementsService.ts - Dynamic volume
extensions/cornerstone-dynamic-volume/src/panels/DynamicVolumeControls.tsx
Other components
- Viewer user
- DICOMweb archive
Connections 32
- Viewer user → Viewer application: opens
- Viewer application → Study search: searches studies
- Study search → DICOMweb archive: queries studies
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
extensions/cornerstone/src/initMeasurementService.ts - Measurement service → Measurement mappings: registers mappings
extensions/cornerstone/src/initMeasurementService.ts - Segmentation service → Image viewports: renders segmentations
- Segmentation service → Viewport transitions: uses viewport transitions
extensions/cornerstone/src/services/SegmentationService/SegmentationService.ts - Segmentation service → Transition utilities: uses transitions
extensions/cornerstone/src/services/SegmentationService/SegmentationService.ts - Viewer application → Extension manager: loads extensions
- Extension manager → Command manager: receives manager
platform/core/src/extensions/ExtensionManager.ts - Extension manager → Services manager: receives manager
platform/core/src/extensions/ExtensionManager.ts - Context menus → Menu item builder: builds menu items
extensions/default/src/CustomizableContextMenu/ContextMenuController.tsx - Context menus → Command manager: runs commands
extensions/default/src/CustomizableContextMenu/ContextMenuController.tsx - Command manager → Application logging: logs commands
platform/core/src/classes/CommandsManager.ts - Extension manager → App type contracts: uses app contracts
platform/core/src/extensions/ExtensionManager.ts - RT structure → Display sets: loads RT data
- DICOM segmentation → Segmentation service: creates segmentation
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
extensions/dicom-pdf/src/getSopClassHandlerModule.js - PDF documents → Image viewports: renders documents
- DICOM video → Image viewports: renders video
- Slide microscopy → Microscopy viewer: manages viewer
extensions/dicom-microscopy/src/services/MicroscopyService.ts - Microscopy viewer → Microscopy styles: uses styles
extensions/dicom-microscopy/src/tools/viewerManager.js - Measurement tracking → Measurement service: tracks observations
- Dynamic volume → Image viewports: supports 4D viewing