Ruby DICOM 技术文档

1. 安装指南

系统要求

• Ruby 1.9.3 或更高版本（如果使用 Ruby 1.8，请使用 0.9.1 版本的 gem）。

安装步骤

1. 打开终端或命令行工具。
2. 运行以下命令安装 dicom gem：

   gem install dicom
   

2. 项目使用说明

加载与包含

首先，需要在 Ruby 脚本中加载并包含 DICOM 模块：

require 'dicom'
include DICOM

读取、修改和写入 DICOM 文件

• 读取文件：

  dcm = DObject.read("some_file.dcm")
  

• 提取患者姓名：

  dcm.patients_name.value
  

• 修改患者姓名：

  dcm.patients_name = "Anonymous"
  

• 删除数据元素：

  dcm.pixel_data = nil
  

• 写入文件：

  dcm.write("new_file.dcm")
  

使用标签字符串进行修改

• 提取患者姓名：

  dcm.value("0010,0010")
  

• 修改患者姓名：

  dcm["0010,0010"].value = "Anonymous"
  

• 删除数据元素：

  dcm.delete("7FE0,0010")
  

提取 DICOM 对象信息

• 显示文件属性摘要：

  dcm.summary
  

• 打印所有数据元素：

  dcm.print
  

• 转换为嵌套哈希：

  dcm.to_hash
  

处理像素数据

• 获取像素数据：

  dcm.pixels
  

• 加载到数值数组（NArray）：

  dcm.narray
  

• 加载到 RMagick 图像对象并显示：

  dcm.image.normalize.display
  

传输 DICOM 文件

• 发送本地文件到服务器：

  node = DClient.new("10.1.25.200", 104)
  node.send("some_file.dcm")
  

启动 DICOM 服务器

• 启动存储提供者：

  s = DServer.new(104, :host_ae => "MY_DICOM_SERVER")
  s.start_scp("C:/temp/")
  

日志设置

• 更改日志级别：

  DICOM.logger.level = Logger::ERROR
  

• 设置文件日志：

  l = Logger.new('my_logfile.log')
  DICOM.logger = l
  

• 创建每日/每月日志：

  DICOM.logger = Logger.new('foo.log', 'daily')
  DICOM.logger = Logger.new('foo.log', 'monthly')
  

IRB 提示

在 IRB 中使用 Ruby DICOM 时，可以通过在命令后添加 ;0 来避免自动打印信息：

dcm = DObject.read("some_file.dcm") ;0

3. 项目 API 使用文档

DObject 类

• read(file_path)：读取 DICOM 文件。
• write(file_path)：写入 DICOM 文件。
• value(tag)：根据标签提取值。
• delete(tag)：删除指定标签的数据元素。
• summary：显示文件属性摘要。
• print：打印所有数据元素。
• to_hash：转换为嵌套哈希。
• pixels：获取像素数据。
• narray：加载像素数据到数值数组。
• image.normalize.display：加载像素数据到 RMagick 图像对象并显示。

DClient 类

• new(ip, port)：创建客户端实例。
• send(file_path)：发送 DICOM 文件到服务器。

DServer 类

• new(port, options)：创建服务器实例。
• start_scp(directory)：启动存储提供者。

日志设置

• DICOM.logger.level = Logger::LEVEL：设置日志级别。
• DICOM.logger = Logger.new(file_path, interval)：设置日志文件。

4. 项目安装方式

使用 Gem 安装

gem install dicom

手动安装

1. 下载 dicom gem 文件。
2. 运行以下命令安装：

   gem install dicom-x.x.x.gem
   

通过以上步骤，您可以顺利安装并使用 Ruby DICOM 库进行 DICOM 文件的读取、修改、写入以及网络传输等操作。