RS_Base 専⽤簡易 DICOM データレシーバ

RS_Receiver 取扱説明書

Ver. 5.21.3.18

2021 年 3 月 18 日
(初版 2004 年 12 月 8 日)

シモノソフトウェアサービス
shimono@orange.ocn.ne.jp

【ご利⽤の前に】
RS_Base 専⽤簡易 DICOM データレシーバ RS_Receiver (以後 RS_Receiver と表示)は CR 等のモダリティから送信された DICOM データを受信し、RS_Base で利⽤可能な DICOM ファイル、JPEG ファイル、AVI ファイル等を生成、保存するアプリケーションソフトウェアです。
保存ファイルは RS_Base で表示、管理する事を前提としています。
RS_Receiver を使⽤するには DICOM 通信の知識が必要です。また、各社モダリティによって設定等が異なる場合があります。ご使⽤にあたっては、モダリティメーカーへご相談頂く事をお勧め致します。
以下の点をご理解、ご了承の上、ご使⽤ください。
・本アプリケーションは不具合、⽋陥の無いことを保証するものではありません。

・

本アプリケーションはソフトウェアのみの提供です。ハードウェアに関しては別途準備してください。

・本アプリケーションはソフトウェアのみの販売のため、他のソフトウェアとの混在による動作は保証できません。万が一の障害発生に備え、大事なデータは事前にバックアップをとって下さい。販売方法の性格上、本ソフトウェアの使⽤による障害、損害に対し、著作者はこれを補償できかねますのでご了承下さい。

・

本アプリケーションは著作者に無断で第 3 者に譲渡・配布・販売してはいけません。

・

本アプリケーションをリバースコンパイル・解析してはいけません。

・

本アプリケーションを RS_Base 以外の他のシステム、アプリケーションのために使⽤してはいけません。

⻑崎県佐世保市大宮町 28-6-204
シモノソフトウェアサービス
著作者

下野 修

【概要】
RS_Receiver は、RS_Base 専⽤の DICOM データレシーバです。
RS_Receiver は、モダリティから送信された DICOM データを受信し、RS_Base で利⽤可能な DICOM ファイル、JPEG ファイル、AVI ファイル等を生成、保存します。
RS_Receiver は通常、タスクトレイに常駐し、データの受信、各ファイルの作成、保存をバックグラウンドで実⾏します。

【動作環境】
RS_Receiver は、Windows 10, 11 のインストールされた PC で、RS_Base を利⽤可能な環境でのみ動作します。
RS_Receiver を運⽤する PC は、固定の IP アドレスを割り当ててください。
固定の IP アドレスは、DHCP による自動割り当てと重複しないよう、比較的大きめのアドレスを割り当ててください。
以外の動作環境は RS_Base のそれと同等です。

【インストール】
解凍された配布ファイルの RS_ReceiverSetup.exe を実⾏してインストーラの指示に従ってください。
インストールが正常に完了すると、プログラムメニューとデスクトップにショートカットが登録されます。
スタートアップへの登録は⾃働的には⾏われません。必要な場合は(推奨)手作業で登録して下さい。(付録 A 参照)

【起動】スタートメニューかデスクトップのショートカットから起動してください。RS_Receiver は起動すると、図 1 のように、すぐにタスクトレイに常駐します。通常、フォーム等は何も表示されません。動作中であるかどうかは、タスクトレイにアイコンが表示されているかどうかで判断してください。
RS_Receiver は起動すると自動的に DICOM データの受信待ち状態となります。
※RS_Receiver は起動時に RS_Base が使⽤可能かどうかのチェックを⾏います｡RS_Base が起動している必要はありませんが、RS_Base を起動できるように Apache が起動している必要があります。Apache が起動している事を確認してから RS_Receiver を起動してください。

図1

起動⽤ショートカット

ダブルクリックかポップアップメニューの起動するとタスクトレイに常駐する。

「フォームを表示」で設定フォームを表示。
ポップアップメニューの「RS_Receiver を終了」で、終了。

【受信ログ表示に付いて】
受信ログは、C:\ProgramData\Shimono\RS_Receiver\Log\フォルダ内にあります。必要に応じてメモ帳などで開いてご覧ください。
受信ログは日付ごとに 1 つのファイルになっております。
ファイル名は年月日、拡張⼦は.log となっています。例えば、2019 年 9 月 15 日のログファイルは、20190915.logとなります。
これらの受信ログファイルのうち、約 90 日を経過したものは RS_Receiver 起動時に自動的に削除されます。
従いまして、受信ログファイルの蓄積によるディスクスペースの消費を心配する必要はありません。

【通信設定】
図2

RS_Receiver の AE タイトル

DICOM 通信のポート No
変更後は、再起動が必要。

受信自己 IP アドレスを指定できる。
具体的に IP アドレスを指定した場合は、それ以外の IP アドレスからの受信は拒否される。(付録 C 参照)

【生成ファイルの設定】受信した DICOM データは DICOM ファイルに、また静止画像の場合は JPEG ファイル、マルチフレーム動画の場合は AVI ファイル、レポートの場合は XML/HTML ファイルに変換して保存する事ができます。
DICOM ファイル、JPEG、AVI ファイル、XML/HTML ファイルそれぞれに保存するかどうかの指定、保存フォルダを設定してください。

受信した DICOM データは、静止画像、マルチフレーム画像、SR(レポート)それぞれごとにファイル保存するかどうかを指定することが出来ます。

図3

DICOM 受信データが静止画像の場合、これを DICOM 形式で保存するかしないかを指定する。

DICOM 受信データがマルチフレー
ム動画の場合、これを DICOM 形式で保存するかしないかを指定する。

DICOM 受信データがレポート(SR)の場合、これを DICOM 形式で保存するかしないかを指定する。

DICOM 形式で保存する場合の保存先フォルダを指定する。

受信した DICOM データが静止画像の場合は Jpeg ファイルに、マルチフレーム動画の場合は AVI ファイルに変換して保存することが出来ます。
本機能のうち、FFMpeg を使⽤する場合は、事前に外部プログラムである FFMpeg のファイルの準備が必要です。(付録 B 参照)
外部プログラム FFMpeg が存在しない場合、FFMpeg の項目はグレーアウトされて選択・設定できません。

図4

DICOM 受信データが静止画像の場合、これを Jpeg ファイルに変換して保存する。
DICOM 受信データがマルチフレーム動画の場合、これを動画ファイルに変換して保存する。
VFW は旧バージョンとの整合のため。(非推奨)
FFMpeg を使った H.264 の生成。
(強く推奨)
Jpeg, ビデオ形式で保存する場合の保存先フォルダを指定する。

受信した DICOM データが SR(Structured Report)の場合、XML または HTML 形式のファイルに変換して保存することが出来ます。
本機能を使⽤する場合は、事前に外部プログラムである DCMTK 3.5.6(3.5.6 はバージョン)のファイルの準備が必要です。(付録 B 参照)
外部プログラム DCMTK が存在しない場合、これらの設定項目はグレーアウトされて設定できません。

図5

DICOM 受信データが SR の場合、これを XML に変換して保存する。

DICOM 受信データが SR の場合、これを HTML に変換して保存する。

XML, HTML 形式で保存する場合の保存先フォルダを指定する。

【検査名の生成】
DICOM 情報からの検査名の生成は､RS_Base への自動登録の精度に大きな影響があります。
残念ながら､モダリティメーカーごとに DICOM 情報の記述が異なり､一意的に検査名を決定する事はできません。
このページでタグの取得方法､取得順序を指定して、適切な検査名となるように調整してください｡
モダリティ・コードを指定します。ここで指定したモダリティは本ページの設定を使⽤します。それ以外はその他のページの設定を使⽤します。
検査名生成に使⽤するタグを指定します。
モダリティによって使⽤するタグが違う
場合､使⽤する全てを指定してください｡
使⽤するタグの順序、連結を指定します。

タグの連結時､重複した⽂字列を削除するかどうかを指定します。
タグの説明(0018, 0015) 検査部位
(0018, 1400) 収集装置処理記述(0008, 1030) 検査記述
(0018, 1030) プロトコル名

図 6

【受信データチェック】
検査名の生成時などに、実際のデータを確認したい場合があります。
本ページでは、最終受信データの内容を表示します。

図 7

【終了】
RS_Receiver は、Windows の終了時に自動的に終了しますので、通常の運⽤では､特に終了させる必要はありません。
メインテナンスや問題解決時に RS_Receiver を終了させる必要がある場合は､フォームを表示してその「終了」ボタンで終了させるか、タスクトレイからのポップアップメニューの「RS_Receiver を終了」をクリックして終了させて下さい。

図 8

フォームの終了ボタンで終了させる。

図 9

ポップアップメニューの「RS_Receiver を終了」で終了。

【生成ファイル名について】
DICOM ファイル、JPEG ファイル、AVI ファイル、CSV ファイルのファイル名は、RS_Base 自動読み込みに対応した形式になります。
RS_Base 自動読み込みの形式は、
ID~適当な番号~撮影日~検査名~RSB.拡張⼦例） 100~01~2004_07_23~胸部写真~RSB.dcm
100~02~2004_07_23~胸部写真 j~RSB.jpg
100~02~2004_07_23~胸部写真 j~RSB.aviとなっています。
RS_Receiver は、RS_Base 自動読み込み時の順序付けの為、DICOM データのタグ情報より下記を生成します。
◆ ID : (0010, 0020) 患者 ID を使⽤します。
◆ 適当な番号 : 日付 + 時刻 + (0020, 0011) シリーズ番号下 6 桁 + (0020, 0013) 画像番号下 6 桁 + 処理番号 3 桁※ 日付 + 時刻は、存在すれば(0008, 0021) シリーズ日付 + (0008, 0031) シリーズ時刻を、でなければ、(0008, 0020) 検査日付 + (0008, 0030) 検査時刻を使⽤します。
処理番号は、同時受信時のファイル名の重複を避ける為の、000〜999 の番号です。
◆ 撮影日 : (0008, 0020) 検査日付を使⽤します。
◆ 検査名 : (0008, 0060) モダリティ + “_” +【検査名の生成】で生成された検査名【検査名の生成】で生成された検査名は、次の 3 つのタグの一つあるいは組み合わせとなります。
(0018, 0015) 検査部位
(0018, 1400) 収集装置処理記述(0008, 1030) 検査記述
(0018, 1030) プロトコル名※ これらのタグの内、存在しない場合は“_”(アンダーバー)と共に省略されます。
※ Jpeg, avi の場合、検査名の最後に”j”が付加されます。

【その他】◆ 図 2 で指定した自己 AE タイトルは本アプリケーションでは使⽤しません。モダリティーからのアソシエーション要求に対しては、呼びかけられたAE タイトルをそのまま自己 AE タイトルとして返信します。これによって、AE タイトルのチェックを省略します。RS_Receiver の使⽤環境においては、厳密な AE タイトルのチェックは必要ないと思います。RS_Receiver に DICOM 通信を求めるモダリティ側はレシーバ側の AE タイトルとして適当な(かつ有効な)⽂字列を指定してください。RS_Receiver にモダリティの AE タイトル管理機能はありません。
◆ RS_Receiver が受信可能な転送構⽂(データ形式)は、次のとおりです。
転送構⽂ UID

説明1.2.840.10008.1.2

Implicit Raw Little Endian

1.2.840.10008.1.2.1

Explicit Raw Little Endian

1.2.840.10008.1.2.4.50

Lossy Jpeg 8bit

1.2.840.10008.1.2.4.70

Lossless Jpeg (MONOCHROME1, MONOCHROME2 のみ対応。 カラーは不可)

1.2.840.10008.1.2.5

RLE

1.2.840.10008.1.2.4.90

JPEG 2000 Image Compression (Lossless Only)

1.2.840.10008.1.2.4.91

JPEG 2000 Image Compression※ 以上の転送構⽂は DICOM 通信において受信を許諾するものであって、受信後の Jpeg ファイルの生成を保証するものではありません。
◆ モダリティ側での設定、操作
たとえば CR のコンソールでは、DICOM 通信の送り先を設定しなければなりません。モダリティからは RS_Receiver は PACS(DICOM サーバー)と同等に⾒えます｡設定は、送り先コンピュータ名、ポート番号、送り元 AE タイトル、送り先 AE タイトルです(詳細は各モダリティの説明書を御確認ください)。
送り先コンピュータ名 受信する(RS_Receiver の)PC の IP アドレス(図 2 の自己 IP アドレス)
ポート番号

104 など(図 2 の通信に使⽤するポート番号)

送り元 AE タイトル

任意の 16 ⽂字以内(RS_Receiver ではチェックしないが、必要)(モダリティ側 AE タイトル)

送り先 AE タイトル

任意の 16 ⽂字以内(RS_Receiver ではチェックしないが、必要) (RS_Receiver 側 AE タイトル)※ RS_Base では患者 ID を数値(整数)で管理します。モダリティでの患者 ID ⼊⼒は RS_Base に合わせてください。

付録 A: スタートアップへの登録方法
インストール後、RS_Receiver へのリンク(デスクトップにあります)をスタートアップに追加して頂きますと、PC 起動時に RS_Receiver が自動的に起動し、データ受信待機状態になります。 通常はこのようにしてお使いください。
RS_Receiver のインストールが完了しても、スタートアップへの登録は自働的には⾏われません。
スタートアップへの登録は次の手順に従って手作業で登録して下さい。
デスクトップの RS_Receiver のショートカットをコピーして、スタートアップ フォルダに張り付けてください。
Windows 10 ではスタートメニューにスタートアップフォルダが表示されなくなりました。
エクスプローラでスタートアッ プフォルダを開いて、デスクトップの RS_Receiver へのリンクをこれにコピーして下さい。
スタートアップフォルダは、
C:\Users\[ユーザ名]\AppData\Roaming\Microsoft\Windows\Start Menu\Programs\Startup (各ユーザーの場合)
C:\ProgramData\Microsoft\Windows\Start Menu\Programs\StartUp (全てのユーザー共通の場合)です。
⻑いので、エクスプローラのアドレス欄にShell:startup (各ユーザーの場合)
Shell:common startup (全てのユーザー共通の場合)と指定して頂くと一発で開きます。
※ スタートアップフォルダへは必ず RS_Receiver の「ショートカット」をコピー・張り付けしてください。
※ スタートアップフォルダは各ユーザーか全てのユーザー共通のどらか一方を設定して下さい。両方設定しないでください。

付録 B: 外部プログラムの利⽤
RS_Receiver では外部プログラムを導⼊することによって、・ DICOM SR(Structured Report)の XML, HTML 変換
・ DICOM マルチフレーム動画の H.264 ファイル変換を実⾏できるようになりました。
RS_Receiver のインストールフォルダ C:\Program Files (x86)\Shimono\RS_Receiver\内に、ExtApps フォルダを作成して頂き、その ExtApps フォルダ内に、各機能の外部プログラムを配置してください。
【 DICOM SR(Structured Report)の XML, HTML 変換 】
この機能を使⽤するには、DCMTK のファイルが必要です。DCMTK はインターネットで検索してダウンロードしてください。
DCMTK の現在のバージョンは 3.5.6 ですが、出来るだけ新しいバージョンをお試しください。
RS_Receiver のインストールフォルダ C:\Program Files (x86)\Shimono\RS_Receiver\内に、ExtApps フォルダが無ければ作成して頂き、その ExtApps フォルダ内に、DCMTK のファイルをコピーしてください。
DCMTK のファイルのうち、右のリストのファイルを上記の C:\Program Files (x86)\Shimono\RS_Receiver\ExtApps フォルダにコピーしてください。
.dll は.exe の動作に必要なものです。実⾏時にエラーが出る場合は表示の.dll を更に追加してください。
以上で、RS_Receiver の SR 変換の設定が可能になります。
実際に受信してみて、保存フォルダ(c:\gazou)に選択した形式のファイルが生成される事をご確認下さい。
※ XML, HTML 変換が必要なければ DCMTK のインストールは必要ありません。
※ DCMTK は 32bit 版 / 64bit 版どちらでも動作します。ただし、.exe ファイルと.dll ファイルは32bit 版 / 64bit 版およびバージョンを統一してください。
※ DCMTK ご利⽤の際は、ライセンスのご確認をお願い致します。

dsr2html.exe
dsr2xml.exedsrdump.exe
dcmdata.dll
dcmimage.dll
dcmimgle.dll
dcmsr.dll
oflog.dll
ofstd.dll

【 DICOM マルチフレーム動画の H.264 ファイル変換 】
この機能を使⽤するには、FFMpeg のファイルが必要です。FFMpeg はインターネットで検索してダウンロードしてください。
旧来の VFW による AVI 変換は非推奨とさせて頂きます。FFMpeg をお使い頂く事を強く推奨します。
RS_Receiver のインストールフォルダ C:\Program Files (x86)\Shimono\RS_Receiver\内に、ExtApps フォルダが無ければ作成して頂き、その ExtApps フォルダ内に、FFMpeg のインストールフォルダあるいは解凍フォルダ内の bin フォルダをフォルダごとコピーしてください。
以上で、RS_Receiver の AVI(FFMpeg)変換の設定が可能になります。
実際に受信してみて、保存フォルダ(c:\gazou)に.mp4 ファイルが生成される事をご確認下さい。
※ 動画への変換が必要なければ FFMpeg のインストールは必要ありません。
※ FFMpeg は 32bit 版 / 64bit 版どちらでも動作します。ただし、.exe ファイルと.dll ファイルは32bit 版 / 64bit 版およびバージョンを統一してください。
※ FFMpeg ご利⽤の際は、ライセンスのご確認をお願い致します。

本アプリでは FFMpeg による変換は、コーデック: H.264
コンテナフォーマット: .mp4
ピクセルフォーマット: yuv420p
ビットレート: 200kbpsに固定されています。

付録 C: 受信 IP アドレスの制御
PC に複数の NIC(ネットワークインターフェース)がある場合、特定の IP アドレス(NIC)からのみ DICOM データを受信し、他の IP アドレス(NIC)からの受信を拒否するように設定する事ができます。
この機能を利⽤するには、設定ファイルの[Receiver]セクションの BindingAddress に受信したい NIC の IP アドレスを指定します。
PC に 192.168.0.1 と 192.168.0.2 の 2 つの NIC があり、192.168.0.2 からのみ受信したい場合、
1. 必ず RS_Receiver を終了させてから、2. 設定ファイル C:\ProgramData\Shimono\RS_Receiver\ReceiverSetting.ini をメモ帳などで開き、3. [Receiver] セクションで、BindingAddress=192.168.0.2 と設定して4. 上書き保存して下さい。
5. RS_Receiver を起動して、通信設定ページの受信 IP アドレス: に指定した IP アドレス(192.168.0.2)が表示される事を確認して下さい。
設定ファイルで、BindingAddress=全てBindingAddress=など、IP アドレスの指定が無効な場合は、本機能は無効(全ての NIC からの受信を許可する)となります。

RS_Base 専⽤簡易 DICOM データレシーバ

RS_Receiver Ver. 5.21.3.18

2021 年 3 月 18 日シモノソフトウェアサービス
⻑崎県佐世保市大宮町 28-6-204
電話 0956-32-8806
shimono@orange.ocn.ne.jp