目次
pydicom.dataset.pop
1.概要
Datasetから引数で指定したkeyに該当する値を返します。
該当する値がない場合は、引数 d で指定した値を返します。もし、引数 d を指定しないで key に該当する値がない場合は、KeyError が発生します。
2.引数
pop(k[,d])
k
検索するkeyを指定します。
d
keyに該当する値が存在しない場合に、返す値を指定します。
3.戻り値
引数keyに該当するDataElement(rawDataElement or DataElement)が返されます。
4.例外
keyで指定した値がDatasetに存在しない、かつ 引数 d を指定していない場合は、KeyError が発生します。
5.使用例
Datasetにkeyが存在する
1 2 3 4 5 6 7 8 9 10 |
import pydicom from pydicom.data import get_testdata_files filename = get_testdata_files('JPEG-lossy.dcm')[0] ds = pydicom.dcmread(filename) ds.pop(0x00100010) # return # RawDataElement(tag=(0010, 0010), VR='PN', length=22, value=b'CompressedSamples^NM1 ', value_tell=1500, is_implicit_VR=False, is_little_endian=True) |
Datasetにkeyが存在しない(引数 d を指定)
1 2 3 4 5 6 7 8 9 10 |
import pydicom from pydicom.data import get_testdata_files filename = get_testdata_files('JPEG-lossy.dcm')[0] ds = pydicom.dcmread(filename) ds.pop(0x00110001,'Not found key value') # return # Not found key value |
Datasetにkeyが存在しない(引数 d を未指定:例外発生)
1 2 3 4 5 6 7 8 9 10 11 12 |
import pydicom from pydicom.data import get_testdata_files filename = get_testdata_files('JPEG-lossy.dcm')[0] ds = pydicom.dcmread(filename) try: ds.pop(0x00110001) except KeyError as ke: print('KeyErrorが発生しました。') # 例外が発生し、except KeyError の処理が行われます。 |