o ij@sdZddlZddlmZddlmZmZddlmZm Z m Z m Z ddl m Z mZddlmZddlmZmZdd lmZmZdd lmZmZdd lmZdd lmZdd lmZddl m!Z!ddl"m#Z#m$Z$m%Z%ddl&Zddl'Zddl'm(Z(m)Z)m*Z*m+Z+m,Z,m-Z-m.Z/m0Z0erddl1Z1ddl'm2Z2e dZ3 d^de4dee4ge3fdBde3e e3BfddZ5d_de6de7de8de%fddZ9 d^de6de7de4dBde4e e4BfddZ: d^de6de7de4dBde%e e%Bfd d!Z;d"e4de(fd#d$Z< d^de6de7de4dBde4e(Be e4Be e(Bfd%d&Z= d^de6de7de4dBdeej>j?e ej>j?d'd(ffd)d*Z@d"e4de)fd+d,ZA d^de6de7de4dBde4e)Be e4Be e)Bfd-d.ZB d^de6de7de4dBdee,e e,d/d(ffd0d1ZCde6de7de4de4e8BeDBe e8Be eDBfd2d3ZE d^de6de7de4dBde6fd4d5ZF d^de6de7de4dBde6fd6d7ZG d^de6de7de4dBde6fd8d9ZH d^de6d:eIe4dBde2e e2Bfd;d<ZJ d^de6de7de4dBde4e e4Bfd=d>ZK d`de6d:eIe4dBd?e4dBde4e e4Bfd@dAZL  d`de6d:eIe4dBd?e4dBde4fdBdCZM  dade6dDe7de7dEeIe4dBde8de!f dFdGZNd"e4de*fdHdIZO d^de6de7de4dBde4e*Be e4Be e*BfdJdKZP d^de6de7de4dBdejQjRe ejQjRBfdLdMZS d^de6de7de4dBde6fdNdOZT d^de6de7de4dBde4fdPdQZU d^dRe4dSed:e4e e4BdBde e e BfdTdUZVe/jWe/jXe/jYe/jZe/j[e/j\e/j]e/j^e/j_e/j`e/j(e/j*e/jae/j,e/jbe/jce/jde/jee/jfe/jge/j)e/jhgZiie/jje:e/jkeKe/jfe;e/jleKe/j(e=e/jbe@e/j)eBe/j]eEdVfe/j\eEdWfe/j,eCe/jmeLe/jceMe/j_eFe/jneFe/j^eGe/joeFe/jgeGie/jpeHe/jaeJe/jWeLe/jYeEdXfe/jdeNe/j[eEdYfe/jqeMe/jreEdZfe/j*ePe/jseLe/j`eSe/jXeEd[fe/jeeTe/jteUe/jZeEd\fe/jheMe/jueEd]fe/jveFe/jweGe/jxeGe/jyeGiZzdS)bzQFunctions for converting values of DICOM data elements to proper python types N)BytesIO)unpackcalcsize)UnioncastAnyTypeVar)MutableSequenceCallable)config)default_encoding decode_bytes)logger have_numpy)empty_value_for_VRRawDataElement)BytesLengthException) read_sequence) MultiValue)Sequence)TagTupleTagBaseTag)DADTTMTEXT_VR_DELIMSISCUSTOMIZABLE_CHARSET_VRVRvalidate_value) PersonName_TvalvaltypereturncCsN|durtttgtft}|dd}t|dkr"||dSt||S)aSplit a string by delimiters if there are any Parameters ---------- val : str The string to split up. valtype : type or callable, optional Default :class:`str`, but can be e.g. :class:`~pydicom.uid.UID` to overwrite to a specific type. Returns ------- valtype or MultiValue[valtype] The split value as `valtype` or a :class:`~pydicom.multival.MultiValue` of `valtype`. Nz \r)rr strr"rstripsplitlenr)r#r$itemsr-D/mnt/sdb/aimis/docanh/lib/python3.10/site-packages/pydicom/values.py multi_string-s"r/ byte_stringis_little_endianoffsetcCsLt|dkr td|rdnd}ttttft||||d}t|S)a(Return a decoded :class:`BaseTag` from the encoded `byte_string`. `byte_string` must be at least 4 bytes long. Parameters ---------- byte_string : bytes The encoded tag. is_little_endian : bool ``True`` if the encoding is little endian, ``False`` otherwise. offset : int, optional The byte offset in `byte_string` to the start of the tag. Returns ------- BaseTag The decoded tag. Raises ------ ValueError If `byte_string` is too short. z6byte string too short - must be at least 4 bytes long.zHH)r+ ValueErrorrtupleintrr)r0r1r2fmtvaluer-r-r. convert_tagIs  $r9 struct_formatcCs<|td}dd|D}t|dkr|dStt|S)aReturn a decoded 'AE' value. Elements with VR of 'AE' have non-significant leading and trailing spaces. Parameters ---------- byte_string : bytes The encoded 'AE' element value. is_little_endian : bool ``True`` if the value is encoded as little endian, ``False`` otherwise. struct_format : str, optional Not used. Returns ------- str The decoded 'AE' value without non-significant spaces. r&cSsg|]}|qSr-)strip).0sr-r-r. ~z%convert_AE_string..r'r)decoder r*r+rr()r0r1r:valuesr-r-r.convert_AE_stringgs   rBcsdt}|dkr tS|ddkr!td|||d8}ttfddtd|dDS)a|Return a decoded 'AT' value. Parameters ---------- byte_string : bytes The encoded 'AT' element value. is_little_endian : bool ``True`` if the value is encoded as little endian, ``False`` otherwise. struct_format : str, optional Not used. Returns ------- BaseTag or MultiValue of BaseTag The decoded value(s). r3rzs z#convert_ATvalue..)r+r9rwarningrrrange)r0r1r:lengthr-rDr.convert_ATvalues     rHr8cCs t|SN)rr))r8r-r-r. _DA_from_strs rJcCDtjr|td}t|dkrt|dStt|St|||S)adReturn a decoded 'DA' value. Parameters ---------- byte_string : bytes The encoded 'DA' element value. is_little_endian : bool ``True`` if the value is encoded as little endian, ``False`` otherwise. struct_format : str, optional Not used. Returns ------- str or MultiValue of str or valuerep.DA or MultiValue of valuerep.DA If :attr:`~pydicom.config.datetime_conversion` is ``True`` then returns either :class:`~pydicom.valuerep.DA` or a :class:`list` of ``DA``, otherwise returns :class:`str` or ``list`` of ``str``. r&r'r) r datetime_conversionr@r r*r+rJrconvert_stringr0r1r:splitupr-r-r.convert_DA_string     rPz numpy.float64 numpy.ndarraycCs|t}tjr<=rzQExpected total bytes to be an even multiple of bytes per value. Instead received bytesz with length z and struct format 'z*' which corresponds to bytes per value of .rTr')rr+rreprrlist)r0r1r: endianCharbytes_per_valuerG format_stringr8r-r-r.convert_numberszs,     r|cC|S)z,Return encoded 'OB' value as :class:`bytes`.r-r0r1r:r-r-r.convert_OBvaluercC t||S)z^Return the encoded 'OW' value as :class:`bytes`. No byte swapping will be performed. rr~r-r-r.convert_OWvalue rcCr)z^Return the encoded 'OV' value as :class:`bytes`. No byte swapping will be performed. rr~r-r-r.convert_OVvaluerr encodingscsbptgdtdtffdd }|d}t|t}|d}t|dkr,||dSt||S) afReturn a decoded 'PN' value. Parameters ---------- byte_string : bytes The encoded 'PN' element value. encodings : list of str, optional A list of the character encoding schemes used to encode the 'PN' value. Returns ------- valuerep.PersonName or MultiValue of PersonName The decoded 'PN' value(s). rCr%cst|}||SrI)r!encoder@)rC person_namerr-r. get_valtypes zconvert_PN..get_valtypes r&r'r) r r(r!r)r rr*r+r)r0rrstripped_string decoded_value value_splitr-rr. convert_PNs       rcCst|tS)aReturn a decoded string VR value. String VRs are 'AE', AS', 'CS' and optionally (depending on :ref:`pydicom.config `) 'DA', 'DT', and 'TM'. Parameters ---------- byte_string : bytes The encoded text VR element value. is_little_endian : bool ``True`` if the value is encoded as little endian, ``False`` otherwise. struct_format : str, optional Not used. Returns ------- str or MultiValue of str The decoded value(s). )r/r@r r~r-r-r.rMrMvrcsfdtdtffdd |ptg}t||t}|d}fdd|D}t|dkr.|d Stt|S) aReturn a decoded text VR value. Text VRs are 'SH', 'LO' and 'UC'. Parameters ---------- byte_string : bytes The encoded text VR element value. encodings : list of str, optional A list of the character encoding schemes used to encode the value. vr : str The value representation of the element. Needed for validation. Returns ------- str or list of str The decoded value(s). vr%cs"dur t|tjj|dS)N )r r settingsreading_validation_moder))r)rr-r. handle_value%s z"convert_text..handle_valuer&csg|]}|qSr-r-)r<r8)rr-r.r>-r?z convert_text..r'r)r(r r rr*r+r)r0rrdecoded_stringrA as_stringsr-)rrr. convert_texts     rcCs8|ptg}t||t}|durt||tjj|dS)aReturn decoded text, ignoring backslashes and trailing spaces. Parameters ---------- byte_string : bytes The encoded string. encodings : list of str, optional A list of the character encoding schemes used to encode the text. vr : str The value representation of the element. Needed for validation. Returns ------- str The decoded text. Nr)r r rr r rrr))r0rrr8r-r-r.convert_single_string3s   ris_implicit_VRencodingcCs,|ptg}t|}t|||t|||}|S)aReturn a decoded 'SQ' value. Parameters ---------- byte_string : bytes The encoded 'SQ' element value. is_implicit_VR : bool ``True`` if the value is encoded as implicit VR, ``False`` otherwise. is_little_endian : bool ``True`` if the value is encoded as little endian, ``False`` otherwise. encoding : list of str, optional The character encoding scheme(s) used to encoded any text VR elements within the sequence value. ``'iso8859'`` is used by default. offset : int, optional The byte offset in `byte_string` to the start of the sequence value. Returns ------- sequence.Sequence The decoded sequence. )r rrr+)r0rr1rr2rfpseqr-r-r. convert_SQOs rcCs@|}t|}|dks|dkr|dkrtd|t|S)Nrz-Expected length between 2 and 16, got length )r)r+rrErrjr-r-r. _TM_from_strss rcCsBtjr|td}t|dkrt|dStt|St||S)aXReturn a decoded 'TM' value. Parameters ---------- byte_string : bytes The encoded 'TM' element value. is_little_endian : bool ``True`` if the value is encoded as little endian, ``False`` otherwise. struct_format : str, optional Not used. Returns ------- str or list of str or valuerep.TM or list of valuerep.TM If :attr:`~pydicom.config.datetime_conversion` is ``True`` then returns either :class:`~pydicom.valuerep.TM` or a :class:`list` of ``TM``, otherwise returns :class:`str` or ``list`` of ``str``. r&r'r) r rLr@r r*r+rrrMrNr-r-r.convert_TM_string|s     rcCs|t}t|dtjjS)aReturn a decoded 'UI' value. Elements with VR of 'UI' may have a non-significant trailing null ``0x00``. Parameters ---------- byte_string : bytes The encoded 'UI' element value. is_little_endian : bool ``True`` if the value is encoded as little endian, ``False`` otherwise. struct_format : str, optional Not used. Returns ------- uid.UID or list of uid.UID The decoded 'UI' element value without trailing nulls or spaces. r)r@r r/r)rbuidUID)r0r1r:r8r-r-r. convert_UIs rcCr})z0Return the encoded 'UN' value as :class:`bytes`.r-r~r-r-r. convert_UNrrcCs|tS)aReturn a decoded 'UR' value. Elements with VR of 'UR' may not be multi-valued and trailing spaces are non-significant. Parameters ---------- byte_string : bytes The encoded 'UR' element value. is_little_endian : bool ``True`` if the value is encoded as little endian, ``False`` otherwise. struct_format : str, optional Not used. Returns ------- bytes or str The encoded 'UR' element value without any trailing spaces. )r@r r)r~r-r-r.convert_UR_stringrrrraw_data_elementc stvr4ttddttdd}td|vs"td|vr,ddd Dtd d |jdkr=tStt t tt rStt t\}}nt}d }|p]t g}t |t rf|g}|j}|j}|j}z,t jkr{|||WStvr|||WSt jkr||||WS||||||jWStytjjtjkrYnwtd |jddfdd tDD]} z t| ||WStyYqwtd|jd|jS)aReturn the element value decoded using the appropriate decoder. Parameters ---------- VR : str The element's VR. raw_data_element : pydicom.dataelem.RawDataElement The encoded element value. encodings : list of str, optional A list of the character encoding schemes used to encode any text elements. Returns ------- type or MultiValue of type The element value decoded using the appropriate decoder. A[a{rr' cSsg|] }dt|dqS)0x02x)ord)r<chr-r-r.r>sz!convert_value..zUnknown Value Representation ''NzUnable to convert tag z with VR z# using the standard value convertercsg|]}|kr|qSr-r-)r<r#rr-r.r>(sz Could not convert value for tag z1 with any VR in the 'convert_retry_VR_order' list) convertersrxrFrjoinNotImplementedErrorrGrrVR_ isinstancer5r r(r8r1rPNrSQ value_tellr4r rrRAISErdebugtagconvert_retry_VR_order convert_value Exception) rrr char_range converter num_formatr0r1rrr-rr.rsd           rdflhqLHQrI)r)NN)Nr){__doc__r\iorstructrrtypingrrrrcollections.abcr r rbr pydicom.charsetr r pydicom.configrrpydicom.dataelemrrpydicom.errorsrpydicom.filereaderrpydicom.multivalrpydicom.sequencer pydicom.tagrrr pydicom.uidpydicom.valuereprrrrrrrrr r`r!r"r(r/ruboolr6r9rBrHrJrPrcrdrhrkrlrrfloatr|rrrrxrrMrrrrrrrrrrrSHULSLUSSSFLFDOFOBUIrDSLTrUNATOWUTrAEASCSLOODOLOVSTSVUCURUVOB_OWUS_SSUS_OWUS_SS_OWrr-r-r-r.s      (        & !  G  ! ; =        $     &     $  !     `           ! "#