DCMTK开发笔记(二):模拟PACS调试(Win10环境)

DCMTK开发笔记(二):模拟PACS调试(Win10环境)

  • 前言
  • 前置条件
  • 实验过程
    • C-ECHO操作
    • C-STORE 操作
    • C-FIND 操作
    • C-MOVE
  • 常见问题和解决方案
  • 用到的命令总结
    • SCP命令
    • SCU命令

前言

本文是对 PACS Debugging with DCMTK 和 DICOM医学图像处理:DCMTK的wiki资料学习之PACS调试 的学习笔记,记录了使用DCMTK提供的命令行工具来模拟客户机和PACS系统(服务器)交互的过程。

前置条件

为了方便地在windows环境下使用DCMTK命令行工具,首先将 DCMTK\bin 添加到系统的环境变量中。
DCMTK开发笔记(二):模拟PACS调试(Win10环境)_第1张图片
然后在 E:\DCMTK\PACS 目录下创建文件夹(这个位置可以自由设置):

  • E:\DCMTK\PACS\SCU 用来模拟DICOM网络通讯中的客户端(Service Class User),并在其目录下创建文件夹database,用来存放数据。
  • E:\DCMTK\PACS\SCP 用来模拟服务端(Service Class Provider),同样创建文件夹database。

实验过程

  1. 将dcmqrscp.cfg配置文件拷贝到 E:\DCMTK\PACS\SCP 目录下,并做如下修改:
    DCMTK开发笔记(二):模拟PACS调试(Win10环境)_第2张图片
    该文件存放在 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存放数据的位置
  1. 打开一个命令行窗口,输入以下命令:
e:
cd E:\DCMTK\PACS\SCP
dcmqrscp --config dcmqrscp.cfg

DCMTK开发笔记(二):模拟PACS调试(Win10环境)_第3张图片
没有出现错误信息表明模拟PACS程序启动。

C-ECHO操作

打开另一个命令行窗口:输入

e:
cd E:\DCMTK\PACS\SCU
echoscu -d localhost 11112 -aec ACME_STORE -aet ACME1

DCMTK开发笔记(二):模拟PACS调试(Win10环境)_第4张图片
出现一大段网络通讯Log,结尾处 Received Echo Response (Success) 表明客户机(SCU)已经与服务端(SCP)通信成功。
DCMTK开发笔记(二):模拟PACS调试(Win10环境)_第5张图片

C-STORE 操作

从 Dcmtk Wiki 下载示例图片 ct.dcm 存放到E:\DCMTK\PACS\SCU 目录下
继续在SCU命令行窗口输入:

storescu.exe -d localhost 11112 ct.dcm -aec ACME_STORE -aet ACME1

DCMTK开发笔记(二):模拟PACS调试(Win10环境)_第6张图片
命令行快速滚动,最后几行为:
DCMTK开发笔记(二):模拟PACS调试(Win10环境)_第7张图片
表明 C-STORE 命令运行成功。此时 E:\DCMTK\PACS\SCP\database 目录下出现重命名后的CT文件和 index.dat 文件。
DCMTK开发笔记(二):模拟PACS调试(Win10环境)_第8张图片

C-FIND 操作

在SCU命令行窗口输入:

findscu.exe -v -S -aec ACME_STORE -aet ACME1 localhost 11112 -k QueryRetrieveLevel=STUDY -k StudyDate -k StudyDescription -k StudyInstanceUID

DCMTK开发笔记(二):模拟PACS调试(Win10环境)_第9张图片
上述结果表明 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

DCMTK开发笔记(二):模拟PACS调试(Win10环境)_第10张图片
表明 C-MOVE 命令运行成功。此时 E:\DCMTK\PACS\SCU\database 目录下出现重命名后的CT文件 DCMTK开发笔记(二):模拟PACS调试(Win10环境)_第11张图片

常见问题和解决方案

所有问题可以根据SCP(PACS)输出的日志查明原因,下面列出根据客户端反馈信息定位问题:

  1. TCP Initialization Error
    DCMTK开发笔记(二):模拟PACS调试(Win10环境)_第12张图片
    请确保你的主机到服务器的网络连接正常,其次请检查 IP/hostname 和端口号 设置是否正确。
  2. Called AE Title Not Recongnized
    DCMTK开发笔记(二):模拟PACS调试(Win10环境)_第13张图片
    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

更多信息请参考本文开头提到的两篇文章。

你可能感兴趣的:(DCMTK)