echoscu#
$ python -m pynetdicom echoscu [options] addr port
Description#
The echoscu
application implements a Service Class User (SCU) for the
Verification service class. It establishes an
association with a peer Application Entity (AE), sends a
C-ECHO request and waits for a
response. 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 is successfully run on
an SCP at IP 127.0.0.1
and listen port 11112
that supports the
Verification service:
$ python -m pynetdicom echoscu 127.0.0.1 11112
When attempting to send a C-ECHO request to an SCP that doesn’t support the Verification service:
$ python -m pynetdicom echoscu 127.0.0.1 11112
E: No accepted presentation contexts
When the association request is rejected by the SCP (in this case because the called AE title wasn’t recognised):
$ python -m pynetdicom echoscu 127.0.0.1 11112
E: Association Rejected
E: Result: Rejected Permanent, Source: Service User
E: Reason: Called AE title not recognised
When attempting to associate with a non-DICOM peer:
$ python -m pynetdicom echoscu 127.0.0.1 11112
E: Association request failed: unable to connect to remote
E: TCP Initialisation Error: Connection refused
More information is available with the -d
flag:
$ python -m pynetdicom echoscu 127.0.0.1 11112 -d
D: echoscu.py v0.7.0
D:
I: Requesting Association
D: Request Parameters:
D: ======================= OUTGOING A-ASSOCIATE-RQ PDU ========================
...
D: ========================== END A-ASSOCIATE-AC PDU ==========================
I: Association Accepted
I: Sending Echo Request: MsgID 1
D: pydicom.read_dataset() TransferSyntax="Little Endian Implicit"
I: Received Echo Response (Status: Success)
I: Releasing Association
Parameters#
addr
TCP/IP address or hostname of DICOM peer
port
TCP/IP port number of peer
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 --calling-aet [a]etitle (str)
set the local AE title (default:
ECHOSCU
)-aec --called-aet [a]etitle (str)
set the called AE title for the peer AE (default:
ANY-SCP
)-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
)
Transfer Syntax Options#
-xe --request-little
request explicit VR little endian TS only
-xb --request-big
request explicit VR big endian TS only
-xi --request-implicit
request implicit VR little endian TS only
Miscellaneous Options#
--repeat [n]umber (int)
repeat echo request
n
times--abort
abort association instead of releasing it
DICOM Conformance#
The echoscu
application supports the Verification service as an SCU. 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 |