Mercurial > hg > orthanc-book
annotate Sphinx/source/plugins/orthanc-explorer-2.rst @ 996:d43d74afdfad
logs-no-thread
| author | Alain Mazy <am@osimis.io> |
|---|---|
| date | Wed, 06 Dec 2023 16:31:42 +0100 |
| parents | df9162e80fc8 |
| children | 5d4701d8fe28 |
| rev | line source |
|---|---|
| 845 | 1 .. _orthanc-explorer-2: |
| 2 | |
| 3 | |
| 4 Orthanc Explorer 2 plugin | |
| 5 ========================= | |
| 6 | |
| 7 .. contents:: | |
| 8 | |
| 9 | |
| 10 Introduction | |
| 11 ------------ | |
| 12 | |
| 13 This plugin provides a new User Interface (UI) to Orthanc. It aims at being | |
| 14 more user-friendly, more configurable and more evolutive than the default | |
| 15 Orthanc UI which was developed mainly for testing/administrative purpose. | |
| 16 | |
| 17 .. image:: ../images/OE2-screenshot-study-list.png | |
| 18 :align: center | |
| 19 :width: 1000px | |
| 20 | |
| 21 | | |
| 22 | |
| 23 Note that a major difference between the legacy UI and Orthanc Explorer 2 (OE2) | |
| 24 is that OE2 works only at the study level, not the patient level. The main page is | |
| 25 the study list in which, of course, you can apply a filter to display only the studies of a single patient. | |
| 26 | |
| 924 | 27 Since version 0.7.0, once connected to `Keycloak <https://www.keycloak.org/>`__ and the `orthanc-auth-service <https://github.com/orthanc-team/orthanc-auth-service>`__, |
| 28 OE2 is able to handle user permissions and sharing of links to access a single study. This is demonstrated in `this sample <https://github.com/orthanc-team/orthanc-auth-service/tree/main/minimal-setup/keycloak>`__. | |
| 845 | 29 |
| 30 How to get it ? | |
| 31 --------------- | |
| 32 | |
| 33 The source code is available on `GitHub <https://github.com/orthanc-server/orthanc-explorer-2>`__. | |
| 34 | |
| 35 Binaries are included in: | |
| 36 | |
| 37 - The `osimis/orthanc Docker image <https://hub.docker.com/r/osimis/orthanc>`__ | |
|
994
df9162e80fc8
Osimis has discontinued the sample demo server for the Osimis Web viewer
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
924
diff
changeset
|
38 - The `Windows Installer <https://orthanc.uclouvain.be/downloads/windows-64/installers/index.html>`__ |
|
df9162e80fc8
Osimis has discontinued the sample demo server for the Osimis Web viewer
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
924
diff
changeset
|
39 - The `macOS packages <https://orthanc.uclouvain.be/downloads/macos/packages/index.html>`__ |
| 845 | 40 |
| 41 Release notes are available `here <https://github.com/orthanc-server/orthanc-explorer-2/blob/master/release-notes.md>`__. | |
| 42 | |
| 43 Depending on the configuration, the plugin can replace the default Orthanc UI you are redirected to when accessing orthanc at `http://localhost:8042/ <http://localhost:8042/>`__. | |
| 44 In any case, the new and old UI can coexist: | |
| 45 | |
| 46 - Orthanc Explorer 2 is available at `http://localhost:8042/ui/app/ <http://localhost:8042/ui/app/>`__ | |
| 47 - Legacy UI remains available at `http://localhost:8042/app/explorer.html <http://localhost:8042/app/explorer.html>`__ | |
| 48 | |
| 49 | |
| 50 Configuration | |
| 51 ------------- | |
| 52 | |
| 53 .. highlight:: json | |
| 54 | |
| 55 The plugin must be configured through a configuration file. The minimal configuration to include in your orthanc configuration file is:: | |
| 56 | |
| 57 "OrthancExplorer2" : { | |
| 58 "Enable": true, | |
| 59 "IsDefaultOrthancUI": true | |
| 60 } | |
| 61 | |
| 62 There are many more options that are documented in the | |
| 63 `default configuration file <https://github.com/orthanc-server/orthanc-explorer-2/blob/master/Plugin/DefaultConfiguration.json>`__. | |
| 64 | |
| 65 Main features you can configure: | |
| 66 | |
| 67 - Root URL | |
|
867
888d6b29245a
faq: Can the Stone Web Viewer display DICOM-SR
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
849
diff
changeset
|
68 - Whether OE2 becomes the default Orthanc UI |
| 845 | 69 - Configure the side menu |
| 70 - Configure the actions available on the resources | |
| 71 - Configure the columns of the main study list | |
| 922 | 72 - Configure `Keycloak <https://www.keycloak.org/>`__ integration and :ref:`authorization plugin <authorization>` |
| 845 | 73 |
| 74 | |
| 75 Advanced features | |
| 76 ----------------- | |
| 77 | |
| 924 | 78 User permissions and web diffusion |
| 79 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ | |
| 80 | |
| 81 Check the documentation of the `orthanc-auth-service <https://github.com/orthanc-team/orthanc-auth-service>`__ | |
| 82 companion web service that provides user permissions and sharing of studies. | |
| 83 | |
| 915 | 84 |
| 85 Direct access to a selection of studies | |
| 86 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ | |
| 87 | |
| 845 | 88 You may open the OE2 interface directly on a specific study or patient by specifying DICOM Tags directly in the URL. |
| 89 e.g:: | |
| 90 | |
| 869 | 91 http://localhost:8042/ui/app/#/filtered-studies?PatientID="00000169" |
| 845 | 92 http://localhost:8042/ui/app/#/filtered-studies?StudyDate=20220512-20220513&ModalitiesInStudy=CR\DX |
| 869 | 93 http://localhost:8042/ui/app/#/filtered-studies?StudyInstanceUID="1.2.3" |
| 94 http://localhost:8042/ui/app/#/filtered-studies?StudyInstanceUID="1.2.3"&expand | |
| 95 http://localhost:8042/ui/app/#/filtered-studies?StudyInstanceUID="1.2.3"&expand=study | |
| 96 http://localhost:8042/ui/app/#/filtered-studies?StudyInstanceUID="1.2.3"&expand=series | |
| 97 | |
| 98 By default, OE2 will add a wildcard ``*`` at the beginning and at the end of the search text. Therefore, searching | |
| 99 for ``PatientID=1234`` will actually search for ``PatientID=*1234*``. If you do not want to have these extra wildcards | |
| 100 added, you should use ``"`` at the beginning and/or at the end of the search text. Therefore, searching for | |
| 101 ``PatientID="1234"`` will return only the studies whose ``PatientID`` is exactly ``1234``. | |
| 102 These ``"`` can also be used in the User Interface search fields. | |
| 845 | 103 |
| 104 | |
| 915 | 105 DICOM Modifications |
| 106 ^^^^^^^^^^^^^^^^^^^ | |
| 107 | |
| 108 Since version 0.6.0, it is possible to edit some of the DICOM Tags directly in the User Interface. | |
| 109 :ref:`DICOM Modification <anonymization>` is quite a complex topic that is provided by Orthanc | |
| 110 Rest API. The Orthanc Explorer 2 User Interface aims at simplifying its use but is also limiting | |
| 111 it to common use cases mainly related to correcting errors in Patient and Study DICOM Tags. | |
| 112 | |
| 113 At study level, it is possible to: | |
| 114 | |
| 115 - Modify a Study | |
| 116 | |
| 117 - to attach it to another existing patient by providing the ``PatientID`` if e.g. the study was | |
| 118 acquired for the wrong patient. | |
| 119 - to edit the patient in all its studies if e.g. the ``PatientName`` was misspelled. | |
| 120 - correct patient or study tags in this study only if e.g. the ``StudyDescription`` was incorrect. | |
| 121 | |
| 122 - Anonymize a Study and possibly provide the anonymized ``PatientID`` or ``PatientName`` to | |
| 123 e.g. force it to a specific identifier for a clinical study. | |
| 124 | |
| 125 .. image:: ../images/OE2-modify-study.png | |
| 126 :align: center | |
| 127 :width: 1000px | |
| 128 | |
| 129 | | |
| 130 | |
| 131 | |
| 132 At series level, it is possible to: | |
| 133 | |
| 134 - Modify a Series | |
| 135 | |
| 136 - to move it to another existing study by providing the ``StudyInstanceUID`` if e.g. the operator | |
| 137 forgot to switch patient in the modality | |
| 138 - to move it to a new study if e.g. the operator forgot to switch patient in the modality | |
| 139 - correct series tags in this series only if e.g. the ``SeriesDescription`` was incorrect. | |
| 140 | |
| 141 - Anonymize a Series and possibly provide the anonymized ``PatientID`` or ``PatientName`` to | |
| 142 e.g. force it to a specific identifier for a clinical study. | |
| 143 | |
| 144 .. image:: ../images/OE2-modify-series.png | |
| 145 :align: center | |
| 146 :width: 1000px | |
| 147 | |
| 148 | | |
| 149 | |
| 150 Each time you modify a study, the user interface might propose you 3 modification modes related to | |
| 151 the handling of the :ref:`DICOM identifiers <dicom-identifiers>` . | |
| 152 | |
| 153 - You may modify the original study and have Orthanc generates new ``StudyInstanceUID``, ``SeriesInstanceUID`` | |
| 154 and ``SOPInstanceUID`` DICOM Tags. This means the that orthanc identifiers will change and the source | |
| 155 study will be deleted. | |
| 156 - You may keep the original ``StudyInstanceUID``, ``SeriesInstanceUID`` and ``SOPInstanceUID`` DICOM Tags. | |
| 157 This means the that orthanc identifiers will not change (unless you also change the ``PatientID`` and the | |
| 916 | 158 study will be modified "in place"). |
| 915 | 159 - You may keep the original study and create a modified copy. In this case, of course, the new modified copy |
| 160 will have a different orthanc identifiers. | |
| 161 | |
| 162 | |
| 163 .. image:: ../images/OE2-modify-options.png | |
| 164 :align: center | |
| 165 :width: 700px | |
| 166 | |
| 167 | | |
| 168 | |
| 169 There are many options related to DICOM Modification in the plugin | |
| 170 `default configuration file <https://github.com/orthanc-server/orthanc-explorer-2/blob/master/Plugin/DefaultConfiguration.json>`__. | |
| 171 Check the ``Modifications`` section and the ``PatientMainTags``, ``StudyMainTags``, ``SeriesMainTags``, ``EnableAnonymization`` | |
| 172 and ``EnableModification`` configurations. | |
| 173 | |
| 174 | |
| 922 | 175 Retrieve a study from a distant modality and open the viewer |
| 176 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ | |
| 845 | 177 |
| 922 | 178 If you want to open e.g. the :ref:`Stone Web viewer <stone_webviewer>`:: on a study that is not yet |
| 179 stored in Orthanc but that you know that it is stored in a remote modality, you may use this endpoint:: | |
| 180 | |
| 923 | 181 http://localhost:8042/ui/app/retrieve-and-view.html?StudyInstanceUID=1.2.3....&modality=pacs&viewer=stone-viewer |
| 845 | 182 |
| 922 | 183 This will first check if the study is already in Orthanc, if not, it will retrieve it from the modality and, |
| 184 once the transfer is complete, open the viewer. | |
| 845 | 185 |
| 922 | 186 This feature has been introduced in v 0.7.0. |
| 845 | 187 |
| 188 | |
| 189 Bug reports & support | |
| 190 --------------------- | |
| 191 | |
| 192 As usual, you can get support and report issues from the `Orthanc Users group <https://groups.google.com/g/orthanc-users>`__. | |
| 193 | |
| 194 You may also directly introduce bugs or feature requests in `GitHub <https://github.com/orthanc-server/orthanc-explorer-2/issues>`__. | |
| 195 | |
| 922 | 196 The plugin is currently maintained by the `Orthanc Team <https://orthanc.team/>`__ who, like many of you, enjoys |
| 197 receiving a salary for his work. Feel free to hire us if you need a specific feature or bug fixed. | |
| 845 | 198 |
| 199 Donations to `Open Collective <https://opencollective.com/orthanc>`__ may also be used to maintain/develop this plugin. |