pydicom.dataset.FileMetaDataset¶

class pydicom.dataset.FileMetaDataset(*args: Dataset | MutableMapping[BaseTag, DataElement | RawDataElement], **kwargs: Any)[source]¶

Contains a collection (dictionary) of group 2 DICOM Data Elements.

New in version 2.0.

Derived from Dataset, but only allows Group 2 (File Meta Information) data elements

__init__(*args: Dataset | MutableMapping[BaseTag, DataElement | RawDataElement], **kwargs: Any) → None[source]¶

Initialize a FileMetaDataset

Parameters are as per Dataset; this overrides the super class only to check that all are group 2 data elements

Raises:

ValueError – If any data elements are not group 2.
TypeError – If the passed argument is not a dict or Dataset

Methods

`__init__`(args, *kwargs)	Initialize a FileMetaDataset
`add`(data_element)	Add an element to the `Dataset`.
`add_new`(tag, VR, value)	Create a new element and add it to the `Dataset`.
`add_new_private`(private_creator, group, ...)	Create a new private element and add it to the `Dataset`.
`clear`()	Delete all the elements from the `Dataset`.
`compress`(transfer_syntax_uid[, arr, ...])	Compress and update an uncompressed dataset in-place with the resulting encapsulated pixel data.
`convert_pixel_data`([handler_name])	Convert pixel data to a `numpy.ndarray` internally.
`copy`()	Return a shallow copy of the dataset.
`data_element`(name)	Return the element corresponding to the element keyword name.
`decode`()	Apply character set decoding to the elements in the `Dataset`.
`decompress`([handler_name])	Decompresses Pixel Data and modifies the `Dataset` in-place.
`dir`(*filters)	Return an alphabetical list of element keywords in the `Dataset`.
`elements`()	Yield the top-level elements of the `Dataset`.
`ensure_file_meta`()	Create an empty `Dataset.file_meta` if none exists.
`fix_meta_info`([enforce_standard])	Ensure the file meta info exists and has the correct values for transfer syntax and media storage UIDs.
`formatted_lines`([element_format, ...])	Iterate through the `Dataset` yielding formatted `str` for each element.
`from_json`(json_dataset[, bulk_data_uri_handler])	Return a `Dataset` from a DICOM JSON Model object.
`get`(key[, default])	Simulate `dict.get()` to handle element tags and keywords.
`get_item`(key)	Return the raw data element if possible.
`get_private_item`(group, element_offset, ...)	Return the data element for the given private tag group.
`group_dataset`(group)	Return a `Dataset` containing only elements of a certain group.
`items`()	Return the `Dataset` items to simulate `dict.items()`.
`iterall`()	Iterate through the `Dataset`, yielding all the elements.
`keys`()	Return the `Dataset` keys to simulate `dict.keys()`.
`overlay_array`(group)	Return the Overlay Data in group as a `numpy.ndarray`.
`pop`(key, *args)	Emulate `dict.pop()` with support for tags and keywords.
`popitem`()	Emulate `dict.popitem()`.
`private_block`(group, private_creator[, create])	Return the block for the given tag group and private_creator.
`private_creators`(group)	Return a list of private creator names in the given group.
`remove_private_tags`()	Remove all private elements from the `Dataset`.
`save_as`(filename[, write_like_original])	Write the `Dataset` to filename.
`set_original_encoding`(is_implicit_vr, ...)	Set the values for the original transfer syntax and encoding.
`setdefault`(key[, default])	Emulate `dict.setdefault()` with support for tags and keywords.
`to_json`([bulk_data_threshold, ...])	Return a JSON representation of the `Dataset`.
`to_json_dict`([bulk_data_threshold, ...])	Return a dictionary representation of the `Dataset` conforming to the DICOM JSON Model as described in the DICOM Standard, Part 18, Annex F.
`top`()	Return a `str` representation of the top level elements.
`trait_names`()	Return a `list` of valid names for auto-completion code.
`update`(d)	Extend `dict.update()` to handle DICOM tags and keywords.
`validate`(init_value)	Raise errors if initialization value is not acceptable for file_meta
`values`()	Return the `Dataset` values to simulate `dict.values()`.
`walk`(callback[, recursive])	Iterate through the `Dataset's` elements and run callback on each.
`waveform_array`(index)	Return an `ndarray` for the multiplex group at index in the (5400,0100) Waveform Sequence.

Attributes

`default_element_format`
`default_sequence_element_format`
`indent_chars`
`is_implicit_VR`
`is_little_endian`
`is_original_encoding`	Return `True` if the encoding to be used for writing is set and is the same as that used to originally encode the `Dataset`.
`original_character_set`	Return the original character set encoding for a dataset decoded from a file or buffer.
`original_encoding`	Return the original encoding used for a dataset decoded from a file or buffer.
`pixel_array`	Return the pixel data as a `numpy.ndarray`.
`read_encoding`
`read_implicit_vr`	Get the VR method used by the original encoding of the dataset.
`read_little_endian`	Get the endianness used by the original encoding of the dataset.

static validate(init_value: Dataset | MutableMapping[BaseTag, DataElement | RawDataElement]) → None[source]¶

Raise errors if initialization value is not acceptable for file_meta

Parameters:

init_value (dict or Dataset) – The tag:data element pairs to initialize a file meta dataset

Raises:

TypeError – If the passed argument is not a dict or Dataset
ValueError – If any data elements passed are not group 2.