DVTK Storage SCP Emulator User Manual
DVTK Storage SCP Emulator User Manual
Table of Contents
1 Introduction ................................................................... 3
1.1 Revision History................................................................................................... 3
1.2 General ................................................................................................................. 3
1.3 System Requirements........................................................................................... 3
1.3.1 Operating system .......................................................................................... 3
1.3.2 Software requirements .................................................................................. 3
2 Software installation...................................................... 4
2.1 Installation of DVTk Storage SCP emulator software ......................................... 4
3 Functional description of the SCP emulator .................. 5
3.1 Menu bar .............................................................................................................. 5
3.2 Tool bar ................................................................................................................ 6
3.3 Information screen selection ................................................................................ 6
3.3.1 Storage SCP configuration............................................................................ 7
3.3.2 Storage Commitment configuration.............................................................. 8
3.3.3 SOP Class selection ...................................................................................... 9
3.3.4 Logging ....................................................................................................... 10
3.3.5 Validation results ........................................................................................ 11
3.3.6 Store Files functionality.............................................................................. 12
4 Supported DICOM SOP classes .................................. 15
5 Supported transfer syntaxes......................................... 19
2
User Manual – DVTk Storage SCP Emulator R3.2.0
1 Introduction
1.1 Revision History
Version Date Description
1.0 October 2, 2007 First version of this document, describing the
functionality of DVTk Storage SCP Emulator version
R3.0.0
1.1 March 13, 2008 Releasing .NET2.0 version
1.2 June 16, 2009 Releasing 3.2.0 version based on HLI
1.3 October 06, 2009 Releasing 3.3.0 with new Store Files functionality
1.2 General
The DVTk Storage SCP emulator application is used to receive DICOM part-10 files
from a remote DICOM Storage SCU system. It can also respond to Storage commitment
requests for the received dataset. The waiting time for sending the storage commitment
response to the SCU is configurable in the SCP emulator.
Supported features of the Storage SCP emulator are:
Configurable transfer syntax selection
Configurable SOP class selection
All received DICOM files will be written in DICOM part 10 format in a user
selectable directory
Possibility to create a DICOMDIR file for the received DICOM files
The Microsoft .NET framework software package is included in the installer of the
DVTk Storage SCP emulator tool.
See: http://www.dvtk.org for new versions and features.
3
User Manual – DVTk Storage SCP Emulator R3.2.0
2 Software installation
All the steps of the installation process are controlled by the DVTk Storage SCP emulator
installer package. During the installation process, the installer will check if the Microsoft
.NET Framework R2.0 is already installed on the system. If present, this step of the
installation process will be skipped.
1. Download or copy the file Storage SCP.zip to a temp directory on the PC.
2. Double click with the left mouse button on the Storage SCP.zip file and extract
the file “Storage SCP Emulator.exe” to the temp directory.
3. Start the installation procedure by double clicking with the left mouse button on
the file Storage SCP Emulator.exe
4. In the window “Microsoft .NET Framework 2.0 setup” select “ I agree” to accept
the license agreement. Press “install” to start the installation process. At the end
of the installation procedure press “OK”. The Microsoft .NET Framework R2.0
software is installed.
After the .NET Framework software is installed, the installer package continues
with the installation of the Storage SCP Emulator software
5. Follow the instructions in the installer window and accept the license agreement.
6. After the button “install” is pressed, the installation will start. At the end, press
the “Finish “button. The DVTk Storage SCP Emulator application is installed and
ready for use.
In windows “All programs” there is an entry created “DVTK”. When selecting DVTK, a
submenu with all installed DVTK applications will be opened. From this submenu the
Storage SCP Emulator tool can be selected and started. There is also a shortcut created
on the desktop
4
User Manual – DVTk Storage SCP Emulator R3.2.0
The Storage SCP emulator start up window contains the following sections:
From the Menu bar the following file options can be selected to control the Storage SCP
emulator:
File:
- Run Emulator
- Stop Emulator
- Config File
5
User Manual – DVTk Storage SCP Emulator R3.2.0
Load
Save As
- Exit
Stored Files:
- Options…
About:
- About Emulator
The tool bar contains the following short keys to control the Storage SCP emulator
process:
Start / Stop Emulator
By pressing this button the SCP emulator starts listening for incoming association
requests for storage and storage commitment. Pressing this button again will stop
the emulator.
Validation On/Off
By pressing this button, the validation will be On/Off. When enabled, the
emulator will perform a validation of the received DICOM messages and DICOM
objects.
- Storage configuration
6
User Manual – DVTk Storage SCP Emulator R3.2.0
- Log information
- Validation results (this screen is only present in case the option “Perform
validation” is enabled).
In the Storage configuration screen, the parameters for the communication with the SCP
as well as the behavior of the SCP emulator can be configured. The configuration
parameters are as follows:
- AE title
AE title used by the SCP emulator
- Port number
Listen port of the Storage SCP emulator for incoming storage associations.
7
User Manual – DVTk Storage SCP Emulator R3.2.0
In the Storage commitment configuration, the parameters for the storage commitment
communication between SCP and SCU node have to be configured.
8
User Manual – DVTk Storage SCP Emulator R3.2.0
- Local AE title
This is the AE title used by the SCP emulator to communicate with the storage
commitment SCU node.
- Local port
The port used by the emulator to listen for incoming storage commitment
associations. In the current version of the emulator, this port must be the same
as the port used by the Storage SCP process. Therefore this port is not
configurable in the Storage Commitment configuration screen.
- Remote AE title
AE title used by the Storage SCU node for incoming Storage Commitment
messages.
- Remote IP address
IP address of the remote Storage Commitment SCU node.
- Remote port
Port number used by the Storage SCU node for incoming associations.
After the configuration parameters have been entered, the test buttons “Ping SCP” and
“DICOM Echo” can be used to check if both the network and DICOM communication
with the remote Storage Commitment node are working correctly.
Remark: All configuration settings for Storage and Storage commitment operation
can be saved by using the File menu option “Config File, Save As”. The system
writes the config settings into an xml file in a user defined location. With the
“Config File, Load” function, the configuration file can be imported into the Storage
SCP emulator again.
9
User Manual – DVTk Storage SCP Emulator R3.2.0
3.3.4 Logging
After the SCP emulator has been started, automatically the log window becomes active
and shows the progress of the emulator operation.
10
User Manual – DVTk Storage SCP Emulator R3.2.0
In case the option Perform validation is enabled in the storage configuration screen, the
validation results window is present after the emulator operation has been stopped.
The validation results of all received DICOM messages and data objects are displayed.
11
User Manual – DVTk Storage SCP Emulator R3.2.0
User can configure/explore the result and data directory for emulator by using this option.
The screen shot is as shown below:
12
User Manual – DVTk Storage SCP Emulator R3.2.0
With the “Browse” button, a directory can be selected for the storage of the result files.
The default result directory will be:
C:\Documents and Settings\ing02479\My Documents\DVTk\Storage SCP
Emulator\Results
With the “Explore” button, Windows explorer is started and shows the contents of the
result directory.
With the “Browse” button, a directory can be selected for the storage of the received
DICOM images. The default data directory will be:
C:\Documents and Settings\ing02479\My Documents\DVTk\Storage SCP Emulator\
Received DICOM Messages
With the “Explore” button, Windows explorer is started and shows the contents of the
data directory (received DICOM files)
13
User Manual – DVTk Storage SCP Emulator R3.2.0
Various options are provided for storing old result (xml/html) files and DICOM message
(dcm) files when application exits or for previous runs as shown in above screen shot.
Create DICOMDIR
When selecting the menu option “Create DICOMDIR for Received DICOM Messages”,
the emulator will create a DICOMDIR file for all DICOM images that are present in the
configured data directory. All the DICOM files present in the “data directory” (including
all sub-directories) are renamed and moved to a new directory called “DICOM” while the
DICOMDIR file is saved in the “data directory”. All original files will be deleted.
14
User Manual – DVTk Storage SCP Emulator R3.2.0
15
User Manual – DVTk Storage SCP Emulator R3.2.0
16
User Manual – DVTk Storage SCP Emulator R3.2.0
17
User Manual – DVTk Storage SCP Emulator R3.2.0
18
User Manual – DVTk Storage SCP Emulator R3.2.0
19
User Manual – DVTk Storage SCP Emulator R3.2.0
20