CTP DICOM Filter 影像條件篩選教學與範例

介紹如何透過 CTP DICOM Filter 的語法，撰寫影像篩選條件的指令稿，檢查與過濾 DICOM 影像資料。

CTP DICOM Filter

CTP DICOM Filter 是 CTP 處理流程中的一個處理步驟（stages），可透過指令稿所定義的篩選條件，從處理流程中挑出不符合條件的 DICOM 影像，存放於指定的隔離目錄下。

CTP DICOM Filter 指令稿語法

CTP DICOM Filter 指令稿是由一個或多個判斷條件所組成的，判斷條件的基本結構如下：

identifier.method("string")

其中 identifier 為 DICOM 的標籤，而 method("string") 則為匹配方法。

DICOM 標籤表示法

DICOM 的標籤可以使用 dcm4che 所定義的名稱或十六進位代碼來表示，例如：

SOPInstanceUID
[0008,0018]

若要表示 DICOM 的巢狀結構，可以使用雙冒號（::）分隔各層的 DICOM 標籤，例如：

SeqOfUltrasoundRegions::RegionLocationMinY0
[0018,6011]::[0018,601A]
SeqOfUltrasoundRegions::[0018,601A]

對於 DICOM 影像中的私有標籤（Private Data Elements），可以使用標準的十六進位代碼來表示，或是採用 Private Creator Data Element 的內容來表示。假設 [0029,0011] 這個 Private Creator Data Element 內容為 XYZ CT HEADER，則 [0029,1140] 這個私有標籤則可用以下兩種方式表示：

[0029,1140]
[0029[XYZ CT HEADER]40]

私有標籤構成的巢狀結構，也是同樣以雙冒號分隔各層的標籤，例如：

[0029[XYZ CT HEADER]40]::[0017[ALIGNMENT HEADER]42]

匹配方法

在 CTP DICOM Filter 的指令稿中可以使用以下幾種匹配方法，對 DICOM 標籤內容進行比對，若比對成功則傳回 true，否則傳回 false：

方法	說明
`equals("string")`	完全等於 `string`。
`equalsIgnoreCase("string")`	完全等於 `string`，不分大小寫。
`equals("regex")`	符合 `regex` 所指定的正規表示法。
`contains("string")`	包含 `string`。
`containsIgnoreCase("string")`	包含 `string`，不分大小寫。
`startsWith("string")`	以 `string` 開頭。
`startsWithIgnoreCase("string")`	以 `string` 開頭，不分大小寫。
`endsWith("string")`	以 `string` 結尾。
`endsWithIgnoreCase("string")`	以 `string` 結尾，不分大小寫。
`isLessThan("value")`	數值小於 `value`。
`isGreaterThan("value")`	數值大於 `value`。

如果在對 DICOM 影像進行標籤內容比對時，若指定的 DICOM 標籤不存在，則會視為空字串（""）。

isLessThan 與 isGreaterThan 在進行比對之前，會對 DICOM 標籤內容與指定參數進行前處理，將所有非數值的字元去除，將資料轉為雙精度浮點數（double precision floating point values）之後，再進行比對，若轉換失敗則傳回 false。

註解

所有雙斜線（//）之後到結尾的內容都會被視為註解，例如：

// 這是註解
PatientName.equals("xyz") // 這也是註解

邏輯運算子與括號

若要結合多種不同的判斷條件，可以使用邏輯運算子以及括號：

運算子	說明
`+`	OR 運算子。
`*`	AND 運算子。
`!`	NOT 運算子。
`()`	優先運算。

以下是使用邏輯運算子的範例：

// ImageType 包含 SECONDARY 或 DERIVED
ImageType.contains("SECONDARY") + ImageType.contains("DERIVED")

// ImageType 不包含 SECONDARY 或 DERIVED
!(ImageType.contains("SECONDARY") + ImageType.contains("DERIVED"))

// ImageType 不包含 SECONDARY 或 DERIVED
!ImageType.contains("SECONDARY") * !ImageType.contains("DERIVED")