dcmscale: DICOM画像を拡大縮小する

書式

dcmscale [options] dcmfile-in dcmfile-out

説明

dcmscale ユーティリティは DICOM 画像を読み込み、コマンドラインの設定に従って拡大縮小し、その結果を DICOM 画像として書き戻します。このユーティリティが扱えるのは非圧縮および RLE 圧縮の DICOM 画像のみです。

引数

dcmfile-in   DICOM input filename to be scaled ("-" for stdin)

dcmfile-out  DICOM output filename to be written ("-" for stdout)

オプション

全般オプション

-h --help: このヘルプを表示して終了します
--version: バージョン情報を表示して終了します
--arguments: 展開後のコマンドライン引数を表示します
-q --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 を使用します

入力オプション

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

画像処理・エンコードオプション

+a --recognize-aspect: 拡大縮小時にピクセルのアスペクト比を考慮します（既定値）
-a --ignore-aspect: 拡大縮小時にピクセルのアスペクト比を無視します
+i --interpolate [n]umber of algorithm: integer: 拡大縮小時に補間を行います（1..4、既定値: 1）
-i --no-interpolation: 拡大縮小時に補間を行いません
-S --no-scaling: 拡大縮小せず、ピクセルのアスペクト比を無視します（既定値）
+Sxf --scale-x-factor [f]actor: float: x 軸を factor 倍に拡大縮小し、y 軸を自動計算します
+Syf --scale-y-factor [f]actor: float: y 軸を factor 倍に拡大縮小し、x 軸を自動計算します
+Sxv --scale-x-size [n]umber: integer: x 軸を n ピクセルに拡大縮小し、y 軸を自動計算します
+Syv --scale-y-size [n]umber: integer: y 軸を n ピクセルに拡大縮小し、x 軸を自動計算します。その他の変換:
+C --clip-region [l]eft [t]op [w]idth [h]eight: integer: 矩形の画像領域 (l, t, w, h) を切り出します。SOP インスタンス UID:
+ua --uid-always: 常に新しい SOP インスタンス UID を割り当てます（既定値）
+un --uid-never: 新しい SOP インスタンス UID を割り当てません

出力オプション

+F --write-file: ファイル形式で書き出します（既定値）
-F --write-dataset: ファイルメタ情報のないデータセットを書き出します。出力転送構文:
+t= --write-xfer-same: 入力と同じ転送構文で書き出します（既定値）
+te --write-xfer-little: 明示的VRリトルエンディアン転送構文で書き出します
+tb --write-xfer-big: 明示的VRビッグエンディアン転送構文で書き出します
+ti --write-xfer-implicit: 暗黙的VRリトルエンディアン転送構文で書き出します。1993年以降の値表現（VR）:
+u --enable-new-vr: 新しい VR（UN/UT）のサポートを有効にします（既定値）
-u --disable-new-vr: 新しい VR のサポートを無効にし、OB に変換します。グループ長のエンコード:
+g= --group-length-recalc: グループ長が存在する場合は再計算します（既定値）
+g --group-length-create: 常にグループ長要素を付けて書き出します
-g --group-length-remove: 常にグループ長要素を付けずに書き出します。シーケンスおよびアイテムの長さエンコード:
+e --length-explicit: 明示的な長さで書き出します（既定値）
-e --length-undefined: 未定義の長さで書き出します。データセット末尾のパディング（--write-dataset とは併用不可）:
-p= --padding-retain: パディングを変更しません（--write-dataset でない場合の既定値）
-p --padding-off: パディングを行いません（--write-dataset の場合は暗黙的に適用）
+p --padding-create [f]ile-pad [i]tem-pad: integer: ファイルを f バイト単位、アイテムを i バイト単位に整列します

注記

–interpolate オプションでは、以下の補間アルゴリズムを選択できます。

1 = pbmplus ツールキット由来の補間付き自由拡大縮小アルゴリズム
2 = c't 誌由来の補間付き自由拡大縮小アルゴリズム
3 = Eduard Stanescu による双線形補間付き拡大アルゴリズム
4 = Eduard Stanescu による双三次補間付き拡大アルゴリズム

ロギング

各種コマンドラインツールおよびその基盤となるライブラリのロギング出力レベルは、ユーザーが指定できます。既定では、エラーと警告のみが標準エラー出力に書き出されます。–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 に用意されています）。

環境変数

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

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