Mercurial > hg > orthanc-book

comparison Sphinx/source/users/anonymization.rst @ 167:7ba16d90ed93

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
split/merge
author Sebastien Jodogne <s.jodogne@gmail.com>
date Wed, 03 Oct 2018 16:50:20 +0200
parents 2e826633420e
children 981e5a996b11
comparison
equal deleted inserted replaced
166:3b80f348cc6b 167:7ba16d90ed93
154 $ curl http://localhost:8042/studies/ef2ce55f-9342856a-aee23907-2667e859-9f3b734d/anonymize -X POST -d '{}' 154 $ curl http://localhost:8042/studies/ef2ce55f-9342856a-aee23907-2667e859-9f3b734d/anonymize -X POST -d '{}'
155 $ curl http://localhost:8042/series/95a6e2bf-9296e2cc-bf614e2f-22b391ee-16e010e0/anonymize -X POST -d '{}' 155 $ curl http://localhost:8042/series/95a6e2bf-9296e2cc-bf614e2f-22b391ee-16e010e0/anonymize -X POST -d '{}'
156 156
157 As written above, the anonymization process can be fine-tuned by using 157 As written above, the anonymization process can be fine-tuned by using
158 a JSON body. 158 a JSON body.
159
160
161 Split/merge of DICOM studies
162 ----------------------------
163
164 Starting with Orthanc 1.4.3, Orthanc supports splitting and merging
165 DICOM studies through its REST API.
166
167 Splitting
168 ^^^^^^^^^
169
170 Here is the syntax to **split** a DICOM study::
171
172 $ curl http://localhost:8042/studies/6e2c0ec2-5d99c8ca-c1c21cee-79a09605-68391d12/split -d \
173 '{"Series":["6ca4c9f3-5e895cb3-4d82c6da-09e060fe-9c59f228"],"Replace":{"PatientName":"HELLO"},"Remove":["AccessionNumber"]}'
174
175 By issuing this command, the series whose :ref:`Orthanc identifier
176 <dicom-identifiers>` is
177 ``6ca4c9f3-5e895cb3-4d82c6da-09e060fe-9c59f228``, and that is part of
178 the source study with identifier
179 ``6e2c0ec2-5d99c8ca-c1c21cee-79a09605-68391d12``, will be removed from
180 the source study, and will be moved to a brand new study.
181
182 This is done by generating a new value for all the following DICOM
183 tags in the DICOM instances of the series of interest:
184 ``StudyInstanceUID (0x0020, 0x000d)``, ``SeriesInstanceUID (0x0020,
185 0x000e)``, and ``SOPInstanceUID (0x0008, 0x0018)``. Here are the
186 arguments of this ``/studies/{study}/split`` URI:
187
188 * ``Series`` gives the list of series to be separated from the parent
189 study (mandatory option). These series must all be children of the
190 same source study, that is specified in the URI.
191 * ``Replace`` allows to overwrite the DICOM tags that are part of the
192 "Patient Module Attributes" and the "General Study Module
193 Attributes", as specified by the DICOM 2011 standard in Tables C.7-1
194 and C.7-3.
195 * ``Remove`` allows to remove DICOM tags from the same modules as in
196 the ``Replace`` options.
197 * ``KeepSource`` (Boolean value), if set to ``true``, instructs
198 Orthanc to keep a copy of the original series in the source study.
199 By default, the original series are deleted from Orthanc.
200
201
202 Merging
203 ^^^^^^^
204
205 Here is the syntax to **merge** DICOM series, into another DICOM study::
206
207 $ curl http://localhost:8042/studies/6e2c0ec2-5d99c8ca-c1c21cee-79a09605-68391d12/merge -d \
208 '{"Resources":["ef2ce55f-9342856a-aee23907-2667e859-9f3b734d"]}'
209
210 By issuing this command, the DICOM series whose :ref:`Orthanc
211 identifier <dicom-identifiers>` is
212 ``ef2ce55f-9342856a-aee23907-2667e859-9f3b734d``, will be merged into
213 target study with identifier
214 ``6e2c0ec2-5d99c8ca-c1c21cee-79a09605-68391d12``.
215
216 As in the case of splitting, this is done by updating the following
217 DICOM tags: ``StudyInstanceUID (0x0020, 0x000d)``, ``SeriesInstanceUID
218 (0x0020, 0x000e)``, and ``SOPInstanceUID (0x0008,
219 0x0018)``. Furthermore, all the DICOM tags that are part of the
220 "Patient Module Attributes" and the "General Study Module Attributes"
221 (as specified by the DICOM 2011 standard in Tables C.7-1 and C.7-3),
222 are modified to match the target study. Here are the
223 arguments of this ``/studies/{study}/merge`` URI:
224
225 * ``Resources`` gives the list of source studies or source series
226 that are to be merged into the target study.
227 * ``KeepSource`` (Boolean value), if set to ``true``, instructs
228 Orthanc to keep the source studies and series. By default, the
229 original resources are deleted from Orthanc.