Mercurial > hg > orthanc-book

annotate Sphinx/source/plugins/ohif.rst @ 1112:ad26102adccc default tip

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
fix broken link
author Alain Mazy <am@orthanc.team>
date Wed, 23 Oct 2024 16:52:30 +0200
parents f8a335fdeae7
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
952
4a76327e83fb started documentation of ohif plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
1 .. _ohif:
4a76327e83fb started documentation of ohif plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
2
4a76327e83fb started documentation of ohif plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
3
4a76327e83fb started documentation of ohif plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
4 OHIF plugin
4a76327e83fb started documentation of ohif plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
5 ===========
4a76327e83fb started documentation of ohif plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
6
4a76327e83fb started documentation of ohif plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
7 .. contents::
4a76327e83fb started documentation of ohif plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
8
4a76327e83fb started documentation of ohif plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
9 This **official** plugin by the `ICTEAM institute of UCLouvain
1056
89bb195dfbc0 starting stl documentation
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 1055
diff changeset
10 <https://orthanc.uclouvain.be/>`__ extends Orthanc with the `OHIF
89bb195dfbc0 starting stl documentation
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 1055
diff changeset
11 <https://ohif.org/>`__ extensible Web imaging platform.
952
4a76327e83fb started documentation of ohif plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
12
953
2038eb1f55bb finalized ohif documentation
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 952
diff changeset
13 The plugin greatly simplifies the deployment of OHIF, as it does not
965
dfd33c9624d8 HTTPS encryption with OHIF
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 956
diff changeset
14 necessitate the setup of any reverse proxy.
dfd33c9624d8 HTTPS encryption with OHIF
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 956
diff changeset
15
dfd33c9624d8 HTTPS encryption with OHIF
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 956
diff changeset
16 If you face difficulties in using OHIF, please get in touch with the
dfd33c9624d8 HTTPS encryption with OHIF
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 956
diff changeset
17 `OHIF community <https://ohif.org/collaborate>`__ in the first place.
dfd33c9624d8 HTTPS encryption with OHIF
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 956
diff changeset
18 Indeed, the OHIF and Orthanc communities are entirely distinct.
953
2038eb1f55bb finalized ohif documentation
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 952
diff changeset
19
1055
ebe3214f3ab0 added citation instructions
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 1027
diff changeset
20 **For researchers**: `Please cite this paper
ebe3214f3ab0 added citation instructions
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 1027
diff changeset
21 <https://dial.uclouvain.be/pr/boreal/object/boreal:257257>`__.
ebe3214f3ab0 added citation instructions
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 1027
diff changeset
22
952
4a76327e83fb started documentation of ohif plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
23
1066
ccba1d561379 added Orthanc project vs. OHIF project
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 1057
diff changeset
24 .. _orthanc_vs_ohif:
ccba1d561379 added Orthanc project vs. OHIF project
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 1057
diff changeset
25
ccba1d561379 added Orthanc project vs. OHIF project
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 1057
diff changeset
26 Orthanc project vs. OHIF project
ccba1d561379 added Orthanc project vs. OHIF project
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 1057
diff changeset
27 --------------------------------
ccba1d561379 added Orthanc project vs. OHIF project
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 1057
diff changeset
28
ccba1d561379 added Orthanc project vs. OHIF project
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 1057
diff changeset
29 The Orthanc server and the OHIF viewer are **fully separate projects,
ccba1d561379 added Orthanc project vs. OHIF project
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 1057
diff changeset
30 with distinct communities**. The OHIF plugin for Orthanc only aims at
ccba1d561379 added Orthanc project vs. OHIF project
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 1057
diff changeset
31 facilitating the deployment of OHIF through Orthanc.
ccba1d561379 added Orthanc project vs. OHIF project
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 1057
diff changeset
32
ccba1d561379 added Orthanc project vs. OHIF project
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 1057
diff changeset
33 As a consequence, the OHIF plugin for Orthanc **only packages official
ccba1d561379 added Orthanc project vs. OHIF project
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 1057
diff changeset
34 releases of OHIF**.
ccba1d561379 added Orthanc project vs. OHIF project
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 1057
diff changeset
35
ccba1d561379 added Orthanc project vs. OHIF project
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 1057
diff changeset
36 Furthermore, any question or issue that is related to OHIF must be
ccba1d561379 added Orthanc project vs. OHIF project
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 1057
diff changeset
37 directly `asked to the OHIF community
ccba1d561379 added Orthanc project vs. OHIF project
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 1057
diff changeset
38 <https://github.com/OHIF/Viewers/issues>`__, *not* to the Orthanc
ccba1d561379 added Orthanc project vs. OHIF project
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 1057
diff changeset
39 discussion group.
ccba1d561379 added Orthanc project vs. OHIF project
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 1057
diff changeset
40
ccba1d561379 added Orthanc project vs. OHIF project
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 1057
diff changeset
41
952
4a76327e83fb started documentation of ohif plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
42 Usage
4a76327e83fb started documentation of ohif plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
43 -----
4a76327e83fb started documentation of ohif plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
44
4a76327e83fb started documentation of ohif plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
45 This plugin adds a dedicated button to Orthanc Explorer, which
4a76327e83fb started documentation of ohif plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
46 provides an easy, fast access to the OHIF viewers (click on the image
4a76327e83fb started documentation of ohif plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
47 to view a demo video):
4a76327e83fb started documentation of ohif plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
48
4a76327e83fb started documentation of ohif plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
49 .. image:: ../images/OHIF.png
4a76327e83fb started documentation of ohif plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
50 :align: center
4a76327e83fb started documentation of ohif plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
51 :width: 800
4a76327e83fb started documentation of ohif plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
52 :target: https://www.youtube.com/watch?v=-lzddzq9iT4
967
2df3597eacc8 documentation of IIIF support
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 965
diff changeset
53
2df3597eacc8 documentation of IIIF support
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 965
diff changeset
54 |
952
4a76327e83fb started documentation of ohif plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
55
4a76327e83fb started documentation of ohif plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
56
4a76327e83fb started documentation of ohif plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
57 Compilation
4a76327e83fb started documentation of ohif plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
58 -----------
4a76327e83fb started documentation of ohif plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
59
4a76327e83fb started documentation of ohif plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
60 .. highlight:: bash
4a76327e83fb started documentation of ohif plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
61
4a76327e83fb started documentation of ohif plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
62 Official releases can be `downloaded from the Orthanc homepage
993
05b106383b2a migration to UCLouvain servers
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 991
diff changeset
63 <https://orthanc.uclouvain.be/downloads/sources/orthanc-ohif/index.html>`__. As
952
4a76327e83fb started documentation of ohif plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
64 an alternative, the `repository containing the source code
4a76327e83fb started documentation of ohif plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
65 <https://orthanc.uclouvain.be/hg/orthanc-ohif/>`__ can be accessed
4a76327e83fb started documentation of ohif plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
66 using Mercurial.
4a76327e83fb started documentation of ohif plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
67
4a76327e83fb started documentation of ohif plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
68 The procedure to compile this plugin is similar of that for the
4a76327e83fb started documentation of ohif plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
69 :ref:`core of Orthanc <binaries>`. The following commands should work
4a76327e83fb started documentation of ohif plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
70 on most GNU/Linux distributions, provided Docker is installed::
4a76327e83fb started documentation of ohif plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
71
4a76327e83fb started documentation of ohif plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
72 $ mkdir Build
4a76327e83fb started documentation of ohif plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
73 $ cd Build
4a76327e83fb started documentation of ohif plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
74 $ ../Resources/CreateOHIFDist.sh
4a76327e83fb started documentation of ohif plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
75 $ cmake .. -DSTATIC_BUILD=ON -DCMAKE_BUILD_TYPE=Release
4a76327e83fb started documentation of ohif plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
76 $ make
4a76327e83fb started documentation of ohif plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
77
4a76327e83fb started documentation of ohif plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
78 The compilation will produce a shared library ``libOrthancOHIF.so``
4a76327e83fb started documentation of ohif plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
79 that contains the OHIF plugin for Orthanc.
4a76327e83fb started documentation of ohif plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
80
4a76327e83fb started documentation of ohif plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
81 Pre-compiled Linux Standard Base (LSB) binaries `are available for
993
05b106383b2a migration to UCLouvain servers
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 991
diff changeset
82 download <https://orthanc.uclouvain.be/downloads/linux-standard-base/orthanc-ohif/index.html>`__.
952
4a76327e83fb started documentation of ohif plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
83
993
05b106383b2a migration to UCLouvain servers
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 991
diff changeset
84 Pre-compiled binaries for `Microsoft Windows <https://orthanc.uclouvain.be/downloads/windows-32/orthanc-ohif/index.html>`__
1057
5a3c238575f8 documentation of stl
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 1056
diff changeset
85 and `macOS <https://orthanc.uclouvain.be/downloads/macos/orthanc-ohif/index.html>`__ are available as well.
952
4a76327e83fb started documentation of ohif plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
86
4a76327e83fb started documentation of ohif plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
87 Furthermore, the :ref:`Docker images <docker>`
1027
60b0b7ea409b migration to orthancteam
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 993
diff changeset
88 ``jodogne/orthanc-plugins`` and ``orthancteam/orthanc`` also contain the
952
4a76327e83fb started documentation of ohif plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
89 plugin. Debian and Ubuntu packages can be found in the
4a76327e83fb started documentation of ohif plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
90 :ref:`standalone repository <binaries>`
4a76327e83fb started documentation of ohif plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
91 ``https://debian.orthanc-labs.com/``.
4a76327e83fb started documentation of ohif plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
92
4a76327e83fb started documentation of ohif plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
93
4a76327e83fb started documentation of ohif plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
94 Configuration
4a76327e83fb started documentation of ohif plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
95 -------------
4a76327e83fb started documentation of ohif plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
96
4a76327e83fb started documentation of ohif plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
97 .. highlight:: json
4a76327e83fb started documentation of ohif plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
98
4a76327e83fb started documentation of ohif plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
99 Here is a minimal sample :ref:`configuration file <configuration>` to
4a76327e83fb started documentation of ohif plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
100 use this plugin::
4a76327e83fb started documentation of ohif plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
101
4a76327e83fb started documentation of ohif plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
102 {
4a76327e83fb started documentation of ohif plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
103 "Plugins" : [
956
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 955
diff changeset
104 "/home/user/orthanc-ohif/Build/libOrthancOHIF.so"
952
4a76327e83fb started documentation of ohif plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
105 ]
4a76327e83fb started documentation of ohif plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
106 }
4a76327e83fb started documentation of ohif plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
107
4a76327e83fb started documentation of ohif plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
108 Orthanc must of course be restarted after the modification of its
4a76327e83fb started documentation of ohif plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
109 configuration file.
4a76327e83fb started documentation of ohif plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
110
4a76327e83fb started documentation of ohif plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
111
4a76327e83fb started documentation of ohif plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
112 Using DICOMweb
4a76327e83fb started documentation of ohif plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
113 ^^^^^^^^^^^^^^
4a76327e83fb started documentation of ohif plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
114
953
2038eb1f55bb finalized ohif documentation
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 952
diff changeset
115 .. highlight:: json
2038eb1f55bb finalized ohif documentation
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 952
diff changeset
116
952
4a76327e83fb started documentation of ohif plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
117 By default, the plugin uses the `DICOM JSON data source
4a76327e83fb started documentation of ohif plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
118 <https://v3-docs.ohif.org/configuration/datasources/dicom-json/>`__ of
4a76327e83fb started documentation of ohif plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
119 OHIF. This data source is optimized to provide the fastest access to
4a76327e83fb started documentation of ohif plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
120 the DICOM images, while requiring no additional plugin. However, in
4a76327e83fb started documentation of ohif plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
121 order to deliver fast access, the OHIF plugin will cache additional
953
2038eb1f55bb finalized ohif documentation
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 952
diff changeset
122 information about each DICOM instance as :ref:`metadata <metadata>` in
2038eb1f55bb finalized ohif documentation
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 952
diff changeset
123 the Orthanc database, which results in a larger size of the Orthanc
2038eb1f55bb finalized ohif documentation
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 952
diff changeset
124 database (an additional 1KB is roughly needed per instance).
952
4a76327e83fb started documentation of ohif plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
125
953
2038eb1f55bb finalized ohif documentation
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 952
diff changeset
126 As an alternative, it is possible to enable the `DICOMweb data source
952
4a76327e83fb started documentation of ohif plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
127 <https://v3-docs.ohif.org/configuration/dataSources/dicom-web>`__. In
4a76327e83fb started documentation of ohif plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
128 this case, the :ref:`DICOMweb plugin of Orthanc <dicomweb>` must also
4a76327e83fb started documentation of ohif plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
129 be loaded. It can also be useful to load the :ref:`GDCM plugin <gdcm>`
953
2038eb1f55bb finalized ohif documentation
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 952
diff changeset
130 if the DICOM images are encoded using a JPEG2k compressed transfer
2038eb1f55bb finalized ohif documentation
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 952
diff changeset
131 syntax.
952
4a76327e83fb started documentation of ohif plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
132
4a76327e83fb started documentation of ohif plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
133 The advantages of using DICOMweb over the default DICOM JSON are:
4a76327e83fb started documentation of ohif plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
134
4a76327e83fb started documentation of ohif plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
135 * More standard-compliant.
4a76327e83fb started documentation of ohif plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
136
1104
f8a335fdeae7 ohif ref to known issue
Alain Mazy <am@orthanc.team>
parents: 1066
diff changeset
137 * More robust (e.g. `this issue <https://github.com/OHIF/Viewers/issues/4271#issuecomment-2242873446>`__ only happens with the ``json`` data source)
f8a335fdeae7 ohif ref to known issue
Alain Mazy <am@orthanc.team>
parents: 1066
diff changeset
138
952
4a76327e83fb started documentation of ohif plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
139 * The OHIF study list is accessible, notably as a button on the
953
2038eb1f55bb finalized ohif documentation
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 952
diff changeset
140 welcome screen of Orthanc Explorer. The study list is not available
2038eb1f55bb finalized ohif documentation
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 952
diff changeset
141 if using the DICOM JSON data source.
952
4a76327e83fb started documentation of ohif plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
142
4a76327e83fb started documentation of ohif plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
143 * No additional space is used in the Orthanc database.
1104
f8a335fdeae7 ohif ref to known issue
Alain Mazy <am@orthanc.team>
parents: 1066
diff changeset
144
952
4a76327e83fb started documentation of ohif plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
145
4a76327e83fb started documentation of ohif plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
146 Here is a minimal configuration file to use DICOMweb::
4a76327e83fb started documentation of ohif plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
147
4a76327e83fb started documentation of ohif plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
148 {
4a76327e83fb started documentation of ohif plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
149 "Plugins" : [
956
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 955
diff changeset
150 "/home/user/orthanc-ohif/Build/libOrthancOHIF.so",
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 955
diff changeset
151 "/home/user/orthanc-dicomweb/Build/libOrthancDicomWeb.so"
952
4a76327e83fb started documentation of ohif plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
152 ],
4a76327e83fb started documentation of ohif plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
153 "OHIF" : {
4a76327e83fb started documentation of ohif plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
154 "DataSource" : "dicom-web"
4a76327e83fb started documentation of ohif plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
155 }
4a76327e83fb started documentation of ohif plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
156 }
4a76327e83fb started documentation of ohif plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
157
4a76327e83fb started documentation of ohif plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
158
954
19fd9eab4ec0 user configuration of OHIF
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 953
diff changeset
159 User configuration of OHIF
19fd9eab4ec0 user configuration of OHIF
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 953
diff changeset
160 ^^^^^^^^^^^^^^^^^^^^^^^^^^
19fd9eab4ec0 user configuration of OHIF
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 953
diff changeset
161
19fd9eab4ec0 user configuration of OHIF
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 953
diff changeset
162 .. highlight:: json
19fd9eab4ec0 user configuration of OHIF
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 953
diff changeset
163
19fd9eab4ec0 user configuration of OHIF
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 953
diff changeset
164 OHIF comes with a number of `configuration options
19fd9eab4ec0 user configuration of OHIF
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 953
diff changeset
165 <https://v3-docs.ohif.org/configuration/configurationfiles/#configuration-options>`__
19fd9eab4ec0 user configuration of OHIF
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 953
diff changeset
166 that can be fine-tuned by the user. User settings can be injected
19fd9eab4ec0 user configuration of OHIF
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 953
diff changeset
167 using the ``UserConfiguration`` option as follows::
19fd9eab4ec0 user configuration of OHIF
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 953
diff changeset
168
19fd9eab4ec0 user configuration of OHIF
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 953
diff changeset
169 {
19fd9eab4ec0 user configuration of OHIF
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 953
diff changeset
170 "Plugins" : [
956
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 955
diff changeset
171 "/home/user/orthanc-ohif/Build/libOrthancOHIF.so"
954
19fd9eab4ec0 user configuration of OHIF
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 953
diff changeset
172 ],
19fd9eab4ec0 user configuration of OHIF
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 953
diff changeset
173 "OHIF" : {
955
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 954
diff changeset
174 "UserConfiguration" : "ohif.js"
954
19fd9eab4ec0 user configuration of OHIF
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 953
diff changeset
175 }
19fd9eab4ec0 user configuration of OHIF
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 953
diff changeset
176 }
19fd9eab4ec0 user configuration of OHIF
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 953
diff changeset
177
19fd9eab4ec0 user configuration of OHIF
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 953
diff changeset
178 .. highlight:: javascript
19fd9eab4ec0 user configuration of OHIF
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 953
diff changeset
179
955
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 954
diff changeset
180 A minimal ``ohif.js`` would be::
954
19fd9eab4ec0 user configuration of OHIF
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 953
diff changeset
181
19fd9eab4ec0 user configuration of OHIF
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 953
diff changeset
182 window.config = {
19fd9eab4ec0 user configuration of OHIF
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 953
diff changeset
183 extensions: [],
19fd9eab4ec0 user configuration of OHIF
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 953
diff changeset
184 modes: []
19fd9eab4ec0 user configuration of OHIF
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 953
diff changeset
185 }
19fd9eab4ec0 user configuration of OHIF
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 953
diff changeset
186
19fd9eab4ec0 user configuration of OHIF
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 953
diff changeset
187 Note that the following configuration options will be overridden by
19fd9eab4ec0 user configuration of OHIF
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 953
diff changeset
188 the OHIF plugin to properly configure the data source and the
19fd9eab4ec0 user configuration of OHIF
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 953
diff changeset
189 integration with the Orthanc Web server:
19fd9eab4ec0 user configuration of OHIF
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 953
diff changeset
190
19fd9eab4ec0 user configuration of OHIF
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 953
diff changeset
191 * ``window.config.dataSources``
19fd9eab4ec0 user configuration of OHIF
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 953
diff changeset
192 * ``window.config.defaultDataSourceName``
19fd9eab4ec0 user configuration of OHIF
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 953
diff changeset
193 * ``window.config.routerBasename``
19fd9eab4ec0 user configuration of OHIF
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 953
diff changeset
194 * ``window.config.showStudyList`` (set to ``false`` if using the DICOM
19fd9eab4ec0 user configuration of OHIF
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 953
diff changeset
195 JSON data source)
19fd9eab4ec0 user configuration of OHIF
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 953
diff changeset
196
19fd9eab4ec0 user configuration of OHIF
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 953
diff changeset
197
965
dfd33c9624d8 HTTPS encryption with OHIF
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 956
diff changeset
198 .. _ohif-router-basename:
dfd33c9624d8 HTTPS encryption with OHIF
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 956
diff changeset
199
952
4a76327e83fb started documentation of ohif plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
200 Router basename
4a76327e83fb started documentation of ohif plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
201 ^^^^^^^^^^^^^^^
4a76327e83fb started documentation of ohif plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
202
953
2038eb1f55bb finalized ohif documentation
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 952
diff changeset
203 .. highlight:: json
2038eb1f55bb finalized ohif documentation
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 952
diff changeset
204
952
4a76327e83fb started documentation of ohif plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
205 If Orthanc is not branched at the root of a Web server thanks of the
4a76327e83fb started documentation of ohif plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
206 presence of a reverse proxy, the configuration option
4a76327e83fb started documentation of ohif plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
207 ``RouterBasename`` must be adapted.
4a76327e83fb started documentation of ohif plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
208
4a76327e83fb started documentation of ohif plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
209 For instance, if Orthanc is running at address
4a76327e83fb started documentation of ohif plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
210 ``https://host.com/imaging/demo/orthanc/``, the following
4a76327e83fb started documentation of ohif plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
211 configuration file must be used for OHIF to work::
4a76327e83fb started documentation of ohif plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
212
4a76327e83fb started documentation of ohif plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
213 {
4a76327e83fb started documentation of ohif plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
214 "Plugins" : [
956
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 955
diff changeset
215 "/home/user/orthanc-ohif/Build/libOrthancOHIF.so"
952
4a76327e83fb started documentation of ohif plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
216 ],
4a76327e83fb started documentation of ohif plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
217 "OHIF" : {
4a76327e83fb started documentation of ohif plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
218 "RouterBasename" : "/imaging/demo/orthanc/ohif/"
4a76327e83fb started documentation of ohif plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
219 }
4a76327e83fb started documentation of ohif plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
220 }
4a76327e83fb started documentation of ohif plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
221
4a76327e83fb started documentation of ohif plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
222 The default value of ``RouterBasename`` is ``/ohif/``.
4a76327e83fb started documentation of ohif plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
223
4a76327e83fb started documentation of ohif plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
224
953
2038eb1f55bb finalized ohif documentation
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 952
diff changeset
225 .. _ohif-preloading:
2038eb1f55bb finalized ohif documentation
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 952
diff changeset
226
952
4a76327e83fb started documentation of ohif plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
227 Preloading
4a76327e83fb started documentation of ohif plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
228 ^^^^^^^^^^
4a76327e83fb started documentation of ohif plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
229
953
2038eb1f55bb finalized ohif documentation
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 952
diff changeset
230 .. highlight:: json
2038eb1f55bb finalized ohif documentation
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 952
diff changeset
231
2038eb1f55bb finalized ohif documentation
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 952
diff changeset
232 If using the DICOM JSON data source, whenever a new DICOM instance is
2038eb1f55bb finalized ohif documentation
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 952
diff changeset
233 received by Orthanc, the OHIF plugin will compute a summary of the
2038eb1f55bb finalized ohif documentation
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 952
diff changeset
234 DICOM tags of interest to OHIF, and will store it as :ref:`metadata
2038eb1f55bb finalized ohif documentation
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 952
diff changeset
235 <metadata>` in the Orthanc database. This process has the advantage of
2038eb1f55bb finalized ohif documentation
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 952
diff changeset
236 speeding up even the first opening of the DICOM study by OHIF, which
2038eb1f55bb finalized ohif documentation
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 952
diff changeset
237 probably corresponds to the expectations of most radiologists.
2038eb1f55bb finalized ohif documentation
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 952
diff changeset
238
2038eb1f55bb finalized ohif documentation
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 952
diff changeset
239 However, if your Orthanc deployment is focused on speed, this
2038eb1f55bb finalized ohif documentation
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 952
diff changeset
240 preloading might be undesirable, as it slows down the ingestion of new
2038eb1f55bb finalized ohif documentation
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 952
diff changeset
241 DICOM instances by Orthanc. Furthermore, if your Orthanc server will
2038eb1f55bb finalized ohif documentation
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 952
diff changeset
242 contain a large number of DICOM studies that will never be displayed
2038eb1f55bb finalized ohif documentation
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 952
diff changeset
243 using OHIF, this can result in a waste of space in the Orthanc
2038eb1f55bb finalized ohif documentation
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 952
diff changeset
244 database because of the metadata that will be preloaded, but that will
2038eb1f55bb finalized ohif documentation
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 952
diff changeset
245 never be read.
2038eb1f55bb finalized ohif documentation
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 952
diff changeset
246
2038eb1f55bb finalized ohif documentation
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 952
diff changeset
247 It is consequently possible to turn off the automated preloading
2038eb1f55bb finalized ohif documentation
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 952
diff changeset
248 of metadata using the following configuration::
2038eb1f55bb finalized ohif documentation
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 952
diff changeset
249
2038eb1f55bb finalized ohif documentation
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 952
diff changeset
250 {
2038eb1f55bb finalized ohif documentation
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 952
diff changeset
251 "Plugins" : [
956
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 955
diff changeset
252 "/home/user/orthanc-ohif/Build/libOrthancOHIF.so"
953
2038eb1f55bb finalized ohif documentation
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 952
diff changeset
253 ],
2038eb1f55bb finalized ohif documentation
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 952
diff changeset
254 "OHIF" : {
2038eb1f55bb finalized ohif documentation
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 952
diff changeset
255 "DataSource" : "dicom-json",
2038eb1f55bb finalized ohif documentation
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 952
diff changeset
256 "Preload" : false
2038eb1f55bb finalized ohif documentation
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 952
diff changeset
257 }
2038eb1f55bb finalized ohif documentation
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 952
diff changeset
258 }
2038eb1f55bb finalized ohif documentation
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 952
diff changeset
259
2038eb1f55bb finalized ohif documentation
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 952
diff changeset
260 If the ``Preload`` option is set to ``false``, the first display of a
2038eb1f55bb finalized ohif documentation
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 952
diff changeset
261 DICOM study can take several seconds because of the computation of the
2038eb1f55bb finalized ohif documentation
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 952
diff changeset
262 metadata, but subsequent displays will run much faster.
2038eb1f55bb finalized ohif documentation
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 952
diff changeset
263
2038eb1f55bb finalized ohif documentation
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 952
diff changeset
264 Note that preloading is only applied to the newly received instances:
2038eb1f55bb finalized ohif documentation
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 952
diff changeset
265 The DICOM instances that were stored in the Orthanc server before the
2038eb1f55bb finalized ohif documentation
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 952
diff changeset
266 installation of the OHIF plugin will only benefit from the
2038eb1f55bb finalized ohif documentation
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 952
diff changeset
267 optimization starting with their second display using OHIF.
2038eb1f55bb finalized ohif documentation
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 952
diff changeset
268
2038eb1f55bb finalized ohif documentation
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 952
diff changeset
269
965
dfd33c9624d8 HTTPS encryption with OHIF
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 956
diff changeset
270 .. _ohif-https:
dfd33c9624d8 HTTPS encryption with OHIF
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 956
diff changeset
271
dfd33c9624d8 HTTPS encryption with OHIF
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 956
diff changeset
272 HTTPS encryption
dfd33c9624d8 HTTPS encryption with OHIF
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 956
diff changeset
273 ^^^^^^^^^^^^^^^^
dfd33c9624d8 HTTPS encryption with OHIF
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 956
diff changeset
274
dfd33c9624d8 HTTPS encryption with OHIF
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 956
diff changeset
275 .. highlight:: bash
dfd33c9624d8 HTTPS encryption with OHIF
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 956
diff changeset
276
dfd33c9624d8 HTTPS encryption with OHIF
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 956
diff changeset
277 In order to use the :ref:`built-in HTTPS encryption <https-builtin>`
dfd33c9624d8 HTTPS encryption with OHIF
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 956
diff changeset
278 of Orthanc together with the OHIF plugin, first generate a proper
dfd33c9624d8 HTTPS encryption with OHIF
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 956
diff changeset
279 X.509 certificate for the ``localhost``::
dfd33c9624d8 HTTPS encryption with OHIF
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 956
diff changeset
280
dfd33c9624d8 HTTPS encryption with OHIF
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 956
diff changeset
281 $ openssl req -x509 -nodes -days 365 -newkey rsa:2048 \
dfd33c9624d8 HTTPS encryption with OHIF
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 956
diff changeset
282 -subj "/C=BE/CN=localhost" -keyout /tmp/private.key -out /tmp/certificate.crt
dfd33c9624d8 HTTPS encryption with OHIF
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 956
diff changeset
283 $ cat /tmp/private.key /tmp/certificate.crt > /tmp/certificate.pem
dfd33c9624d8 HTTPS encryption with OHIF
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 956
diff changeset
284
dfd33c9624d8 HTTPS encryption with OHIF
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 956
diff changeset
285
dfd33c9624d8 HTTPS encryption with OHIF
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 956
diff changeset
286 .. highlight:: json
dfd33c9624d8 HTTPS encryption with OHIF
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 956
diff changeset
287
dfd33c9624d8 HTTPS encryption with OHIF
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 956
diff changeset
288 Secondly, create the following configuration file::
dfd33c9624d8 HTTPS encryption with OHIF
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 956
diff changeset
289
dfd33c9624d8 HTTPS encryption with OHIF
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 956
diff changeset
290 {
dfd33c9624d8 HTTPS encryption with OHIF
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 956
diff changeset
291 "Plugins" : [
dfd33c9624d8 HTTPS encryption with OHIF
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 956
diff changeset
292 "/home/user/orthanc-ohif/Build/libOrthancOHIF.so"
dfd33c9624d8 HTTPS encryption with OHIF
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 956
diff changeset
293 ],
dfd33c9624d8 HTTPS encryption with OHIF
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 956
diff changeset
294 "SslEnabled" : true,
dfd33c9624d8 HTTPS encryption with OHIF
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 956
diff changeset
295 "SslCertificate" : "/tmp/certificate.pem",
dfd33c9624d8 HTTPS encryption with OHIF
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 956
diff changeset
296 "OHIF" : {
dfd33c9624d8 HTTPS encryption with OHIF
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 956
diff changeset
297 "DataSource" : "dicom-json",
dfd33c9624d8 HTTPS encryption with OHIF
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 956
diff changeset
298 "RouterBasename" : "/ohif/"
dfd33c9624d8 HTTPS encryption with OHIF
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 956
diff changeset
299 }
dfd33c9624d8 HTTPS encryption with OHIF
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 956
diff changeset
300 }
dfd33c9624d8 HTTPS encryption with OHIF
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 956
diff changeset
301
dfd33c9624d8 HTTPS encryption with OHIF
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 956
diff changeset
302 If more complex scenarios with reverse proxies are involved, make sure
dfd33c9624d8 HTTPS encryption with OHIF
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 956
diff changeset
303 to properly setup :ref:`CORS in your reverse proxy <nginx-cors>` and
dfd33c9624d8 HTTPS encryption with OHIF
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 956
diff changeset
304 to :ref:`adapt the router basename <ohif-router-basename>`. If you
dfd33c9624d8 HTTPS encryption with OHIF
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 956
diff changeset
305 face difficulties, while the simple setup with the built-in HTTPS
dfd33c9624d8 HTTPS encryption with OHIF
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 956
diff changeset
306 encryption described above works, your issue is related to OHIF, so
dfd33c9624d8 HTTPS encryption with OHIF
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 956
diff changeset
307 please get in touch with the `OHIF community
dfd33c9624d8 HTTPS encryption with OHIF
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 956
diff changeset
308 <https://ohif.org/collaborate>`__.
dfd33c9624d8 HTTPS encryption with OHIF
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 956
diff changeset
309
dfd33c9624d8 HTTPS encryption with OHIF
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 956
diff changeset
310
953
2038eb1f55bb finalized ohif documentation
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 952
diff changeset
311 For developers
2038eb1f55bb finalized ohif documentation
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 952
diff changeset
312 --------------
2038eb1f55bb finalized ohif documentation
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 952
diff changeset
313
2038eb1f55bb finalized ohif documentation
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 952
diff changeset
314 Extensions to the REST API
2038eb1f55bb finalized ohif documentation
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 952
diff changeset
315 ^^^^^^^^^^^^^^^^^^^^^^^^^^
2038eb1f55bb finalized ohif documentation
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 952
diff changeset
316
2038eb1f55bb finalized ohif documentation
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 952
diff changeset
317 .. highlight:: bash
2038eb1f55bb finalized ohif documentation
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 952
diff changeset
318
2038eb1f55bb finalized ohif documentation
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 952
diff changeset
319 The content of the `DICOM JSON data source
2038eb1f55bb finalized ohif documentation
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 952
diff changeset
320 <https://v3-docs.ohif.org/configuration/datasources/dicom-json/>`__
2038eb1f55bb finalized ohif documentation
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 952
diff changeset
321 for a DICOM study of interest can be retrieved as follows::
2038eb1f55bb finalized ohif documentation
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 952
diff changeset
322
991
1316bc62b5d5 migration to UCLouvain servers
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 967
diff changeset
323 $ curl https://orthanc.uclouvain.be/demo/studies/6b9e19d9-62094390-5f9ddb01-4a191ae7-9766b715/ohif-dicom-json
953
2038eb1f55bb finalized ohif documentation
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 952
diff changeset
324
2038eb1f55bb finalized ohif documentation
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 952
diff changeset
325 This data source is constructed from the :ref:`metadata 4202
2038eb1f55bb finalized ohif documentation
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 952
diff changeset
326 <registry>` associated with the individual DICOM instances of the
2038eb1f55bb finalized ohif documentation
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 952
diff changeset
327 DICOM study. The metadata corresponds to the `Base64 encoding
2038eb1f55bb finalized ohif documentation
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 952
diff changeset
328 <https://en.wikipedia.org/wiki/Base64>`__ of a gzipped JSON file. For
2038eb1f55bb finalized ohif documentation
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 952
diff changeset
329 debugging, the JSON file associated with a DICOM instance can be
2038eb1f55bb finalized ohif documentation
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 952
diff changeset
330 inspected using::
2038eb1f55bb finalized ohif documentation
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 952
diff changeset
331
991
1316bc62b5d5 migration to UCLouvain servers
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 967
diff changeset
332 $ curl https://orthanc.uclouvain.be/demo/instances/1f3c00bd-49df10b7-f416a598-1b3bb5a2-cb791b52/metadata/4202 | base64 -d | gunzip -c
953
2038eb1f55bb finalized ohif documentation
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 952
diff changeset
333
2038eb1f55bb finalized ohif documentation
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 952
diff changeset
334
2038eb1f55bb finalized ohif documentation
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 952
diff changeset
335 Preloading existing studies
2038eb1f55bb finalized ohif documentation
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 952
diff changeset
336 ^^^^^^^^^^^^^^^^^^^^^^^^^^^
2038eb1f55bb finalized ohif documentation
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 952
diff changeset
337
2038eb1f55bb finalized ohif documentation
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 952
diff changeset
338 :ref:`As explained above <ohif-preloading>`, the metadata associated
2038eb1f55bb finalized ohif documentation
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 952
diff changeset
339 with DICOM instances are only preloaded for the newly ingested DICOM
2038eb1f55bb finalized ohif documentation
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 952
diff changeset
340 instances. Using the REST API of Orthanc, it is easy to create a
2038eb1f55bb finalized ohif documentation
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 952
diff changeset
341 script that would preload the metadata for the already existing DICOM
2038eb1f55bb finalized ohif documentation
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 952
diff changeset
342 studies, hereby greatly speeding up the first opening of those studies
2038eb1f55bb finalized ohif documentation
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 952
diff changeset
343 as well.
2038eb1f55bb finalized ohif documentation
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 952
diff changeset
344
954
19fd9eab4ec0 user configuration of OHIF
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 953
diff changeset
345 This script would loop over the :ref:`the DICOM studies that are
19fd9eab4ec0 user configuration of OHIF
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 953
diff changeset
346 stored by Orthanc <rest-access>` using ``GET /studies``. For each
19fd9eab4ec0 user configuration of OHIF
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 953
diff changeset
347 study whose :ref:`Orthanc identifier <orthanc-ids>` is ``id``, the
19fd9eab4ec0 user configuration of OHIF
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 953
diff changeset
348 script would simply call ``GET /studies/{id}/ohif-dicom-json``.
953
2038eb1f55bb finalized ohif documentation
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 952
diff changeset
349