dicomdict

Get or set active DICOM data dictionary

Syntax

dictionaryOut = dicomdict('get')

dicomdict('set',dictionaryIn)

dicomdict('factory')

Description

dictionaryOut = dicomdict('get') returns the name of the active Digital Imaging and Communications in Medicine (DICOM) data dictionary file.

dicomdict('set',dictionaryIn) sets the file specified by input dictionaryIn as the active DICOM data dictionary. If the file is not found in the specified path, the function returns an error.

dicomdict('factory') restores the active DICOM data dictionary to its default value. The default value is a file in the MATLAB^® path:

fullfile(matlabroot,'toolbox','images','iptformats','dicom-dict.txt')

Examples

Get and Set Active DICOM Data Dictionary

Find the default active DICOM data dictionary.

dictionaryOut = dicomdict('get')

dictionaryOut = 
'/mathworks/devel/bat/Bdoc21b/build/matlab/toolbox/images/iptformats/dicom-dict.txt'

Specify the path to a new file to set as the active DICOM data dictionary.

dictionaryIn = 'dicomdictnew.txt';
dicomdict('set',dictionaryIn)

Check if the active DICOM data dictionary is updated to 'dicomdictnew'.

dictionaryOut1 = dicomdict('get')

dictionaryOut1 = 
'/tmp/Bdoc21b_1796508_102698/tp161c9277/images-ex49312738/dicomdictnew.txt'

Reset the active DICOM data dictionary to the default value and verify the same.

dicomdict('factory')
dictionaryOut2 = dicomdict('get')

dictionaryOut2 = 
'/mathworks/devel/bat/Bdoc21b/build/matlab/toolbox/images/iptformats/dicom-dict.txt'

Input Arguments

dictionaryIn — DICOM data dictionary file

character vector | string scalar

DICOM data dictionary file of type .txt to be set as active, specified as a character vector or string scalar.

Data Types: char | string

Output Arguments

dictionaryOut — Active DICOM data dictionary file

fullfile(matlabroot,'toolbox','images','iptformats','dicom-dict.txt') (default) | character vector | string scalar

Active DICOM data dictionary file of type .txt, returned as a character vector or string scalar. The default value is:

fullfile(matlabroot,'toolbox','images','iptformats','dicom-dict.txt')