getscu - 云端在线

程序：

您的姓名

getscu - DICOM 检索 (C-GET) SCU

概要

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

商品描述

杰斯库 应用程序为查询/检索服务类实现 SCU。 杰斯库
支持使用 C-GET 消息检索功能。 它将查询密钥发送到 SCP 并
等待通过 C-STORE 发送的图像或其他 DICOM 对象的响应。 作为 DICOM
服务需求，C-GET 和伴随的 C-STORE 消息在同一个
协会。 因此，对象只能由 杰斯库 本身不能发送
给第三方（移动库 将是执行此任务的正确工具）。

有无库存

DICOM 对等点的对等主机名

port tcp/ip peer 的端口号

dcmfile-in DICOM 查询文件

配置

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

- 版
打印版本信息并退出

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

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

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

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

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

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

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

网络 选项
覆盖匹配键：

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

查询信息模型：

-P --病人
使用患者根信息模型（默认）

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

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

应用实体标题：

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

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

首选存储传输语法（传入关联）：

+x= --prefer-uncompr
更喜欢显式 VR 本地字节顺序（默认）

+xe --更喜欢一点
更喜欢显式 VR 小端 TS

+xb --prefer-大
更喜欢显式 VR 大端 TS

+xs --prefer-无损
更喜欢默认的JPEG无损TS

+xy --首选-jpeg8
对于 8 位数据，更喜欢默认的 JPEG 有损 TS

+xx --prefer-jpeg12
对于 12 位数据，更喜欢默认的 JPEG 有损 TS

+xv --prefer-j2k-无损
更喜欢 JPEG 2000 无损 TS

+xw --prefer-j2k-有损
更喜欢 JPEG 2000 有损 TS

+xt --prefer-jls-无损
更喜欢 JPEG-LS 无损 TS

+xu --prefer-jls-有损
更喜欢 JPEG-LS 有损 TS

+xm --首选 mpeg2
更喜欢 MPEG2 Main Profile @ Main Level TS

+xh --prefer-mpeg2-high
更喜欢 MPEG2 Main Profile @ High Level TS

+xn --首选 mpeg4
首选 MPEG4 AVC/H.264 HP / Level 4.1 TS

+xl --prefer-mpeg4-bd
更喜欢 MPEG4 AVC/H.264 BD 兼容的 TS

+xr --prefer-rle
更喜欢 RLE 无损 TS

+xd --prefer-放气
更喜欢放气的显式 VR 小端 TS

+xi --隐式
仅接受隐式 VR 小端 TS

提议的检索传输语法（传出关联）：

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

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

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

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

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

其他网络选项：

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

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

产量 选项
一般：

-od --output-directory [d] 目录：字符串（默认值：“.”）
将接收到的对象写入现有目录 d

存储方式：

-B --正常
在内存中接收，然后写入磁盘（默认）

+B --位保留
直接接收到磁盘

- 忽略
忽略存储数据，接收但不存储

附注

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

# 请求 ID=PAT001 的患者的所有图像
(0008,0052) CS [患者] # QueryRetrieveLevel
(0010,0020) LO [PAT001] # 患者 ID

另一种可能性是使用 修改 从头开始创建文件的工具
选项 --创建文件 连续调用 - 插入 选项。 个人属性
可以修改或补充使用 -k （或 - 钥匙） 选项。 例如命令：

getscu -k "0010,0020=PAT002" 凯撒 5678 patqry.dcm

当发送到 TCP/IP 端口 5678 的 SCP caesar 时，将导致任何 PatientID 属性在
patqry.dcm 具有值“PAT002”。 如果存在这样的属性，它将是
替换，如果不存在，它将被插入。 这 -k 选项可以出现多次。 这
值部分（在“=”之后）可能不存在导致属性以零发送
长度。 也可以使用 -k
选项。 在这些情况下，必须使用特殊的“路径”符号。 详细信息可以在
此 修改 文档。

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

已知的 问题
杰斯库 旨在用作 DICOM 软件开发人员的测试工具。 查询
必须根据 SCP 的内容手动创建密钥文件。

并非所有查询/检索 SCP 都支持 C-GET。 C-MOVE 协议是
由...实施 移动库 工具在实践中更常见。

杰斯库 应用程序不会尝试防止不正确的查询。 特别是，
C-MOVE 请求的查询键应该只包含 QueryRetrieveLevel 属性和
一个或多个所谓的“唯一关键属性”（PatientID、StudyInstanceUID、
SeriesInstanceUID 和 SOPInstanceUID）。

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

GETPatientRootQueryRetrieveInformationModel 1.2.840.10008.5.1.4.1.2.1.3
GETStudyRootQueryRetrieveInformationModel 1.2.840.10008.5.1.4.1.2.2.3
GETPatientStudyOnlyQueryRetrieveInformationModel 1.2.840.10008.5.1.4.1.2.3.3

杰斯库 应用程序将为上述之一提出演示上下文
支持的 SOP 类取决于命令行选项（-P, -S或 -O）。 用于外出
关联，支持以下传输语法：

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 支持（请参阅 - 版 输出）

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

存储 一致性
杰斯库 应用程序支持以下 SOP 类作为 SCP：

验证SOPClass 1.2.840.10008.1.1

RETIRED_StoredPrintStorage 1.2.840.10008.5.1.1.27
RETIRED_HardcopyGrayscaleImageStorage 1.2.840.10008.5.1.1.29
RETIRED_HardcopyColorImageStorage 1.2.840.10008.5.1.1.30
计算放射线摄影图像存储 1.2.840.10008.5.1.4.1.1.1
DigitalXRayImageStorageForPresentation 1.2.840.10008.5.1.4.1.1.1.1
DigitalXRayImageStorageForProcessing 1.2.840.10008.5.1.4.1.1.1.1.1
数字乳腺X射线图像存储演示1.2.840.10008.5.1.4.1.1.1.2
数字乳房X射线摄影X射线图像存储处理1.2.840.10008.5.1.4.1.1.1.2.1
DigitalIntraOralXRayImageStorageForPresentation 1.2.840.10008.5.1.4.1.1.1.3
数字口腔内X射线图像存储处理1.2.840.10008.5.1.4.1.1.1.3.1
CT图像存储1.2.840.10008.5.1.4.1.1.2
增强型CTImageStorage 1.2.840.10008.5.1.4.1.1.2.1
RETIRED_UltrasoundMultiframeImageStorage 1.2.840.10008.5.1.4.1.1.3
超声多帧图像存储1.2.840.10008.5.1.4.1.1.3.1
MR图像存储1.2.840.10008.5.1.4.1.1.4
增强MRImageStorage 1.2.840.10008.5.1.4.1.1.4.1
MR光谱存储1.2.840.10008.5.1.4.1.1.4.2
增强MRColorImageStorage 1.2.840.10008.5.1.4.1.1.4.3
RETIRED_NuclearMedicineImageStorage 1.2.840.10008.5.1.4.1.1.5
RETIRED_UltrasoundImageStorage 1.2.840.10008.5.1.4.1.1.6
超声图像存储 1.2.840.10008.5.1.4.1.1.6.1
增强型 USVolumeStorage 1.2.840.10008.5.1.4.1.1.6.2
辅助捕获图像存储1.2.840.10008.5.1.4.1.1.7
多帧SingleBitSecondaryCaptureImageStorage 1.2.840.10008.5.1.4.1.1.7.1
多帧灰度字节辅助捕获图像存储1.2.840.10008.5.1.4.1.1.7.2
多帧GrayscaleWordSecondaryCaptureImageStorage 1.2.840.10008.5.1.4.1.1.7.3
多帧TrueColorSecondaryCaptureImageStorage 1.2.840.10008.5.1.4.1.1.7.4
RETIRED_StandaloneOverlayStorage 1.2.840.10008.5.1.4.1.1.8
RETIRED_StandaloneCurveStorage 1.2.840.10008.5.1.4.1.1.9
十二铅ECG波形存储1.2.840.10008.5.1.4.1.1.9.1.1
通用ECGWaveformStorage 1.2.840.10008.5.1.4.1.1.9.1.2
动态ECGWaveformStorage 1.2.840.10008.5.1.4.1.1.9.1.3
血流动力学波形存储 1.2.840.10008.5.1.4.1.1.9.2.1
心脏电生理波形存储 1.2.840.10008.5.1.4.1.1.9.3.1
基本语音音频波形存储1.2.840.10008.5.1.4.1.1.9.4.1
通用音频波形存储 1.2.840.10008.5.1.4.1.1.9.4.2
动脉脉搏波形存储 1.2.840.10008.5.1.4.1.1.9.5.1
呼吸波形存储 1.2.840.10008.5.1.4.1.1.9.6.1
RETIRED_StandaloneModalityLUTStorage 1.2.840.10008.5.1.4.1.1.10
RETIRED_StandaloneVOILUTStorage 1.2.840.10008.5.1.4.1.1.11
GrayscaleSoftcopyPresentationStateStorage 1.2.840.10008.5.1.4.1.1.11.1
ColorSoftcopyPresentationStateStorage 1.2.840.10008.5.1.4.1.1.11.2
伪彩色软拷贝演示状态存储1.2.840.10008.5.1.4.1.1.11.3
BlendingSoftcopyPresentationStateStorage 1.2.840.10008.5.1.4.1.1.11.4
XAXRFGrayscaleSoftcopyPresentationStateStorage 1.2.840.10008.5.1.4.1.1.11.5
X射线血管造影图像存储1.2.840.10008.5.1.4.1.1.12.1
增强型XAImageStorage 1.2.840.10008.5.1.4.1.1.12.1.1
X射线放射荧光图像存储1.2.840.10008.5.1.4.1.1.12.2
增强型XRFImageStorage 1.2.840.10008.5.1.4.1.1.12.2.1
RETIRED_XRayAngigraphicBiPlaneImageStorage 1.2.840.10008.5.1.4.1.1.12.3
XRay3D血管造影图像存储1.2.840.10008.5.1.4.1.1.13.1.1
XRay3DCraniofacialImageStorage 1.2.840.10008.5.1.4.1.1.13.1.2
乳房断层合成图像存储 1.2.840.10008.5.1.4.1.1.13.1.3
血管内Opt.Coh.Tom.ImageStorageForPresentation 1.2.840.10008.5.1.4.1.1.14.1
血管内 Opt.Coh.Tom.ImageStorageForProcessing 1.2.840.10008.5.1.4.1.1.14.2
核医学图像存储 1.2.840.10008.5.1.4.1.1.20
原始数据存储 1.2.840.10008.5.1.4.1.1.66
空间注册存储 1.2.840.10008.5.1.4.1.1.66.1
空间基准存储 1.2.840.10008.5.1.4.1.1.66.2
可变形空间注册存储 1.2.840.10008.5.1.4.1.1.66.3
分段存储 1.2.840.10008.5.1.4.1.1.66.4
表面分割存储1.2.840.10008.5.1.4.1.1.66.5
真实世界值映射存储 1.2.840.10008.5.1.4.1.1.67
SurfaceScanMeshStorage 1.2.840.10008.5.1.4.1.1.68.1
表面扫描点云存储1.2.840.10008.5.1.4.1.1.68.2
RETIRED_VLImageStorage 1.2.840.10008.5.1.4.1.1.77.1
VLEndoscopeImageStorage 1.2.840.10008.5.1.4.1.1.77.1.1
视频内窥镜图像存储 1.2.840.10008.5.1.4.1.1.77.1.1.1
VL显微镜图像存储1.2.840.10008.5.1.4.1.1.77.1.2
视频显微图像存储1.2.840.10008.5.1.4.1.1.77.1.2.1
VLSlide坐标显微图像存储1.2.840.10008.5.1.4.1.1.77.1.3
VL摄影图像存储1.2.840.10008.5.1.4.1.1.77.1.4
视频摄影图像存储1.2.840.10008.5.1.4.1.1.77.1.4.1
眼科摄影8BitImageStorage 1.2.840.10008.5.1.4.1.1.77.1.5.1
眼科摄影16BitImageStorage 1.2.840.10008.5.1.4.1.1.77.1.5.2
立体关系存储 1.2.840.10008.5.1.4.1.1.77.1.5.3
眼科断层扫描图像存储 1.2.840.10008.5.1.4.1.1.77.1.5.4
VLWholeSlideMicroscopyImageStorage 1.2.840.10008.5.1.4.1.1.77.1.6
RETIRED_VLMultiFrameImageStorage 1.2.840.10008.5.1.4.1.1.77.2
焦度测量测量存储 1.2.840.10008.5.1.4.1.1.78.1
自动折射测量存储 1.2.840.10008.5.1.4.1.1.78.2
角膜曲率测量存储 1.2.840.10008.5.1.4.1.1.78.3
主观折射测量存储 1.2.840.10008.5.1.4.1.1.78.4
视力测量存储 1.2.840.10008.5.1.4.1.1.78.5
SpectaclePrescriptionReportStorage 1.2.840.10008.5.1.4.1.1.78.6
眼科轴向测量存储 1.2.840.10008.5.1.4.1.1.78.7
人工晶状体计算存储 1.2.840.10008.5.1.4.1.1.78.8
黄斑网格厚度和体积报告存储1.2.840.10008.5.1.4.1.1.79.1
眼科VisualFieldStaticPerimetryMeasurementsSt。 1.2.840.10008.5.1.4.1.1.80.1
眼科厚度图存储 1.2.840.10008.5.1.4.1.1.81.1
基本文本SR存储1.2.840.10008.5.1.4.1.1.88.11
增强型SRStorage 1.2.840.10008.5.1.4.1.1.88.22
综合SRStorage 1.2.840.10008.5.1.4.1.1.88.33
综合3DSRStorage 1.2.840.10008.5.1.4.1.1.88.34
过程日志存储 1.2.840.10008.5.1.4.1.1.88.40
乳腺摄影CADSRStorage 1.2.840.10008.5.1.4.1.1.88.50
KeyObjectSelectionDocumentStorage 1.2.840.10008.5.1.4.1.1.88.59
胸部CADSRS存储1.2.840.10008.5.1.4.1.1.88.65
XRayRadiationDoseSRStorage 1.2.840.10008.5.1.4.1.1.88.67
ColonCADSR 存储 1.2.840.10008.5.1.4.1.1.88.69
植入计划SRDocumentStorage 1.2.840.10008.5.1.4.1.1.88.70
封装的PDFStorage 1.2.840.10008.5.1.4.1.1.104.1
封装的CDAStorage 1.2.840.10008.5.1.4.1.1.104.2
正电子发射断层扫描图像存储 1.2.840.10008.5.1.4.1.1.128
RETIRED_StandalonePETCurveStorage 1.2.840.10008.5.1.4.1.1.129
增强型PETImageStorage 1.2.840.10008.5.1.4.1.1.130
基本结构化显示存储 1.2.840.10008.5.1.4.1.1.131
RTImageStorage 1.2.840.10008.5.1.4.1.1.481.1
RTDoseStorage 1.2.840.10008.5.1.4.1.1.481.2
RTStructureSetStorage 1.2.840.10008.5.1.4.1.1.481.3
RTBeamsTreatmentRecordStorage 1.2.840.10008.5.1.4.1.1.481.4
RTP计划存储1.2.840.10008.5.1.4.1.1.481.5
RTBrachyTreatmentRecordStorage 1.2.840.10008.5.1.4.1.1.481.6
RTTreatmentSummaryRecordStorage 1.2.840.10008.5.1.4.1.1.481.7
RTIion计划存储1.2.840.10008.5.1.4.1.1.481.8
RTIonBeamsTreatmentRecordStorage 1.2.840.10008.5.1.4.1.1.481.9
RTBeamsDeliveryInstructionStorage 1.2.840.10008.5.1.4.34.7
通用植入模板存储 1.2.840.10008.5.1.4.43.1
种植体装配模板存储 1.2.840.10008.5.1.4.44.1
植入模板组存储 1.2.840.10008.5.1.4.45.1

杰斯库 应用程序通常会接受所有的表示上下文
上述支持的 SOP 类使用以下任何传输语法：

LittleEndianImplicitTransferSyntax 1.2.840.10008.1.2
LittleEndianExplicitTransferSyntax 1.2.840.10008.1.2.1
BigEndianExplicitTransferSyntax 1.2.840.10008.1.2.2

当充当存储 SCP 时， 杰斯库 应用程序将更喜欢具有
对默认隐式传输语法的显式编码。 如果 杰斯库 正在运行
big-endian 硬件它会更喜欢 BigEndianExplicit 到 LittleEndianExplicit 传输
语法（反之亦然）。 这种行为可以通过 - 更喜欢 选项（见
以上）。 取决于 - 更喜欢 实际使用的选项，以下组合
支持传输语法：

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
JPEGProcess1TransferSyntax 1.2.840.10008.1.2.4.50
JPEGProcess2_4TransferSyntax 1.2.840.10008.1.2.4.51
JPEGProcess14SV1TransferSyntax 1.2.840.10008.1.2.4.70
JPEGLSLosslessTransferSyntax 1.2.840.10008.1.2.4.80
JPEGLSLossyTransferSyntax 1.2.840.10008.1.2.4.81
JPEG2000LosslessOnlyTransfer语法 1.2.840.10008.1.2.4.90
JPEG2000传输语法 1.2.840.10008.1.2.4.91
MPEG2MainProfileAtMainLevelTransferSyntax 1.2.840.10008.1.2.4.100
MPEG2MainProfileAtHighLevelTransferSyntax 1.2.840.10008.1.2.4.101
MPEG4HighProfileLevel4_1TransferSyntax 1.2.840.10008.1.2.4.102
MPEG4BD compatibleHighProfileLevel4_1TransferSyntax 1.2.840.10008.1.2.4.103
RLLosslessTransferSyntax 1.2.840.10008.1.2.5

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

杰斯库 应用程序不支持扩展协商。

示例

getscu --patient --call ARCHIVE 凯撒 104 q.dcm

将包含在 DICOM 文件“q.dcm”中的属性作为 C-GET 请求的一部分发送到
使用 Patient Root 查询在 104 端口的主机 caesar 上的应用程序实体 ARCHIVE
模型。 杰斯库 本身使用默认的 AE 标题GETSCU。

与基于 C-MOVE 的查询/检索 SOP 类相比，基于 C-GET 的 SOP 类
被...利用 杰斯库 只允许在同一连接上检索所需的对象，即
杰斯库 将接收对象本身。 因此，不可能告诉 SCP
将对象传输给第三方。 这是 DICOM 协议的限制，而不是
的 杰斯库 工具。

记录

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