pydicom｜Dataset.get_item の使い方

pydicomのDataset.get_item の使い方について記載しています。

pydicom.dataset.get_item

１．概要

引数で指定されたkeyに一致するRawDataElement、もしくはDataElementを返します。
プライベートタグなどは、DataElement が返されます。

２．引数

get_item(key)

key：pydicom.tag.Tag
pydicom.tag.Tag で表現されるタグで指定します。
例えば、PatientNameの場合は、[0x0010,0x0010]、（0x10,0x10）、0x00100010 で指定します。

３．戻り値

keyに一致するDataElementが存在する場合は、一致する要素がpydicom.dataelem.RawDataElement もしくは pydicom.dataelem.DataElement で返されます。

４．使用例

import pydicom
from pydicom.data import get_testdata_files
from pydicom.dataelem import DataElement

filename = get_testdata_files('JPEG-lossy.dcm')[0]
ds = pydicom.dcmread(filename)

# 戻り値は pydicom.dataelem.RawDataElement が返されます。
ds.get_item(0x00100010)
# RawDataElement(tag=(0010, 0010), VR='PN', length=22, value=b'CompressedSamples^NM1 ', value_tell=1500, is_implicit_VR=False, is_little_endian=True)

# プライベートタグを追加して取得します。
# 戻り値は pydicom.dataelem.DataElement が返されます。
ds.add(DataElement(0x00090001, 'SH', 'private data1'))
ds.get_item(0x00090001)
# (0009, 0001) Private Creator                     SH: 'private data1'

import pydicom

from pydicom.data import get_testdata_files

from pydicom.dataelem import DataElement

filename = get_testdata_files('JPEG-lossy.dcm')[0]

ds = pydicom.dcmread(filename)

# 戻り値は pydicom.dataelem.RawDataElement が返されます。

ds.get_item(0x00100010)

# RawDataElement(tag=(0010, 0010), VR='PN', length=22, value=b'CompressedSamples^NM1 ', value_tell=1500, is_implicit_VR=False, is_little_endian=True)

# プライベートタグを追加して取得します。

# 戻り値は pydicom.dataelem.DataElement が返されます。

ds.add(DataElement(0x00090001, 'SH', 'private data1'))

ds.get_item(0x00090001)

# (0009, 0001) Private Creator SH: 'private data1'