Mercurial > hg > orthanc-book

comparison Sphinx/source/plugins/dicomweb.rst @ 838:6afc236cd60a

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
dicom-web & main-dicom-tags
author Alain Mazy <am@osimis.io>
date Thu, 05 May 2022 12:27:09 +0200
parents 0f4f11636193
children 60c4deeb6892
comparison
equal deleted inserted replaced
837:66ff2f30afcc 838:6afc236cd60a
112 the Orthanc configuration file:: 112 the Orthanc configuration file::
113 113
114 { 114 {
115 [...] 115 [...]
116 "DicomWeb" : { 116 "DicomWeb" : {
117 "Enable" : true, // Whether DICOMweb support is enabled 117 "Enable" : true, // Whether DICOMweb support is enabled
118 "Root" : "/dicom-web/", // Root URI of the DICOMweb API (for QIDO-RS, STOW-RS and WADO-RS) 118 "Root" : "/dicom-web/", // Root URI of the DICOMweb API (for QIDO-RS, STOW-RS and WADO-RS)
119 "EnableWado" : true, // Whether WADO-URI (previously known as WADO) support is enabled 119 "EnableWado" : true, // Whether WADO-URI (previously known as WADO) support is enabled
120 "WadoRoot" : "/wado", // Root URI of the WADO-URI (aka. WADO) API 120 "WadoRoot" : "/wado", // Root URI of the WADO-URI (aka. WADO) API
121 "Ssl" : false, // Whether HTTPS should be used for subsequent WADO-RS requests 121 "Ssl" : false, // Whether HTTPS should be used for subsequent WADO-RS requests
122 "QidoCaseSensitive" : true, // For QIDO-RS server, whether search is case sensitive (since release 0.5) 122 "QidoCaseSensitive" : true, // For QIDO-RS server, whether search is case sensitive (since release 0.5)
123 "Host" : "localhost", // Hard-codes the name of the host for subsequent WADO-RS requests (deprecated) 123 "Host" : "localhost", // Hard-codes the name of the host for subsequent WADO-RS requests (deprecated)
124 "StudiesMetadata" : "Full", // How study-level metadata is retrieved (since release 1.1, cf. section below) 124 "StudiesMetadata" : "Full", // How study-level metadata is retrieved (since release 1.1, cf. section below)
125 "SeriesMetadata" : "Full" // How series-level metadata is retrieved (since release 1.1, cf. section below) 125 "SeriesMetadata" : "Full", // How series-level metadata is retrieved (since release 1.1, cf. section below)
126 "PublicRoot": "/dicom-web/", // The public Root URI of the DICOMweb API in case it is different from "Root".
127 // This is useful if, e.g, your Orthanc is behind a reverse-proxy and has another
128 // base endpoint than the "Root" one. Note that, if using a reverse-proxy, make sure to set the "host"
129 // and "proto" correctly in the "Forwarded" HTTP headers.
130 // (since release 1.8)
126 } 131 }
127 } 132 }
128 133
129 Furthermore, the global option ``DefaultEncoding`` specifies the 134 Furthermore, the global option ``DefaultEncoding`` specifies the
130 encoding (specific character set) that will be used when answering a 135 encoding (specific character set) that will be used when answering a
177 * If ``MainDicomTags`` mode is used, the plugin will only report the 182 * If ``MainDicomTags`` mode is used, the plugin will only report the
178 main DICOM tags that are indexed by the Orthanc database. The DICOM 183 main DICOM tags that are indexed by the Orthanc database. The DICOM
179 files are not read from the disk, which provides best 184 files are not read from the disk, which provides best
180 performance. However, this is a small subset of all the tags that 185 performance. However, this is a small subset of all the tags that
181 would be retrieved if using the ``Full`` mode: A DICOMweb viewer 186 would be retrieved if using the ``Full`` mode: A DICOMweb viewer
182 might need more tags. 187 might need more tags. **Important Note:** From Orthanc 1.11.0 and DICOMweb plugin 1.8,
188 you may store more :ref:`MainDicomTags <main-dicom-tags>` in DB.
189 By correctly setting these tags, the ``MainDicomTags`` mode can
190 become faster than the ``Extrapolate`` mode with the same accuracy
191 as the ``Full`` mode.
183 192
184 * If ``Extrapolate`` mode is used, the plugin will read up to 3 DICOM 193 * If ``Extrapolate`` mode is used, the plugin will read up to 3 DICOM
185 instances at random that belong to the study/series of interest. It 194 instances at random that belong to the study/series of interest. It
186 will then test whether the majority of these instances share the 195 will then test whether the majority of these instances share the
187 same value for a predefined subset of DICOM tags. If so, this value 196 same value for a predefined subset of DICOM tags. If so, this value