Skip to content

Osimis Dicom Viewer, forked and tuned

License

GPL-3.0, AGPL-3.0 licenses found

Licenses found

GPL-3.0
LICENSE
AGPL-3.0
COPYING
Notifications You must be signed in to change notification settings

Terabuck/Osimis-Dicom-Viewer-Elessar-

Repository files navigation

Osimis Dicom Viewer - Elessar (Green) Skin

Osimis Dicom Viewer, forked and tuned (green and grey).

  • Vertical browsing in mobile media, and fullscreen optimization. Some minors adjustments were made to the scss just to avoid some fields overlapping of the PDF menu bar when used in small screens.
  • DICOM tools are still available in small screens (first select desktop mode, and then activate fullscreen mode).
  • Patient age and additional study diagnostic information is displayed.
  • QR & Social Share snippets must be properly configured in /frontend/src/app/webviewer.directive.html after YOURLS installation
  • After "build" folder is created, it must be renamed to frontend-build, then PDFJS and Worker must be copied to /frontend/frontend-build/js folder. Then the folder must be compressed to 1.4.1.zip and moved to /backend/ThirdPartyDownloads. Then build the plugin as explained in the original documentation.
  • Please note IOS/iPhone is not supported.

"The Elessar I leave with thee, for there are grievous hurts to Middle-earth which thou maybe shalt heal."

This "tuning" is entirely based on the original Osimis Dicom Viewer

Mainly motivated to avoid the visual stress of high contrast of black and light blue, the interface matches the colors of the Orthanc Explorer Elessar mode as well as the Orthanc Explorer 2 Dark Mode, respectively available at https://github.com/Terabuck/Elessar and https://github.com/Terabuck/orthanc-explorer-2/tree/master-dark-i18n

Localization

Following Pascal Precht Angular Translate scheme, the updated locales for the Osimis WebViewer are includded.

Available languages:

French, Spanish, Portuguese, Chinese, Dutch, German, Japanese, Italian and English (default)

Examples (Anonymized):

Chest xRay (COVID-19): https://misimagenes.online/ym166

Face CT: https://misimagenes.online/g9b6v

Lumbar Spine MRI: https://misimagenes.online/j8hqh

Digital Mammography and Doppler US: https://misimagenes.online/6d4ac

The following is the Readme.md text from the original Osimis Web Viewer, now deprecated, that can be found at https://bitbucket.org/osimis/osimis-webviewer-plugin/src/master/

Osimis Web Viewer

The Osimis' Web Viewer provides medical image visualization straight from the browser.

It is distributed as a plugin to Orthanc. In other words, the viewer can be connected to most modalities, but also leveraged through Orthanc's strong architectural extensibility.

2D rendering is supported with the usual tools:

  • Zooming
  • Panning
  • Windowing
  • Length Measurement
  • Angle Measurement
  • Point/Circle/Rectangle of Interest
  • Image Flipping/Rotation
  • Multiframe support

Have a look at our blog.

Demo

A demo of the viewer is available at those links:

  • IRM study.
  • Full demo, embedded within the Orthanc Explorer. Other studies are available from there.

What's new

See the release notes.

Installation & Usage

The latest stable version is available here.

Nightly builds are available here. They are still unstable at the moment.

We recommend to download the binaries for Windows and Mac OS X & the docker image for Linux.

This article details the installation process on Windows.

This procedure explains how to use the docker image on Linux.

For Mac OS X, the procedure is very similar to the windows' one. Unzip the downloaded folder and double click on the startOrthanc.command file.

Configuration

Orthanc is configurable via a JSON file. This plugin provide a few optional options as well. Check this page for a full list.

Licensing

The Osimis' Web Viewer is licensed under the AGPL license. See the COPYING file. We also kindly ask scientific works and clinical studies that make use of Orthanc to cite Orthanc in their associated publications. Similarly, we ask open-source and closed-source products that make use of Orthanc to warn us about this use. You can cite S. Jodogne's work using the following BibTeX entry:

@inproceedings{Jodogne:ISBI2013,
author = {Jodogne, S. and Bernard, C. and Devillers, M. and Lenaerts, E. and Coucke, P.},
title = {Orthanc -- {A} Lightweight, {REST}ful {DICOM} Server for Healthcare and Medical Research},
booktitle={Biomedical Imaging ({ISBI}), {IEEE} 10th International Symposium on}, 
year={2013}, 
pages={190-193}, 
ISSN={1945-7928},
month=apr,
url={http://ieeexplore.ieee.org/xpl/articleDetails.jsp?tp=&arnumber=6556444},
address={San Francisco, {CA}, {USA}}
}

Contact & Bug/Feedback Report

Any question/feedback/bug report are well appreciated. You may report them on the Orthanc Users Group.

The full bug/feedback report procedure is available in the procedures/report-bug-or-feedback.md file.

Authentification Proxy Development & Plugin's routes

See the procedures/develop-auth-proxy.md file.

Development

Folder structure

Six folders are available at the root:

  • backend/ contains the C++ plugin source code (& cmake build process).
  • frontend/ contains the HTML/JavaScript source code (& gulp build process).
  • reverse-proxy/ contains a reverse proxy suitable for development.
  • demo/ contains a standalone docker, proxied version of orthanc and the viewer with sample files.
  • scripts/ contains global demo building scripts, it is mostly used by the Continuous Integration System. It also contains scripts to build/run the web viewer demo in a docker environment.
  • tests/ contains the integration tests.

Build

See the procedures/bootstrap-dev-environment.md file.

Development

See the procedures/bootstrap-dev-environment.md file.

Testing

See the procedures/run-tests.md file.

Release procedure

See the procedures/release-version.md file. The procedures/archive-test-reports.md file will be mentionned.

Pulling changes back from orthanc-webviewer-plugin

See the procedures/merge-orthancwebviewer.md file.

About

Osimis Dicom Viewer, forked and tuned

Resources

License

GPL-3.0, AGPL-3.0 licenses found

Licenses found

GPL-3.0
LICENSE
AGPL-3.0
COPYING

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published