Configuration Options (pydicom.config)

pydicom configuration options

allow_DS_float

Set to True to allow DSdecimal instances to be created using floats; otherwise, they must be explicitly converted to str, with the user explicitly setting the precision of digits and rounding.

data_element_callback

Set to a callable function to be called from dcmread() every time a RawDataElement has been returned, before it is added to the Dataset.

data_element_callback_kwargs

Set the keyword arguments passed to data_element_callback().

datetime_conversion

Set to True to convert the value(s) of elements with a VR of DA, DT and TM to datetime.date, datetime.datetime and datetime.time respectively.

debug([debug_on, default_handler])

Turn on/off debugging of DICOM file reading and writing.

enforce_valid_values

Raise exceptions if any value is not allowed by DICOM Standard.

future_behavior([enable_future])

Imitate the behavior for the next major version of pydicom.

overlay_data_handlers

Handlers for converting (60xx,3000) Overlay Data

pixel_data_handlers

Handlers for converting (7FE0,0010) Pixel Data.

reset_data_element_callback()

Reset the data_element_callback() function to the default.

show_file_meta

New in version 2.0.

DS_decimal([use_Decimal_boolean])

Set DS class to be derived from decimal.Decimal or float.

DS_numpy([use_numpy])

Set whether multi-valued elements with VR of DS will be numpy arrays

use_DS_decimal

Set using DS_decimal() to control if elements with a VR of DS are represented as Decimal.

use_IS_numpy

Set to False to avoid IS values being returned as numpy ndarray objects.

use_DS_numpy

Set using the function DS_numpy() to control whether arrays of VR DS are returned as numpy arrays.

APPLY_J2K_CORRECTIONS

Use the information within JPEG 2000 data to correct the returned pixel data

INVALID_KEY_BEHAVIOR

Control the behavior when invalid keys are used with __contains__() (e.g.

INVALID_KEYWORD_BEHAVIOR

Control the behavior when setting a Dataset attribute that’s not a known element keyword.