dcmrecv - クラウド上のオンライン

プログラム：

NAME

dcmrecv - 単純な DICOM ストレージ SCP (受信者)

SYNOPSIS

dcmrecv [オプション] ポート

DESCRIPTION

　 dcmrecv アプリケーションは、ストレージサービスのサービスクラスプロバイダー（SCP）を実装します
クラス。 よく知られているものとは対照的に、 Storescp ユーティリティ、 dcmrecv 選択肢が少なくなる可能性がありますが、
したがって、使いやすくなります。これは、タイトルの「シンプル」という用語の説明にもなります。 メイン
このアプリケーションの目的は、ストレージから大量の DICOM データセットを受信することです。
サービス クラス ユーザー (SCU) を作成し、構成可能なディレクトリとファイル構造に保存します。

パラメーター

リッスンするポートtcp / ipポート番号

OPTIONS

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

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

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

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

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

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

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

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

+ v --verbose-pc
詳細モードでプレゼンテーションコンテキストを表示する

ネットワーク オプション
構成ファイルからのアソシエーションネゴシエーションプロファイル：

-xf --config-file [f]ファイル名、[p]rofile: 文字列
構成ファイル f のプロファイル p を使用する

アプリケーションエンティティのタイトル:

-aet --aetitle [a] etitle：文字列
AE タイトルを設定します (デフォルト: DCMRECV)

-uca --use-call-aetitle
常に呼び出された AE タイトルで応答します

その他のネットワークオプション：

-ta --acse-timeout [s] econds：整数（デフォルト：30）
ACSEメッセージのタイムアウト

-td --dimse-timeout [s] econds：整数（デフォルト：無制限）
DIMSEメッセージのタイムアウト

-pdu --max-pdu [n]バイト数：整数（4096..131072）
最大受信pduをnバイトに設定します（デフォルト：16384）

-dhl --disable-host-lookup ホスト名の検索を無効にする

出力 オプション
一般：

-od --output-directory [d] irectory：文字列（デフォルト： "。"）
受信したオブジェクトを既存のディレクトリに書き込むd

サブディレクトリの生成:

-s --サブディレクトリなし
サブディレクトリを生成しません (デフォルト)

+ssd --シリーズ日付サブディレクトリ
シリーズの日付からサブディレクトリを生成

ファイル名の生成：

+fd --default-filenames
インスタンスUIDからファイル名を生成します（デフォルト）

+fu --一意のファイル名
新しいUIDに基づいて一意のファイル名を生成する

+fsu --短い固有の名前
短い擬似ランダムの一意のファイル名を生成する

+fst --システム時間名
現在のシステム時間からファイル名を生成する

-fe --filename-extension [e]xtension: 文字列 (デフォルト: なし)
生成されたすべてのファイル名に e を追加します

ストレージモード:

-B--通常
暗黙的なフォーマット変換を許可する（デフォルト）

+ B--ビット保存
受け取ったとおりにデータセットを書き込む

- 無視
データセットを無視し、受信しますが保存しません

注意事項

分解能 使用法
典型的な使用例は、 dcmrecv ストレージ SCU から送信された SOP インスタンスを受信することです
DICOM ファイルとして保存します。 次のコマンドはまさにこれを実行します。

dcmrecv --verbose --config-filestorecp.cfg デフォルト

自動的に作成されるサブディレクトリ構造、短いファイル名、および
すべての DICOM ファイルの拡張子「.dcm」を使用するには、次のコマンドを使用します。

dcmrecv -v -xf は cp.cfg のデフォルトを保存します--シリーズ日付サブディレクトリ
--短い固有名
--ファイル名拡張子 .dcm

非常に大規模な SOP インスタンスの場合、またはデータセットを次のように正確に記述する必要がある場合
(デバッグ目的などで) 受信した場合は、「ビット保存モード」を使用できます。

dcmrecv -v -xf は cp.cfg のデフォルトを保存します--ビット保存

受信したデータセットは、常に DICOM ファイルとして同じ転送構文で保存されます。
ネットワーク伝送に使用されます。

DICOM 適合
基本的には、 dcmrecv アプリケーションは、以下を含むすべてのストレージ SOP クラスを SCP としてサポートします。
プライベートのもの。 ただし、これには、対応するアソシエーション ネゴシエーション プロファイルが必要です。
構成ファイルからロードされます。 この設定ファイルの形式とセマンティクス
に文書化されています asconfig.txt.

デフォルトでは、アソシエーション ネゴシエーション プロファイルがロードされていない場合、 dcmrecv の
Verification SOP クラスを SCP としてサポートします (デフォルトの転送構文、つまり暗黙的)
VR リッテ エンディアン）。

将来的には、次のリストを指定できる追加のオプションが登場する可能性があります。
サポートされているプレゼンテーションコンテキスト (つまり、SOP クラスと転送構文の組み合わせ)
直接、つまり設定ファイルをロードせずに。

サブディレクトリ 世代
オプション --シリーズ日付サブディレクトリ サブディレクトリ（指定されたディレクトリの下）を生成できます。
出力ディレクトリ) のデータ要素 Series Date (0008,0021) の値に基づいて、
DICOM データセットを受信しました。 この値がデータセットから取得でき、有効であるかどうか
(つまり、有効な DICOM 日付フィールドで構成されている)、サブディレクトリ構造は次のとおりです。

/データ/ / / /

シリーズ日付 (0008,0021) が取得できないか無効な場合、現在のシステム日付
は、次のサブディレクトリ構造に使用されます。

/undef/ /

両方の場合において、 4 桁の 2 進数で構成され、 同様にXNUMXの
XNUMX 進数。

ファイル名 世代
デフォルトでは、受信した DICOM データセットを保存するファイル名は次のように生成されます。
次のスキームに変換します。

。

同じ SOP インスタンスを XNUMX 回受信すると、警告メッセージが報告され、既存の SOP インスタンスが
ファイルが上書きされます。

オプション --一意のファイル名 受信した各 DICOM データセットがファイルとして保存されていることを確認します。
つまり、ファイルは決して上書きされるべきではありません。 これは、新たに
生成された各ファイル名に一意の識別子 (UID) を作成します (および順に中置 '.X')
実際のSOPインスタンスUID値との競合を避けるため)。 このオプションの命名スキーム
次のとおりです。

。バツ。

オプションの場合 --短い固有名 が使用されている場合、ファイル名は何らかの疑似関数によって生成されます。
ランダム名ジェネレーター。競合がないことも確認します（つまり、既存の
ファイルは上書きされません）。 命名スキームは次のとおりです。

_

と16 進表記の XNUMX 桁で構成されます。

最後にオプション --システム時間名 現在のファイル名に基づいてファイル名を生成できます。
システム時刻：

。

とからなる ' ' そしての
' 。 '。 このスキームにより、次のような結果が生じる可能性があることに注意してください。
システム時間の解像度が十分に高くない場合（つまり、
マイクロ秒はサポートされていません）。

制限事項
そのオプションに注意してください --ビット保存 オプションとの併用はできません - シリーズ-
日付サブディレクトリ 受信したデータセットはファイルに直接保存されるため、
したがって、シリーズ日付 (0008,0021) は、ファイルが作成されるまでは使用できません。

ロギング

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

ロギング出力をファイルに書き込む必要がある場合（オプションでログファイルローテーションを使用）、
syslog（Unix）またはイベントログ（Windows）オプションへ --log-config に使える。 この
構成ファイルでは、特定のメッセージのみを特定の出力に送信することもできます
ストリームおよびモジュールまたはアプリケーションに基づいて特定のメッセージをフィルタリングするため
が生成されます。 構成ファイルの例は、に提供されています。 /logger.cfg.

COMMAND LINE

すべてのコマンドラインツールは、パラメータに次の表記を使用します。角かっこで囲みます
オプションの値（0-1）、末尾のXNUMXつのドットは、複数の値が許可されていることを示します
（1-n）、両方の組み合わせは0からnの値を意味します。

コマンドラインオプションは、先頭の「+」または「-」記号によってパラメータと区別されます。
それぞれ。 通常、コマンドラインオプションの順序と位置は任意です（つまり、
どこにでも表示できます）。 ただし、オプションが相互に排他的である場合、右端の外観
使用されている。 この動作は、一般的なUnixシェルの標準的な評価ルールに準拠しています。

さらに、XNUMXつ以上のコマンドファイルは、接頭辞として「@」記号を使用して指定できます。
ファイル名（例： @ command.txt）。 このようなコマンド引数は、次の内容に置き換えられます。
対応するテキストファイル（複数の空白は、次の場合を除いて単一の区切り文字として扱われます）
さらに評価する前に、XNUMXつの引用符の間に表示されます）。 その点に注意してください
コマンドファイルに別のコマンドファイルを含めることはできません。 このシンプルだが効果的なアプローチ
オプション/パラメータの一般的な組み合わせを要約することができ、長くなり、
紛らわしいコマンドライン（例はファイルで提供されています /dumppat.txt).

EXIT コード

　 dcmrecv ユーティリティは終了時に次の終了コードを使用します。 これにより、ユーザーは
アプリケーションが終了した理由を確認します。

一般的な
EXITCODE_NO_ERROR 0
EXITCODE_COMMANDLINE_SYNTAX_ERROR 1

file エラー
EXITCODE_CANNOT_READ_INPUT_FILE 20 (*)

出力 file エラー
EXITCODE_CANNOT_WRITE_OUTPUT_FILE 40 (*)
EXITCODE_INVALID_OUTPUT_DIRECTORY 45

ネットワーク エラー
EXITCODE_CANNOT_INITIALIZE_NETWORK 60 (*)
EXITCODE_CANNOT_START_SCP_AND_LISTEN 64
EXITCODE_INVALID_ASSOCIATION_CONFIG 66

(*) 実際には、これらのコードは現在使用されていません。 dcmrecv ただし、プレースホルダーとして機能します
対応する終了コードのグループ。

ENVIRONMENT

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

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

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