dcmsend - 云端在线

程序：

您的姓名

dcmsend - 简单的 DICOM 存储 SCU（发送器）

概要

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

商品描述

这款 发送 应用程序为存储服务实现服务类用户 (SCU)
班级。 与众所周知的相比 商店 效用， 发送 有更少的选择，并且是，
因此，更易于使用 - 这也解释了标题中的“简单”一词。 主要的
此应用程序的目的是将一大堆 DICOM 文件发送到存储服务
类提供者 (SCP)。 发送 支持多个关联（一个接一个）
和解压缩 DICOM SOP 实例（如果需要传输它们）。

有无库存

DICOM 对等点的对等主机名

port tcp/ip peer 的端口号

dcmfile-in 要传输的 DICOM 文件或目录

配置

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

- 版
打印版本信息并退出

--list-解码器
列出解码器的传输语法并退出

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

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

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

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

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

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

+v --详细-pc
以详细模式显示演示上下文

输入 选项
输入文件格式：

+f --读取文件
读取文件格式或数据集

+fo --只读文件
仅读取文件格式（默认）

-f --读取数据集
读取没有文件元信息的数据集

输入文件：

+rd --从 dicomdir 读取
从 DICOMDIR 读取有关输入文件的信息

+sd --扫描目录
扫描输入文件的目录 (dcmfile-in)

+sp --scan-pattern [p]attern: 字符串（仅适用于 --scan-directories）
文件名匹配模式（通配符）

# 可能并非在所有系统上都可用

-r --no-递归
不要在目录中递归（默认）

+r --递归
在指定目录内递归

处理 选项
传输语法转换：

-dn --解压缩-从不
从不解压压缩数据集

+dls --解压缩无损
只解压无损压缩（默认）

+dly --解压缩有损
解压缩有损和无损压缩

放气压缩级别：

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

其他处理选项：

-nh --不停止
不要停在第一个无效的输入文件上
或者如果遇到不成功的存储

-nip --无非法提案
不建议任何表示上下文
不包含默认传输语法（如果需要）

-nuc --无 uid 检查
不检查输入文件的 UID 值

网络 选项
应用实体标题：

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

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

关联处理：

+ma --多关联
使用多个关联（一个接一个）
如果需要转移实例（默认）

-ma --单关联
始终使用单个关联

其他网络选项：

-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）

--max-send-pdu [n] 字节数：整数 (4096..131072)
将最大发送 pdu 限制为 n 个字节

产量 选项
一般：

+crf --create-report-file [f] 文件名：字符串
创建关于转移的详细报告
（如果成功）并将其写入文本文件 f

附注

Typical 用法
一个典型的用例 发送 是发送存储为 DICOM 的任意 SOP 实例
文件到存储 SCP。 以下命令正是这样做的：

dcmsend --详细*.dcm

如果 DICOM 文件存储在目录“图像”下的目录层次结构中，
可以使用以下命令：

dcmsend -v --scan-directories --recurse 图像

也可以指定多个目录并组合上述
方法（同时使用文件名和目录名）：

dcmsend -v +sd +r IMAGES_1 IMAGES_2 test.img *.dcm

如果 SOP 实例是从 DICOMDIR 文件中引用的，则选项 --从 dicomdir 读取 （或
+rd) 可用于发送所有引用的 DICOM 文件，而无需为
关联协商：

dcmsend -v --read-from-dicomdir DICOMDIR

同样，上述所有方法都可以像这样组合：

dcmsend -v +sd +r +rd IMAGES_1 IMAGES_2 test.img DICOMDIR *.dcm

默认选项 --只读文件 确保只有 DICOM 文件（即带有
元标题和前导码后的魔术字“DICM”）被处理。 通常，如果
处理一大堆文件，最好不要停在第一个无效的文件上
输入文件或遇到不成功的存储。 这可以通过使用来完成
选项 --不停机. 但是请注意，“不成功的存储”并不意味着
C-STORE 响应的 DIMSE 状态指示错误。 这意味着 C-STORE 请求
无法发送到存储 SCP。

如果需要超过 128 个表示上下文，这是允许的最大数量
根据 DICOM 标准，在前一个关联完成后开始新的关联
已完成。 在不需要此行为的情况下，可以使用选项禁用它
--单一关联. 另外，是否只有无损压缩数据集
解压缩（如果需要），这是默认值，或者也可以是有损压缩数据集
指定使用 --解压-xxx 选项​​。

为了获得有关 DICOM SOP 传输的概述和详细信息
实例，选项 --创建报告文件 可用于创建相应的文本文件。
但是，如果应用程序没有终止，则此文件仅作为最后一步创建
之前（有错误）。

扫描 目录
将目录作为参数添加到命令行只有在选项时才有意义 - 扫描-
目录 也给了。 如果应选择提供的目录中的文件
根据特定的名称模式（例如使用通配符匹配），选项 --扫描模式
必须使用。 请注意，此文件模式仅适用于
扫描的目录，并且，如果在命令行之外指定了任何其他模式
此 --扫描模式 选项（例如，为了选择更多文件），这些不适用于
指定的目录。

因此，上述示例中的第三个将递归目录 IMAGES_1 和 IMAGES_2
并传输包含在这两个文件夹及其所有子文件夹中的文件（由于
选择 +r）。 另外， 发送 将传输“test.img”和所有带有扩展名的文件
当前工作文件夹中的“dcm”。 请注意，不提供目录名称
启用选项 +标准差 没有意义。

DICOM 一致性
基本上， 发送 应用程序支持所有存储 SOP 类作为 SCU，包括
私人的。 默认情况下，应用程序检查 DICOM 文件的 SOP 类 UID
以确保仅发送有效的 SOP 实例。 带选项 --无 uid 检查
可以禁用此检查。

这款 发送 应用程序还支持在 DICOM 中定义的所有传输语法
标准。 仅当 UID 检查被禁用时才能使用私有传输语法
选项 --无 uid 检查. 但请注意，只有数量有限的转账
支持将它们转换为默认传输语法（隐式 VR
小端）。 带选项 --list-解码器 本机或由支持的传输语法
列出了解码器。 输出通常如下所示：

本机支持的传输语法：
- 小端隐式
- 小端显式
- 大端显式

解码器支持的传输语法：
- 放气的显式 VR 小端
- JPEG 基线
- JPEG 扩展，处理 2+4
- JPEG 光谱选择，非分层，处理 6+8
- JPEG 全渐进、非分层、处理 10+12
- JPEG 无损、非分层、过程 14
- JPEG 无损、非分层、一阶预测
- JPEG-LS 无损
- JPEG-LS 有损（近无损）
- RLE 无损

建立 发送 尝试对用户尽可能简单，默认情况下呈现
可能会向 SCP 提出严格意义上“非法”的上下文。 这是
因为，根据 DICOM 标准，SCU 总是要提出默认的
在与每个抽象句法相关的至少一个表示上下文中传递句法
（即 SOP 类）。 当 SCU 只能访问 SOP 时，此要求被免除
有损压缩形式的实例。 带选项 --无非法提案 严格的 DICOM-
可以强制执行合规行为，即不会出现可能非法的表示上下文
建议，但相应的 SOP 实例将被拒绝（如果需要）。

但是请注意，“无损 JPEG 压缩”的默认传输语法，
“有损 JPEG 压缩”等并不总是按照 DICOM 的要求提出
标准。 相同的限制适用于其他压缩方案。 请参阅 DICOM PS 3.5
10 节了解详情。

记录

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

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

指挥 LINE

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

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

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

退出 编码

这款 发送 实用程序在终止时使用以下退出代码。 这使用户
检查应用程序终止的原因。

一般
EXITCODE_NO_ERROR 0
EXITCODE_COMMANDLINE_SYNTAX_ERROR 1

输入 文件 错误
EXITCODE_CANNOT_READ_INPUT_FILE 20 (*)
EXITCODE_NO_INPUT_FILES 21
EXITCODE_INVALID_INPUT_FILE 22
EXITCODE_NO_VALID_INPUT_FILES 23

产量 文件 错误
EXITCODE_CANNOT_WRITE_OUTPUT_FILE 40 (*)
EXITCODE_CANNOT_WRITE_REPORT_FILE 43

网络 错误
EXITCODE_CANNOT_INITIALIZE_NETWORK 60
EXITCODE_CANNOT_NEGOTIATE_ASSOCIATION 61
EXITCODE_CANNOT_SEND_REQUEST 62
EXITCODE_CANNOT_ADD_PRESENTATION_CONTEXT 65

(*) 实际上，这些代码目前不被使用 发送 但作为占位符
相应的退出代码组。

环境

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

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

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