C# 操作DICOM SR文件 C#如何解析医疗影像的结构化报告

来源:这里教程网 时间:2026-02-21 17:42:04 作者:

DicomDataset.Read
读取 SR 文件时为什么报“Unsupported transfer syntax”

DICOM SR(Structured Report)不是普通图像,它依赖特定传输语法(Transfer Syntax),比如

1.2.840.10008.1.2.1
(Explicit VR Little Endian)或
1.2.840.10008.1.2.1.99
(Deflated Explicit VR Little Endian)。直接用
DicomDataset.Read
读原始文件,若未启用对应解码器,就会抛出这个错误。

解决方法很简单:在读取前注册解码器。常见漏掉的是 Deflate 解压支持——很多 SR 文件被压缩过。

调用
DicomEncoding.RegisterEncoding(DicomTransferSyntax.DeflatedExplicitVRLittleEndian)
,再读
如果仍失败,检查文件头前 128 字节是否有 DICOM 导言(DICM),没有的话可能是纯 XML 或封装格式(如 ZIP),得先解包 别用
File.ReadAllBytes
+
DicomDataset.Read
硬读,优先用
DicomFile.Open
,它自动处理导言和传输语法协商

DicomStructuredReport
解析后拿不到内容项(Content Items)

SR 的核心是树状的

ContentSequence
,但
DicomStructuredReport
构造后默认不展开嵌套结构——它只加载顶层数据集,深层内容项需手动遍历
Root.ContentSequence

容易误以为“解析成功了但内容为空”,其实是没往下钻。

不要只看
Root.CodeValue
Root.RelationshipType
,这些只是根节点元信息
用递归方式遍历
ContentSequence
,每个项是
DicomContentItem
,其
ValueType
决定怎么取值(如
CODE
CodeValue
TEXT
TextValue
注意
ContentSequence
可能为空,但子节点藏在
ContentTemplateSequence
里(尤其 IOD 模板化报告),得查
TemplateIdentifier

从 SR 提取测量值时,
MeasuredValueSequence
里的数值单位对不上

DICOM SR 中的测量值(如病灶长径、CT 值)都封装在

MeasuredValueSequence
,但它不直接存数字,而是存
NumericValue
DS
类型)、
MeasurementUnitsCodeSequence
(单位编码)两部分。单位不是字符串,是标准 SNOMED CT 或 UCUM 编码。

直接 ToString() 会丢单位,硬转 double 可能因小数位数丢失精度。

NumericValue
string
,要用
decimal.TryParse
而非
double.Parse
,避免浮点误差(DICOM 要求 DS 保留原始精度)
单位编码查
CodeValue
+
CodingSchemeDesignator
,例如
CodeValue="258680004"
+
CodingSchemeDesignator="SCT"
对应 “millimeter”
别忽略
MeasurementAccuracy
MeasurementMethodCodeSequence
,临床系统常靠它们判断可信度

用 fo-dicom 生成 SR 时,写入后 PACS 拒收或显示乱码

生成合法 SR 不只是填字段,必须满足 IOD(Information Object Definition)约束:模板 ID、必需属性、关系路径、编码一致性。PACS 拒收往往卡在

ContentTemplateSequence
缺失或
TemplateIdentifier
错误。

中文文本乱码多因字符集声明不匹配——DICOM 默认 ISO_IR 192(UTF-8),但有些旧 PACS 仍期望 ISO_IR 100(Latin-1)。

新建
DicomStructuredReport
时显式指定
SpecificCharacterSet = "ISO_IR 192"
所有文本字段(
TextValue
PersonName
)必须 UTF-8 编码,且
DicomDataset
SpecificCharacterSet
属性要同步设置
模板 ID 必须来自 DICOM 标准(如 TID 1500 “Imaging Measurement Report”),自定义 ID 需在
MappingResource
中声明,否则 PACS 当非法
写入前用
DicomFile.Save
保存为文件,再用
dcmtk
dcmdump
检查
(0040,0005) Content Template Identifier
是否存在且格式正确

SR 的结构比表面看起来深得多,一个

ContentItem
RelationshipType
CONTAINS
还是
HAS OBS CONTEXT
,直接影响下游系统如何渲染和索引。别只盯着值,关系链才是关键。

相关推荐