PyDICOM 使用指南

最新推荐文章于 2025-05-16 10:55:15 发布

原创最新推荐文章于 2025-05-16 10:55:15 发布 · 1k 阅读

21 ·

CC 4.0 BY-SA版权

PyDICOM 使用指南

项目地址:https://gitcode.com/gh_mirrors/pyd/pydicom

项目介绍

PyDICOM 是一个纯 Python 的库，旨在简化 DICOM（Digital Imaging and Communications in Medicine）文件的读取、修改和写入过程。它以一种“Pythonic”的方式提供了对 DICOM 数据集的操作能力。作为一个跨平台的工具，PyDICOM 无需其他依赖即可运行，但在处理像素数据时推荐安装 NumPy 以提高效率。PyDICOM 着重于通用的 DICOM 数据操作，并不直接处理特定的服务对象类（SOP）或协议细节，这使得它成为一个灵活的基础框架。对于更专业的 DICOM 应用需求，如 DICOM 网络交互或匿名化处理，可以结合如 pynetdicom 或 deid 等基于 PyDICOM 的其他库。

项目快速启动

要迅速开始使用 PyDICOM，首先确保你已经安装了它。可以通过以下命令进行安装：

pip install pydicom

或者如果你使用的是 Anaconda，可以通过 conda 安装：

conda install -c conda-forge pydicom

接下来，简单的示例来展示如何读取并打印一个 DICOM 文件的基本信息：

from pydicom import dcmread

# 获取测试数据的路径
path_to_dcm = 'path/to/your/dicom/file.dcm'
ds = dcmread(path_to_dcm)
print(ds)

这段代码将加载指定路径下的 DICOM 文件并打印其元数据。

应用案例和最佳实践

修改患者信息

在处理 DICOM 文件时，我们常需修改敏感信息，例如患者 ID：

from pydicom import dcmread

# 读取 DICOM 文件
ds = dcmread('/path/to/file.dcm')
# 修改患者ID
ds.PatientID = '新ID号'
# 保存修改后的文件
ds.save_as('/path/to/newfile.dcm')

显示像素数据

借助 NumPy 和 Matplotlib，你可以展示 DICOM 图像：

import matplotlib.pyplot as plt
from pydicom import dcmread

# 读取 DICOM 文件的路径
path = 'path/to/image.dcm'
ds = dcmread(path)
# 将像素数据转换为图像并显示
plt.imshow(ds.pixel_array, cmap=plt.cm.gray)
plt.show()