dcmdrle: RLE圧縮されたDICOMファイルをデコードする

書式

dcmdrle [options] dcmfile-in dcmfile-out

説明

dcmdrle ユーティリティは、RLE圧縮されたDICOM画像（dcmfile-in）を読み込み、その画像データを展開し（すなわちネイティブのDICOM転送構文へ変換し）、変換後の画像を出力ファイル（dcmfile-out）に書き出します。

引数

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

dcmfile-out  DICOM output filename ("-" for stdout)

オプション

全般オプション

-h --help: このヘルプを表示して終了します
--version: バージョン情報を表示して終了します
--arguments: 展開後のコマンドライン引数を表示します
-q --quiet: quietモード。警告やエラーを表示しません
-v --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: メタ情報を持たないデータセットとして読み込みます # このオプションを使うと、メタヘッダなしのデータセットとして保存されたRLE圧縮DICOMオブジェクトを展開できます。メタヘッダがなければ転送構文を確実に判定できないため、本来そのようなものは存在しないはずですが、現実には存在してしまっています。

処理オプション

+ud --uid-default: SOP Instance UID を同じまま保持します（既定値）
+ua --uid-always: 常に新しいUIDを割り当てます RLEバイトセグメントの順序:
+bd --byte-order-default: 最上位バイトを先頭にします（既定値）
+br --byte-order-reverse: 最下位バイトを先頭にします # このオプションを使うと、バイトセグメントの順序が誤った順番でエンコードされているRLE圧縮DICOMファイルを展開できます。これが影響するのは1サンプルあたり2バイト以上の画像のみです。

出力オプション

+F --write-file: ファイル形式で書き出します（既定値）
-F --write-dataset: メタ情報を持たないデータセットとして書き出します出力の転送構文:
+te --write-xfer-little: explicit VR little endian で書き出します（既定値）
+tb --write-xfer-big: explicit VR big endian TS で書き出します
+ti --write-xfer-implicit: implicit VR little endian TS で書き出します 1993年以降の値表現:
+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 バイトの倍数に整列させます

転送構文

dcmdrle は入力（dcmfile-in）について次の転送構文をサポートします:

LittleEndianImplicitTransferSyntax             1.2.840.10008.1.2
LittleEndianExplicitTransferSyntax             1.2.840.10008.1.2.1
DeflatedExplicitVRLittleEndianTransferSyntax   1.2.840.10008.1.2.1.99 (*)
BigEndianExplicitTransferSyntax                1.2.840.10008.1.2.2
RLELosslessTransferSyntax                      1.2.840.10008.1.2.5

(*) zlibサポートを有効にしてコンパイルした場合

dcmdrle は出力（dcmfile-out）について次の転送構文をサポートします:

LittleEndianImplicitTransferSyntax             1.2.840.10008.1.2
LittleEndianExplicitTransferSyntax             1.2.840.10008.1.2.1
BigEndianExplicitTransferSyntax                1.2.840.10008.1.2.2

ロギング

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

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

コマンドライン

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

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

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

環境変数

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

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