comparison Sphinx/source/users/anonymization.rst @ 691:b8a744941e58

DicomVersion 2021b for anonymization
author Sebastien Jodogne <s.jodogne@gmail.com>
date Thu, 03 Jun 2021 21:19:42 +0200
parents fcd2c2b66297
children 549824ebdf5a
comparison
equal deleted inserted replaced
690:b3e56e604b2d 691:b8a744941e58
15 Anonymization of a Single Instance 15 Anonymization of a Single Instance
16 ---------------------------------- 16 ----------------------------------
17 17
18 Orthanc allows to anonymize a single DICOM instance and to download 18 Orthanc allows to anonymize a single DICOM instance and to download
19 the resulting anonymized DICOM file. Anonymization consists in erasing 19 the resulting anonymized DICOM file. Anonymization consists in erasing
20 all the tags that are specified in Table E.1-1 from PS 3.15 of the 20 all the tags that are specified in `Table E.1-1 from PS 3.15
21 DICOM standard 2008 or 2017c (default). Example:: 21 <http://dicom.nema.org/medical/dicom/current/output/chtml/part15/chapter_E.html#table_E.1-1>`__
22 of the DICOM standard 2008, 2017c or 2021b (default). Example::
22 23
23 $ curl http://localhost:8042/instances/6e67da51-d119d6ae-c5667437-87b9a8a5-0f07c49f/anonymize -X POST -d '{}' > Anonymized.dcm 24 $ curl http://localhost:8042/instances/6e67da51-d119d6ae-c5667437-87b9a8a5-0f07c49f/anonymize -X POST -d '{}' > Anonymized.dcm
24 25
25 It is possible to control how anonymization is achieved by specifying 26 It is possible to control how anonymization is achieved by specifying
26 a JSON body:: 27 a JSON body::
56 * If ``KeepPrivateTags`` is set to ``true`` in the JSON request, 57 * If ``KeepPrivateTags`` is set to ``true`` in the JSON request,
57 private tags (i.e. manufacturer-specific tags) are not removed by 58 private tags (i.e. manufacturer-specific tags) are not removed by
58 the anonymization process. The default behavior consists in removing 59 the anonymization process. The default behavior consists in removing
59 the private tags, as such tags can contain patient-specific 60 the private tags, as such tags can contain patient-specific
60 information. 61 information.
61 * ``DicomVersion`` specifies which version of the DICOM standard shall be used 62 * ``DicomVersion`` specifies which version of the DICOM standard shall
62 for anonymization. Allowed values are ``2008`` and ``2017c`` (default value 63 be used for anonymization. Allowed values are ``2008``, ``2017c``,
63 if the parameter is absent). This parameter has been introduced in Orthanc 64 or ``2021b`` (default value is ``2021b`` if the parameter is
64 1.3.0. In earlier version, the ``2008`` standard was used. 65 absent). This parameter has been introduced in Orthanc 1.3.0. In
66 earlier version, the ``2008`` standard was used.
67
68
69 **Implementation:** Internally, the setup of the anonymization
70 profiles can be found in the methods ``SetupAnonymizationXXX()`` of
71 the class ``Orthanc::DicomModification`` (cf. `source code
72 <https://hg.orthanc-server.com/orthanc/file/tip/OrthancFramework/Sources/DicomParsing/DicomModification.cpp>`__).
65 73
66 74
67 Modification of a Single Instance 75 Modification of a Single Instance
68 --------------------------------- 76 ---------------------------------
69 77
257 * ``Remove`` allows to remove DICOM tags from the same modules as in 265 * ``Remove`` allows to remove DICOM tags from the same modules as in
258 the ``Replace`` options. 266 the ``Replace`` options.
259 * ``KeepSource`` (Boolean value), if set to ``true``, instructs 267 * ``KeepSource`` (Boolean value), if set to ``true``, instructs
260 Orthanc to keep a copy of the original series in the source study. 268 Orthanc to keep a copy of the original series in the source study.
261 By default, the original series are deleted from Orthanc. 269 By default, the original series are deleted from Orthanc.
262 270
263 .. _merge: 271 .. _merge:
264 272
265 Merging 273 Merging
266 ^^^^^^^ 274 ^^^^^^^
267 275