img2dcm - クラウドでオンライン

プログラム：

NAME

img2dcm - 標準の画像形式を DICOM 形式に変換する

SYNOPSIS

img2dcm [オプション] imgfile-in dcmfile-out

DESCRIPTION

この img2dcm ツールは、JPEG や BMP などの標準画像形式からの変換ツールとして機能します
DICOMへ。 異なる出力 SOP クラスを選択できます。 追加情報
(患者、シリーズなどに関して) DICOM 出力ファイルに保存されているデータは、次の場所から抽出できます。
結果のDICOMオブジェクトの「テンプレート」として機能する他のDICOMファイル。 img2dcm できる
また、欠落している DICOM タイプ 1 およびタイプ 2 属性を発明して機能させるように構成することもできます
テンプレートデータセットなし。

パラメーター

imgfile-in インポートする画像ファイル

dcmfile-out DICOM 出力ファイル

OPTIONS

一般的な オプション
-h --ヘルプ
このヘルプテキストを印刷して終了します

- バージョン
バージョン情報を印刷して終了します

-引数
拡張されたコマンドライン引数を出力する

-q -- 静かに
クワイエットモード、警告やエラーを出力しない

-v --verbose
詳細モード、印刷処理の詳細

-d --デバッグ
デバッグモード、デバッグ情報の出力

-ll --log-level [l] evel：文字列定数
（致命的、エラー、警告、情報、デバッグ、トレース）
ロガーにはレベルlを使用します

-lc --log-config [f] ilename：文字列
ロガーには設定ファイルfを使用します

オプション
一般：

-i --input-format [i]入力ファイル形式: 文字列
対応フォーマット：JPEG（デフォルト）、BMP

-df --dataset-from [f] ファイル名: 文字列
DICOM ファイルのデータセットを使用する f

-stf --study-from [f] ファイル名: 文字列
DICOM ファイルから患者/研究を読み取る f

-sef --series-from [f]ilename: 文字列
DICOM ファイルから患者/研究/シリーズを読み取る f

-ii --instance-inc
DICOM ファイルから読み取ったインスタンス数を増やす

JPEG形式:

-dp --disable-progr
プログレッシブ JPEG のサポートを無効にする

-de --disable-ext
拡張シーケンシャル JPEG のサポートを無効にする

-jf --insist-on-jfif
JFIF ヘッダーの存在を主張する

-ka --keep-appn
APPn セクションを保持 (JFIF を除く)

処理 オプション
属性チェック:

--do-チェック
属性の有効性チェックを有効にする (デフォルト)

--チェックなし
属性の有効性チェックを無効にする

+i2 --挿入タイプ2
欠落しているタイプ 2 属性を挿入する (デフォルト)
(--do-checks のみ)

-i2 --no-type2-insert
欠落しているタイプ 2 属性を挿入しない
(--do-checks のみ)

+i1 --invent-type1
欠落しているタイプ 1 属性を発明する
(--do-checks のみ)

-i1 --no-type1-invent
欠落しているタイプ 1 属性を発明しないでください
(--do-checks のみ)

キャラクターセット：

+l1 --ラテン1
latin-1 を標準文字セットとして設定 (デフォルト)

-l1 --no-latin1
標準文字セットとして 7 ビット ASCII を保持

その他の処理オプション：

-k --key [k]ey: gggg,eeee="str"、パスまたは辞書名="str"
さらに属性を追加

出力 オプション
ターゲット SOP クラス:

-sc --秒キャプチャ
セカンダリ キャプチャ SOP クラスの書き込み

-nsc --new-sc
新しいSecondary Capture SOPクラスを書く

-vlp --vl-写真
Visible Light Photographic SOP クラスを書き込みます (デフォルト)

出力ファイル形式：

+ F --write-file
書き込みファイル形式（デフォルト）

-F--write-dataset
ファイルメタ情報なしでデータセットを書き込む

グループ長エンコーディング：

+ g = --group-length-recalc
存在する場合はグループの長さを再計算します（デフォルト）

+ g --group-length-create
常にグループ長の要素で書く

-g--group-length-remove
常にグループ長要素なしで書き込む

シーケンスとアイテムの長さのエンコード：

+ e --length-explicit
明示的な長さで書き込む（デフォルト）

-e--length-未定義
未定義の長さで書き込む

データセットの末尾のパディング (--write-dataset を使用しない):

-p --パディングオフ
パディングなし (--write-dataset の場合は暗黙的)

+ p --padding-create [f] ile-pad [i] tem-pad：整数
ファイルを f バイトの倍数に整列させる
および i バイトの複数の項目

注意事項

属性 ソース
一般的な画像形式を DICOM 形式に変換するには、 img2dcm アプリケーションは
new の必須 (およびオプション) 属性を埋めるための追加の入力が与えられます。
患者、研究、シリーズ情報のような DICOM ファイル。 この情報を収集できます
さまざまなアプローチを使用して、これらを組み合わせて結果ファイルに適用することができます
次の順序：

· の使用 --データセットから オプション img2dcm 属性を既存の
DICOM ファイル。 指定された DICOM ファイルは完全にインポートされ、すべてのベースとして機能します。
さらなる輸出業務。 例外として、SOP インスタンス UID はこれによってコピーされません。
オプション。 行、列などの画像関連データも変換中に交換されます。
注意してください img2dcm 他の属性値の有効性はチェックしません。たとえば、チェックします。
新しいオブジェクトに属性を適応させるためにシーケンスを調べない (参照イメージ)
等。）。 したがって、(old) のデータ ディレクトリにあるテンプレートを使用することをお勧めします。
SC および VLP オブジェクト。 「入力テンプレート」セクションも参照してください。
・ --スタディ-フロム と --シリーズ-from オプション (相互に排他的) を使用してインポートできます
既存の DICOM ファイルからの患者、研究、およびシリーズの情報。 もしも --シリーズ-from is
指定された場合、指定されたDICOMファイルはによって開かれます img2dcm およびすべての必須情報
シリーズ レベルまでインポートされます。 これには、患者、研究、シリーズが含まれることに注意してください
情報。 の場合には --スタディ-フロム、シリーズ情報は除きます。 以下
属性が引き継がれます:
患者レベル:
患者の名前
患者ID
患者の性別
患者の生年月日
特定の文字セット

研究レベル：
スタディ インスタンス UID
研究日
勉強の時間
紹介医の名前
スタディID
受入番号

シリーズ レベル (オプション --series-from の場合のみ):
シリーズ インスタンス UID
シリーズ番号
メーカー
・ とともに --挿入タイプ2 と --invent-type1 オプション (両方ともデフォルトで有効)、欠落
属性 (タイプ 2 属性) および/または欠落している属性値 (タイプ 1 属性の場合)
によって自動的に追加され、発明されます。 img2dcm. これらのオプションは、
オプションの場合は評価 --do-チェック 有効になっています (デフォルト)。 もし --チェックなし オプションは
有効にすると、属性の自動挿入は行われません。
・ - 鍵 オプションを使用して、DICOM 出力ファイルにさらに属性を追加できます。 これ
オプションは、DICOM ファイルを保存する直前の最後に適用されます。 それも
を使用して、シーケンス、アイテム、およびネストされた属性を指定できます - 鍵 オプション。 の
これらの場合、特別な「パス」表記を使用する必要があります。 このパス表記の詳細は、
のドキュメントに記載されています 変更する.
UID
新しいスタディとシリーズ インスタンスの UID が生成されます if 必要 を適用した後 - 勉強-
from と - シリーズ オプション。 スタディ インスタンス UID またはシリーズ インスタンス UID が存在しない場合
これらの手順の後、それらは互いに独立して新しく生成されます。 反対
SOP インスタンス UID の動作は、次の場合に引き継がれることが期待できるように選択されます。
--データセットから オプション。 これは この場合、SOP インスタンス UID は コピー
新しいオブジェクトに。 これは、ほとんどのユース ケースで望ましい動作です。 ただし、
特定の SOP インスタンス UID を新しいオブジェクトに挿入する必要があります。 - 鍵 オプションはすべきです
利用される。
入力 テンプレ
DICOMへの変換をサポートするため、 img2dcm いくつかの事前定義されたテンプレートが付属しています
に使用できます --データセットから オプション (サンプル ファイルを参照) SC.ダンプ と VLP.ダンプ).
これらのテンプレートには目的の値を入力してから、ダンプする必要があります
実際に使用する前に DICOM ファイルに (変換) img2dcm。 使用 ダンプ2dcm 〜へ
ダンプをDICOMに変換します。 例：
dump2dcm SC.dump SC.dcm

任意の DICOM ファイルをテンプレートとして使用できます。 完全な DICOM
データセットがインポートされます。 したがって、属性のみが存在することを保証する必要があります。
構成された DICOM オブジェクトの一部である必要があります。 SOP クラス UID とピクセルデータ
属性 (行、列などの属性を含む) はコピーされませんが、
img2dcm 変換中。
入力 プラグイン
この img2dcm アプリケーションは現在、JPEG および BMP 画像形式を入力としてサポートしています。
JPEG 入力 プラグイン
JPEG の場合、ソース ファイルの元の JPEG はデコードされずに抽出され、わずかに
大きな JPEG ファイルでも高速に変換できるように (JFIF ヘッダーが切り取られているなど) 変換されます。
デコードして再エンコードする必要はありません。 JPEG プラグインは必要な出力を選択します
JPEG内のデータの実際のエンコードに応じて、構文を自動的に転送します
ファイル。 したがって、次の転送構文 (および対応する JPEG エンコーディング)
JPEG プラグインで使用されます。
· JPEG 符号化処理 1 ベースライン、ロッシー、非階層、シーケンシャル、DCT、ハフマン、8 ビット
SOP クラス = 1.2.840.10008.1.2.4.50
· JPEG コーディング プロセス 2 (8 ビット) および 4 (12 ビット) 拡張、非可逆、非階層、
シーケンシャル、DCT、ハフマン、8/12 ビット SOP クラス = 1.2.840.10008.1.2.4.51
· JPEG コーディング プロセス 10 (8 ビット) および 12 (12 ビット) フル プログレッション、非可逆、非階層。
プログレッシブ、DCT、ハフマン、8/12 ビット SOP クラス = 1.2.840.10008.1.2.4.55
カラー画像とグレースケール画像がサポートされています。
拡張 JPEG 転送構文のサポートを無効にすることができます (--disable-ext オプション）
(廃止された) プログレッシブ JPEG 転送構文 (--プログラムを無効にする
オプション）。
JPEG ロスレス エンコーディング、および算術または階層型 JPEG エンコーディング モードは、
プラグインではサポートされていません。
JFIF (JPEG File Interchange Format) 情報は、オプションの APPn マーカーを
JPEG ファイル。 多くのデジタル カメラは、そのような JFIF 情報を JPEG に統合しません。
彼らが作成する出力。 たとえば、JFIF には、ピクセルの縦横比に関する情報が含まれています。
圧縮された画像。 あなたがしたい場合 img2dcm JFIF ヘッダーを要求するアプリケーション
JPEGストリーム、オプションを使用できます --insist-on-jfif JFIFがない場合は中止されます
情報を見つけることができます。 デフォルトでは、欠落している JFIF 情報は無視されます。
DICOMの場合、JFIF（または他のAPPn）の統合に関係なく、一種の「グレーゾーン」です
DICOM オブジェクトの内部 JPEG ストリームへのデータの転送が許可されているかどうか。 ただし、最も
信頼できるアプローチは、これらのマーカーとその情報を JPEG ストリームから切り離すことです。 これ
アプローチも採用されています。 img2dcm 応用。 デフォルトでは、すべての APPn マーカーがカットされます
元の JPEG ストリームからオフ。 ただし、他の APPn マーカーを保持したい場合は、
DICOM ストリーム内の JFIF (例: EXIF 情報)、オプション --keep-appn は
騙す。 また、APPn 情報を切り離すよりもわずかに高速になるはずです。
そのようなデータの JPEG ストリーム全体をスキャンする必要はありません。 JFIF情報は 常に
によって削除されました img2dcm.
BMP 入力 プラグイン
img2dcm 入力形式として BMP をサポートします。 ただし、これまでのところ、最も一般的な BMP イメージのみが
サポートされています。 特に、ビットフィールドまたはランレングス エンコーディングを使用する BMP イメージは、
拒否されました。 このような画像は珍しいです。 すべての入力画像は DICOM 画像に変換されます
RGB カラー モデルと 24 のビット深度を使用します。微調整のための特定のオプションはありません。
BMP フォーマット変換。
出力 プラグイン
必要な出力 SOP クラスは、コマンド ラインで選択できます。 現在、輸出
セカンダリ キャプチャ イメージ SOP クラスのプラグイン (デフォルト、オプション -sc)、新しいセカンダリ
Capture Image SOP クラス (オプション -nsc) および可視光写真画像 SOP クラス
（オプション -vl） 利用可能です。 最初のものは非推奨であることに注意してください
DICOM 標準ですが、広くサポートされているため、デフォルトとして選択されています。 未来
のバージョン img2dcm 他の SOP クラスにさらに出力プラグインを提供するかもしれません。
新しいセカンダリ キャプチャ SOP クラスの場合、どの特定のクラスを指定することはできません。
出力には SOP クラスを使用する必要があります。 これは、これらの新しい SOP クラスが
色深度 (1/8/16) と、画像が
黒/白またはカラー。 それが理由です img2dcm 変換中にどの出力 SOP を決定するか
クラスは、特定のソース イメージに適しています。

例

以下にいくつかの例を示します。 img2dcm アプリケーションを使用できます。
1. img2dcm image.jpg out.dcm
JPEGファイル「image.jpg」を読み込み、古いSecondary Capture SOPクラスに変換して保存
結果を DICOM ファイル 'out.dcm' に出力します。 これが最も簡単な使用方法です img2dcm. いかなるタイプ
この SOP クラスの有効なオブジェクトを書き込むために必要なタイプ 1 およびタイプ 2 の属性は、
自動的に挿入されます。
2. img2dcm -i BMP image.bmp out.dcm
上記と同じですが、JPEG の代わりに BMP ファイルを読み取るように img2dcm に指示します。
3. img2dcm image.jpg out.dcm -vlp -k 'PatientName=Bond^James'
最初の例と同じですが、Visible Light Photographic Image オブジェクトを「out.dcm」に書き込みます。
そして、PatientName を 'Bond^James' に設定します。それ以外の場合は空のままになります。
4. img2dcm image.jpg out.dcm --series-from template.dcm -k 'PatientName=Bond^James'
1) と同じですが、DICOM ファイルから患者/研究/シリーズ情報をインポートします
「テンプレート.dcm」。 属性 PatientName には「Bond^James」が含まれることに注意してください。
最後に、「template.dcm」の値はすべて上書きされます。 つまり、-k
オプションは、変換パイプラインの最後に適用されます (上記を参照)。
5. img2dcm image.jpg out.dcm --チェックなし
1) と同じですが、属性チェックは実行せず、タイプ 1 とタイプ 2 も実行しません。
属性挿入！ したがって、この場合、無効な DICOM オブジェクトが生成されます。 これ
出力ファイルが完全なものではなく、
を使用して属性を追加するなど、さらなる変換 変更する. オプションのみ使用 - 番号-
チェック あなたが何をしているのか知っていれば！
6. img2dcm image.jpg out.dcm --no-type1-invent
1) と同じですが、欠落しているタイプ 1 属性および/またはそれらの値を挿入しません。 タイプ2
属性が挿入されます。 この場合、すべてのタイプ 1 を保証する必要があることに注意してください。
属性は他の方法で提供されます。つまり、 - 鍵 オプションを選択します。
さもないと、 img2dcm エラーが報告され、変換が停止します。
7. img2dcm image.jpg out.dcm --keep-appn --insist-on-jfif
1) と同じですが、EXIF などの APPn 情報を DICOM オブジェクトの
結果の JPEG ストリーム。 さらに遠く、 --insist-on-jfif 強制します img2dcm ない場合は中止する
JFIF 情報はソース ファイルに存在します。

ロギング

さまざまなコマンドラインツールと基盤となるライブラリのログ出力のレベルは、
ユーザーが指定します。 デフォルトでは、エラーと警告のみが標準に書き込まれます
エラーストリーム。 オプションの使用 -詳細 処理の詳細などの情報メッセージもあります
報告されています。 オプション - デバッグ 内部アクティビティの詳細を取得するために使用できます。
たとえば、デバッグの目的で。 オプションを使用して、他のログレベルを選択できます - ログ-
レベル。 に - 静かな モードのみの致命的なエラーが報告されます。 このような非常に重大なエラーイベントでは、
通常、アプリケーションは終了します。 さまざまなログレベルの詳細については、
モジュール 'oflog'のドキュメントを参照してください。
ロギング出力をファイルに書き込む必要がある場合（オプションでログファイルローテーションを使用）、
syslog（Unix）またはイベントログ（Windows）オプションへ --log-config に使える。 この
構成ファイルでは、特定のメッセージのみを特定の出力に送信することもできます
ストリームおよびモジュールまたはアプリケーションに基づいて特定のメッセージをフィルタリングするため
が生成されます。 構成ファイルの例は、に提供されています。 /logger.cfg.

COMMAND LINE

すべてのコマンドラインツールは、パラメータに次の表記を使用します。角かっこで囲みます
オプションの値（0-1）、末尾のXNUMXつのドットは、複数の値が許可されていることを示します
（1-n）、両方の組み合わせは0からnの値を意味します。
コマンドラインオプションは、先頭の「+」または「-」記号によってパラメータと区別されます。
それぞれ。 通常、コマンドラインオプションの順序と位置は任意です（つまり、
どこにでも表示できます）。 ただし、オプションが相互に排他的である場合、右端の外観
使用されている。 この動作は、一般的なUnixシェルの標準的な評価ルールに準拠しています。
さらに、XNUMXつ以上のコマンドファイルは、接頭辞として「@」記号を使用して指定できます。
ファイル名（例： @ command.txt）。 このようなコマンド引数は、次の内容に置き換えられます。
対応するテキストファイル（複数の空白は、次の場合を除いて単一の区切り文字として扱われます）
さらに評価する前に、XNUMXつの引用符の間に表示されます）。 その点に注意してください
コマンドファイルに別のコマンドファイルを含めることはできません。 このシンプルだが効果的なアプローチ
オプション/パラメータの一般的な組み合わせを要約することができ、長くなり、
紛らわしいコマンドライン（例はファイルで提供されています /dumppat.txt).

ENVIRONMENT

この img2dcm ユーティリティは、で指定されたDICOMデータディクショナリを読み込もうとします。
DCMDICTPATH 環境変数。 デフォルトでは、つまり DCMDICTPATH 環境変数
設定されていない、ファイル /dicom.dic 辞書が作成されない限りロードされます
アプリケーションに（Windowsのデフォルト）。
デフォルトの動作が優先され、 DCMDICTPATH 環境変数のみ
代替データディクショナリが必要な場合に使用されます。 NS DCMDICTPATH 環境変数
Unixシェルと同じ形式です パス コロン（ '：'）で区切る変数
エントリ。 Windowsシステムでは、セミコロン（ ';'）が区切り文字として使用されます。 データディクショナリ
コードは、で指定された各ファイルをロードしようとします DCMDICTPATH 環境変数。 それ
データディクショナリをロードできない場合はエラーです。

onworks.net サービスを使用してオンラインで img2dcm を使用する