DCMTK开发笔记(二):模拟PACS调试(Win10环境)
前言
本文是对 PACS Debugging with DCMTK 和 DICOM医学图像处理:DCMTK的wiki资料学习之PACS调试 的学习笔记,记录了使用DCMTK提供的命令行工具来模拟客户机和PACS系统(服务器)交互的过程。
前置条件
为了方便地在windows环境下使用DCMTK命令行工具,首先将 DCMTK\bin 添加到系统的环境变量中。
然后在 E:\DCMTK\PACS 目录下创建文件夹(这个位置可以自由设置):
- E:\DCMTK\PACS\SCU 用来模拟DICOM网络通讯中的客户端(Service Class User),并在其目录下创建文件夹database,用来存放数据。
- E:\DCMTK\PACS\SCP 用来模拟服务端(Service Class Provider),同样创建文件夹database。
实验过程
- 将dcmqrscp.cfg配置文件拷贝到 E:\DCMTK\PACS\SCP 目录下,并做如下修改:
该文件存放在 DCMTK\etc\dcmtk\ 目录下,也可以从 Dcmtk Wiki 处下载得到。改动的地方有:
- NetworkTCPPort,改为SCP开放的端口号
- acme1 = (ACME1, acmehost1, 5678) 中间的 acmehost1 改为你的计算机的主机名(hostname),也可以是IP地址。
- ACME_STORE /home/dicom/db/ACME_STORE RW (9, 1024mb) acmeCTcompany 中间的路径改为你希望SCP存放数据的位置
- 打开一个命令行窗口,输入以下命令:
e:
cd E:\DCMTK\PACS\SCP
dcmqrscp --config dcmqrscp.cfg
没有出现错误信息表明模拟PACS程序启动。
C-ECHO操作
打开另一个命令行窗口:输入
e:
cd E:\DCMTK\PACS\SCU
echoscu -d localhost 11112 -aec ACME_STORE -aet ACME1
出现一大段网络通讯Log,结尾处 Received Echo Response (Success) 表明客户机(SCU)已经与服务端(SCP)通信成功。
C-STORE 操作
从 Dcmtk Wiki 下载示例图片 ct.dcm 存放到E:\DCMTK\PACS\SCU 目录下
继续在SCU命令行窗口输入:
storescu.exe -d localhost 11112 ct.dcm -aec ACME_STORE -aet ACME1
命令行快速滚动,最后几行为:
表明 C-STORE 命令运行成功。此时 E:\DCMTK\PACS\SCP\database 目录下出现重命名后的CT文件和 index.dat 文件。
C-FIND 操作
在SCU命令行窗口输入:
findscu.exe -v -S -aec ACME_STORE -aet ACME1 localhost 11112 -k QueryRetrieveLevel=STUDY -k StudyDate -k StudyDescription -k StudyInstanceUID
上述结果表明 C-FIND 操作成功。从中我们可以看到,示例CT图像的StudyDate为20140101,StudyInstanceUID为2.16.840.1.113662.2.1.1519.11582.1990505.1105152,我们可以进一步使用这些信息进行查询:
findscu.exe -v -S -aec ACME_STORE -aet ACME1 localhost 11112 -k QueryRetrieveLevel=STUDY -k StudyDate=20140101
或
findscu.exe -v -S -aec ACME_STORE -aet ACME1 localhost 11112 -k QueryRetrieveLevel=STUDY -k StudyInstanceUID=2.16.840.1.113662.2.1.1519.11582.1990505.1105152
C-MOVE
在SCU命令行窗口输入:
movescu.exe -v -S -aec ACME_STORE -aet ACME1 -aem ACME1 --port 1234 -od E:\DCMTK\PACS\SCU\database localhost 11112 -k QueryRetrieveLevel=STUDY -k StudyDate=20140101
表明 C-MOVE 命令运行成功。此时 E:\DCMTK\PACS\SCU\database 目录下出现重命名后的CT文件
常见问题和解决方案
所有问题可以根据SCP(PACS)输出的日志查明原因,下面列出根据客户端反馈信息定位问题:
- TCP Initialization Error
请确保你的主机到服务器的网络连接正常,其次请检查 IP/hostname 和端口号 设置是否正确。 - Called AE Title Not Recongnized
TCP连接可以建立,但连接使用的 AEC 或 AET 不正确,或者你的AET没有添加到dcmqrscp.cfg 的配置中。
用到的命令总结
SCP命令
SCP命令行用到的命令有:
e:
cd E:\DCMTK\PACS\SCP
dcmqrscp --config dcmqrscp.cfg
dcmqrscp --config dcmqrscp.cfg --prefer-lossless
dcmqrscp -d -c dcmqrscp.cfg +xs -xs
SCU命令
SCU命令行用到的命令有:
e:
cd E:\DCMTK\PACS\SCU
echoscu -d localhost 11112 -aec ACME_STORE -aet ACME1
storescu.exe -d localhost 11112 ct.dcm -aec ACME_STORE -aet ACME1
storescu localhost 11112 ct-compressed.dcm -aec ACME_STORE -aet ACME1 -d --required --propose-lossless
findscu.exe -v -S -aec ACME_STORE -aet ACME1 localhost 11112 -k QueryRetrieveLevel=STUDY -k StudyDate -k StudyDescription -k StudyInstanceUID
findscu.exe -v -S -aec ACME_STORE -aet ACME1 localhost 11112 -k QueryRetrieveLevel=STUDY -k StudyDate=20140101
findscu.exe -v -S -aec ACME_STORE -aet ACME1 localhost 11112 -k QueryRetrieveLevel=STUDY -k StudyInstanceUID=2.16.840.1.113662.2.1.1519.11582.1990505.1105152
movescu.exe -v -S -aec ACME_STORE -aet ACME1 -aem ACME1 --port 1234 -od E:\DCMTK\PACS\SCU\database localhost 11112 -k QueryRetrieveLevel=STUDY -k StudyDate=20140101
movescu.exe -v -S -aec ACME_STORE -aet ACME1 -aem ACME1 --port 1234 -od E:\DCMTK\PACS\SCU\database localhost 11112 -k QueryRetrieveLevel=STUDY -k StudyInstanceUID=2.16.840.1.113662.2.1.1519.11582.1990505.1105152
movescu -v -S -aec ACME_STORE -aet ACME1 -aem ACME1 --port 1234 -od E:\DCMTK\PACS\SCU\database localhost 11112 -k QueryRetrieveLevel=STUDY -k StudyInstanceUID=1.2.276.0.7230010.3.1.2.8323329.4723.1404318646.59559 +xs
更多信息请参考本文开头提到的两篇文章。