dicomContours

DICOM-RT 構造体セットからの ROI データの抽出

R2020a 以降

説明

dicomcontours オブジェクトは、関心領域 (ROI) データを DICOM-RT 構造体セット ファイルのメタデータから抽出して格納します。オブジェクト関数を使用して、この ROI データからマスクを追加、削除、表示、変更、作成できます。詳細については、オブジェクト関数を参照してください。

作成

構文

contour = dicomContours(info)

説明

contour = dicomContours(info) は、指定された DICOM メタデータ info の構造体セットと ROI 輪郭モジュールからの ROI データを格納する dicomCountours オブジェクトを作成します。

入力引数

info — DICOM メタデータ

構造体配列

DICOM メタデータ。構造体配列として指定します。このメタデータは、有効な RT 構造体セット ファイルに対応していなければなりません。関数 dicominfo を使用して、DICOM-RT 構造体セット ファイルからメタデータを読み取ることができます。

データ型: struct

プロパティ

ROIs — ROI データ

M 行 5 列のテーブル

この プロパティ は読み取り専用です。

ROI データ。M 行 5 列のテーブルとして返されます。ここで M は、DICOM メタデータで定義されている ROI シーケンスの番号です。テーブルの各行のエントリは、1 つの ROI シーケンスを定義します。テーブルには、以下の列があります。

列	説明
Number	ROI の識別番号。スカラー整数として返されます。この番号は、構造体セットの ROI シーケンスの ROI 番号を参照します。
Name	ROI の名前。文字ベクトルとして返されます。この名前は、構造体セットの ROI シーケンスの ROI 名を参照します。
ContourData	ROI の輪郭を定義する点。cell 配列として返されます。セルの数は、ROI 内に定義される軸スライスの数に一致します。各セルには、N 行 3 列の行列が含まれます。この行列の行は、[x y z] 形式で 1 つの軸スライスの座標データを指定します。N は、輪郭内の点の数です。これらの座標は、患者ベースの座標系で輪郭を定義します。
GeometricType	輪郭の幾何学的タイプ。文字ベクトルとして返されます。幾何学的タイプの値は、以下のオプションのいずれかになります。 POINT OPEN_PLANAR OPEN_NONPLANAR CLOSED_PLANAR
Color	ROI の表示色。範囲 [0, 255] の値をもつ RGB 3 成分 [r, g, b] として返されます。

データ型: table

オブジェクト関数

addContour	ROI データへの ROI シーケンスの追加
convertToInfo	DICOM メタデータへの ROI データの書き込み
createMask	dicomContours オブジェクトからのボリューム マスクの作成
deleteContour	ROI データからの ROI シーケンスの削除
plotContour	DICOM-RT 構造体セットの ROI 輪郭データのプロット

例

DICOM-RT 構造体セットからの ROI データの抽出

関数dicominfoを使用して、DICOM-RT 構造体セット ファイルから DICOM メタデータを読み取ります。

info = dicominfo("rtstruct.dcm");

DICOM メタデータの構造体セットと ROI 輪郭モジュールから、ROI データを抽出します。出力は、抽出した ROI データを格納する dicomContours オブジェクトです。

contour = dicomContours(info);

dicomContours オブジェクトの詳細を表示します。

contour

contour = 
  dicomContours with properties:

    ROIs: [2x5 table]

dicomContours オブジェクトの ROIs プロパティを表示します。ROIs プロパティは、抽出した ROI データを含むテーブルです。

contour.ROIs

ans=2×5 table
    Number          Name           ContourData    GeometricType       Color    
    ______    _________________    ___________    _____________    ____________

      1       {'Body_Contour' }    {90x1 cell}     {90x1 cell}     {3x1 double}
      2       {'Tumor_Contour'}    {21x1 cell}     {21x1 cell}     {3x1 double}

バージョン履歴

R2020a で導入

参考

関数

• dicominfo | dicomwrite

トピック

• Add and Modify ROIs of DICOM-RT Contour Data
• Create and Display 3-D Mask of DICOM-RT Contour Data