/usr/bin/dsr2xml

$dcmtk: dsr2xml v3.7.1 2026-10-15 $

dsr2xml: Convert DICOM SR file and data set to XML
usage: dsr2xml [options] dsrfile-in [xmlfile-out]

parameters:
  dsrfile-in                     DICOM SR input filename to be converted
                                 ("-" for stdin)
  xmlfile-out                    XML output filename (default: stdout)

general options:
  -h     --help                  print this help text and exit
         --version               print version information and exit
         --arguments             print expanded command line arguments
  -q     --quiet                 quiet mode, print no warnings and errors
  -v     --verbose               verbose mode, print processing details
  -d     --debug                 debug mode, print debug information
  -ll    --log-level             [l]evel: string constant
                                 (fatal, error, warn, info, debug, trace)
                                 use level l for the logger
  -lc    --log-config            [f]ilename: string
                                 use config file f for the logger
input options:
  input file format:
    +f   --read-file             read file format or data set (default)
    +fo  --read-file-only        read file format only
    -f   --read-dataset          read data set without file meta information
  input transfer syntax:
    -t=  --read-xfer-auto        use TS recognition (default)
    -td  --read-xfer-detect      ignore TS specified in the file meta header
    -te  --read-xfer-little      read with explicit VR little endian TS
    -tb  --read-xfer-big         read with explicit VR big endian TS
    -ti  --read-xfer-implicit    read with implicit VR little endian TS
processing options:
  error handling:
    -Er  --unknown-relationship  accept unknown/missing relationship type
    -Ev  --invalid-item-value    accept invalid content item value
                                 (e.g. violation of VR or VM definition)
    -Ec  --ignore-constraints    ignore relationship content constraints
    -Ee  --ignore-item-errors    do not abort on content item errors, just warn
                                 (e.g. missing value type specific attributes)
    -Ei  --skip-invalid-items    skip invalid content items (incl. sub-tree)
    -Dv  --disable-vr-checker    disable check for VR-conformant string values
  specific character set:
    +Cr  --charset-require       require declaration of ext. charset (default)
    +Ca  --charset-assume        [c]harset: string
                                 assume charset c if no extended charset declared
    +Cc  --charset-check-all     check all data elements with string values
                                 (default: only PN, LO, LT, SH, ST, UC and UT)
    +U8  --convert-to-utf8       convert all element values that are affected
                                 by Specific Character Set (0008,0005) to UTF-8
output options:
  encoding:
    +Ea  --attr-all              encode everything as XML attribute
                                 (shortcut for +Ec, +Er, +Ev and +Et)
    +Ec  --attr-code             encode code value, coding scheme designator
                                 and coding scheme version as XML attribute
    +Er  --attr-relationship     encode relationship type as XML attribute
    +Ev  --attr-value-type       encode value type as XML attribute
    +Et  --attr-template-id      encode template id as XML attribute
    +Ee  --template-envelope     template element encloses content items
                                 (requires +Wt, implies +Et)
  XML structure:
    +Xs  --add-schema-reference  add reference to XML Schema "dsr2xml.xsd"
                                 (not with +Ea, +Ec, +Er, +Ev, +Et, +Ee, +We)
    +Xn  --use-xml-namespace     add XML namespace declaration to root element
  writing:
    +We  --write-empty-tags      write all tags even if their value is empty
    +Wi  --write-item-id         always write item identifier
    +Wt  --write-template-id     write template identification information