Mercurial > hg > orthanc-book

annotate Sphinx/source/plugins.rst @ 431:442632721660

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
fix
author Sebastien Jodogne <s.jodogne@gmail.com>
date Sat, 23 May 2020 12:51:32 +0200
parents 83f36bc9e725
children 938206110483
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
24
25fa874803ab plugins inside book
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
1 .. _plugins:
25fa874803ab plugins inside book
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
2
25fa874803ab plugins inside book
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
3 Plugins
25fa874803ab plugins inside book
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
4 =======
25fa874803ab plugins inside book
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
5
25
669ea65ba7fb fix links
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 24
diff changeset
6 .. contents::
669ea65ba7fb fix links
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 24
diff changeset
7
669ea65ba7fb fix links
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 24
diff changeset
8 Overview
669ea65ba7fb fix links
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 24
diff changeset
9 --------
669ea65ba7fb fix links
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 24
diff changeset
10
24
25fa874803ab plugins inside book
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
11 The core of Orthanc can be extended through **plugins**. A plugin
25fa874803ab plugins inside book
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
12 takes the form of a shared library (``.DLL`` under Windows, ``.so``
42
a52f1dc48ebc GNU/Linux
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 40
diff changeset
13 under GNU/Linux, ``.dylib`` under Apple OS X...). A plugin can do
a52f1dc48ebc GNU/Linux
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 40
diff changeset
14 various things, among others:
24
25fa874803ab plugins inside book
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
15
25fa874803ab plugins inside book
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
16 * Serving new **Web applications** that have full access to the REST
25fa874803ab plugins inside book
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
17 API of Orthanc, which makes easy to handle DICOM images from
25fa874803ab plugins inside book
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
18 JavaScript code.
25fa874803ab plugins inside book
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
19 * Replacing **the way DICOM images are decoded** (e.g. the official
25fa874803ab plugins inside book
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
20 :ref:`Web viewer plugin <webviewer>` introduces the decoding of
25fa874803ab plugins inside book
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
21 JPEG2000 images, which is not available in the core of Orthanc).
154
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 115
diff changeset
22 * Replacing the default **database back-end** of Orthanc (that is
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 115
diff changeset
23 built upon SQLite) by another (:ref:`PostgreSQL <postgresql>`,
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 115
diff changeset
24 :ref:`MySQL <mysql>`, SQL Server...).
24
25fa874803ab plugins inside book
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
25 * Creating **new REST APIs** on the top of the Orthanc built-in API (as in
25fa874803ab plugins inside book
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
26 in the official :ref:`DICOMweb <dicomweb>` plugin).
25fa874803ab plugins inside book
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
27 * **Reacting** to the arrival of new DICOM images or other
25fa874803ab plugins inside book
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
28 DICOM-related events so as to carry on automated processing.
25
669ea65ba7fb fix links
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 24
diff changeset
29 * ...
669ea65ba7fb fix links
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 24
diff changeset
30
669ea65ba7fb fix links
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 24
diff changeset
31 Developers external to the official Orthanc project are :ref:`invited
38
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 31
diff changeset
32 to contribute <contributing>` to the C/C++ part of Orthanc by creating
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 31
diff changeset
33 third-party plugins. A specific section of the Orthanc Book explains
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 31
diff changeset
34 :ref:`how to create new Orthanc plugins <creating-plugins>`.
24
25fa874803ab plugins inside book
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
35
25fa874803ab plugins inside book
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
36 .. _plugins-official:
25fa874803ab plugins inside book
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
37
25fa874803ab plugins inside book
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
38 Index of the official plugins
25fa874803ab plugins inside book
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
39 -----------------------------
25fa874803ab plugins inside book
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
40
96
750f7ab733c1 start documentation of authorization
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 93
diff changeset
41 From University Hospital of Liège
750f7ab733c1 start documentation of authorization
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 93
diff changeset
42 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
750f7ab733c1 start documentation of authorization
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 93
diff changeset
43
24
25fa874803ab plugins inside book
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
44 .. toctree::
25fa874803ab plugins inside book
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
45 :maxdepth: 1
25fa874803ab plugins inside book
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
46
31
93bbfaf0e62c worklist instructions migrated to a specific page, indexing of Osimis Web viewer
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 25
diff changeset
47 plugins/webviewer.rst
24
25fa874803ab plugins inside book
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
48 plugins/dicomweb.rst
25fa874803ab plugins inside book
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
49 plugins/postgresql.rst
53
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 42
diff changeset
50 plugins/wsi.rst
24
25fa874803ab plugins inside book
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
51 plugins/worklists-plugin.rst
31
93bbfaf0e62c worklist instructions migrated to a specific page, indexing of Osimis Web viewer
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 25
diff changeset
52 plugins/serve-folders.rst
431
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 414
diff changeset
53 plugins/gdcm.rst
24
25fa874803ab plugins inside book
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
54
229
c74f044dc3ce note about docker
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 203
diff changeset
55 .. _plugins-osimis:
c74f044dc3ce note about docker
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 203
diff changeset
56
96
750f7ab733c1 start documentation of authorization
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 93
diff changeset
57 From Osimis
750f7ab733c1 start documentation of authorization
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 93
diff changeset
58 ^^^^^^^^^^^
750f7ab733c1 start documentation of authorization
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 93
diff changeset
59
301
b2baccb32101 page dedicated to the Osimis Web viewer plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 254
diff changeset
60 * :ref:`osimis_webviewer`
154
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 115
diff changeset
61 * :ref:`mysql`
96
750f7ab733c1 start documentation of authorization
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 93
diff changeset
62 * :ref:`authorization`
164
05aa4f426621 transfers
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 163
diff changeset
63 * :ref:`transfers`
254
63cc25161330 skeleton of gcp
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 229
diff changeset
64 * :ref:`google`
341
d1f00afca0fb adding blank page for the Python plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 301
diff changeset
65 * :ref:`python-plugin`
24
25fa874803ab plugins inside book
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
66
25fa874803ab plugins inside book
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
67 .. _plugins-contributed:
25fa874803ab plugins inside book
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
68
25fa874803ab plugins inside book
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
69 Index of the contributed plugins
25fa874803ab plugins inside book
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
70 --------------------------------
25fa874803ab plugins inside book
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
71
163
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 154
diff changeset
72 * `AWS S3 storage plugin
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 154
diff changeset
73 <https://github.com/radpointhq/orthanc-s3-storage>`__: This plugin
358
011b01ccf52d fixing external hyperlinks
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 341
diff changeset
74 by `Radpoint <https://radpoint.pl/>`__ makes Orthanc store its
163
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 154
diff changeset
75 DICOM files into an `Amazon S3 bucket
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 154
diff changeset
76 <https://en.wikipedia.org/wiki/Amazon_S3>`__.
24
25fa874803ab plugins inside book
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
77 * `DWV Orthanc Plugin
25fa874803ab plugins inside book
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
78 <https://github.com/ivmartel/dwv-orthanc-plugin>`__: This plugin by
25fa874803ab plugins inside book
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
79 Yves Martelli is based on `dwv
25fa874803ab plugins inside book
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
80 <https://github.com/ivmartel/dwv/wiki>`__ and extends Orthanc with a
25fa874803ab plugins inside book
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
81 Web viewer of DICOM images.
25fa874803ab plugins inside book
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
82 * Another Web viewer is provided courtesy of `Emsy Chan
25
669ea65ba7fb fix links
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 24
diff changeset
83 <https://groups.google.com/d/msg/orthanc-users/EC5Z2KaM4Hs/MG3KkzhCDAAJ>`__.
358
011b01ccf52d fixing external hyperlinks
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 341
diff changeset
84 * `VPI Reveal <https://www.vpireveal.com/>`__ provides a plugin to
71
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 70
diff changeset
85 "write the DICOM records in a normal Windows-readable file hierarchy
70
bcd9e83dac7a index VPI Reveal
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 53
diff changeset
86 (patient-study-series-DICOM file) at a location called
bcd9e83dac7a index VPI Reveal
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 53
diff changeset
87 ``VPIStorage`` that can then be imported into VPI Reveal." `Check
71
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 70
diff changeset
88 out their source code
70
bcd9e83dac7a index VPI Reveal
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 53
diff changeset
89 <https://github.com/jodogne/OrthancContributed/tree/master/Plugins/orthancVPIRevealPlugin>`__.
93
a1e55e1baf38 mongodb
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 71
diff changeset
90 * `Doc Cirrus <https://www.doc-cirrus.com/>`__ is working on `MongoDB
115
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 96
diff changeset
91 <https://en.wikipedia.org/wiki/MongoDB>`__ database plugins. Check
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 96
diff changeset
92 out their `source code
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 96
diff changeset
93 <https://github.com/Doc-Cirrus/orthanc-mongodb>`__ and the
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 96
diff changeset
94 `associated description
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 96
diff changeset
95 <https://github.com/jodogne/OrthancContributed/tree/master/Plugins/orthanc-mongodb>`__.
40
99b45a963bcf contributing
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 38
diff changeset
96 * Check out the `OrthancContributed repository on GitHub
99b45a963bcf contributing
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 38
diff changeset
97 <https://github.com/jodogne/OrthancContributed/tree/master/Plugins>`__, that
99b45a963bcf contributing
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 38
diff changeset
98 might contain plugins that are not tracked in this list.
24
25fa874803ab plugins inside book
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
99
38
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 31
diff changeset
100 *Remark:* Do not hesitate to `contact us
358
011b01ccf52d fixing external hyperlinks
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 341
diff changeset
101 <https://www.orthanc-server.com/static.php?page=contact>`__ if you have
203
b79ef7808f16 note about plugins
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 164
diff changeset
102 developed a plugin so that we can promote it in the list above!