dcmodify(1) OFFIS DCMTK dcmodify(1) (NAME) dcmodify - DICOM (SYNOPSIS) dcmodify [options] dcmfile-in... (DESCRIPTION) dcmodify DICOM . (Sequences) (value multiplicity) . (metaheader) (VR) dcmodify . dcmodify -- dcmodify -- . dcmodify . dcmodify (VR) . VR . dcmodify VR UN () ( VR=OB ) . . -iun dcmodify UN . -u dcmodify VR=UN OB . dcmodify << >> (tag paths) . ( ) : {sequence[item-no].}*element 'sequence' (0008,1111) . 'item-no' ( ). 'element' . (0010,0010) "PatientName" . '*' DICOM ( ). 'item-no' '*' ( ). ( ) -i ( ) . : dcmodify . '5' ( ) ( ). ( ) . dcmodify dcmfile-in... . ( ) UID ( ) . (PARAMETERS) dcmfile-in () DICOM ("-" stdin/stdout) (OPTIONS) (general options) -h --help --version --arguments -q --quiet -v --verbose -d --debug -ll --log-level [l]evel: string constant (fatal, error, warn, info, debug, trace) l -lc --log-config [f]ilename: string f (input options) : +f --read-file () +fo --read-file-only -f --read-dataset +fc --create-file : -t= --read-xfer-auto TS () -td --read-xfer-detect TS -te --read-xfer-little TS VR little endian -tb --read-xfer-big TS VR big endian -ti --read-xfer-implicit TS VR little endian : +ao --accept-odd-length () +ae --assume-even-length : +dc --enable-correction () -dc --disable-correction : +bd --bitstream-deflated deflated () +bz --bitstream-zlib deflated zlib (processing options) : --backup () -nb --no-backup () : -i --insert "[t]ag-path=[v]alue" ( ) t v -if --insert-from-file "[t]ag-path=[f]ilename" ( ) t f -nrc --no-reserv-check : -m --modify "[t]ag-path=[v]alue" t v -mf --modify-from-file "[t]ag-path=[f]ilename" t f -ma --modify-all "[t]ag=[v]alue" t v : -e --erase "[t]ag-path" / t -ea --erase-all "[t]ag" t -ep --erase-private : -gst --gen-stud-uid Study Instance UID -gse --gen-ser-uid Series Instance UID -gin --gen-inst-uid SOP Instance UID -nmu --no-meta-uid UID UID : -ie --ignore-errors -imt --ignore-missing-tags << >> -iun --ignore-un-values VR UN (output options) : +F --write-file () -F --write-dataset : +t= --write-xfer-same () +te --write-xfer-little TS VR little endian +tb --write-xfer-big TS VR big endian +ti --write-xfer-implicit TS VR little endian (post-1993 value representations): +u --enable-new-vr VR (UN/UT) () -u --disable-new-vr VR OB : +g= --group-length-recalc () +g --group-length-create -g --group-length-remove : +le --length-explicit () -le --length-undefined ( --write-dataset): -p= --padding-retain ( --write-dataset) -p --padding-off ( --write-dataset) +p --padding-create [f]ile-pad [i]tem-pad: integer f i (PRIVATE TAGS) . (gggg,00xx) . (Insertions) ( gggg,00xx) ( /datadict.txt ). dcmodify VR=UN . . dcmodify : (private creator) VR . dcmodify . -nrc . VR UN . VR . (Modifications) dcmodify VR . VR . (VR) dcmodify . dcmodify VR ( ). VR . (Deletions) dcmodify dcmodify . . . (CHANGING UIDS) ('SOP Class UID' 'SOP Instance UID') dcmodify 'Media Storage SOP Class UID' 'Media Storage SOP Instance UID' . -nmu . UID -gst -gse -gin UID . -gst 'Study Instance UID' 'Series Instance UID' 'SOP Instance UID' ! . UID <<>> . DICOM <<>> UID dcmodify UID . -gin ('Media Storage SOP Instance UID') . . dcmodify UID . -gst dcmodify Study Instance UID . (CREATING NEW FILES) --create-file dcmodify . --insert . (query) findscu movescu . dcmodify Little Endian Explicit Uncompressed . DICOM --write-dataset --create-file . dcmodify . (ELEMENT VALUES FROM FILE) -mf -if . OW little endian (swap) . . (WILDCARDS) dcmodify "*" "ContentSequence[*].CodeValue" "CodeValue" ContentSequence . -m -i -e . -ma -ea DICOM ( ) . (EXAMPLES) -i --insert: dcmodify -i "(0010,0010)=A Name" file.dcm PatientName 'file.dcm' . -i ! (value multiplicity) ( ) : dcmodify -i "(0018,1310)=1\2\3\4" dcmodify -i "(0008,1111)[0].PatientName=Another Name" *.dcm PatientName (0008,1111) . . ( : "(0008,1111)[0].(0008,1111)[1].(0010,0010)=A Third One"). "0" dcmodify . dcmodify -i "(0008,1111)[*].PatientName=Another Name" *.dcm PatientName __ (0008,1111) . . ( : "(0008,1111)[*].(0008,1111)[*].(0010,0010)=A Third One"). -if --insert-from-file: dcmodify -if "PixelData=pixel.raw" file.dcm 'pixel.raw' PixelData 'file.dcm' . . OW little endian (swap) . Rows Columns . -m --modify: dcmodify -m "(0010,0010)=A Name" file.dcm (0010,0010) "A Name" . -i . '-i' . dcmodify -m "(0010,0010)=A Name" -imt file.dcm (0010,0010) "A Name" . '-imt' / ( ) "tag not found" . '-m' . -mf --modify-from-file: dcmodify -mf "PixelData=pixel.raw" file.dcm -if PixelData 'file.dcm' . . -ma --modify-all: dcmodify -ma "(0010,0010)=New Name" file.dcm -m 'file.dcm' . (0010,0010) "New Name" . -e --erase: dcmodify -e "(0010,0010)" *.dcm (0010,0010) *&.dcm . -i . dcmodify -e "(0010,0010)" -imt *.dcm (0010,0010) *&.dcm . '-imt' / ( ) "tag not found" . -ea --erase-all: dcmodify -ea "(0010,0010)" *.dcm -e . -ep --erase-private: dcmodify -ep *.dcm ( ) *&.dcm . -gst --gen-stud-uid: dcmodify -gst file.dcm StudyInstanceUID (0020,000d) . UID ! -gse --gen-ser-uid: dcmodify -gse file.dcm SeriesInstanceUID (0020,000e) . UID ! -gin --gen-inst-uid: dcmodify -gin file.dcm SOPInstanceUID (0008,0018) . MediaStorageSOPInstanceUID (0002,0003) . -nmu . -nmu --no-meta-uid: dcmodify -m "SOPInstanceUID=[UID]" -nmu *.dcm SOPInstanceUID [UID] -nmu MediaStorageSOPInstanceUID dcmodify . (ERROR HANDLING) dcmodify : . --ignore-errors . dcmodify dcmodify . --ignore-missing-tags ( --insert) . -- -- . (LOGGING) . (stderr) . --verbose . --debug . --log-level . --quiet . . "oflog" . ( ) syslog () () --log-config . . /logger.cfg . (COMMAND LINE) : (-) (-n) n . '+' '-' . ( ). . . '@' ( @command.txt). ( ). . / ( /dumppat.txt ). (ENVIRONMENT) dcmodify DICOM DCMDICTPATH . DCMDICTPATH /dicom.dic ( ). DCMDICTPATH . DCMDICTPATH PATH (":") . (";") . DCMDICTPATH . . (COPYRIGHT) Copyright (C) 2003-2025 by OFFIS e.V., Escherweg 2, 26121 Oldenburg, Germany. Version 3.7.0 Thu Jul 9 2026 18:43:40 dcmodify(1)