dcmpschk: プレゼンテーションステートの検査ツール

書式

dcmpschk [options] [dcmfile-in...]

説明

dcmpschk ユーティリティは、DICOM の Grayscale Softcopy Presentation State オブジェクトが規格に準拠しているかを検査します。検査は次の3つのフェーズで行われます。

フェーズ1では、DICOM ファイルのメタヘッダを検査します。必須属性がすべて存在するか、SOP クラスUID とインスタンスUID がメインオブジェクト内の UID と一致するか、グループ長属性が正しい値を持つかを確認します。メタヘッダの転送構文も検査します。
フェーズ2では、オブジェクト内の各属性について、値・値表現（VR）・値多重度（VM）の構文的な検査を行います。検査対象オブジェクトに含まれる値を、DICOM データ辞書の定義と照合します。
フェーズ3では、プレゼンテーションステートの整合性について意味的な検査を行います。他の SOP クラスのオブジェクトが見つかった場合、このフェーズは省略されます。フェーズ1と2は、任意の SOP クラスの他の DICOM オブジェクトにも適用できます。なお、dcmpschk は Mask Module を含むプレゼンテーションステートには対応していません。これらは Mask Module は未対応である旨のメッセージとともに拒否されます。

引数

dcmfile-in  presentation state file(s) to be checked

オプション

一般オプション

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

検証オプション

--validate-std: GSPS から参照される画像は同一の SOP クラスに属していなければならない（既定値）
--validate-related: GSPS から参照される画像は、関連する 'for presentation' および 'for processing' の SOP クラスに属していてもよい
--validate-relaxed: GSPS から参照される画像は任意の SOP クラスでよい

ロギング

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

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

コマンドライン

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

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

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

環境

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

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