Mercurial > hg > orthanc-book
comparison Sphinx/source/users/anonymization.rst @ 167:7ba16d90ed93
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. |