dcmpsmk: DICOM グレースケールソフトコピープレゼンテーションステートの作成

書式

dcmpsmk [options] dcmfile-in dcmfile-out

説明

dcmpsmk ユーティリティは DICOM 画像ファイルを読み込み、Supplement 33 に従ってグレースケールソフトコピープレゼンテーションステートオブジェクトを作成します。作成したプレゼンテーションステートオブジェクトはファイルへ書き戻されます。画像ファイルに含まれる可能性のある各種構造を、プレゼンテーションステート内でどのように参照・有効化するかは、複数のコマンドラインオプションで指定できます。新しく作成したプレゼンテーションステートは元画像を参照し、プレゼンテーションステートの制御下でレンダリングしたときに「妥当な」表示が得られるような値を保持します。

引数

dcmfile-in   DICOM image file(s) to be read ("-" for stdin)

dcmfile-out  DICOM presentation state file to be created ("-" for stdout)

オプション

全般オプション

-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: 転送構文の自動認識を使用します（既定値）
-td --read-xfer-detect: ファイルメタヘッダで指定された転送構文を無視します
-te --read-xfer-little: explicit VR little endian の転送構文で読み込みます
-tb --read-xfer-big: explicit VR big endian の転送構文で読み込みます
-ti --read-xfer-implicit: implicit VR little endian の転送構文で読み込みます

処理オプション

+Vl --voi-lut: 存在すれば最初の VOI LUT を使用します（既定値）
+Vw --voi-window: 存在すれば最初の window center/width を使用します
-V --voi-ignore: VOI LUT および window center/width を無視します。カーブの扱い:
+c --curve-activate: 存在すればカーブデータを有効化します（既定値）
-c --curve-ignore: カーブデータを無視します。オーバーレイの扱い:
+oc --overlay-copy: 埋め込まれていなければオーバーレイをコピーし、そうでなければ有効化します（既定値）
+oa --overlay-activate: オーバーレイを有効化します
-o --overlay-ignore: オーバーレイを無視します。シャッターの扱い:
+s --shutter-activate: 画像に存在すればシャッターを使用します（既定値）
-s --shutter-ignore: シャッターを無視します。プレゼンテーション LUT 形状の扱い:
+p --plut-activate: 存在すればプレゼンテーション LUT 形状を使用します（既定値）
-p --plut-ignore: プレゼンテーション LUT 形状を無視します。レイヤリング:
+l1 --layer-single: すべてのカーブとオーバーレイを 1 つのレイヤーに配置します
+l2 --layer-double: カーブ用に 1 レイヤー、オーバーレイ用に 1 レイヤーを割り当てます（既定値）
+ls --layer-separate: 各カーブと各オーバーレイを個別のレイヤーに分けます。参照画像の所在:
-lx --location-none: 所在を伴わない画像参照（既定値）
-ln --location-network [a]etitle: string: アプリケーションエンティティ a に所在する画像
-lm --location-media [f]ilesetID, fileset[UID]: string: 記憶媒体上に所在する画像

検証オプション

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

出力オプション

+t= --write-xfer-same: 画像ファイルと同じ転送構文で書き込みます（既定値）
+te --write-xfer-little: explicit VR little endian の転送構文で書き込みます
+tb --write-xfer-big: explicit VR big endian の転送構文で書き込みます
+ti --write-xfer-implicit: implicit VR little endian の転送構文で書き込みます

注記

複数の入力ファイル（dcmfile-in）を指定した場合、追加の画像ファイルは作成されるプレゼンテーションステートファイルから参照されるだけで、それ以上の情報（表示に関する情報など）は取り込まれません。

ロギング

各コマンドラインツールおよび基盤となるライブラリのロギング出力のレベルは、ユーザーが指定できます。既定では、エラーと警告のみが標準エラー出力へ書き出されます。オプション –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）。このようなコマンド引数は、それ以降の評価に先立って、対応するテキストファイルの内容に置き換えられます（連続する空白は、引用符で囲まれている場合を除き、1 つの区切りとして扱われます）。なお、コマンドファイルの中に別のコマンドファイルを含めることはできません。この単純だが効果的な仕組みにより、よく使うオプションや引数の組み合わせをまとめておけるため、長く分かりにくいコマンドラインを避けられます（例は < datadir>/dumppat.txt に用意されています）。

環境変数

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

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