echoscp#

$ python -m pynetdicom echoscp [options] port

Description#

The echoscp application implements a Service Class Provider (SCP) for the Verification service class. It listens for incoming association requests on the specified port, and once an association is established, responds to incoming C-ECHO requests. The application can be used to verify basic DICOM connectivity.

The source code for the application can be found here

Usage#

The following example shows what happens when it’s started and receives a C-ECHO request from a peer:

$ python -m pynetdicom echoscp 11112

More information is available when running with the -v option:

$ python -m pynetdicom echoscp 11112 -v
I: Accepting Association
I: Received Echo Request (MsgID 1)
I: Association Released

When a peer AE attempts to send non C-ECHO message:

$ python -m pynetdicom echoscp 11112 -v
I: Accepting Association
I: Association Aborted

Much more information is available when running with the -d option:

$ python -m pynetdicom echoscp 11112 -d
D: echoscp.py v0.7.0
D:
D: Request Parameters:
D: ======================= INCOMING A-ASSOCIATE-RQ PDU ========================
D: Their Implementation Class UID:      1.2.276.0.7230010.3.0.3.6.2
...
I: Received Echo Request (MsgID 1)
D: ========================== INCOMING DIMSE MESSAGE ==========================
D: Message Type                  : C-ECHO RQ
D: Presentation Context ID       : 1
D: Message ID                    : 1
D: Data Set                      : None
D: ============================ END DIMSE MESSAGE =============================
I: Association Released

Options#

General Options#

-q --quiet: quiet mode, prints no warnings or errors
-v --verbose: verbose mode, prints processing details
-d --debug: debug mode, prints debugging information
-ll --log-level [l]evel (str): One of ['critical', 'error', 'warning', 'info', 'debug'], prints logging messages with corresponding level or lower

Network Options#

-aet --ae-title [a]etitle (str): set the local AE title (default: ECHOSCP)
-ta --acse-timeout [s]econds (float): timeout for ACSE messages (default: 30)
-td --dimse-timeout [s]econds (float): timeout for DIMSE messages (default: 30)
-tn --network-timeout [s]econds (float): timeout for the network (default: 30)
-pdu --max-pdu [n]umber of bytes (int): set maximum receive PDU bytes to n bytes (default: 16382)

Preferred Transfer Syntaxes#

-x= --prefer-uncompr: prefer explicit VR local byte order
-xe --prefer-little: prefer explicit VR little endian transfer syntax
-xb --prefer-big: prefer explicit VR big endian transfer syntax
-xi --implicit: accept implicit VR little endian transfer syntax only

DICOM Conformance#

The echoscp application supports the Verification service as an SCP. The following SOP classes are supported:

Verification Service#

SOP Classes#

UID	SOP Class
1.2.840.10008.1.1	Verification SOP Class

Transfer Syntaxes#

UID	Transfer Syntax
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
1.2.840.10008.1.2.4.50	JPEG Baseline (Process 1)
1.2.840.10008.1.2.4.51	JPEG Extended (Process 2 and 4)
1.2.840.10008.1.2.4.57	JPEG Lossless, Non-Hierarchical (Process 14)
1.2.840.10008.1.2.4.70	JPEG Lossless, Non-Hierarchical, First-Order Prediction (Process 14 [Selection Value 1])
1.2.840.10008.1.2.4.80	JPEG-LS Lossless Image Compression
1.2.840.10008.1.2.4.81	JPEG-LS Lossy (Near-Lossless) Image Compression
1.2.840.10008.1.2.4.90	JPEG 2000 Image Compression (Lossless Only)
1.2.840.10008.1.2.4.91	JPEG 2000 Image Compression
1.2.840.10008.1.2.4.92	JPEG 2000 Part 2 Multi-component Image Compression (Lossless Only)
1.2.840.10008.1.2.4.93	JPEG 2000 Part 2 Multi-component Image Compression
1.2.840.10008.1.2.5	RLE Lossless