dcm2niix项目中GE数据相位编码方向显示问题的分析与修复

dcm2niix项目中GE数据相位编码方向显示问题的分析与修复

【免费下载链接】dcm2niix dcm2nii DICOM to NIfTI converter: compiled versions available from NITRC 项目地址: https://gitcode.com/gh_mirrors/dc/dcm2niix

问题背景

在医学影像处理领域，dcm2niix是一个广泛使用的DICOM到NIfTI格式转换工具。近期在该项目的开发版本中发现了一个关于GE(通用电气)磁共振设备采集数据的相位编码方向显示问题。

问题描述

开发版本在处理GE设备采集的数据时，错误地将相位编码方向(PhaseEncodingDirectionDisplayed)字段输出为"EPI2"。经过分析，这是由于代码逻辑中错误地复用了为UIH设备设计的处理路径导致的。

技术分析

在dcm2niix的源代码中，存在以下关键逻辑：

1. 对于GE数据，setBidsGE函数中复用了d->phaseEncodingDirectionDisplayedUIH字段
2. 后续代码中无条件地将该字段输出到JSON元数据中
3. 这一设计原本是为UIH设备准备的，但不恰当地应用到了GE设备上

解决方案

项目维护者提出了两种修复方案：

1. 仅当设备不是GE时输出该字段
2. 明确限定仅在设备是UIH时输出该字段

最终采用了第二种更明确的方案，通过添加条件判断：

if (d.manufacturer == kMANUFACTURER_UIH)
    json_Str(fp, "\t\"PhaseEncodingDirectionDisplayed\": \"%s\",\n", d.phaseEncodingDirectionDisplayedUIH);

修复验证

该修复已在PR v1.0.20240123中提交，并使用GE设备的样本数据集进行了验证，确认解决了相位编码方向显示错误的问题。

技术意义

这个修复保证了：

1. GE设备数据的元数据准确性
2. 不同厂商设备数据处理逻辑的清晰分离
3. BIDS格式输出的规范性

对于使用dcm2niix处理GE磁共振数据的用户，这一修复将确保相位编码方向信息的正确记录，避免后续分析中的潜在错误。

【免费下载链接】dcm2niix dcm2nii DICOM to NIfTI converter: compiled versions available from NITRC 项目地址: https://gitcode.com/gh_mirrors/dc/dcm2niix