Skip to content

Home

Jump to bottom
Grimmer edited this page Oct 4, 2021 · 43 revisions

A Chrome extension to view the images in medical DICOM p10 files. This is not for clinical use and just a reference. Web version: https://grimmer.io/dicom-web-viewer/

Features

  1. View online DICOM files by clicking DICOM urls
  2. View offline DICOM by dragging files onto Chrome, or use built-in file browser to select files.
  3. In terminal, use https://www.npmjs.com/package/cli-open-dicom-with-chrome to open DICOM files via this extension.
  4. Shortcut (ctrl+u/cmd+u) to open extension viewer page. Or click extension icon.
  5. Support adjustable window center mode.
  6. Support multi-frame, RGB DICOM files
  7. Support different plane views mode

After installation, to enable dragging offline files onto Chrome function, please

  1. Open the Extension Management page by navigating to "chrome://extensions" (input this in the address bar)
  2. Locate DICOM Image Viewer and click on the DETAILS button
  3. Turn Allow access to file URLs switch on

Change Log

v1.7:

  • Migrate to use Python browser runtime and Python package to parse DICOM. Please wait for a second to load these.
  • Improve UI.
  • Add back PALETTE color support.
  • List "1.2.840.10008.1.2.4.90" in not support list.
  • When loading a folder to see its series plane views, if there are multiple series, we only show the first series and use the file/axial slider to switch files. Multiple series switching may be added in the future.

v1.6:

  • Fix broken function to view online DICOM image
  • Add the snapshot for axial/sagittal/coronal view.
  • Show transferSyntax on UI and print RGB planar in console

v1.5: Add series mode to view different plane views (e.g. axial, sagittal, and coronal)

v1.4: Change icon

v1.3:

  • [Add] Use mouse/touch press+move to change Window Center (level) and Window Width
  • [Add] Add some difference common Window Center (level) modes (e.g. Brain/Lungs)
  • [Add] Support MONOCHROME1 inverted color DICOM
  • [Add] View multiple local files (sort by name)
  • [Add] CLI tool to open DICOM files with this extension in your terminal !!
  • [Add] Use shortcut (ctrl+u/cmd+u) to open extension viewer page
  • [Add] Click extension icon to open extension viewer page
  • [Remove] PALETTE COLOR DICOM support

v1.2:

  1. Remove the handle on outside-of-scan pixels.
  2. Add windowCenter/windowHeight mode
  3. Set maximal shown resolution and resize too large DICOM files.
  4. Support RGB and PALETTE COLOR DICOM files, useful for ultrasound DICOM
  5. Show some meta info. on UI

v1.1.3: Add the function to view online DICOM files. Also, add the support for .DCM, .DICOM and .dicom file extension.

v1.1.2: Detect outside-of-scan pixels and reset to minimal value (~air) when the file is using default unsigned pixel representation, intercept (-1024) and padding (-2000).

v1.1.1: Rename the extension to DICOM image viewer

v1.1:

  1. support multi-frame file
  2. add "drop file zone" in the opened DICOM extension page
  3. add web site version: https://grimmer.io/dicom-web-viewer/

v1.0:

  1. open DICOM p10 image file

Misc

[Not mentioned in feature list] This also supports those DICOM files with missing "Supported Transfer Syntax".

Not support yet:

  1. DICOM video format.
  2. (0028,3000) Modality LUT Sequence present DICOM
  3. YBR Photometric DICOM
  4. PALETTE COLOR Photometric DICOM

CLI tool

Use https://www.npmjs.com/package/cli-open-dicom-with-chrome, to open DICOM files with this chrome extension in your terminal

Installation

  1. You need to install Node.js first, https://nodejs.org/en/
  2. Then, in your terminal, execute npm install -g cli-open-dicom-with-chrome
  3. If it fails to install due to permission issue, try to add sudo, sudo npm install -g cli-open-dicom-with-chrome

usage

  1. In your terminal, execute dicom to launch chrome extension
  2. In your terminal, execute dicom {dicom_path/folder}, e.g. dicom CR-MONO1-10-chest.dcm to let Chrome to open it. It supports multiple files/folders.
Clone this wiki locally