o
i. @ s d Z ddlmZmZ zddlZdZW n ey dZY nw ddlm Z ddl
m Z m Z m
Z
ddlZer:ddlmZ d Zd
d iZejjejjejjejjgZd efd
dZdejj d efddZ ddd efddZ ddd efddZ d ddded dfddZ dS ) a Use the `numpy `_ package to convert supported pixel
data to a :class:`numpy.ndarray`.
**Supported transfer syntaxes**
* 1.2.840.10008.1.2 : Implicit VR Little Endian
* 1.2.840.10008.1.2.1 : Explicit VR Little Endian
* 1.2.840.10008.1.2.1.99 : Deflated Explicit VR Little Endian
* 1.2.840.10008.1.2.2 : Explicit VR Big Endian
**Supported data**
The numpy handler supports the conversion of data in the (7FE0,0008) *Float
Pixel Data*, (7FE0,0009) *Double Float Pixel Data* and (7FE0,0010)
*Pixel Data* elements to a :class:`~numpy.ndarray` provided the
related :dcm:`Image Pixel`, :dcm:`Floating Point
Image Pixel` or :dcm:`Double Floating Point Image
Pixel` module elements have values given in the
table below.
+------------------------------------------------+---------------+----------+
| Element | Supported | |
+-------------+---------------------------+------+ values | |
| Tag | Keyword | Type | | |
+=============+===========================+======+===============+==========+
| (0028,0002) | SamplesPerPixel | 1 | N | Required |
+-------------+---------------------------+------+---------------+----------+
| (0028,0004) | PhotometricInterpretation | 1 | MONOCHROME1, | Required |
| | | | MONOCHROME2, | |
| | | | RGB, | |
| | | | YBR_FULL, | |
| | | | YBR_FULL_422 | |
+-------------+---------------------------+------+---------------+----------+
| (0028,0006) | PlanarConfiguration | 1C | 0, 1 | Optional |
+-------------+---------------------------+------+---------------+----------+
| (0028,0008) | NumberOfFrames | 1C | N | Optional |
+-------------+---------------------------+------+---------------+----------+
| (0028,0010) | Rows | 1 | N | Required |
+-------------+---------------------------+------+---------------+----------+
| (0028,0011) | Columns | 1 | N | Required |
+-------------+---------------------------+------+---------------+----------+
| (0028,0100) | BitsAllocated | 1 | 1, 8, 16, 32, | Required |
| | | | 64 | |
+-------------+---------------------------+------+---------------+----------+
| (0028,0101) | BitsStored | 1 | 1, 8, 12, 16 | Optional |
+-------------+---------------------------+------+---------------+----------+
| (0028,0103) | PixelRepresentation | 1C | 0, 1 | Optional |
+-------------+---------------------------+------+---------------+----------+
)
TYPE_CHECKINGcastNTF) warn_and_log) pixel_dtypeget_expected_length unpack_bits)DatasetNumpynumpy)zhttps://numpy.org/NumPyreturnc C s t S )z8Return ``True`` if the handler has its dependencies met.)HAVE_NP r r _/mnt/sdb/aimis/docanh/lib/python3.10/site-packages/pydicom/pixel_data_handlers/numpy_handler.py is_availableW s r transfer_syntaxc C s | t v S )zReturn ``True`` if the handler supports the `transfer_syntax`.
Parameters
----------
transfer_syntax : uid.UID
The Transfer Syntax UID of the *Pixel Data* that is to be used with
the handler.
)SUPPORTED_TRANSFER_SYNTAXES)r r r r supports_transfer_syntax\ s r dsr c C dS )zReturn ``True`` if the *Pixel Data* should to be converted from YCbCr to
RGB.
This affects JPEG transfer syntaxes.
Fr r r r r needs_to_convert_to_RGBh r c C r )zReturn ``True`` if the *Photometric Interpretation* should be changed
to RGB.
This affects JPEG transfer syntaxes.
Fr r r r r .should_change_PhotometricInterpretation_to_RGBq r r read_only
np.ndarrayc s& j j}|tvr tdg d} fdd|D }t|dkr#tdg d}|d d kr4|d
d g fd d|D }|rHtd
d| jdkrVt dsVtdt
|d }t }t|} ||d }
| |
k r| |krxt d n>t
d| d|
d| |
krd| d| | d} jdkr|d d |d d d } | | krd| d| d } t | jdkrt d d }
td t|d d!d"|
}nt d#|d v d$} jd s|jdkr|d d kr d% jd&kr|jd"d' d( }tj||d) }tj|d"| |d)}n tj|d"| |d)} jdkr|tj|d d |d)}|d"d"d* |d"d"d+< |dd"d* |dd"d+< |dd"d* |dd"d* |dd"d+< |d*d"d+< |dd"d* |dd"d* |dd"d+< |d,d"d+< |}t rd- _|s jdkr| S |S ).a Return a :class:`numpy.ndarray` of the pixel data.
Parameters
----------
ds : Dataset
The :class:`Dataset` containing an Image Pixel, Floating Point Image
Pixel or Double Floating Point Image Pixel module and the
*Pixel Data*, *Float Pixel Data* or *Double Float Pixel Data* to be
converted. If (0028,0004) *Photometric Interpretation* is
`'YBR_FULL_422'` then the pixel data will be
resampled to 3 channel data as per Part 3, :dcm:`Annex C.7.6.3.1.2
` of the DICOM Standard.
read_only : bool, optional
If ``False`` (default) then returns a writeable array that no longer
uses the original memory. If ``True`` and the value of (0028,0100)
*Bits Allocated* > 1 then returns a read-only array that uses the
original memory buffer of the pixel data. If *Bits Allocated* = 1 then
always returns a writeable array.
Returns
-------
np.ndarray
The contents of (7FE0,0010) *Pixel Data*, (7FE0,0008) *Float Pixel
Data* or (7FE0,0009) *Double Float Pixel Data* as a 1D array.
Raises
------
AttributeError
If `ds` is missing a required element.
NotImplementedError
If `ds` contains pixel data in an unsupported format.
ValueError
If the actual length of the pixel data doesn't match the expected
length.
ziUnable to convert the pixel data as the transfer syntax is not supported by the numpy pixel data handler.) PixelDataFloatPixelDataDoubleFloatPixelDatac s g | ]}| v r|qS r r ).0kwr r r
z!get_pixeldata.. zUnable to convert the pixel data: one of Pixel Data, Float Pixel Data or Double Float Pixel Data must be present in the dataset)
BitsAllocatedRowsColumnsSamplesPerPixelPhotometricInterpretationr r PixelRepresentation
BitsStoredc s g | ]}| vr|qS r r )r elemr r r r! r" zbUnable to convert the pixel data as the following required elements are missing from the dataset: z, PlanarConfigurationzUnable to convert the pixel data as the following conditionally required element is missing from the dataset: PlanarConfiguration z s4 3