Stone Web Viewer plugin

This plugin extends Orthanc with a Web viewer of medical images, with more advanced features than the basic Orthanc Web viewer plugin.

For general information and a demonstration, check out the official homepage of the plugin. Also check out the source code.

How to get it

The Stone Web viewer is part of the Windows installers (since release 20.12.0 of the installers).

For GNU/Linux users, the Stone Web viewer is part of the official Docker images. Precompiled LSB binaries (Linux Standard Base) are available as well.

The compilation process is quite complex since it requires using the Emscripten compiler toolchain. The full build instructions are available in the source code.

Usage

On Microsoft Windows or if you are using the jodogne/orthanc-plugins Docker images, the plugin is enabled by default and will work out-of-the-box.

The osimis/orthanc Docker images are more suited to devops need, as they allow to start a minimal Docker environment as follows:

$ docker run -p 4242:4242 -p 8042:8042 -e STONE_WEB_VIEWER_PLUGIN_ENABLED=true -e DICOM_WEB_PLUGIN_ENABLED=true --rm osimis/orthanc:20.12.0

On plain GNU/Linux distributions (i.e. if not using Docker), the Stone Web viewer will only work with the LSB binaries (Linux Standard Base) of the Orthanc server that can be downloaded from here (this setup will work with most recent GNU/Linux distributions). The Stone Web viewer also requires the DICOMweb plugin to be installed.

Once the binaries are installed, you must change the configuration file to tell Orthanc where it can find the plugin: This is done by properly modifying the Plugins option. You could for instance use the following configuration file:

{
  "Name" : "MyOrthanc",
  [...]
  "Plugins" : [
    "/home/user/xxx/Downloads/libStoneWebViewer.so",
    "/home/user/xxx/Downloads/libOrthancDicomWeb.so"
  ]
}

Orthanc must of course be restarted after the modification of its configuration file.

Once a DICOM study is opened using Orthanc Explorer, a yellow button entitled Stone Web Viewer will show up. It will open the Web viewer for that particular study. See also the interactive demonstration on the official homepage of the plugin.

Advanced options

The configuration of the Web viewer can be fine-tuned by adapting some options in the configuration file.

FAQ

  • Can I use the Stone Viewer in a medical environment?

    The Stone Viewer is not a Medical Device; it is not CE marked or FDA approved. The Stone Viewer is free and open-source software that cannot be used for diagnostic or therapeutic purposes.

    However, the viewer can be used as a communication tool that allows researchers, teachers, technicians, medical physicists, general practitioner or patients to visualize medical images for information only.

    Check out your local regulations to ensure you’re using it in a legal manner.

  • What video formats are supported by the Stone Web Viewer?

    The set of codecs supported by the Stone Viewer is an intersection of the sets of codecs supported by the DICOM standard and those supported by the web browsers. In short, this mostly comes down to just MPEG-4.

    Note that video playing is not supported using the plain DICOMweb protocol: The Stone Web viewer will use the REST API of Orthanc to play videos.

  • How do Osimis Web viewer and Stone Web viewer compare?

    The two viewers use a very similar user interface. However, their internal architecture is totally different:

    The Osimis Web viewer is deprecated and superseded by the Stone Web viewer, as the Stone of Orthanc library allows to use a single C++ codebase between mobile apps, desktop software and Web applications.

    Some features from the Osimis Web viewer are not available (yet), such as creating custom annotations or the Live Share feature.

  • How can I migrate from Osimis Web viewer to Stone Web viewer?

    Full instructions are provided in the source distribution.

  • What are the future plans?

    The internal use of Stone of Orthanc library gives us a lot of flexibility to implement new advanced features, such as 3D rendering (MPR, reslicing, image fusion...), DICOM-RT support, creation of annotations/measurements, internationalization (translation)...

    We are looking for industrial sponsors to implement such new features in the Stone Web viewer.