pydicom.datadict.add_dict_entry(tag: int, VR: str, keyword: str, description: str, VM: str = '1', is_retired: str = '') None[source]

Update the DICOM dictionary with a new non-private entry.

  • tag (int) – The tag number for the new dictionary entry.

  • VR (str) – DICOM value representation.

  • description (str) – The descriptive name used in printing the entry. Often the same as the keyword, but with spaces between words.

  • VM (str, optional) – DICOM value multiplicity. If not specified, then '1' is used.

  • is_retired (str, optional) – Usually leave as blank string (default). Set to 'Retired' if is a retired data element.


ValueError – If the tag is a private tag.


Does not permanently update the dictionary, but only during run-time. Will replace an existing entry if the tag already exists in the dictionary.

See also


Example file which shows how to use this function


Update multiple values at once.


>>> from pydicom import Dataset
>>> add_dict_entry(0x10021001, "UL", "TestOne", "Test One")
>>> add_dict_entry(0x10021002, "DS", "TestTwo", "Test Two", VM='3')
>>> ds = Dataset()
>>> ds.TestOne = 'test'
>>> ds.TestTwo = ['1', '2', '3']