Working with DICOM Tables (C++ Class Library)

The internal DICOM tables have been moved from the ltdicu.dll to a dedicated LtDicTablesu.dll. This makes the main DICOM dll Ltdicu.dll significantly smaller in size, and offers the developer several new options for accessing and tailoring the DICOM tables to the specific requirements of their application.  

There are five DICOM tables that are defined and stored internally in the DICOM toolkit:

DICOM toolkit users have several options when using and tailoring the DICOM tables to meet the needs of their application.

  1. Developers can include ltdicu.dll and LtDicTablesu.dll in their distributable.  LtDicTablesu.dll includes all UID©s, Element tags, IOD©s, and DICOM Context Groups from the 2008 DICOM specification.  This is the easiest way of using the DICOM tables.

  2. Developers can choose not to include ltdictablesu.dll in their redistributable.  In this case, developers should call the appropriate LoadXml function to load the DICOM tables that they want to load.  As part of the toolkit, four human-readable DICOM table XML files are now installed in the LEADTOOLS Sample Images directory:

These four tables can easily be tailored to your needs.  For example, to add new UID©s, elements, IOD©s, or context groups, developers can edit any one of these files with any text editor.  Also, the tables can be easily combined into a single table.

Developers can easily remove items from these tables that will not be used.  For example, the DICOM IOD table contains more than 60 IOD definitions, more 300 modules definitions, which comes to more than 18000 lines in the dicTableIodModule.xml file. If a particular DICOM application does not use IOD©s, then the application footprint can be significantly reduced by not including these IODs at all.  Or if you are doing basic DICOM communication, you can include only the IODs that you need, and remove all others.  For example, your application might use only the following IODs:

© Patient level for the patient root query/retrieve model

© Study level for the patient root query/retrieve model

© Series level for the patient root query/retrieve model

© Image level for the patient root query/retrieve model

© Study level for the study root query/retrieve model

© Series level for the study root query/retrieve model

© Image level for the study root query/retrieve model

© Patient level  for the patient/study only query/retrieve model

© Study level for the patient/study only query/retrieve model

 

For more information on UIDs, Dicom Elements, IODs, and Context Groups, refer to

Working with Unique Identifiers (UIDs)

Working with Tags

Working with Information Object Definitions

Working with Context Groups

An Overview of the DICOM File Format or the DICOM Standard