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

プログラム：

NAME

xml2dcm - XML ドキュメントを DICOM ファイルまたはデータセットに変換する

SYNOPSIS

xml2dcm [オプション] xmlfile-in dcmfile-out

DESCRIPTION

　 xml2dcm ユーティリティは、XML (Extensible Markup Language) ドキュメントの内容を変換します
DICOM ファイルまたはデータ セットに。 XML ドキュメントは、DTD に対して検証されることが期待されています
ファイルに記述されている（Document Type Definition） dcm2xml.dtd. 適切な XML ファイル
を使用して作成できます dcm2xml ツール（オプション +Wb バイナリ データを含めることをお勧めします)。

パラメーター

xmlfile-in 変換する XML 入力ファイル名 (stdin: "-")

dcmfile-outDICOM出力ファイル名

OPTIONS

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

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

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

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

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

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

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

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

オプション
入力ファイル形式：

+f --メタ情報の読み取り
メタ情報が存在する場合は読み取ります (デフォルト)

-f --メタ情報を無視する
ファイルのメタ情報を無視する

処理 オプション
検証:

+Vd --検証ドキュメント
XML ドキュメントを DTD に対して検証する

+Vn --check-namespace
ドキュメント ルートの XML 名前空間を確認する

一意の識別子:

+Ug --新しいUIDを生成
新しいスタディ/シリーズ/SOP インスタンス UID を生成します

-Uo --dont-overwrite-uids
既存の UID を上書きしません (デフォルト)

+Uo --overwrite-uids
既存のUIDを上書きする

出力 オプション
出力ファイル形式：

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

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

+Fu --更新メタ情報
特定のファイルのメタ情報を更新する

出力転送構文:

+ t =-write-xfer-同じ
入力と同じTSで書き込む（デフォルト）

+ te --write-xfer-little
明示的なVRリトルエンディアンTSで書く

+ tb --write-xfer-big
明示的なVRビッグエンディアンTSで書く

+ ti--write-xfer-implicit
暗黙のVRリトルエンディアンTSで書く

+ td --write-xfer-deflated
収縮した明示的なVRリトルエンディアンTSで書き込む

1993年以降の値の表現：

+ u --enable-new-vr
新しいVRのサポートを有効にする（UN / UT）（デフォルト）

-u --新しいvrを無効にする
新しいVRのサポートを無効にし、OBに変換します

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

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

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

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

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

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

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

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

-p= --パディング保持
パディングを変更しないでください (--write-dataset でない場合のデフォルト)

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

+ p --padding-create [f] ile-pad [i] tem-pad：整数
ファイルを複数のfバイトに揃え、アイテムを
iバイトの倍数

deflate 圧縮レベル (--write-xfer-defulated を使用した場合のみ):

+ cl --compression-level [l] evel：整数（デフォルト：6）
0 =非圧縮、1 =最速、9 =最高の圧縮

注意事項

期待される XML 入力の基本構造は次のようになります。



<ファイル形式 xmlns=http://dicom.offis.de/dcmtk">

<要素タグ="0002,0000" vr="UL" vm="1" len="4"
name="MetaElementGroupLength">
166

...
<要素タグ="0002,0013" vr="SH" vm="1" len="16"
name="実装バージョン名">
OFFIS_DCMTK_353



<要素タグ="0008,0005" vr="CS" vm="1" len="10"
name="特定の文字セット">
ISO_IR100

...


<要素タグ="0028,3002" vr="xs" vm="3" len="6"
name="LUTDescriptor">
256 \ 0 \ 8

...

...

...
<要素タグ="7fe0,0010" vr="OW" vm="1" len="262144"
name="PixelData" loaded="no" binary="hidden">




「file-format」および「meta-header」タグは、DICOM データ セットには存在しない場合があります。

文字 エンコーディング
DICOM 文字エンコーディングは、タグ付きの要素から自動的に決定されます
'0008,0005' (特定の文字セット) - 存在する場合。 以下の文字セットは
現在サポートされています (必須 のlibxml 含める iconv サポート、参照 - バージョン 出力）：

アスキー (ISO_IR 6) (UTF-8)
UTF-8 "ISO_IR 192" (UTF-8)
ISO Latin 1 "ISO_IR 100" (ISO-8859-1)
ISO Latin 2 "ISO_IR 101" (ISO-8859-2)
ISO Latin 3 "ISO_IR 109" (ISO-8859-3)
ISO Latin 4 "ISO_IR 110" (ISO-8859-4)
ISO Latin 5 "ISO_IR 148" (ISO-8859-9)
キリル文字 "ISO_IR 144" (ISO-8859-5)
アラビア語 "ISO_IR 127" (ISO-8859-6)
ギリシャ語 "ISO_IR 126" (ISO-8859-7)
ヘブライ語 "ISO_IR 138" (ISO-8859-8)

複数の文字セットはサポートされていません (「特定の文字」の最初の値のみ)。
Set' は、値の多重度の場合の文字エンコーディングに使用されます)。

見る dcm2xml XML 構造の詳細については、ドキュメンテーションを参照してください。

バイナリ 且つ
バイナリ データは、バックスラッシュで区切られた一連の XNUMX 進数としてエンコードできます。
'\' または Base64 形式 (binary='base64')。 また、バイナリデータも読み込めます。
ファイル (バイナリ = 'ファイル')。 この場合、要素の値としてファイル名を指定する必要があります。
マシン情報の記入> という構文でなければなりません。例えば、

サブディレクトリ/pixeldata.raw

ファイルの内容がそのまま読み込まれますのでご注意ください。 OW データは
リトルエンディアンが注文され、必要に応じて交換されます。 確認するためのチェックは行われません
Rows または
列。

圧縮
libxml が zlib サポート付きでコンパイルされている場合、入力ファイル (XMLファイル入力）にすることもできます
ZIP で圧縮されているため、通常ははるかに小さなファイルになります。 オプションの出力を参照
- バージョン zlib サポートが利用可能かどうかを確認するため。

制限事項
libxml のバージョンが異なれば、XML の最大長の制限も異なる場合があります。
要素値。 したがって、非常に長い要素値を使用することは避ける必要があります (例:
ピクセル データ)。

ということに注意してください xml2dcm 現在、DICOMDIR ファイルは完全にはサポートされていません。 具体的には、
さまざまなオフセット データ要素の値は、このツールによって自動的に更新されません。

ロギング

さまざまなコマンドラインツールと基盤となるライブラリのログ出力のレベルは、
ユーザーが指定します。 デフォルトでは、エラーと警告のみが標準に書き込まれます
エラーストリーム。 オプションの使用 -詳細 処理の詳細などの情報メッセージもあります
報告されています。 オプション - デバッグ 内部アクティビティの詳細を取得するために使用できます。
たとえば、デバッグの目的で。 オプションを使用して、他のログレベルを選択できます - ログ-
レベル。 に - 静かな モードのみの致命的なエラーが報告されます。 このような非常に重大なエラーイベントでは、
通常、アプリケーションは終了します。 さまざまなログレベルの詳細については、
モジュール '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

　 xml2dcm ユーティリティは、で指定されたDICOMデータディクショナリを読み込もうとします。
DCMDICTPATH 環境変数。 デフォルトでは、つまり DCMDICTPATH 環境変数
設定されていない、ファイル /dicom.dic 辞書が作成されない限りロードされます
アプリケーションに（Windowsのデフォルト）。

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

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