findscu - 云端在线

程序：

您的姓名

findscu - DICOM 查询 (C-FIND) SCU

概要

findscu [选项] 对等端口 [dcmfile-in...]

商品描述

这款 芬斯库 应用程序为查询/检索服务类和
基本工作列表管理服务类。 芬斯库 仅支持使用查询功能
C-FIND 消息。 它向 SCP 发送查询密钥并等待响应。 应用程序
可用于测试查询/检索和基本工作列表管理服务的 SCP
类。

有无库存

DICOM 对等点的对等主机名

port tcp/ip peer 的端口号

dcmfile-in DICOM 查询文件

配置

一般 选项
-h --帮助
打印此帮助文本并退出

- 版
打印版本信息并退出

--参数
打印扩展的命令行参数

-q --安静
安静模式，不打印警告和错误

-v --详细
详细模式，打印处理细节

-d --调试
调试模式，打印调试信息

-ll --log-level [l]evel: 字符串常量
（致命、错误、警告、信息、调试、跟踪）
记录器使用级别 l

-lc --log-config [f] 文件名：字符串
将配置文件 f 用于记录器

网络 选项
覆盖匹配键：

-k --key [k]ey: gggg,eeee="str", 路径或字典名称="str"
覆盖匹配键

查询信息模型：

-W --工作清单
使用模态工作清单信息模型（默认）

-P --病人
使用患者根信息模型

-S——研究
使用研究根信息模型

-O -​​-psonly
使用仅限患者/研究的信息模型

应用实体标题：

-aet --aetitle [a]etitle: 字符串
设置我的呼叫 AE 标题（默认：FINDSCU）

-aec --call [a]etitle: 字符串
设置称为对等方的 AE 标题（默认：ANY-SCP）

1993 年后的价值表现：

+u --启用新 VR
启用对新 VR (UN/UT) 的支持（默认）

-u --禁用新 VR
禁用对新 VR 的支持，转换为 OB

建议的传输传输语法：

-x= --提议-uncompr
建议所有未压缩的 TS，显式 VR
首先使用本地字节排序（默认）

-xe --建议小
建议所有未压缩的 TS，显式 VR
小端优先

-xb --提议-大
建议所有未压缩的 TS，显式 VR
大端优先

-xd --propose-放气
提出放气显式 VR little endian TS
以及所有未压缩的传输语法

-xi --propose-隐式
仅建议隐式 VR 小端 TS

deflate 压缩级别（仅适用于 --propose-deflated）：

+cl --compression-level [l]evel：整数（默认值：6）
0=未压缩，1=最快，9=最佳压缩

其他网络选项：

-to --timeout [s] 秒：整数（默认值：无限制）
连接请求超时

-ta --acse-timeout [s]econds：整数（默认值：30）
ACSE 消息超时

-td --dimse-timeout [s]econds：整数（默认值：无限制）
DIMSE 消息超时

-pdu --max-pdu [n] 字节数：整数 (4096..131072)
将最大接收 pdu 设置为 n 字节（默认值：16384）

--repeat [n]number: 整数
重复n次

--中止
中止关联而不是释放它

--cancel [n]number: 整数
在 n 个响应后取消（默认值：从不）

运输 层 安全 （TLS） 选项
传输协议栈：

-tls --禁用-tls
使用普通 TCP/IP 连接（默认）

+tls --enable-tls [p]私钥文件，[c]证书文件：字符串
使用经过身份验证的安全 TLS 连接

+tla--匿名-tls
使用没有证书的安全 TLS 连接

私钥密码（仅适用于 --enable-tls）：

+ps --std-密码
提示用户在标准输入上输入密码（默认）

+pw --use-passwd [p]assword: 字符串
使用指定密码

-pw --null-passwd
使用空字符串作为密码

密钥和证书文件格式：

-pem --pem-密钥
将密钥和证书读取为 PEM 文件（默认）

-der --der 键
将密钥和证书读取为 DER 文件

认证机构：

+cf --add-cert-file [c] 证书文件名：字符串
将证书文件添加到证书列表

+cd --add-cert-dir [c] 证书目录：字符串
将 d 中的证书添加到证书列表中

密码套件：

+cs --cipher [c]iphersuite 名称：字符串
将密码套件添加到协商套件列表中

+dp --dhparam [f] 文件名：字符串
读取 DH/DSS 密码套件的 DH 参数

伪随机发生器：

+rs --seed [文件] 文件名：字符串
内容为 f 的种子随机生成器

+ws --写入种子
写回修改后的种子（仅使用 --seed）

+wf --write-seed-file [f] 文件名：字符串（仅与 --seed 一起使用）
将修改后的种子写入文件 f

对等身份验证：

-rc --需要对等证书
验证对等证书，如果不存在则失败（默认）

-vc --验证对等证书
验证对等证书（如果存在）

-ic --忽略对等证书
不验证对等证书

产量 选项
一般：

-od --output-directory [d] 目录：字符串（默认值：“.”）
将输出文件写入现有目录 d

自动数据校正：

+dc --enable-更正
启用自动数据校正

-dc --disable-更正
禁用自动数据校正（默认）

C-FIND 回复：

+sr --显示响应
始终向记录器输出响应

-sr --隐藏响应
不向记录器输出响应

-X --提取
提取对文件的响应 (rsp0001.dcm, ...)

附注

命令行上提供的每个文件都将作为 C-FIND 的一部分发送到 SCP
要求。 查询文件必须是有效的 DICOM 数据集，其中包含 C-
FIND-RQ 消息。 例如，可以使用以下命令创建查询文件 转储2dcm 效用
来自如下示例的脚本：

# 查询患者姓名和 ID
(0008,0052) CS [患者] # QueryRetrieveLevel
(0010,0010) PN [] # 患者姓名
(0010,0020) LO [] # 患者 ID

可以使用 -k
选项。 例如命令：

findscu -P -k "(0010,0010)=HEWETT*" 凯撒 5678 patqry.dcm

当发送到 TCP/IP 端口 5678 的 SCP caesar 时，将导致任何 PatientName 属性在
patqry.dcm 具有值“HEWETT*”。 如果存在这样的属性，它将是
替换，如果不存在，它将被插入。 这 -k 选项可以出现多次。 这
值部分（在“=”之后）可能不存在导致属性以零发送
长度。

在较早的版本中 芬斯库, 标签键在 group 周围没有大括号
和元素编号，例如“0010,0010”而不是“(0010,0010)”。 推荐
切换到新语法； 然而，旧的语法仍然有效。

还 -k 接受字典名称而不是元素标签来指定 DICOM 元素。
例如 芬斯库 上面的调用然后是这样的：

findscu -P -k PatientName="HEWETT*" caesar 5678 patqry.dcm

也可以使用 -k 选项。
在这些情况下，必须使用特殊的“路径”符号，例如

findscu -W -k "(0040,0100)[0].Modality=CT" 凯撒 5678

此调用在主机 caesar 的工作列表服务器上查询任何计划的 CT 程序
通过指定标签 (0040,0100) 'Scheduled Procedure Step Sequence' 和一个
此序列的第一项中的属性 'Modality' 值为 'CT'。 这方面的详细信息
路径符号可以在文档中找到 修改.

如果在命令行上没有指定文件，则必须完整地指定查询
一个或多个 -k 选项。 如果提供了多个查询文件， 芬斯库 将发送多个
C-FIND 向 SCP 提出请求。

收到的每组响应标识符将输出到记录器，除非选项
--隐藏响应, - 提炼, - 安静的 或者使用适当的记录器配置。
附加选项 --显示响应 可用于强制输出到记录器。

DICOM 一致性
这款 芬斯库 应用程序支持以下 SOP 类作为 SCU：

FINDPatientRootQueryRetrieveInformationModel 1.2.840.10008.5.1.4.1.2.1.1
FINDStudyRootQueryRetrieveInformationModel 1.2.840.10008.5.1.4.1.2.2.1
FINDPatientStudyOnlyQueryRetrieveInformationModel 1.2.840.10008.5.1.4.1.2.3.1
FINDModalityWorklistInformationModel 1.2.840.10008.5.1.4.31

这款 芬斯库 应用程序将为上述之一提出演示上下文
支持的 SOP 类取决于命令行选项（-P, -S, -O or -W）。 基本上，
支持以下传输语法：

LittleEndianImplicitTransferSyntax 1.2.840.10008.1.2
LittleEndianExplicitTransferSyntax 1.2.840.10008.1.2.1
DeflatedExplicitVRLittleEndianTransferSyntax 1.2.840.10008.1.2.1.99 (*)
BigEndianExplicitTransferSyntax 1.2.840.10008.1.2.2

(*) 如果编译时启用了 zlib 支持（请参阅 - 版 输出）

哪些传输语法实际上是以什么顺序提出的，可以用
- 提出 选项​​。

这款 芬斯库 应用程序不支持扩展协商。

记录

各种命令行工具和底层库的日志输出级别可以
由用户指定。 默认情况下，仅将错误和警告写入标准
错误流。 使用选项 --详细 还有信息性消息，如处理细节
被报道。 选项 -调试 可用于获取有关内部活动的更多详细信息，
例如用于调试目的。 可以使用选项选择其他日志记录级别 - 日志-
水平。在 - 安静的 模式只报告致命错误。 在如此严重的错误事件中，
申请通常会终止。 有关不同日志记录级别的更多详细信息，
请参阅模块“oflog”的文档。

如果应该将日志输出写入文件（可选择使用日志文件轮换），
到系统日志 (Unix) 或事件日志 (Windows) 选项 --日志配置 可以使用。 这个
配置文件还允许仅将某些消息定向到特定输出
流并根据模块或应用程序过滤某些消息
生成。 提供了一个示例配置文件 /logger.cfg.

指挥 LINE

所有命令行工具都使用以下参数表示法：方括号括起来
可选值 (0-1)，三个尾随点表示允许多个值
(1-n)，两者的组合意味着 0 到 n 值。

命令行选项通过前导“+”或“-”符号与参数区分开来，
分别。 通常，命令行选项的顺序和位置是任意的（即它们
可以出现在任何地方）。 但是，如果选项相互排斥，则最右边的外观
用来。 此行为符合常见 Unix shell 的标准评估规则。

此外，可以使用“@”符号作为前缀来指定一个或多个命令文件
文件名（例如 @命令.txt）。 这样的命令参数被替换为
相应的文本文件（多个空格被视为单个分隔符，除非
在任何进一步评估之前，它们出现在两个引号之间）。 请注意
命令文件不能包含另一个命令文件。 这种简单而有效的方法
允许总结选项/参数的常见组合并避免冗长和
令人困惑的命令行（文件中提供了一个示例 /dumppat.txt).

环境

这款 芬斯库 实用程序将尝试加载指定的 DICOM 数据字典
DCMDICT路径 环境变量。 默认情况下，即如果 DCMDICT路径 环境变量
未设置，文件 /dicom.dic 除非构建字典，否则将被加载
进入应用程序（Windows 的默认设置）。

默认行为应该是首选的，并且 DCMDICT路径 仅环境变量
当需要替代数据字典时使用。 这 DCMDICT路径 环境变量
具有与 Unix shell 相同的格式 PATH 冒号 (':') 分隔的变量
条目。 在 Windows 系统上，分号 (';') 用作分隔符。 数据字典
代码将尝试加载指定的每个文件 DCMDICT路径 环境变量。 它
如果无法加载数据字典，则是一个错误。

使用 onworks.net 服务在线使用 findscu