The OHIF Viewer is a zero-footprint medical image viewer provided by the Open Health Imaging Foundation (OHIF). It is a configurable and extensible progressive web application with out-of-the-box support for image archives which support DICOMweb.
![]() |
Measurement Tracking | Demo |
![]() |
Labelmap Segmentations | Demo |
![]() |
Fusion and Custom Hanging protocols | Demo |
![]() |
Volume Rendering | Demo |
![]() |
Demo | |
![]() |
RT STRUCT | Demo |
![]() |
4D | Demo |
![]() |
Video | Demo |
![]() |
Slide Microscopy | Demo |
The OHIF Medical Imaging Viewer is for viewing medical images. It can retrieve and load images from most sources and formats; render sets in 2D, 3D, and reconstructed representations; allows for the manipulation, annotation, and serialization of observations; supports internationalization, OpenID Connect, offline use, hotkeys, and many more features.
Almost everything offers some degree of customization and configuration. If it doesn't support something you need, we accept pull requests and have an ever improving Extension System.
The OHIF Viewer is a collaborative effort that has served as the basis for many active, production, and FDA Cleared medical imaging viewers. It benefits from our extensive community's collective experience, and from the sponsored contributions of individuals, research groups, and commercial organizations.
After more than 8-years of integrating with many companies and organizations, The OHIF Viewer has been rebuilt from the ground up to better address the varying workflow and configuration needs of its many users. All of the Viewer's core features are built using it's own extension system. The same extensibility that allows us to offer:
- 2D and 3D medical image viewing
- Multiplanar Reconstruction (MPR)
- Maximum Intensity Project (MIP)
- Whole slide microscopy viewing
- PDF and Dicom Structured Report rendering
- Segmentation rendering as labelmaps and contours
- User Access Control (UAC)
- Context specific toolbar and side panel content
- and many others
Can be leveraged by you to customize the viewer for your workflow, and to add any new functionality you may need (and wish to maintain privately without forking).
For commercial support, academic collaborations, and answers to common questions; please use Get Support to contact us.
master
- The latest dev release
This is typically where the latest development happens. Code that is in the master branch has passed code reviews and automated tests, but it may not be deemed ready for production. This branch usually contains the most recent changes and features being worked on by the development team. It's often the starting point for creating feature branches (where new features are developed) and hotfix branches (for urgent fixes).
Each package is tagged with beta version numbers, and published to npm such as @ohif/[email protected]
This branch represents the latest stable version of the project that is considered ready for production. The code in this branch should be fully tested and vetted for release. Once the code in the master branch reaches a state where it's stable and ready to be released to users, we do a comprehensive code review and QA testing. Once the code is approved, we merge it into the release branch and tag a new release.
Each package is tagged with version numbers, and published to npm such as @ohif/[email protected]
Note: master
is always ahead of release
branch. We publish both docker builds for beta and stable releases.
Here is a schematic representation of our development workflow:
- Yarn 1.17.3+
- Node 16+
- Yarn Workspaces should be enabled on your machine:
yarn config set workspaces-experimental true
- Fork this repository
- Clone your forked repository
git clone https://github.com/YOUR-USERNAME/Viewers.git
- Navigate to the cloned project's directory
- Add this repo as a
remote
namedupstream
git remote add upstream https://github.com/OHIF/Viewers.git
yarn install
to restore dependencies and link projects
From this repository's root directory:
# Enable Yarn Workspaces
yarn config set workspaces-experimental true
# Restore dependencies
yarn install
These commands are available from the root directory. Each project directory
also supports a number of commands that can be found in their respective
README.md
and package.json
files.
Yarn Commands | Description |
---|---|
Develop | |
dev or start |
Default development experience for Viewer |
test:unit |
Jest multi-project test runner; overall coverage |
Deploy | |
build * |
Builds production output for our PWA Viewer |
* - For more information on our different builds, check out our Deploy Docs
The OHIF Medical Image Viewing Platform is maintained as a
monorepo
. This means that this repository, instead of containing a
single project, contains many projects. If you explore our project structure,
you'll see the following:
.
โโโ extensions #
โ โโโ _example # Skeleton of example extension
โ โโโ default # basic set of useful functionalities (datasources, panels, etc)
โ โโโ cornerstone # image rendering and tools w/ Cornerstone3D
โ โโโ cornerstone-dicom-sr # DICOM Structured Report rendering and export
โ โโโ cornerstone-dicom-sr # DICOM Structured Report rendering and export
โ โโโ cornerstone-dicom-seg # DICOM Segmentation rendering and export
โ โโโ cornerstone-dicom-rt # DICOM RTSTRUCT rendering
โ โโโ cornerstone-microscopy # Whole Slide Microscopy rendering
โ โโโ dicom-pdf # PDF rendering
โ โโโ dicom-video # DICOM RESTful Services
โ โโโ measurement-tracking # Longitudinal measurement tracking
โ โโโ tmtv # Total Metabolic Tumor Volume (TMTV) calculation
|
โ
โโโ modes #
โ โโโ _example # Skeleton of example mode
โ โโโ basic-dev-mode # Basic development mode
โ โโโ longitudinal # Longitudinal mode (measurement tracking)
โ โโโ tmtv # Total Metabolic Tumor Volume (TMTV) calculation mode
โ โโโ microscopy # Whole Slide Microscopy mode
โ
โโโ platform #
โ โโโ core # Business Logic
โ โโโ i18n # Internationalization Support
โ โโโ ui # React component library
โ โโโ docs # Documentation
โ โโโ viewer # Connects platform and extension projects
โ
โโโ ... # misc. shared configuration
โโโ lerna.json # MonoRepo (Lerna) settings
โโโ package.json # Shared devDependencies and commands
โโโ README.md # This file
To acknowledge the OHIF Viewer in an academic publication, please cite
Open Health Imaging Foundation Viewer: An Extensible Open-Source Framework for Building Web-Based Imaging Applications to Support Cancer Research
Erik Ziegler, Trinity Urban, Danny Brown, James Petts, Steve D. Pieper, Rob Lewis, Chris Hafey, and Gordon J. Harris
JCO Clinical Cancer Informatics, no. 4 (2020), 336-345, DOI: 10.1200/CCI.19.00131
Open-Access on Pubmed Central: https://www.ncbi.nlm.nih.gov/pmc/articles/PMC7259879/
or, for v1, please cite:
LesionTracker: Extensible Open-Source Zero-Footprint Web Viewer for Cancer Imaging Research and Clinical Trials
Trinity Urban, Erik Ziegler, Rob Lewis, Chris Hafey, Cheryl Sadow, Annick D. Van den Abbeele and Gordon J. Harris
Cancer Research, November 1 2017 (77) (21) e119-e122 DOI: 10.1158/0008-5472.CAN-17-0334
Note: If you use or find this repository helpful, please take the time to star this repository on GitHub. This is an easy way for us to assess adoption and it can help us obtain future funding for the project.
This work is supported primarily by the National Institutes of Health, National Cancer Institute, Informatics Technology for Cancer Research (ITCR) program, under a grant to Dr. Gordon Harris at Massachusetts General Hospital (U24 CA199460).
NCI Imaging Data Commons (IDC) project supported the development of new features and bug fixes marked with "IDC:priority", "IDC:candidate" or "IDC:collaboration". NCI Imaging Data Commons is supported by contract number 19X037Q from Leidos Biomedical Research under Task Order HHSN26100071 from NCI. IDC Viewer is a customized version of the OHIF Viewer.
This project is tested with BrowserStack. Thank you for supporting open-source!
MIT ยฉ OHIF