File: transcode.rst

package info (click to toggle)
odil 0.13.0-2
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid
  • size: 5,476 kB
  • sloc: cpp: 55,982; python: 3,947; javascript: 460; xml: 182; makefile: 99; sh: 36
file content (68 lines) | stat: -rw-r--r-- 2,195 bytes parent folder | download | duplicates (5)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
Convert a binary DICOM file
===========================

Binary DICOM files can be converted to their `JSON`_ or `XML`_ representation or recoded using another `transfer syntax`_ using ``odil transcode``.

Convert to JSON
---------------

Specify ``-f json`` to convert to JSON:

.. code-block:: console

  $ odil transcode -f json file.dcm /dev/stdout
  { "00080005":{"Value":["ISO_IR 100"],"vr":"CS"}, ... }

If the output is to be read by a human being, the condensed format is not appropriate, and the result can be pretty-printed using the ``-p`` flag:

.. code-block:: console

  $ odil transcode -f json -p file.dcm /dev/stdout
  {
    "00080005" : {
      "Value" : [ "ISO_IR 100" ],
      "vr" : "CS"
    },
    ...
    "00080016" : {
      "Value" : [ "1.2.840.10008.5.1.4.1.1.4" ],
      "vr" : "UI"
    },
    ...
  }

Convert to XML
--------------

Similarly, specify ``-f xml`` to convert to XML, with optional pretty-printing with the ``-p`` flag:

.. code-block:: console

  $ odil transcode -f xml -p file.dcm /dev/stdout
  <?xml version="1.0" encoding="utf-8"?>
  <NativeDicomModel>
    <DicomAttribute vr="CS" tag="00080005" keyword="SpecificCharacterSet">
      <Value number="1">ISO_IR 100</Value>
    </DicomAttribute>
    ...
    <DicomAttribute vr="UI" tag="00080016" keyword="SOPClassUID">
      <Value number="1">1.2.840.10008.5.1.4.1.1.4</Value>
    </DicomAttribute>
    ...
  </NativeDicomModel>

Change the transfer syntax
--------------------------

The transfer syntax of a file can also be changed through the ``-t`` flag with a `transfer syntax name`_:

.. code-block:: console

  $ odil transcode -t ExplicitVRLittleEndian input.dcm output.dcm
  $ odil print -H -u output.dcm | grep "Transfer Syntax"
  Transfer Syntax UID  0002,0010 UI ['Explicit VR Little Endian']

.. _JSON: http://dicom.nema.org/medical/dicom/current/output/chtml/part18/chapter_F.html
.. _transfer syntax: http://dicom.nema.org/medical/dicom/current/output/chtml/part05/chapter_10.html
.. _transfer syntax name: http://dicom.nema.org/medical/dicom/current/output/chtml/part06/chapter_A.html
.. _XML: http://dicom.nema.org/medical/dicom/current/output/chtml/part19/chapter_A.html#sect_A.1