Pydicom 2.1.1

依赖项

pydicom

安装当前版本

使用 pip

pip install -U pynetdicom

使用 conda

conda install -c conda-forge pynetdicom

有关更详细的说明，包括如何安装当前开发版本，请参阅 安装指南。

SCU 服务

当 AE 作为 SCU 行事并已与对等 SCP 建立关联时，以下 DIMSE-C 和 -N 服务可用

其中 dataset 是 pydicom 数据集 对象，query_model 是 UID 字符串，identifier_list 是 pydicom 标签 对象的列表，event_type 和 action_type 是整数，class_uid 和 instance_uid 是 UID 字符串。有关更多信息，请参阅 关联文档。

SCP 服务

当 AE 作为 SCP 行事时，一旦建立关联，以下 DIMSE-C 和 -N 服务即可供对等方使用

除C-ECHO服务外，必须将用户定义的可调用函数handler绑定到相应的干预事件，以完成DIMSE服务请求。事件可以通过from pynetdicom import evt导入，并通过AE.start_server()和AE.associate()中的evt_handlers关键字参数在建立关联之前将handler绑定到事件。

当事件发生时，将调用handler函数并传递一个名为event的单个参数，它是一个Event对象，其特定属性取决于发生的事件类型。绑定到干预事件的handler必须返回或产生某些值。请参阅handler文档，了解每个事件类型在Event中可用的属性和属性，以及对应handler的预期返回/产生值。

回波SCU

向验证SCP（在TCP/IP地址addr，监听端口port）发送C-ECHO请求

from pynetdicom import AE

ae = AE(ae_title='MY_ECHO_SCU')
# Verification SOP Class has a UID of 1.2.840.10008.1.1
#   we can use the UID str directly when adding the requested
#   presentation context
ae.add_requested_context('1.2.840.10008.1.1')

# Associate with a peer AE
assoc = ae.associate(addr, port)

if assoc.is_established:
    # Send a DIMSE C-ECHO request to the peer
    status = assoc.send_c_echo()

    # Print the response from the peer
    if status:
        print('C-ECHO Response: 0x{0:04x}'.format(status.Status))

    # Release the association
    assoc.release()

回波SCP

在端口11112上创建阻塞式回波SCP（如果您想返回除0x0000 成功状态之外的内容，可以可选地将handler绑定到evt.EVT_C_ECHO事件）

from pynetdicom import AE, VerificationPresentationContexts

ae = AE(ae_title='MY_ECHO_SCP')
# Or we can use the inbuilt VerificationPresentationContexts list,
#   there's one for each of the supported Service Classes
# In this case, we are supporting any requests to use Verification SOP
#   Class in the association
ae.supported_contexts = VerificationPresentationContexts

# Start the SCP on (host, port) in blocking mode
ae.start_server(("localhost", 11112), block=True)

或者，您可以以非阻塞模式启动SCP，这会返回正在运行的服务器实例。当您想在同一AE中运行存储SCP并发出C-MOVE请求时，这非常有用。

在下一个示例中，我们将创建一个非阻塞的验证SCP，并绑定一个处理C-ECHO服务请求事件evt.EVT_C_ECHO的handler，该handler记录请求者的地址和端口以及事件的日期和时间。

import logging

from pynetdicom import AE, evt, debug_logger
from pynetdicom.sop_class import Verification

# Setup logging to use the StreamHandler at the debug level
debug_logger()

ae = AE(ae_title='MY_ECHO_SCP')
ae.add_supported_context(Verification)

# Implement the EVT_C_ECHO handler
def handle_echo(event, logger):
    """Handle a C-ECHO service request.

    Parameters
    ----------
    event : evt.Event
        The C-ECHO service request event, this parameter is always
        present.
    logger : logging.Logger
        The logger to use, this parameter is only present because we
        bound ``evt.EVT_C_ECHO`` using a 3-tuple.

    Returns
    -------
    int or pydicom.dataset.Dataset
        The status returned to the peer AE in the C-ECHO response.
        Must be a valid C-ECHO status value as either an ``int`` or a
        ``Dataset`` object containing an (0000,0900) *Status* element.
    """
    # Every *Event* includes `assoc` and `timestamp` attributes
    #   which are the *Association* instance the event occurred in
    #   and the *datetime.datetime* the event occurred at
    requestor = event.assoc.requestor
    timestamp = event.timestamp.strftime("%Y-%m-%d %H:%M:%S")
    msg = (
        "Received C-ECHO service request from ({}, {}) at {}"
        .format(requestor.address, requestor.port, timestamp)
    )
    logger.info(msg)

    # Return a *Success* status
    return 0x0000

# By binding using a 3-tuple we can pass extra arguments to
#   the handler
handlers = [(evt.EVT_C_ECHO, handle_echo, [logging.getLogger('pynetdicom')])]

# Start the SCP in non-blocking mode
scp = ae.start_server(("localhost", 11112), block=False, evt_handlers=handlers)

# Associate and send a C-ECHO request to our own Verification SCP
ae.add_requested_context(Verification)
assoc = ae.associate('localhost', 11112)
if assoc.is_established:
    status = assoc.send_c_echo()
    assoc.release()

# Shutdown the SCP
scp.shutdown()

存储SCU

将DICOM CT图像存储数据集从file-in.dcm发送到对等存储SCP（在TCP/IP地址addr，监听端口port）

from pydicom import dcmread
from pydicom.uid import ImplicitVRLittleEndian

from pynetdicom import AE, VerificationPresentationContexts
from pynetdicom.sop_class import CTImageStorage, MRImageStorage

ae = AE(ae_title='MY_STORAGE_SCU')
# We can also do the same thing with the requested contexts
ae.requested_contexts = VerificationPresentationContexts
# Or we can use inbuilt objects like CTImageStorage.
# The requested presentation context's transfer syntaxes can also
#   be specified using a str/UID or list of str/UIDs
ae.add_requested_context(CTImageStorage,
                         transfer_syntax=ImplicitVRLittleEndian)
# Adding a presentation context with multiple transfer syntaxes
ae.add_requested_context(MRImageStorage,
                         transfer_syntax=[ImplicitVRLittleEndian,
                                          '1.2.840.10008.1.2.1'])

assoc = ae.associate(addr, port)
if assoc.is_established:
    dataset = dcmread('file-in.dcm')
    # `status` is the response from the peer to the store request
    # but may be an empty pydicom Dataset if the peer timed out or
    # sent an invalid dataset.
    status = assoc.send_c_store(dataset)

    assoc.release()