Getting Started with JDT


If you have downloaded an installer distribution, run the installer. If you have downloaded JDT as a zip file, unzip the file into a directory of your choice.

Jar File

The JDT library is contained within a single jar file named jdt.jar and located in the lib folder of installation directory. You will need to add this jar file to the classpath of your development environment. When applications that make use of JDT are distributed , this jar file should also be distributed together with the jar files and other files of your applications.

Key File

JDT requires a key file called jdt.key in order to run. The key file can be an evaluation key which you received by email or it can be a permanent key which you received after purchasing a license. The key should be placed in the classpath of your development environment and it should also be redistributed together with the jdt.jar file when you distribute the applications you have developed with JDT.

Getting Started

A good way to get started is to have a look at the examples included in the distribution. We provide email support during the 30-day trial period of your evaluation. If you need help during your evaluation or have technical questions, please contact support via email at

For more information, consult the following sections of the user guide:


The Trispark Java DICOM Toolkit is a small footprint 100% java library and API for building DICOM applications. The library has the following features:

  • Up-to-date DICOM dictionary classes covering all tags,transfer syntaxes, sop classes and other UID's defined in the 2008 edition of the DICOM standard
  • DICOM PART 10 File support including automatic detection of DICOM files
  • DICOM PART 8 Network support for creating 'associations' over TCP/IP and connecting to DICOM devices, including support for SCP/SCU role negotiation, maximum operations setting, extended negotiations and easy exchange of DIMSE commands and Data Sets over associations.
  • Support for all non-compressed transfer syntaxes and transfer syntax conversion when reading/writing DICOM files and streams.
  • All VR's are supported including newly added OF (Other Float).
  • Sequences can be read or written with defined or undefined length.
  • Sequence delimitation items and Item delimitation items are added automatically when necessary.
  • Support for RLE encoding and JPEG encoding
  • Read/Write DICOM data to InputStreams/OutputStreams using the normal streams concepts.
  • Easy manipulation of sequences and positioning of sequence items with utility classes
  • Straight-forward type mapping of DICOM VR's to native Java Types.


Customers having purchased a distribution license and/or source code license are entitled to one year of technical support via email starting from the purchase date. The support also includes minor updates and bug fix releases.Support can be renewed annually.

If you have any technical questions contact

Additional Resources

This software library requires a basic understanding of the DICOM standard. The DICOM standard is quite an extensive standard published by

National Electrical Manufacturers Association 1300 N. 17th Street Rosslyn, Virginia 22209 USA

The official ACR/NEMA home page of the DICOM standard is

A very good site on DICOM with links to the various parts of the standard, correction proposals and supplements in PDF format is David Clunie's Medical Imaging Format site.

The parts of the DICOM standard that are particularly relevant with respect to this library are:

  • Part 5: Data Structures and Encoding
  • Part 7: Message Exchange
  • Part 8: Network Communication Support for Message Exchange
  • Part 10: Media Storage and File Format for Data Interchange