dicom4ortho 0.1.1

dicom4ortho 0.1.1

一个 Python 库，用于在 DICOM 中创建完全定义的正畸照片。
浏览文档 »

查看演示 · 报告错误 · 请求功能

• 关于该项目
  • 内置
• 入门
  • 先决条件
  • 安装
  • 使用 dicom3tools 进行验证
• 用法
  • CSV 图像文件格式
    • 病人名字
    • 患者姓氏
    • 患者编号
    • 患者性别
    • 患者生日
    • 牙科提供者名字
    • 牙科提供者姓氏
    • 图像类型
    • 制造商
    • 输入图像文件名
    • study_instance_uid
    • study_description
    • series_instance_uid
    • series_description
• 路线图
• 贡献
• 执照
• 接触
• 致谢

关于该项目

DICOM 标准可供正畸社区中的任何开发人员实施。但是，它可能很复杂，并且实施可能很耗时。我们希望创建一个概念验证，以演示如何使用 DICOM 正确存储正畸可见光图像（又名照片），同时确保所有代码（唯一标识每种图像类型所必需的）都在正确的位置。

原因如下：

• 你的时间应该集中在创造一些令人惊奇的东西上。
• 能够在您的正畸软件中导入和导出 DICOM 图像将为您和正畸提供者打开大门。
• 没有一种软件可以完全服务于所有正畸提供者。添加互操作性将使您的产品能够与其他产品集成，从而为您的解决方案带来额外的价值。

您可以通过分叉此 repo 并创建拉取请求或打开问题来建议更改。感谢所有为这个项目做出贡献的人！

致谢中列出了我们认为有用的常用资源列表。

内置

• pydicom
• 枕头
• dicom3tools

入门

像任何其他 Python 模块一样，安装模块而不是使用它。还有一个 CLI 界面。

先决条件

• Python 3+ 的安装。
• 可选：dicom3tools

安装

通过运行安装 unsing pipenv

$ pipenv install dicom4ortho

通过运行使用 pip 安装

$ pip install dicom4ortho

仅支持 Python 3+

使用 dicom3tools 进行验证

dicom3tools 用于验证，仅在使用该--validate 选项时使用。这只是一个方便的调试包装器，正常运行不需要安装。

dicom3tools可以从已编译的二进制文件中安装，这些二进制文件可用于 macOS 和 Windows 。

安装后，指向dicom3toolsDICOM3TOOLS_PATH的defaults.py安装。

用法

DICOM 图像需要大量不包含在平面 PNG 或 JPEG 图像中的信息。在生产环境中，这些信息通常来自练习管理软件或照片管理软件。

将此信息提供给dicom4orthoCLI 的最简单方法是使用 CSV 文件。您可以在此处找到示例 CSV 文件

安装后，如有必要，启动虚拟环境：

pipenv shell

然后像这样使用 dicom4ortho：

$ dicom4ortho <filename>

filename文件应该在哪里.csv。计划通过参数传递带有元数据的单个图像文件以供将来实现。

CSV 图像文件格式

CSV 文件应为：

• ,作为分隔符
• UTF-8编码

每个 CSV 文件应包含以下列（标题）

病人名字

病人的名字。DICOM 标签的第一部分(0010, 0010) Patient's Name。

患者姓氏

患者姓氏。DICOM 标签的第二部分(0010, 0010) Patient's Name。

患者编号

病人身份证。DICOM(0010, 0020) Patient ID标记。

患者性别

患者性别。DICOM(0010, 0040) Patient's Sex标记。

患者生日

患者的出生日期，格式为 YYYY-MM-DD。DICOM(0010, 0030) Patient's Birth Date标记。

牙科提供者名字

正畸（或牙科）提供者的名字。(0008, 0090) Referring Physician's NameDICOM标签的第一部分。

牙科提供者姓氏

正畸（或牙科）提供者的姓氏。(0008, 0090) Referring Physician's NameDICOM标签的第二部分。

图像类型

ADA SCDI WP-1100 定义的图像类型。类型

dicom4ortho list-image-types

获取允许的图像类型列表。

制造商

相机制造商。例如，使用 iPhone 时，请Apple 在此处使用。覆盖输入文件的 EXIF 元数据。

输入图像文件名

用作输入的平面 JPG/PNG/TIFF 图像文件的完整路径。

study_instance_uid

将该研究与任何其他研究区分开来的唯一标识符。出于正畸目的，在同一患者就诊期间拍摄的所有图像都应进行同一研究，因此具有相同的研究 UID。

这是一个 DICOM UID 对象并进入 DICOM(0020, 000d) Study Instance UID标记。确切的格式在DICOM 第 5 部分数据结构和编码 - 值编码 - 值表示中定义

study_description

此特定研究的描述。对于正畸目的，该值可能类似于“初始就诊”。

这是一个 DICOM UID 对象并进入 DICOM (0008, 1030) Study Description。根据DICOM LO VR的定义，最多允许 64 个字符

series_instance_uid

将此系列与任何其他系列区分开来的唯一标识符。出于正畸目的，使用相同成像设备（对于照片，这将是相机）和在相同研究期间（因此预约访问）拍摄的所有图像应该是同一系列的一部分，因此具有相同的系列 UID。

这是一个 DICOM UID 对象并进入 DICOM(0020, 000e) Series Instance UID标签。确切的格式在DICOM 第 5 部分数据结构和编码 - 值编码 - 值表示中定义

series_description

此特定系列的说明。对于正畸目的，该值可能类似于“正畸口内系列”。

这是一个 DICOM UID 对象并进入 DICOM (0008, 103e) Series Description。根据DICOM LO VR的定义，最多允许 64 个字符

路线图

请参阅未解决的问题以获取建议功能（和已知问题）的列表。

贡献

贡献使开源社区成为学习、启发和创造的绝佳场所。非常感谢您所做的任何贡献。

1. 分叉项目
2. 创建您的功能分支 ( git checkout -b feature/AmazingFeature)
3. 提交您的更改 ( git commit -m 'Add some AmazingFeature')
4. 推送到分支 ( git push origin feature/AmazingFeature)
5. 打开拉取请求

执照

根据 MIT 许可证分发。有关更多信息，请参阅许可证。

接触

Toni Magni- @zgypa - open-ortho@ afm.co

项目链接：https ://github.com/open-ortho/dicom4ortho

致谢

• DICOM
• 美国牙科协会牙科信息学标准委员会