dcmdspfn: 標準的なディスプレイ曲線をテキストファイルに書き出す

書式

dcmdspfn [options]

説明

このコマンドラインプログラムは、DCMTK のモニタ／カメラ／プリンタ／スキャナの特性ファイルを、タブ区切りのテキストファイルに変換します。出力されるテキストには、8 ビットディスプレイ向けの特性曲線（CC）、ディスプレイ関数、標準化後の曲線（PSC）が記述されます。各曲線の 256 個の値は、一般的な表計算ソフトで可視化できます。さらに、CC と PSC を含まないディスプレイ曲線については、指定した輝度／OD の範囲（最小／最大）と任意の Digital Driving Level（DDL）数に対して計算することもできます。

引数

dcmfile-in  DICOM input filename to be dumped

オプション

全般オプション

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

入力オプション（相互排他）

+Im --monitor-file [f]ilename: string: モニタ特性を記述したテキストファイル
+Ic --camera-file [f]ilename: string: カメラ特性を記述したテキストファイル
+Ip --printer-file [f]ilename: string: プリンタ特性を記述したテキストファイル
+Is --scanner-file [f]ilename: string: スキャナ特性を記述したテキストファイル
+Il --lum-range [m]in max: float: 輝度の最小値と最大値（cd/m^2）
+Io --od-range [m]in max: float: 光学濃度（OD）の最小値と最大値。自動的に輝度へ変換されます

作成オプション

+Ca --ambient-light [a]mbient light: float: 環境光の値（cd/m^2、既定値: ファイル f の設定）
+Ci --illumination [i]llumination: float: 照明光の値（cd/m^2、既定値: ファイル f の設定）
+Dn --min-density [m]inimum optical density: float: Dmin の値（既定値: off、+Ip および +Io と併用する場合のみ）
+Dx --max-density [m]aximum optical density: float: Dmax の値（既定値: off、+Ip および +Io と併用する場合のみ）
+Cd --ddl-count [n]umber of DDLs: integer: Digital Driving Level の数（既定値: 256、--lum/od-range と併用する場合のみ）
+Cf --curve-fitting [n]umber: integer: 次数 n の多項式曲線フィッティングアルゴリズムを使用します（0..99、既定値: ファイルの設定または三次スプライン）

出力オプション

+Og --gsdf [f]ilename: string: GSDF 曲線データをファイル f に書き出します
+Oc --cielab [f]ilename: string: CIELAB 曲線データをファイル f に書き出します

注記

8 ビットディスプレイシステム（モニタ、カメラ、プリンタ、スキャナ）の CC、GSDF または CIELAB、PSC を記述した出力ファイルは、単純なテキストファイルです。'#' で始まる行はコメントとして扱われ、空行とともに読み飛ばされます。入力ファイルは、たとえばコマンドラインツール dconvlum で作成できます。

特性ファイルに環境光の値が定義されている場合、その値も計算に使用されます。このとき、環境光の値はファイルのコメントヘッダの一部となり、DDL（digital driving level）値の数、絶対輝度範囲（カンデラ毎平方メートルで測定）、GSDF の場合は JND インデックス（just noticeable difference、弁別可能な最小差）の範囲も同様に含まれます。あるいは、環境光の値はコマンドラインオプションとして指定することもできます。モニタ特性ファイルを入力として読み込む代わりに 2 つの輝度値を設定した場合、輝度範囲は DDL 数で線形に分割されます。

プリンタとスキャナでは、反射環境光に加えて照明光を指定できます（特性ファイルとコマンドラインのいずれでも指定可能）。出力ファイルのヘッダには、輝度範囲ではなく光学濃度（OD）の最小値と最大値が含まれます。入力ファイル内の OD 値は降順に並べる必要がある点に注意してください（モニタやカメラで使用する輝度値とは逆です）。DDL 値 0 は常に黒（最も暗い値）を、最大の DDL 値は白（最も明るい値、透明なフィルム）を意味します。

data フォルダには、モニタ、カメラ、プリンタ、スキャナのサンプル特性ファイルが含まれています。ディスプレイ校正と Barten のモデル（GSDF を含む）の詳細については、DICOM 規格パート 14 を参照してください。

ロギング

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

ファイル

< datadir>/camera.lut - カメラのサンプル特性ファイル
< datadir>/monitor.lut - モニタのサンプル特性ファイル
< datadir>/printer.lut - プリンタのサンプル特性ファイル
< datadir>/scanner.lut - スキャナのサンプル特性ファイル