o iث@s"dZddlZddlmZmZddlmZmZmZddl m Z m Z m Z ddl Z ddlmZddlmZmZddlmZdd lmZdd lmZmZmZmZdd lmZmZmZdd l m!Z!dd l"m#Z#m$Z$ddl%m&Z&m'Z'm(Z(m)Z)ddl*m+Z+m,Z,ddl-m.Z.ddl/m0Z0m1Z1m2Z2m3Z3m4Z4ddl5Zddl6m7Z7ddl8m9Z9m:Z;dde;DZdBe?ge=fdBde?e>Be@BdBde>e e>BdeAe3e?BdBde eeBfddZBded e=de=de e3e>dBe?ge=fdBd!e=de=f d"d#ZCdddedd$fdede=de=d%e?dBde e3e>dBe?ge=fdBde>e?Be@BdBd&e>e e>BdeAe3e?BdBd'e=defd(d)ZD dNdede=de=d%e?de>e e>Bd*e?de.fd+d,ZE dNdede=de=de>e e>Bd*e?dedBf d-d.ZFdedefd/d0ZGdedefd1d2ZHd3e(defd4d5ZIded6e=deJdBfd7d8ZKd9e3d:e>dBd;e?de=fd dOd?ede e3e>dBe?ge=fdBde?e>Be@BdBd6e=deAe3e?BdBdef d@dAZM  > > dPde(eBe#Bde>e?Be@BdBdBe=d6e=de4dBdef dCdDZNde=dEe>dBde?fdFdGZOdHedIe(eBdJe@dBdKedef dLdMZPdS)QzRead a dicom media fileN)Structunpack)BinaryIOAnycast)CallableMutableSequenceIterator)config)default_encodingconvert_encodings)logger)_dictionary_vr_fast) DataElementRawDataElementconvert_raw_data_elementempty_value_for_VR)Dataset FileDatasetFileMetaDataset)InvalidDicomError)ReadableBuffer DicomBytesIO)read_undefined_length_valuepath_from_pathlikePathType _unpack_tag) size_in_bytes warn_and_log)Sequence)ItemTagSequenceDelimiterTagTagBaseTag TagListType) bytes2hex)EXPLICIT_VR_LENGTH_32VRcCsh|]}|tqS)encoder ).0vrr(r(H/mnt/sdb/aimis/docanh/lib/python3.10/site-packages/pydicom/filereader.py -sr-fpis_implicit_VRis_little_endian stop_when defer_sizeencoding specific_tagsreturnc!csddlm}d|}t|dj} |r| } nt|dj} t|dj} |j} |j} |j}tj}t j }t |}|rDdd|Dnt }t |}|rR|d  t| d }d kr_d S|ro|d d dt|}|r{d }| |\}}}ne| |\}}}}|tvr|t}|tvr| d}| |d}|r|dt|7}n;d|krdksnt jr|rtd|dd|dddd }| |\}}}n|t}|rtd|d|r|dd|dd|dd}|s|d|d7}|dkr|d|7}n|d 7}|||}|d!>|B}|d"kr d S|d urK|t|||rK|r5|d#d }|sC|tvrC|d7}| ||d S|dkr|r`||vr`| ||qR|d ur||kr|d krd }|rx|d$| ||n8|dkr| |n ttd Bt|d d%}|r|d&krd'nd(}|r|d d&nd)}|d*|t||||f|d kr|tt|pd)|}t|}tt|||||||Vn|tjkrt jj rtj!}|d us|tjkrt j"rzt#|}Wn t$yt%| d|}| |d|t&krtj!}Ynw|tj!krN|r0||d+d,t'|||||} |rA||vrAqRt(t||| |d d-Vn$|rU|d.t)||t*|}|re||vreqRtt|||||||VqS)/aCreate a generator to efficiently return the raw data elements. .. note:: This function is used internally - usually there is no need to call it from user code. To read data from a DICOM file, :func:`dcmread` shall be used instead. Parameters ---------- fp : file-like The file-like to read from. is_implicit_VR : bool ``True`` if the data is encoded as implicit VR, ``False`` otherwise. is_little_endian : bool ``True`` if the data is encoded as little endian, ``False`` otherwise. stop_when : None, callable, optional If ``None`` (default), then the whole file is read. A callable which takes tag, VR, length, and returns ``True`` or ``False``. If it returns ``True``, ``read_data_element`` will just return. defer_size : int, str or float, optional See :func:`dcmread` for parameter info. encoding : str | MutableSequence[str] Encoding scheme specific_tags : list or None See :func:`dcmread` for parameter info. Yields ------- RawDataElement or DataElement Yields DataElement for undefined length UN or SQ, RawDataElement otherwise. r)convert_stringz><HHLHH2sHLcSsh|]}|qSr(r()r*tagr(r(r,r-sz)data_element_generator..TN08x:  sAAsZZzUnknown VR '0x02xz' assuming implicit VR encodingz Unknown VR 'z2' assuming explicit VR encoding with 2-byte lengthz<47sz (04X,)zLength: z#Length: Undefined length (FFFFFFFF)l `zHReading ended by stop_when callback. Rewinding to start of data element.z;Defer size exceeded. Skipping forward to next data element.)raw...z z%08x: %-34s %s %r %s08Xz+: Reading/parsing undefined length sequence)is_undefined_lengthz%Reading undefined length data element)+pydicom.valuesr6rrreadseektellr debugr debuggingrsetbooladdlenr% ENCODED_VRdecoder r&assume_implicit_vr_switchwarningr#rbytesrr rVR_UNsettingsinfer_sq_for_un_vrSQreplace_un_with_known_vrrKeyErrorrr read_sequencerrr!)!r.r/r0r1r2r3r4r6 endian_chrimplicit_VR_unpackelement_struct_unpackextra_length_unpackfp_readfp_seekfp_tell logger_debugrStag_set has_tag_set bytes_read debug_msgr+groupelemlength value_tellr: rewind_lengthvaluedotdotdisplayed_valuenext_tagseqr(r(r,data_element_generator0s6 =                      r{implicit_vr_is_assumed is_sequencecCs|r|rdS|d}|d}t|dkr|Sd|dko#dkno3d|dko1dkn }||kr|r=dnd }t||} |t} |d urU|| | drU|S|r[|r[dS|r_d nd } |sed nd } d | d| d} tjjtjkr{t | t | d| dt |S)aCheck if the real VR is explicit or implicit. Parameters ---------- fp : an opened file object implicit_vr_is_assumed : bool True if implicit VR is assumed. If this does not match with the real transfer syntax, a user warning will be issued. is_little_endian : bool True if file has little endian transfer syntax. Needed to interpret the first tag. stop_when : None, optional Optional call_back function which can terminate reading. Needed to check if the next tag still belongs to the read dataset. is_sequence : bool True if called for a sequence, False for a top-level dataset. Returns ------- True if implicit VR is used, False otherwise. Tr?@r[rB<>Nimplicitexplicitz Expected z VR, but found z VRz - using z VR for reading) rOrWrrYr r r_reading_validation_modeRAISErr UserWarning)r.r|r0r1r} tag_bytesraw_vrfound_implicitrer:r+found_vr expected_vrmsgr(r(r,_is_implicit_vrPs,    :     rT bytelengthparent_encoding at_top_levelc  Csi} |j} |} t||||| d}|| t|||||||} z%|dur/dd| D} n| | |krFt| } | | | j<| | |ks6WnItyPYnAtyz}ztj j tj kr_t |dt |dd}t|tWYd}~nd}~wty}z t|WYd}~nd}~wwt| |d}d | vrtt| td }tt tt BdBt|j}t|}n|}|||||S) aReturn a :class:`~pydicom.dataset.Dataset` instance containing the next dataset in the file. Parameters ---------- fp : file-like An opened file-like object. is_implicit_VR : bool ``True`` if file transfer syntax is implicit VR. is_little_endian : bool ``True`` if file has little endian transfer syntax. bytelength : int, None, optional ``None`` to read until end of file or ItemDelimiterTag, else a fixed number of bytes to read stop_when : None, optional Optional call_back function which can terminate reading. See help for :func:`data_element_generator` for details defer_size : int, str or float, optional Size to avoid loading large elements in memory. See :func:`dcmread` for more parameter info. parent_encoding : str or List[str] Optional encoding to use as a default in case (0008,0005) *Specific Character Set* isn't specified. specific_tags : list of BaseTag, optional See :func:`dcmread` for parameter info. at_top_level: bool If dataset is top level (not within a sequence). Used to turn off explicit VR heuristic within sequences Returns ------- dataset.Dataset A Dataset instance. See Also -------- :class:`~pydicom.dataset.Dataset` A collection (dictionary) of DICOM :class:`~pydicom.dataelem.DataElement` instances. )r}NcSsi|]}|j|qSr()r:)r*er(r(r, z read_dataset..z in file namez )rr;)rQrrPr{nextr: StopIterationEOFErrorr r_rrstrgetattrrrNotImplementedErrorr errorrrrr#rrrvr set_original_encoding)r.r/r0rr1r2rr4rraw_data_elementsrkfp_startde_genraw_data_elementdetailsrdsrrchar_setr3r(r(r, read_datasets\3       roffsetc Csg}d}|dkrB|dkrd}d}|j}|} |r|| |krB|} t|||||} | dur/n| || _|| |r|| |kst|} || _| S)zRead and return a :class:`~pydicom.sequence.Sequence` -- i.e. a :class:`list` of :class:`Datasets`. FrrFTN)rQread_sequence_item file_tellappendrrM) r.r/r0rr3rrzrMrkfpStartrdatasetsequencer(r(r,rds*     rdc Cs||}|r dnd}z|d}t||\}} } Wnty.td||dw|| f} | tkrbtjr`t |d|dd| dkr`t d | dd |d |dd Stjr| t kr|t d t d|d |dnt |d |ddt |d| dkrt |||d |dd} d| _nt |||| |dd} d| _tjrt ||dd|| _| S)zuRead and return a single :class:`~pydicom.sequence.Sequence` item, i.e. a :class:`~pydicom.dataset.Dataset`. zHHLr<z No tag to read at file position Xr=z: End of Sequencerz-Expected 0x00000000 after delimiter, found 0xz, at position 0xr?Nz Expected sequence item with tag z at file position 0xr>z Found Item tag (start of item)rFF)rrrT)rrrLz: Finished sequence item)rQrOr BaseExceptionOSErrorr!r rSr rRr[r r%r!is_undefined_length_sequence_item seq_item_tell) r.r/r0r3rrtag_length_formatrorqelementrsr:rr(r(r,rsh     rcCs.dtdtdBdtdtfdd}t|dd|d S) akReturn a Dataset containing any Command Set (0000,eeee) elements in `fp`. Command Set elements are always Implicit VR Little Endian (DICOM Standard, Part 7, :dcm:`Section 6.3`). Once any Command Set elements are read `fp` will be positioned at the start of the next group of elements. Parameters ---------- fp : file-like The file-like positioned at the start of any command set elements. Returns ------- dataset.Dataset The command set elements as a Dataset instance. May be empty if no command set elements are present. r:r+Nrsr5cS |d?dkS)z?Return True if the tag is not in group 0x0000, False otherwise.rGrr(r:r+rsr(r(r,_not_group_0000| z3_read_command_set_elements.._not_group_0000Tr/r0r1)r#rintrUr)r.rr(r(r,_read_command_set_elementsgsrc CsdtdtdBdtdtfdd}|}tt|dd |d }|jdd td |j s*|Sz |t | d j Wn t yW||tt|d d |d }|jd d td Ynwd |vrw||d}|j}||krwtd|d|d|S)alReturn a Dataset containing any File Meta (0002,eeee) elements in `fp`. File Meta elements are always Explicit VR Little Endian (DICOM Standard, Part 10, :dcm:`Section 7`). Once any File Meta elements are read `fp` will be positioned at the start of the next group of elements. Parameters ---------- fp : file-like The file-like positioned at the start of any File Meta Information group elements. Returns ------- dataset.Dataset The File Meta elements as a Dataset instance. May be empty if no File Meta are present. r:r+Nrsr5cSr)z?Return True if the tag is not in group 0x0002, False otherwise.rGr~r(rr(r(r,_not_group_0002rz-_read_file_meta_info.._not_group_0002FTr)is_implicit_vrr0character_encodingrFileMetaInformationGroupLength z_read_file_meta_info: (0002,0000) 'File Meta Information Group Length' value doesn't match the actual File Meta Information length (z vs z bytes))r#rrrUrQrrrr _dictlistelementsr:rrPrr info)r.rstart_file_meta file_meta actual_lenelem_lenr(r(r,_read_file_meta_infosT   rfilenamecCs@t|d}t|dt|WdS1swYdS)aRead and return the DICOM file meta information only. This function is meant to be used in user code, for quickly going through a series of files to find one which is referenced to a particular SOP, without having to read the entire files. rbFN)open read_preambler)rr.r(r(r,read_file_meta_infos  $rforcecCstd|d}tjr.t|dddt|dd}t|ddd|td |d }|d krJ|rJtd |d dS|d krT|sTt dt|d dd|S)aPReturn the 128-byte DICOM preamble in `fp` if present. `fp` should be positioned at the start of the file-like. If the preamble and prefix are found then after reading `fp` will be positioned at the first byte after the prefix (byte offset 133). If either the preamble or prefix are missing and `force` is ``True`` then after reading `fp` will be positioned at the start of the file-like. Parameters ---------- fp : file-like object The file-like to read the preamble from. force : bool Flag to force reading of a file even if no header is found. Returns ------- preamble : bytes or None The 128-byte DICOM preamble will be returned if the appropriate prefix ('DICM') is found at byte offset 128. Returns ``None`` if the 'DICM' prefix is not found and `force` is ``True``. Raises ------ InvalidDicomError If `force` is ``False`` and no appropriate header information found. Notes ----- Also reads past the 'DICM' marker. Rewinds file to the beginning if no header found. z)Reading File Meta Information preamble...Nr<rJir=r>z'Reading File Meta Information prefix...r?sDICMzFile is not conformant with the DICOM File Format: 'DICM' prefix is missing from the File Meta Information header or the header itself is missing. Assuming no header and continuing.rzFile is missing DICOM File Meta Information header or the 'DICM' prefix is missing from the header. Use force=True to force reading.z: 'DICM' prefix found) r rRrOr rSr%rQrrPr)r.rpreamblesamplemagicr(r(r,rs& ! $     rr:r+rscCs|dvS)N> r(rr(r(r,_at_pixel_datasrFfileobjcCst||}t|}t|}|d}|dkr|ddd} d} |d} |dkr*n| durYtd|d\} } }|d dd d lm}| t }|| vrXd } | d krXd } n^| t j jkr`nW| t j jkrid } nN| t j jkrtd } d } nC| t j jkr|}t|dd}t|tj }t|}||_tt|}d } n| t j jvrt j j| }t j j|} | j} | j} nd } z t|| | |||d}Wntyt j!j"t j#kr҂Ynw|r|$|t%||||| | }|&| | |j'|S)aParse a DICOM file until a condition is met. Parameters ---------- fileobj : a file-like object Note that the file will not close when the function returns. stop_when : Stop condition. See :func:`read_dataset` for more info. defer_size : int, str or float, optional See :func:`dcmread` for parameter info. force : bool See :func:`dcmread` for parameter info. specific_tags : list or None See :func:`dcmread` for parameter info. Notes ----- Use :func:`dcmread` unless you need to stop on some condition other than reaching pixel data. Returns ------- dataset.FileDataset The read dataset. See Also -------- dcmread More generic file reading function. rBrKTTransferSyntaxUIDNz`. If the dataset is not stored in accordance with the File Format (i.e. the preamble and prefix are missing, there are missing required Type 1 *File Meta Information Group* elements or the entire *File Meta Information* is missing) then you will have to set `force` to ``True``. Examples -------- Read and return a dataset stored in accordance with the DICOM File Format: >>> ds = pydicom.dcmread("CT_small.dcm") >>> ds.PatientName Read and return a dataset not in accordance with the DICOM File Format: >>> ds = pydicom.dcmread("rtplan.dcm", force=True) >>> ds.PatientName Use within a context manager: >>> with pydicom.dcmread("rtplan.dcm") as ds: ... ds.PatientName Parameters ---------- fp : str, PathLike, file-like or readable buffer A file-like object, a string containing the file name or the path to the file or a buffer-like object. The buffer-like object must have ``seek()``, ``read()`` and ``tell()`` methods and the caller is responsible for closing it (if required). defer_size : int, str or float, optional If not used then all elements are read into memory. If specified, then if a data element's stored value is larger than `defer_size`, the value is not read into memory until it is accessed in code. Should be the number of bytes to be read as :class:`int` or as a :class:`str` with units, e.g. ``'512 KB'``, ``'2 MB'``. stop_before_pixels : bool, optional If ``False`` (default), the full file will be read and parsed. Set ``True`` to stop before reading (7FE0,0010) *Pixel Data* (and all subsequent elements). force : bool, optional If ``False`` (default), raises an :class:`~pydicom.errors.InvalidDicomError` if the file is missing the *File Meta Information* header. Set to ``True`` to force reading even if no *File Meta Information* header is found. specific_tags : list of (int or str or 2-tuple of int), optional If used the only the supplied tags will be returned. The supplied elements can be tags or keywords. Note that the element (0008,0005) *Specific Character Set* is always returned if present - this ensures correct decoding of returned text values. Returns ------- FileDataset An instance of :class:`~pydicom.dataset.FileDataset` that represents a parsed DICOM file. Raises ------ InvalidDicomError If `force` is ``False`` and the file is not a valid DICOM file. TypeError If `fp` is ``None`` or of an unsupported type. See Also -------- pydicom.dataset.FileDataset Data class that is returned. pydicom.filereader.read_partial Only read part of a DICOM file, stopping on given conditions. TFzReading file ''rNrOrPrQzEdcmread: Expected a file path, file-like or readable buffer, but got zQ --------------------------------------------------------------------------------zCall to dcmread()z filename: rzz , defer_size=z, stop_before_pixels=z, force=z, specific_tags=zCaller passed file objectzCaller passed file namezP--------------------------------------------------------------------------------cSsg|]}t|qSr()r")r*tr(r(r, -rzdcmread..)r2rr4)r isinstancerr rRrhasattr TypeErrortype__name__r rSrrrr#rrrrclose)r.r2rrr4caller_owns_filer1rr(r(r,dcmreadslR        rr'cCs|rdStt|tvr dSdS)zCReturn number of bytes from start of data element to start of valuer<r)rrr&)r/r'r(r(r,data_element_offset_to_valueDs r fileobj_typefilename_or_obj timestamp raw_data_elemc Cs,tjr td|j|durtdt|t}t|tr>tj |s,td|d|dur>t |}|j |kr>t d|rE||dn|}|j}|j}t||j} ||j| t|||dd} ttt| } |rp|| j|jkrtd | jd |j| j|jkrtd | jd |j| S) a3Read the previously deferred value from the file into memory and return a raw data element. .. note: This is called internally by pydicom and will normally not be needed in user code. Parameters ---------- fileobj_type : type The type of the original file object. filename_or_obj : str or file-like The filename of the original file if one exists, or the file-like object where the data element persists. timestamp : float or None The time (as given by stat.st_mtime) the original file has been read, if not a file-like. raw_data_elem : dataelem.RawDataElement The raw data element with no value set. Returns ------- dataelem.RawDataElement The data element with the value set. Raises ------ OSError If `filename_or_obj` is ``None``. OSError If `filename_or_obj` is a filename and the corresponding file does not exist. ValueError If the VR or tag of `raw_data_elem` does not match the read value. zReading deferred element Nz=Deferred read -- original filename not stored. Cannot re-openzDeferred read -- original file z is missingz;Deferred read warning -- file modification time has changedr)r2zDeferred read VR z does not match original zDeferred read tag )r rSr rRr:rrrospathexistsstatst_mtimerr/r0rr'rPrtr{rrrr ValueError) rrrr is_filenamestatinfor.r/r0relem_genrrr(r(r,read_deferred_data_elementOsL*          r )r)NNFN)NFFN)Q__doc__rstructrrtypingrrrcollections.abcrrr rrr pydicom.charsetr r pydicom.configr pydicom.datadictrpydicom.dataelemrrrrpydicom.datasetrrrpydicom.errorsrpydicom.filebaserrpydicom.fileutilrrrr pydicom.miscrrpydicom.sequencer pydicom.tagr r!r"r#r$ pydicom.uidpydicom.util.hexutilr%pydicom.valuerepr&r'r]rXrUrrfloatrr{rrrdrrrrr\rrrrrr r(r(r(r,sP         " K   j  )  HK ?