RT-Utils 安装和配置指南

RT-Utils 安装和配置指南

rt-utils 项目地址: https://gitcode.com/gh_mirrors/rt/rt-utils

1. 项目基础介绍和主要编程语言

项目基础介绍

RT-Utils 是一个用于创建和操作 DICOM RTStructs 的 Python 库。RTStructs 是医学影像中用于描述放射治疗计划中的结构化数据的标准格式。RT-Utils 旨在简化 RTStructs 的创建、加载、修改和保存过程，使得医生和其他用户能够更方便地查看和处理医学影像的分割结果。

主要编程语言

RT-Utils 主要使用 Python 编程语言开发。

2. 项目使用的关键技术和框架

关键技术

• DICOM: 医学数字成像和通信标准，RT-Utils 主要处理 DICOM 格式的医学影像数据。
• RTStructs: 放射治疗结构化数据，用于描述放射治疗计划中的结构化信息。
• Numpy: 用于处理和操作多维数组和矩阵数据。
• Pydicom: 一个用于处理 DICOM 文件的 Python 库。

框架

• Python: RT-Utils 完全基于 Python 开发，利用 Python 的强大生态系统和丰富的库来实现功能。

3. 项目安装和配置的准备工作和详细安装步骤

准备工作

在开始安装 RT-Utils 之前，请确保您的系统满足以下要求：

• Python 3.6 或更高版本: RT-Utils 需要 Python 3.6 或更高版本。
• pip: Python 的包管理工具，用于安装 Python 库。

详细安装步骤

步骤 1: 安装 Python

如果您还没有安装 Python，请访问 Python 官方网站 下载并安装适合您操作系统的 Python 版本。安装过程中，请确保勾选“Add Python to PATH”选项。

步骤 2: 安装 pip

大多数现代 Python 安装包中已经包含了 pip。您可以通过以下命令检查 pip 是否已安装：

pip --version

如果 pip 未安装，请参考 pip 安装指南 进行安装。

步骤 3: 安装 RT-Utils

使用 pip 安装 RT-Utils：

pip install rt_utils

步骤 4: 验证安装

安装完成后，您可以通过以下 Python 代码验证 RT-Utils 是否安装成功：

import rt_utils
print(rt_utils.__version__)

如果成功输出版本号，说明 RT-Utils 已正确安装。

配置和使用

RT-Utils 的使用非常简单，以下是一个基本的示例代码，展示如何创建一个新的 RTStruct：

from rt_utils import RTStructBuilder

# 创建新的 RTStruct，需要提供 DICOM 系列路径
rtstruct = RTStructBuilder.create_new(dicom_series_path="/testlocation")

# 添加 ROI，这里假设您已经通过某种方式（如机器学习模型）生成了 3D 掩码
rtstruct.add_roi(mask=MASK_FROM_ML_MODEL)

# 保存 RTStruct
rtstruct.save('new-rt-struct')

通过以上步骤，您已经成功安装并配置了 RT-Utils，可以开始使用它来处理 DICOM RTStructs 了。

rt-utils 项目地址: https://gitcode.com/gh_mirrors/rt/rt-utils