API Reference

Release:

2.4.5

Date:

Mar 20, 2026

This API reference guide details the functions, modules and objects included in pydicom.

• Character Encoding and Decoding (pydicom.charset)
  • pydicom.charset.convert_encodings
  • pydicom.charset.decode_element
  • pydicom.charset.decode_bytes
  • pydicom.charset.encode_string
• Configuration Options (pydicom.config)
  • Settings
  • pydicom.config.settings
  • pydicom.config.allow_DS_float
  • pydicom.config.assume_implicit_vr_switch
  • pydicom.config.convert_wrong_length_to_UN
  • pydicom.config.data_element_callback
  • pydicom.config.data_element_callback_kwargs
  • pydicom.config.datetime_conversion
  • pydicom.config.debug
  • pydicom.config.enforce_valid_values
  • pydicom.config.future_behavior
  • pydicom.config.overlay_data_handlers
  • pydicom.config.pixel_data_handlers
  • pydicom.config.reset_data_element_callback
  • pydicom.config.show_file_meta
  • pydicom.config.DS_decimal
  • pydicom.config.DS_numpy
  • pydicom.config.use_DS_decimal
  • pydicom.config.use_IS_numpy
  • pydicom.config.use_DS_numpy
  • pydicom.config.APPLY_J2K_CORRECTIONS
  • pydicom.config.INVALID_KEY_BEHAVIOR
  • pydicom.config.INVALID_KEYWORD_BEHAVIOR
  • pydicom.config.IGNORE
  • pydicom.config.WARN
  • pydicom.config.RAISE
• Getting Included Datasets (pydicom.data)
  • pydicom.data.get_charset_files
  • pydicom.data.get_palette_files
  • pydicom.data.get_testdata_file
  • pydicom.data.get_testdata_files
• Data Dictionary Utilities (pydicom.datadict)
  • DICOM Data Dictionary
  • Private Data Dictionary
• Representation of Data Elements
  • Data Elements (pydicom.dataelem)
  • Element Tags (pydicom.tag)
  • Element Value Decoding (pydicom.values)
  • Element Multi-value Representation (pydicom.multival)
  • Sequence Element Value Representation (pydicom.sequence)
  • Specialized Element Value Representation (pydicom.valuerep)
• Representation of Datasets (pydicom.dataset)
  • pydicom.dataset.Dataset
  • pydicom.dataset.FileDataset
  • pydicom.dataset.FileMetaDataset
  • pydicom.dataset.PrivateBlock
  • pydicom.dataset.validate_file_meta
• Bulk Data Handlers
  • Overlay Data Handlers (pydicom.overlays)
  • Pixel Data Handlers (pydicom.pixel_data_handlers)
  • Waveform Data Handlers (pydicom.waveforms)
• Pixel Data Utilities
  • pydicom.pixel_data_handlers.apply_color_lut
  • pydicom.pixel_data_handlers.apply_modality_lut
  • pydicom.pixel_data_handlers.apply_rescale
  • pydicom.pixel_data_handlers.apply_windowing
  • pydicom.pixel_data_handlers.apply_voi
  • pydicom.pixel_data_handlers.apply_voi_lut
  • pydicom.pixel_data_handlers.convert_color_space
  • pydicom.pixel_data_handlers.util
• Pixel Data Encoders (pydicom.encoders)
  • pydicom.encoders.RLELosslessEncoder
  • pydicom.encoders.get_encoder
  • pydicom.encoders.base.Encoder
• DICOM File-sets (pydicom.fileset)
  • pydicom.fileset.RecordNode
  • pydicom.fileset.FileInstance
  • pydicom.fileset.FileSet
  • pydicom.fileset.generate_filename
  • pydicom.fileset.is_conformant_file_id
  • pydicom.fileset.DIRECTORY_RECORDERS
• DICOMDIR (pydicom.dicomdir)
  • pydicom.dicomdir.DicomDir
• Bulk Data Encapsulation Utilities (pydicom.encaps)
  • Parsing Encapsulated Data
  • Creating Encapsulated Data
• Exceptions (pydicom.errors)
  • pydicom.errors.InvalidDicomError
• Dataset IO
  • Dataset Reading (pydicom.filereader)
  • Dataset Writing (pydicom.filewriter)
  • IO Base Classes (pydicom.filebase)
  • IO Utilities (pydicom.fileutil)
• Miscellaneous (pydicom.misc)
  • pydicom.misc.is_dicom
  • pydicom.misc.size_in_bytes
• UID Definitions and Utilities (pydicom.uid)
  • Transfer Syntax UIDs
  • Transfer Syntax Lists
  • UID Utilities
  • Storage SOP Class UIDs