Skip to content

Conversation

@mbellehumeur
Copy link
Contributor

@mbellehumeur mbellehumeur commented Dec 16, 2025

  • Added @cornerstonejs/nifti-volume-loader as a dependency.
  • Registered NIFTI image loader in the initialization process.
  • Implemented logic to load NIFTI image IDs and cache metadata in the display set handler.
  • Introduced utility functions for URL handling to support NIFTI file paths.

Context

NIfTI Loader Support

Overview:
The NIfTI Loader feature allows the OHIF Viewer to load NIfTI images directly if a specific DICOM private tag contains a NIfTI URL. This is especially useful for hybrid datasets or research workflows.

How It Works

  • Add the niftiPrivateTagName attribute to your data source configuration.
  • When loading a study, the viewer checks for this private tag in the DICOM metadata.
  • If the tag is present, the viewer loads the NIfTI file from the URL specified in the tag, bypassing standard DICOMweb retrieval.

Example Configuration

{
  "namespace": "@ohif/extension-default.dataSourcesModule.dicomweb",
  "sourceName": "jls",
  "configuration": {
    "friendlyName": "JLS Static WADO Server",
    "name": "jls",
    "wadoUriRoot": "http://localhost:5001/dicomweb",
    "qidoRoot": "http://localhost:5001/dicomweb",
    "wadoRoot": "http://localhost:5001/dicomweb",
    "niftiPrivateTagName": "00090010"
  }
}

Key Option Explained:

  • niftiPrivateTagName:
    The DICOM private tag (in group/element format, e.g., "00090010") where the NIfTI URL is stored.

Behavior:
If a DICOM instance contains this private tag, the viewer will use the URL from the tag to load the NIfTI file, bypassing standard DICOMweb image retrieval.


Summary

  • Subresolution:
    Use imageRetrieveOptions to customize how frames/volumes are retrieved from your DICOMweb server, including progressive loading and custom frame paths.
  • NIfTI Loader:
    Use niftiPrivateTagName to enable direct loading of NIfTI files via a DICOM private tag.

Changes & Results

Testing

Checklist

PR

  • [] My Pull Request title is descriptive, accurate and follows the
    semantic-release format and guidelines.

Code

  • [] My code has been well-documented (function documentation, inline comments,
    etc.)

Public Documentation Updates

  • [] The documentation page has been updated as necessary for any public API
    additions or removals.

Tested Environment

  • [] OS:
  • [] Node version:
  • [] Browser:

…capabilities

- Added @cornerstonejs/nifti-volume-loader as a dependency.
- Registered NIFTI image loader in the initialization process.
- Implemented logic to load NIFTI image IDs and cache metadata in the display set handler.
- Introduced utility functions for URL handling to support NIFTI file paths.
@netlify
Copy link

netlify bot commented Dec 16, 2025

Deploy Preview for ohif-dev canceled.

Name Link
🔨 Latest commit 71ba73c
🔍 Latest deploy log https://app.netlify.com/projects/ohif-dev/deploys/6945c43580bf090008c9f45c

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants