drtdump: DICOM RT ファイルとデータセットのダンプ

書式

drtdump [options] drtfile-in...

説明

drtdump は、DICOM 放射線治療（RT）オブジェクト（ファイル形式または生のデータセット）の内容をテキスト形式で標準出力にダンプするユーティリティです。出力には RT オブジェクトの主要な情報が含まれ、dcmdump による汎用的な出力よりおそらく読みやすい形式になっています。

drtdump が生のデータセット（ファイル形式のメタヘッダを持たない DICOM データ）を読み込む場合、ファイル先頭の数バイトを調べて転送構文を推測しようとします。転送構文を常に正しく推測できるとは限らないため、可能な限り（dcmconv ユーティリティを使って）データセットをファイル形式に変換しておくほうがよいでしょう。また、-f オプションと -t[ieb] オプションを使えば、特定の転送構文でデータセットを読むよう drtdump に強制することもできます。

引数

drtfile-in  DICOM RT input filename to be dumped ("-" for stdin)

オプション

全般オプション

-h --help: このヘルプを表示して終了します
--version: バージョン情報を表示して終了します
--arguments: 展開後のコマンドライン引数を表示します
-q --quiet: quiet モード。警告とエラーを表示しません
-v --verbose: verbose モード。処理の詳細を表示します
-d --debug: debug モード。デバッグ情報を表示します
-ll --log-level [l]evel: string constant: (fatal, error, warn, info, debug, trace) ロガーにレベル l を使用します
-lc --log-config [f]ilename: string: ロガーに設定ファイル f を使用します

入力オプション

+f --read-file: ファイル形式またはデータセットを読み込みます（既定値）
+fo --read-file-only: ファイル形式のみを読み込みます
-f --read-dataset: ファイルメタ情報を持たないデータセットを読み込みます。入力転送構文:
-t= --read-xfer-auto: TS の自動認識を使用します（既定値）
-td --read-xfer-detect: ファイルメタヘッダで指定された TS を無視します
-te --read-xfer-little: 明示的 VR リトルエンディアン TS で読み込みます
-tb --read-xfer-big: 明示的 VR ビッグエンディアン TS で読み込みます
-ti --read-xfer-implicit: 暗黙的 VR リトルエンディアン TS で読み込みます

出力オプション

printing:

  +Pf  --print-filename
         print header with filename for each input file

注記

DICOM 適合性

drtdump ユーティリティは次の SOP クラスをサポートします。

RTImageStorage                   1.2.840.10008.5.1.4.1.1.481.1
RTDoseStorage                    1.2.840.10008.5.1.4.1.1.481.2
RTStructureSetStorage            1.2.840.10008.5.1.4.1.1.481.3
RTPlanStorage                    1.2.840.10008.5.1.4.1.1.481.5
RTTreatmentSummaryRecordStorage  1.2.840.10008.5.1.4.1.1.481.7
RTIonPlanStorage                 1.2.840.10008.5.1.4.1.1.481.8
RTIonBeamsTreatmentRecordStorage 1.2.840.10008.5.1.4.1.1.481.9

ロギング

各コマンドラインツールおよびその基盤となるライブラリのロギング出力レベルは、ユーザーが指定できます。既定では、エラーと警告のみが標準エラー出力に書き出されます。–verbose オプションを使うと、処理の詳細などの情報メッセージも報告されます。–debug オプションを使うと、デバッグ目的などのために内部動作のより詳しい情報が得られます。その他のロギングレベルは –log-level オプションで選択できます。–quiet モードでは致命的エラーのみが報告されます。そのような非常に重大なエラーが発生した場合、アプリケーションは通常そこで終了します。各ロギングレベルの詳細については、モジュール "oflog" のドキュメントを参照してください。

ロギング出力をファイルに書き出したい場合（必要に応じてログファイルのローテーション付き）、あるいは syslog（Unix）やイベントログ（Windows）に書き出したい場合は、–log-config オプションを使用できます。この設定ファイルでは、特定のメッセージだけを特定の出力ストリームへ振り分けたり、メッセージを生成したモジュールやアプリケーションに基づいてフィルタリングしたりすることもできます。設定ファイルの例は < etcdir>/logger.cfg に用意されています。

コマンドライン

すべてのコマンドラインツールは、引数について次の表記法を用います。角括弧は省略可能な値（0〜1個）を囲み、末尾の三つのドットは複数の値（1〜n個）を指定できることを示します。両者を組み合わせると 0〜n個の値を意味します。

コマンドラインオプションは、先頭の '+' または '-' 記号によって引数と区別されます。通常、コマンドラインオプションの順序と位置は任意です（すなわちどこに置いても構いません）。ただし、相互に排他的なオプションについては、もっとも右側に現れたものが使われます。この挙動は一般的な Unix シェルの標準的な評価規則に準拠しています。

さらに、ファイル名の前に '@' 記号を付けることで、1つ以上のコマンドファイルを指定できます（例: @command.txt）。このコマンド引数は、それ以降の評価に先立って、対応するテキストファイルの内容に置き換えられます（複数の空白は、引用符で囲まれていない限り単一の区切りとして扱われます）。なお、コマンドファイルの中に別のコマンドファイルを含めることはできません。この単純だが効果的な仕組みにより、よく使うオプションや引数の組み合わせをまとめておくことができ、長くて分かりにくいコマンドラインを避けられます（例は < datadir>/dumppat.txt にあります）。

環境変数

drtdump ユーティリティは、DCMDICTPATH 環境変数で指定された DICOM データ辞書を読み込もうとします。既定では、すなわち DCMDICTPATH 環境変数が設定されていない場合は、辞書がアプリケーションに組み込まれていない限り（Windows では組み込みが既定）、ファイル < datadir>/dicom.dic が読み込まれます。

通常はこの既定の動作を用いるべきであり、DCMDICTPATH 環境変数は別のデータ辞書が必要な場合にのみ使用します。DCMDICTPATH 環境変数は Unix シェルの PATH 変数と同じ形式で、エントリをコロン（":"）で区切ります。Windows システムでは区切りにセミコロン（";"）を使います。データ辞書のコードは、DCMDICTPATH 環境変数で指定された各ファイルを読み込もうとします。データ辞書を1つも読み込めない場合はエラーとなります。