dcmrt: 放射線治療ライブラリとユーティリティアプリ群

このモジュールには、各種の DICOM 放射線治療（RT）オブジェクトを読み書き・生成・変更・参照するためのクラスが含まれます。これらのクラスは、公式の DocBook/XML 版 DICOM 規格から自動生成されています。

主なインターフェースクラスは次のとおりです。

この低レベルインターフェースをより扱いやすくするため、よく使う機能を提供する手書きのクラスもいくつか用意されています。

それらのクラスは次のとおりです。

ツール

このモジュールには次のコマンドラインツールが含まれます。

drtdump: Dump DICOM RT file and data set

例

次の例は、RT Dose ファイルを読み込み、患者名を出力する方法を示します。

DcmFileFormat fileformat;
OFCondition status = fileformat.loadFile("rtdose.dcm");
if (status.good())
{
 DRTDoseIOD rtdose;
  status = rtdose.read(*fileformat.getDataset());
 if (status.good())
  {
 OFString patientName;
    status = rtdose.getPatientName(patientName);
 if (status.good())
    {
      cout << "Patient's Name: " << patientName << endl;
    } else
      cerr << "Error: cannot access Patient's Name (" << status.text() << ")" << endl;
  } else
    cerr << "Error: cannot read RT Dose object (" << status.text() << ")" << endl;
} else
  cerr << "Error: cannot load DICOM file (" << status.text() << ")" << endl;

次の例は、RT Dose ファイルを読み込み、スケール済みの線量画像にアクセスする方法を示します。

DRTDose rtdose;
OFCondition status = rtdose.loadFile("rtdose.dcm");
if (status.good())
{
 const unsigned int frame = 0;
 OFVector<double> doseImage;
  status = rtdose.getDoseImage(doseImage, frame);
 if (status.good())
  {
 OFVector<double>::iterator it = doseImage.begin();
 for (int y = 0; y < doseImage.getDoseImageHeight(); ++y)
    {
 for (int x = 0; x < doseImage.getDoseImageWidth(); ++x)
      {
 double value = *it++;
 /* do something useful with the dose image pixel */
      }
    }
  } else
    cerr << "Error: cannot read RT Dose image (" << status.text() << ")" << endl;
} else
  cerr << "Error: cannot load RT Dose object (" << status.text() << ")" << endl;

次の例は、RT Plan ファイルを読み込み、患者名を変更して新しいファイルに保存する方法を示します。

DcmFileFormat fileformat;
OFCondition status = fileformat.loadFile("rtplan.dcm");
if (status.good())
{
 DRTPlanIOD rtplan;
  status = rtplan.read(*fileformat.getDataset());
 if (status.good())
  {
    status = rtplan.setPatientName("Doe^John");
 if (status.good())
    {
      fileformat.clear();
      status = rtplan.write(*fileformat.getDataset());
 if (status.good())
      {
        status = fileformat.saveFile("rtplan_new.dcm");
 if (status.bad())
          cerr << "Error: cannot save DICOM file (" << status.text() << ")" << endl;
      } else
        cerr << "Error: cannot write RT Plan object (" << status.text() << ")" << endl;
    } else
      cerr << "Error: cannot change Patient's Name (" << status.text() << ")" << endl;
  } else
    cerr << "Error: cannot read RT Plan object (" << status.text() << ")" << endl;
} else
  cerr << "Error: cannot load DICOM file (" << status.text() << ")" << endl;

既知の問題

このモジュールのクラスの多くは機械可読版の DICOM 規格から自動生成されており、RT オブジェクトでは同じシーケンス属性を場所ごとに異なる内容で「再利用」することが知られています。そのため、一部のサブシーケンスでは定義の誤りに起因する問題がまだ残っている可能性があります。たとえば、Referenced Beam Sequence (300C,0004) と Referenced SOP Sequence (0008,1199) は、まだ完全には正しく扱えていない可能性のある候補です。