dcmqridx: DICOM画像ファイルを画像データベースのインデックスファイルに登録する

書式

dcmqridx [options] index-out [dcmfile-in...]

説明

dcmqridx ユーティリティは、dcmqrscp と dcmqrti が使用するデータベースのインデックスファイルにDICOM画像ファイルを登録します。画像ファイル自体はコピーされません。dcmqridx はインデックスファイルの内容を一覧表示することもできます。

引数

index-out   storage area for the index file (directory)

dcmfile-in  DICOM image file to be registered in the index file

オプション

-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 を使用します
-p --print: データベースのインデックスファイルの内容を一覧表示します
-n --not-new: インスタンスのレビュー状態を 'not new' に設定します

補足

dcmqridx は、コマンドラインで指定された各画像ファイルへの参照をデータベースのインデックスファイルに追加しようとします。

dcmqridx はデータベースのバックエンドのクォータ機構を無効にするため、画像ファイルが削除されることはありません。

ロギング

各コマンドラインツールおよび内部で使用するライブラリのロギング出力のレベルは、ユーザーが指定できます。既定では、エラーと警告のみが標準エラー出力に書き込まれます。オプション –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 にあります）。

環境変数

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

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

dcmqridx: DICOM画像ファイルを画像データベースのインデックスファイルに登録する

書式

説明

引数

オプション

補足

ロギング

コマンドライン

環境変数

関連項目

著作権