用 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,直接影响下游系统如何渲染和索引。别只盯着值,关系链才是关键。
