OS Manuals

/usr/bin/json2dcm

DCMTK is a collection of libraries and applications implementing large parts the DICOM standard.

From dcmtk 3.7.1-r0 (os), captured 2026-11-05 by running json2dcm --help (exit 0). permalink

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

json2dcm: Convert JSON document to DICOM file or data set
usage: json2dcm [options] jsonfile-in dcmfile-out

parameters:
  jsonfile-in                   JSON input filename to be converted
                                ("-" for stdin)
  dcmfile-out                   DICOM output filename
                                ("-" for 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-meta-info       read meta information if present (default)
    -f   --ignore-meta-info     ignore file meta information
processing options:
  unique identifiers:
    +Ug  --generate-new-uids    generate new Study/Series/SOP Instance UID
    -Uo  --dont-overwrite-uids  do not overwrite existing UIDs (default)
    +Uo  --overwrite-uids       overwrite existing UIDs
  bulkdata URI handling:
    +Bu  --parse-bulkdata-uri   parse Bulkdata URIs (default)
    -Bu  --ignore-bulkdata-uri  ignore Bulkdata URIs
    +Bd  --add-bulkdata-dir     [d]irectory: string
                                add d to list of permitted bulk data sources
  handling of arrays with multiple data sets:
    -ar  --array-reject         reject multiple data sets (default)
    +as  --array-select         [n]umber: integer
                                select data set n from array
    +ar  --array-sequence       store all data sets in private sequence
  charset handling:
    +c   --charset-convert      convert to the specific character set given in JSON (default)
    -c   --charset-utf8         write DICOM file with UTF-8 (ISO_IR 192), no conversion
output options:
  output file format:
    +F   --write-file           write file format (default)
    -F   --write-dataset        write data set without file meta information
    +Fu  --update-meta-info     update particular file meta information
  output transfer syntax:
    +t=  --write-xfer-same      write with same TS as input (default)
    +te  --write-xfer-little    write with explicit VR little endian TS
    +tb  --write-xfer-big       write with explicit VR big endian TS
    +ti  --write-xfer-implicit  write with implicit VR little endian TS
    +td  --write-xfer-deflated  write with deflated expl. VR little endian TS
  error handling:
    -E   --stop-on-error        do not write if document is invalid (default)
    +E   --ignore-errors        attempt to write even if document is invalid
  post-1993 value representations:
    +u   --enable-new-vr        enable support for new VRs (UN/UT) (default)
    -u   --disable-new-vr       disable support for new VRs, convert to OB
  length encoding in sequences and items:
    +e   --length-explicit      write with explicit lengths (default)
    -e   --length-undefined     write with undefined lengths
  deflate compression level (only with --write-xfer-deflated):
    +cl  --compression-level    [l]evel: integer (default: 6)
                                0=uncompressed, 1=fastest, 9=best compression
Options (17)
OptionDescriptionSource
-h--help print this help text and exithelp
--versionprint version information and exithelp
--argumentsprint expanded command line argumentshelp
-q--quiet quiet mode, print no warnings and errorshelp
-v--verbose verbose mode, print processing detailshelp
-d--debug debug mode, print debug informationhelp
-ll--log-level [l]evel: string constant (fatal, error, warn, info, debug, trace) use level l for the loggerhelp
-lc--log-config [f]ilename: string use config file f for the loggerhelp
-f--ignore-meta-info ignore file meta informationhelp
-Uo--dont-overwrite-uids do not overwrite existing UIDs (default)help
-Bu--ignore-bulkdata-uri ignore Bulkdata URIshelp
-ar--array-reject reject multiple data sets (default)help
-c--charset-utf8 write DICOM file with UTF-8 (ISO_IR 192), no conversionhelp
-F--write-dataset write data set without file meta informationhelp
-E--stop-on-error do not write if document is invalid (default)help
-u--disable-new-vr disable support for new VRs, convert to OBhelp
-e--length-undefined write with undefined lengthshelp

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.