Skip to main content

High-level DICOM abstractions.

Project description

Build Status PyPi Distribution Python Versions Downloads


A library that provides high-level DICOM abstractions for the Python programming language to facilitate the creation and handling of DICOM objects for image-derived information, including image annotations, and image analysis results. It currently provides tools for creating and decoding the following DICOM information object definitions (IODs):

  • Annotations
  • Parametric Map images
  • Segmentation images
  • Structured Report documents
  • Secondary Capture images
  • Key Object Selection documents
  • Legacy Converted Enhanced CT/PET/MR images (e.g., for single frame to multi-frame conversion)
  • Softcopy Presentation State instances (including Grayscale, Color, and Pseudo-Color)


Please refer to the online documentation at, which includes installation instructions, a user guide with examples, a developer guide, and complete documentation of the application programming interface of the highdicom package.


For more information about the motivation of the library and the design of highdicom's API, please see the following article:

Highdicom: A Python library for standardized encoding of image annotations and machine learning model outputs in pathology and radiology C.P. Bridge, C. Gorman, S. Pieper, S.W. Doyle, J.K. Lennerz, J. Kalpathy-Cramer, D.A. Clunie, A.Y. Fedorov, and M.D. Herrmann

If you use highdicom in your research, please cite the above article.


The developers gratefully acknowledge their support:

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

highdicom-0.18.4.tar.gz (1.0 MB view hashes)

Uploaded source

Built Distribution

highdicom-0.18.4-py3-none-any.whl (798.0 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page