Mercurial > hg > orthanc-book

comparison Sphinx/source/users/anonymization.rst @ 444:06521ac2c14a

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
transcode info
author Alain Mazy <alain@mazy.be>
date Sat, 06 Jun 2020 16:34:40 +0200
parents 48673b8abae3
children fcd2c2b66297
comparison
equal deleted inserted replaced
443:c66d8b7b1a13 444:06521ac2c14a
23 $ curl http://localhost:8042/instances/6e67da51-d119d6ae-c5667437-87b9a8a5-0f07c49f/anonymize -X POST -d '{}' > Anonymized.dcm 23 $ curl http://localhost:8042/instances/6e67da51-d119d6ae-c5667437-87b9a8a5-0f07c49f/anonymize -X POST -d '{}' > Anonymized.dcm
24 24
25 It is possible to control how anonymization is achieved by specifying 25 It is possible to control how anonymization is achieved by specifying
26 a JSON body:: 26 a JSON body::
27 27
28 $ curl http://localhost:8042/instances/6e67da51-d119d6ae-c5667437-87b9a8a5-0f07c49f/anonymize -X POST -d '{"Replace":{"PatientName":"Hello","0010-1001":"World"},"Keep":["StudyDescription", "SeriesDescription"],"KeepPrivateTags": true, "DicomVersion" : "2017c"}' > Anonymized.dcm 28 $ curl http://localhost:8042/instances/6e67da51-d119d6ae-c5667437-87b9a8a5-0f07c49f/anonymize -X POST \
29 --data '{
30 "Replace": {
31 "PatientName": "Hello",
32 "0010-1001": "World"
33 },
34 "Keep": [
35 "StudyDescription",
36 "SeriesDescription"
37 ],
38 "KeepPrivateTags": true,
39 "DicomVersion" : "2017c"
40 }' > Anonymized.dcm
29 41
30 Explanations: 42 Explanations:
31 43
32 * New UUIDs are automatically generated for the study, the series and 44 * New UUIDs are automatically generated for the study, the series and
33 the instance. 45 the instance.
57 69
58 Orthanc allows to modify a set of specified tags in a single DICOM 70 Orthanc allows to modify a set of specified tags in a single DICOM
59 instance and to download the resulting anonymized DICOM 71 instance and to download the resulting anonymized DICOM
60 file. Example:: 72 file. Example::
61 73
62 $ curl http://localhost:8042/instances/6e67da51-d119d6ae-c5667437-87b9a8a5-0f07c49f/modify -X POST -d '{"Replace":{"PatientName":"hello","PatientID":"world"},"Remove":["InstitutionName"],"RemovePrivateTags": true, "Force": true}' > Modified.dcm 74 $ curl -X POST http://localhost:8042/instances/6e67da51-d119d6ae-c5667437-87b9a8a5-0f07c49f/modify \
75 --data '{
76 "Replace": {
77 "PatientName":"hello",
78 "PatientID":"world"
79 },
80 "Remove":[
81 "InstitutionName"
82 ],
83 "RemovePrivateTags": true,
84 "Force": true,
85 "Transcode": "1.2.840.10008.1.2.4.70"
86 }' > Modified.dcm
63 87
64 Remarks: 88 Remarks:
65 89
66 * The ``Remove`` array specifies the list of the tags to remove. 90 * The ``Remove`` array specifies the list of the tags to remove.
67 * The ``Replace`` associative array specifies the substitions to be applied (cf. anonymization). 91 * The ``Replace`` associative array specifies the substitions to be applied (cf. anonymization).
68 * If ``RemovePrivateTags`` is set to ``true``, the private tags 92 * If ``RemovePrivateTags`` is set to ``true``, the private tags
69 (i.e. manufacturer-specific tags) are removed. 93 (i.e. manufacturer-specific tags) are removed.
94 * The ``Transcode`` option allows you to define the TransferSyntax
95 of the modified file.
70 * The ``Force`` option must be set to ``true``, in order to allow the 96 * The ``Force`` option must be set to ``true``, in order to allow the
71 modification of the ``PatientID``, as such a modification of the 97 modification of the ``PatientID``, as such a modification of the
72 :ref:`DICOM identifiers <dicom-identifiers>` might lead to breaking 98 :ref:`DICOM identifiers <dicom-identifiers>` might lead to breaking
73 the DICOM model of the real-world. In general, any explicit 99 the DICOM model of the real-world. In general, any explicit
74 modification to one of the ``PatientID``, ``StudyInstanceUID``, 100 modification to one of the ``PatientID``, ``StudyInstanceUID``,