img2dcm - 云端在线

程序：

您的姓名

img2dcm - 将标准图像格式转换为 DICOM 格式

概要

img2dcm [选项] imgfile-in dcmfile-out

商品描述

图像2dcm 工具用作标准图像格式（如 JPEG 或 BMP）的转换工具
到 DICOM。 可以选择不同的输出 SOP Classes。 附加信息
（关于患者、系列等）存储在 DICOM 输出文件中，可以从
用作生成的 DICOM 对象的“模板”的其他 DICOM 文件。 图像2dcm 能够
还可以配置为发明缺少的 DICOM 类型 1 和类型 2 属性甚至可以工作
没有任何模板数据集。

有无库存

imgfile-in 要导入的图像文件

dcmfile-out DICOM 输出文件

配置

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

- 版
打印版本信息并退出

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

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

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

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

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

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

输入 选项
一般：

-i --input-format [i]输入文件格式：字符串
支持的格式：JPEG（默认）、BMP

-df --dataset-from [f] 文件名：字符串
使用来自 DICOM 文件 f 的数据集

-stf --study-from [f] 文件名：字符串
从 DICOM 文件 f 读取患者/研究

-sef --series-from [f] 文件名：字符串
从 DICOM 文件 f 读取患者/研究/系列

-ii --实例-inc
增加从 DICOM 文件读取的实例编号

JPEG格式：

-dp --禁用程序
禁用对渐进式 JPEG 的支持

-de --禁用-ext
禁用对扩展顺序 JPEG 的支持

-jf --坚持jfif
坚持 JFIF 标头存在

-ka --keep-appn
保留 APPn 部分（JFIF 除外）

处理 选项
属性检查：

--做检查
启用属性有效性检查（默认）

--无检查
禁用属性有效性检查

+i2 --插入类型2
插入缺少的类型 2 属性（默认）
（仅与 --do-checks 一起使用）

-i2 --无类型2插入
不要插入缺少的类型 2 属性
（仅与 --do-checks 一起使用）

+i1 --发明类型1
发明缺失的类型 1 属性
（仅与 --do-checks 一起使用）

-i1 --无类型1发明
不要发明缺失的类型 1 属性
（仅与 --do-checks 一起使用）

字符集：

+l1 --拉丁语1
将 latin-1 设置为标准字符集（默认）

-l1 --无拉丁语1
保持 7 位 ASCII 作为标准字符集

其他处理选项：

-k --key [k]ey: gggg,eeee="str", 路径或字典名称="str"
添加更多属性

产量 选项
目标 SOP 类别：

-sc --sec 捕获
编写二级捕获 SOP 类

-nsc --新-sc
编写新的二级捕获 SOP 类

-vlp --vl-照片
编写可见光摄影 SOP 类（默认）

输出文件格式：

+F --写入文件
写入文件格式（默认）

-F --写数据集
写入没有文件元信息的数据集

组长编码：

+g= --组长度重新计算
如果存在，则重新计算组长度（默认）

+g --组长度-创建
总是用组长元素写

-g --组长度删除
总是在没有组长度元素的情况下写入

序列和项目中的长度编码：

+e --length-显式
使用显式长度写入（默认）

-e --length-未定义
以未定义的长度写入

数据集尾随填充（不使用 --write-dataset）：

-p --填充关闭
无填充（如果 --write-dataset 则隐式）

+p --padding-create [f]ile-pad [i]tem-pad: 整数
在多个 f 字节上对齐文件
和多个 i 字节上的项目

附注

属性 来源
要将通用图像格式转换为 DICOM 格式， 图像2dcm 申请可能是
用一些额外的输入来填充新的强制（和可选）属性
DICOM 文件，如患者、研究和系列信息。 可以收集这些信息
使用不同的方法，可以组合并应用于结果文件
以下顺序：

· 使用 --数据集来自 选项 图像2dcm 被迫从现有的导入属性
DICOM 文件。 给定的 DICOM 文件是完全导入的，并作为所有
进一步的出口业务。 作为一个例外，SOP 实例 UID 不会被此复制
选项。 在转换过程中还交换图像相关数据，如行、列等。
需要注意的是 图像2dcm 不检查任何其他属性值的有效性，例如它确实
不查看序列以适应新对象的任何属性（参考图像
等等。）。 所以建议使用data目录下的模板（旧）
SC 和 VLP 对象。 另请参阅“输入模板”部分。
· --学习自 和 --系列-从 选项（互斥）可用于导入
来自现有 DICOM 文件的患者、研究和系列信息。 如果 --系列-从 is
指定，然后给定的 DICOM 文件被打开 图像2dcm 以及所有必填信息
下至系列级别是进口的。 请注意，这包括患者、研究和系列
信息。 的情况下 --学习自，排除系列信息。 下列
属性被接管：
患者级别：
病人姓名
患者编号
患者性别
患者的出生日期
特定字符集

学习水平：
研究实例 UID
学习日期
学习时间
转介医师姓名
学习编号
登录号

系列级别（仅在选项 --series-from 的情况下）：
系列实例 UID
系列号
生产厂家
·随着 --插入类型2 和 --发明类型1 选项（默认情况下均启用），缺少
属性（类型 2 属性）和/或缺失的属性值（对于类型 1 属性）
由自动添加和发明 图像2dcm. 请注意，这些选项仅
评估是否选项 --做检查 已启用（默认）。 如果 --无检查 选项是
启用，不会发生自动属性插入。
· - 钥匙 选项可用于向 DICOM 输出文件添加更多属性。 这个
选项在最后应用，就在保存 DICOM 文件之前。 也是
可以使用 - 钥匙 选项。 在
在这些情况下，必须使用特殊的“路径”符号。 此路径符号的详细信息可以
在文档中可以找到 修改.
UID
生成新的研究和系列实例 UID if 必要 应用后 - 学习-
止 和 - 系列 选项。 如果研究实例 UID 或系列实例 UID 不存在
在这些步骤之后，它们是新生成的，彼此独立。 一个相反的
为 SOP 实例 UID 选择行为，当
使用 --数据集来自 选项。 这是 不能 在这种情况下，SOP 实例 UID 是 不能 复制
到新对象。 这应该是大多数用例的理想行为。 然而，如果一个
应该将某些 SOP 实例 UID 插入到新对象中， - 钥匙 选项应该
使用。
输入 模板
为了支持转换为 DICOM， 图像2dcm 带有一些预定义的模板
可用于 --数据集来自 选项（见示例文件 转储文件 和 转储文件).
这些模板应填充所需的值，然后必须转储
（转换）为 DICOM 文件，然后再实际使用 图像2dcm。 使用 转储2dcm 至
将转储转换为 DICOM。 例子：
dump2dcm SC.dump SC.dcm

可以使用任何 DICOM 文件作为模板。 请注意，完整的 DICOM
数据集被导入； 因此，应该确保只有属性存在
应该是构造的 DICOM 对象的一部分。 SOP 类 UID 和像素数据
属性（包括行、列等属性）不会被复制，而是被替换为
图像2dcm 转换过程中。
输入 插件
图像2dcm 应用程序目前支持 JPEG 和 BMP 图像格式作为输入。
JPEG格式 输入 插件
对于 JPEG，源文件中的原始 JPEG 不会被解码，而是被提取并稍微
转换（例如 JFIF 标头被切断）以允许快速转换甚至大的 JPEG 文件
无需解码和重新编码。 JPEG 插件选择必要的输出
根据 JPEG 内部数据的实际编码自动传输语法
文件。 因此，以下传输语法（及其对应的 JPEG 编码）
由 JPEG 插件使用：
· JPEG 编码过程 1 Baseline, Lossy, Non-Hierarchical, Sequential, DCT, Huffman, 8 Bit
SOP 等级 = 1.2.840.10008.1.2.4.50
· JPEG 编码过程 2（8 位）和 4（12 位）扩展、有损、非分层、
顺序、DCT、霍夫曼、8/12 位 SOP 类 = 1.2.840.10008.1.2.4.51
· JPEG 编码过程 10（8 位）和 12（12 位）全渐进，有损，无层次，
渐进式、DCT、霍夫曼、8/12 位 SOP 等级 = 1.2.840.10008.1.2.4.55
支持彩色和灰度图像。
可以禁用对扩展 JPEG 传输语法的支持 (--禁用分机 选项​​）
以及对（已停用的）渐进式 JPEG 传输语法的支持（--禁用程序
选项）。
JPEG 无损编码以及任何算术或分层 JPEG 编码模式都是
插件不支持。
JFIF（JPEG 文件交换格式）信息促进了可选的 APPn 标记
JPEG 文件。 许多数码相机并未将此类 JFIF 信息集成到 JPEG 中
他们创造的输出。 例如，JFIF 包含有关像素长宽比的信息
压缩后的图像。 如果你想要 图像2dcm 坚持使用 JFIF 标头的应用程序
JPEG 流，您可以使用该选项 --坚持-jfif 如果没有 JFIF，这将中止
信息可以查到。 默认情况下，忽略缺少的 JFIF 信息。
对于 DICOM 来说，它是一种“灰色地带”，无论是 JFIF（或任何其他 APPn）的集成
数据进入 DICOM 对象的内部 JPEG 流是否允许。 然而，最
可靠的方法是从 JPEG 流中删除这些标记及其信息。 这个
也采取了办法 图像2dcm 应用。 默认情况下，所有 APPn 标记都被剪切
从原始 JPEG 流中关闭。 但是，如果您想保留其他 APPn 标记而不是
DICOM 流中的 JFIF（例如 EXIF 信息），选项 --keep-appn 做的
诡计。 它也应该比切断APPn信息稍微快一点，因为它是
无需扫描整个 JPEG 流以获取此类数据。 JFIF 信息是 时刻
被移除 图像2dcm.
骨形态发生蛋白 输入 插件
图像2dcm 支持 BMP 作为输入格式。 然而，到目前为止，只有最常见的 BMP 图像是
支持的。 特别是，使用位域或运行长度编码的 BMP 图像将是
拒绝了。 这样的图像并不常见。 所有输入图像都将转换为 DICOM 图像
具有 RGB 颜色模型和 24 位深度。没有用于微调的特定选项
BMP 格式转换。
输出 插件
可以在命令行上选择所需的输出 SOP 类。 目前，出口
辅助捕获图像 SOP 类的插件（默认，选项 -sc)，新的中学
捕获图像 SOP 类（选项 -NSC) 和可见光摄影图像 SOP 类
（选项 -vl) 可用。 请注意，第一个已根据
DICOM 标准，但被选为默认值，因为它被广泛支持。 未来
版本 图像2dcm 可能会为其他 SOP 类提供更多输出插件。
对于新的二级捕获 SOP 类，无法指定哪个特定的
SOP 类应该用于输出。 那是因为这些新的 SOP 类是
通过颜色深度 (1/8/16) 和图像是否是
黑色/白色或彩色。 这就是为什么 图像2dcm 在转换期间决定哪个输出 SOP
类适用于给定的源图像。

示例

以下是一些示例，说明如何 图像2dcm 可以使用应用程序。
1. img2dcm image.jpg 输出.dcm
读取JPEG文件'image.jpg'，转换为旧的Secondary Capture SOP类并保存
结果到 DICOM 文件“out.dcm”。 这是最简单的使用方法 图像2dcm. 任何类型
编写此 SOP 类的有效对象所需的 1 和类型 2 属性是
自动插入。
2. img2dcm -i BMP 图像.bmp 输出.dcm
与上面相同，但告诉 img2dcm 读取 BMP 文件而不是 JPEG。
3. img2dcm image.jpg out.dcm -vlp -k 'PatientName=Bond^James'
与第一个示例相同，但将可见光摄影图像对象写入“out.dcm”
并将 PatientName 设置为 'Bond^James'，否则将留空。
4. img2dcm image.jpg out.dcm --series-from template.dcm -k 'PatientName=Bond^James'
与 1) 相同，但从 DICOM 文件导入患者/研究/系列信息
'模板.dcm'。 请注意，属性 PatientName 将包含 'Bond^James' 在
最后，'template.dcm' 中的任何值都将被覆盖。 也就是说，因为 -k
选项应用于转换管道的最末端（见上文）。
5. img2dcm image.jpg 输出.dcm --no-checks
同 1)，但不执行任何属性检查，也没有类型 1 和类型 2
属性插入！ 因此，在这种情况下，将生成无效的 DICOM 对象。 这个
如果输出文件不打算完成但将经历
进一步的转换，例如使用添加属性 修改. 仅使用选项 - 不-
检查 如果你知道你在做什么！
6. img2dcm image.jpg 输出.dcm --no-type1-invent
与 1) 相同，但不插入缺失的类型 1 属性和/或其值。 类型 2
将插入属性。 请注意，在这种情况下，必须确保所有类型 1
属性是通过其他方式提供的，即通过添加它们 - 钥匙 选项。
除此以外， 图像2dcm 将报告错误并停止转换。
7. img2dcm image.jpg 输出.dcm --keep-appn --insist-on-jfif
与 1) 相同，但将 EXIF 等 APPn 信息接收到 DICOM 对象的
生成的 JPEG 流。 更远， --坚持-jfif 将迫使 图像2dcm 如果没有则中止
JFIF 信息存在于源文件中。

记录

各种命令行工具和底层库的日志输出级别可以
由用户指定。 默认情况下，仅将错误和警告写入标准
错误流。 使用选项 --详细 还有信息性消息，如处理细节
被报道。 选项 -调试 可用于获取有关内部活动的更多详细信息，
例如用于调试目的。 可以使用选项选择其他日志记录级别 - 日志-
水平。在 - 安静的 模式只报告致命错误。 在如此严重的错误事件中，
申请通常会终止。 有关不同日志记录级别的更多详细信息，
请参阅模块“oflog”的文档。
如果应该将日志输出写入文件（可选择使用日志文件轮换），
到系统日志 (Unix) 或事件日志 (Windows) 选项 --日志配置 可以使用。 这个
配置文件还允许仅将某些消息定向到特定输出
流并根据模块或应用程序过滤某些消息
生成。 提供了一个示例配置文件 /logger.cfg.

指挥 LINE

所有命令行工具都使用以下参数表示法：方括号括起来
可选值 (0-1)，三个尾随点表示允许多个值
(1-n)，两者的组合意味着 0 到 n 值。
命令行选项通过前导“+”或“-”符号与参数区分开来，
分别。 通常，命令行选项的顺序和位置是任意的（即它们
可以出现在任何地方）。 但是，如果选项相互排斥，则最右边的外观
用来。 此行为符合常见 Unix shell 的标准评估规则。
此外，可以使用“@”符号作为前缀来指定一个或多个命令文件
文件名（例如 @命令.txt）。 这样的命令参数被替换为
相应的文本文件（多个空格被视为单个分隔符，除非
在任何进一步评估之前，它们出现在两个引号之间）。 请注意
命令文件不能包含另一个命令文件。 这种简单而有效的方法
允许总结选项/参数的常见组合并避免冗长和
令人困惑的命令行（文件中提供了一个示例 /dumppat.txt).

环境

图像2dcm 实用程序将尝试加载指定的 DICOM 数据字典
DCMDICT路径 环境变量。 默认情况下，即如果 DCMDICT路径 环境变量
未设置，文件 /dicom.dic 除非构建字典，否则将被加载
进入应用程序（Windows 的默认设置）。
默认行为应该是首选的，并且 DCMDICT路径 仅环境变量
当需要替代数据字典时使用。 这 DCMDICT路径 环境变量
具有与 Unix shell 相同的格式 PATH 冒号 (':') 分隔的变量
条目。 在 Windows 系统上，分号 (';') 用作分隔符。 数据字典
代码将尝试加载指定的每个文件 DCMDICT路径 环境变量。 它
如果无法加载数据字典，则是一个错误。

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