DCMTK Howtos¶

On this page one should find some short guides, how to accomplish specific tasks or use specific features in DCMTK.

Currently, the following Howtos are available:

General ¶

• DCMTK development How-To: How to contribute to the software development of DCMTK (auch auf Deutsch verfügbar)
• Data Dictionaries: How to use multiple data dictionaries, e.g. for private or additional DICONDE tags
• Adding a SOP Class: Files to change for adding new (e. g. private) SOP classes to DCMTK

Compiling DCMTK ¶

• Third Party Support Libraries: Preparing DCMTK's external dependencies
• Compiling on Mac OS X: How to build DCMTK under Mac OS X
• Compiling on Linux/Unix: Refer to INSTALL file that comes with DCMTK source code
• Compiling on Windows: Refer to INSTALL file that comes with DCMTK source code
• CMake configuration: Meaning of all the CMake configuration options for DCMTK version 3.6.0 and latest source code.
• DCMTK's CMake exports for using DCMTK in external projects (DCMTKConfig.cmake and related)
• Cross-compiling DCMTK

Logging ¶

• Loggers in Commandline Applications: How to use loggers in commandline applications
• Create Log File: How to output all log messages to a log file (and not to the console)
• Configure Logger from Program: How to configure the logger from a program (without config file)

Files ¶

• Load File Meta-Header: How to load the meta-header of a DICOM file (without reading the dataset)
• Find particular Files: How to find DICOM files of a particular modality (or any other element value) with dcmdump
• Compare Files: How to compare the content of two DICOM files and show the differences (Unix only)

Data Elements ¶

• Add Sequence Item: How to add a new item with attributes to sequence (example Reference Image Sequence and corresponding UIDs)
• Get Sequence Item: How to get information from a sequence item (example Procedure Code Sequence and corresponding Code Meaning)
• Add Private Data: How to add private data elements to a dataset
• Remove Private Data: How to remove all private data from a dataset
• Generate UIDs: How to generate new UIDs for a DICOM SOP Instance
• Extract Element Values: How to extract element values from dcmdump's textual output
• XML Tools: How to use DCMTK's XML tools and an XSLT processor to change the patient's name
• Iterate Dataset: How to iterate over a DICOM dataset

Images and GSPS ¶

• Multi-frame Images: How to access multi-frame images without loading the complete pixel data
• Accessing Compressed Data: How to access the original compressed data from a DICOM image/video?
• Overlay Data: How to extract Overlay Data from a DICOM Image with DCMTK
• GSPS Annotations: How to create GSPS object with annotations and multiple image references

Structured Reporting ¶

• Mammography CAD SR: How to create a Mammography CAD SR Document with DCMTK

Network ¶

• Example for DcmSCU: How to use the DcmSCU class to code DICOM clients
• Understanding association negotiation logging: How to understand DCMTK association negotiation logs
• Debugging PACS with DCMTK: How to use DCMTK' PACS client and server tools for debugging
• User Identity Negotiation: User Identity Negotiation with DCMTK

Mobile Platforms ¶

• Offline? Android Tutorial: Tutorial explaining how to compile DCMTK for Android platforms (external link, in french language!)
• Offline? iOS Tutorial: Tutorial explaining how to compile DCMTK for iOS platforms (external link, in french language!)
• iOS Tutorial: Tutorial explaining how to compile DCMTK for iOS platforms (external link, in Chinese, yes Chinese, language!)

Testing ¶

• Testing in DCMTK: How to write and run tests with DCMTK