API Reference

Release:

3.0.2

Date:

Mar 19, 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.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 Datasets (pydicom.dataset)
  • pydicom.dataset.Dataset
  • pydicom.dataset.FileDataset
  • pydicom.dataset.FileMetaDataset
  • pydicom.dataset.PrivateBlock
  • pydicom.dataset.validate_file_meta
• 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)
• Example Datasets (pydicom.examples)
  • pydicom.examples.get_path
  • Usage
• 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)
• 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
• Bulk Data Handlers
  • Pixel Data Handlers (pydicom.pixel_data_handlers)
• User Hooks (pydicom.hooks)
  • pydicom.hooks.hooks
  • pydicom.hooks.Hooks
  • pydicom.hooks.raw_element_vr
  • pydicom.hooks.raw_element_value
  • pydicom.hooks.raw_element_value_fix_separator
  • pydicom.hooks.raw_element_value_retry
• Miscellaneous (pydicom.misc)
  • pydicom.misc.is_dicom
  • pydicom.misc.size_in_bytes
• Overlay Data Handling (pydicom.overlays)
  • pydicom.overlays.numpy_handler
• Pixel Data (pydicom.pixels)
  • pydicom.pixels.apply_color_lut
  • pydicom.pixels.apply_icc_profile
  • pydicom.pixels.apply_modality_lut
  • pydicom.pixels.apply_presentation_lut
  • pydicom.pixels.apply_rescale
  • pydicom.pixels.apply_voi_lut
  • pydicom.pixels.apply_voi
  • pydicom.pixels.apply_windowing
  • pydicom.pixels.convert_color_space
  • pydicom.pixels.create_icc_transform
  • pydicom.pixels.as_pixel_options
  • pydicom.pixels.compress
  • pydicom.pixels.decompress
  • pydicom.pixels.get_decoder
  • pydicom.pixels.get_encoder
  • pydicom.pixels.iter_pixels
  • pydicom.pixels.pack_bits
  • pydicom.pixels.pixel_array
  • pydicom.pixels.set_pixel_data
  • pydicom.pixels.unpack_bits
  • Sub-modules
• Concepts and Context Groups (pydicom.sr)
  • pydicom.sr.Collection
  • pydicom.sr.Concepts
  • pydicom.sr.Code
  • Usage
• Waveform Data Handlers (pydicom.waveforms)
  • pydicom.waveforms.numpy_handler
• UID Definitions and Utilities (pydicom.uid)
  • Transfer Syntax UIDs
  • Transfer Syntax Lists
  • UID Utilities
  • Storage SOP Class UIDs