General Electric LOGIQWORKS RADWORKS 6.0 INSTALLATION GUIDE_SM_RW60INSTALL_0 RAD Works Installation and Configuration Guide 6.0
ICG-1021-001/00-001
version 2.0
March 2002
Important
Using RadWorks implies that you have read and accepted the terms of the license provisions as laid down in this guide.
The information in this guide is subject to change without notice. GEMS IT Applicare assumes no responsibility or liability for
any errors or inaccuracies that may appear in this book.
GEMS IT Applicare assumes no liability for the improper or inexpert use of the software described herein.
© Copyright 2002 GEMS IT Applicare
No part of this publication may be reproduced in any form by print, photoprint, microfilm, electronically or by any other
means without the prior appro val in writing of GEMS IT Applicare. Additional copies are obtainable from GEMS IT Applicare
or your distributor.
RadWorks and RadStore are registered trademarks of GEMS IT Applicare.
Microsoft, Windows, Windows NT, SQL Server, Internet Information Server and Internet Explorer are registered trademarks
of Microsoft Corporation.
All other product and company names mentioned within this user’s guide may be the trademarks of their respective owners.
All patient names used in this manual are fictitious.
WARNING
AVERTISSEMENT
WARNUNG
• This Service Manual is available in English only.
• If a customer’s service provider requires a language other than English, it is the
customer’s responsibility to provide translation services.
• Do not attempt to service the equipment unless this service manual has been con-
sulted and is understood.
• Failure to heed this Warning may result in injury to the service provider, operator
or patient from electric shock, mechanical or other hazards.
• Ce Manuel de maintenance n’est disponible qu’en anglais.
• Si le technicien du client a besoin de ce manuel dans une autre langue que l’ang-
lais, c’est au client qu’il incombe de le faire traduire.
• Ne pas tenter d’intervention sur les équipements tant que le manuel Service n’a pas
été consulté et compris.
• Le non-respect de cet avertissement peut entraîner chez le technicien, l’opérateur
ou le patient des blessures dues à des dangers électriques, mécaniques ou autres.
• Dieses Kundendienst-Handbuch existiert nur in englischer Sprache.
• Falls ein fremder Kundendienst eine andere Sprache benötigt, ist es Aufgabe des
Kunden für eine entsprechende Übersetzung zu sorgen.
• Versuchen Sie nicht, das Gerät zu reparieren, bevor dieses Kundendienst-Hand-
buch nicht zu Rate gezogen und verstanden wurde.
• Wird diese Warnung nicht beachtet, so kann es zu Verletzungen des Kundendienst-
technikers, des Bedieners oder des Patienten durch elektrische Schläge, mechanische oder sonstige Gefahren kommen.
AVISO
• Este Manual de Servicio sólo existe en inglés.
• Si algún proveedor de servicios ajeno a GEMS solicita un idioma que no sea el
inglés, es responsabilidad del cliente ofrecer un servicio de traducción.
• No se deberá dar servicio técnico al equipo, sin haber consultado y comprendido
este manual de servicio.
• La no observancia del presente aviso puede dar lugar a que el proveedor de servi-
cios, el operador o el paciente sufran lesiones provocadas por causas eléctricas,
mecánicas o de otra naturaleza.
ATENÇAO
AVVERTENZA
• Este Manual de Assistência Técnica só se encontra disponível em Inglês.
• Se qualquer outro serviço de assistência técnica, quE não a GEMS, solicitar estes
manuais noutro idioma, é da responsabilidade do cliente fornecer os serviços de
tradução.
• Não tente reparar o equipamento sem ter consultado e compreendido este Manual
de Assistência Técnica.
• O não cumprimento deste aviso pode por em perigo a segurança do técnico, opera-
dor ou.
• Il presente manuale di manutenzione è disponibile soltanto in inglese.
• Se un addetto alla manutenzione esterno alla GEMS richiede il manuale in una lin-
gua diversa, il cliente è tenuto a provvedere direttamente alla traduzione.
• Si proceda alla manutenzione dell’apparecchiatura solo dopo aver consultato il pre-
sente manuale ed averne compreso il contenuto.
• Non tenere conto della presente avvertenza potrebbe far compiere operazioni da
cui derivino lesioni all’addetto alla manutenzione, all’utilizzatore ed al paziente per
folgorazione elettrica, per urti meccanici od altri rischi.
Contents
5
F O R E W O R D ........................................................................................... 13
Conventions used in this guide ............................................................................ 14
CHAPTER
CHAPTER
CHAPTER 3 C O N F I G U R I N G T E L E R A D I O L O G Y ......................... 53
1 PREPARING FOR INSTALLATION ........................ 15
Recommended hardware..................................................................................... 21
Software requirements ......................................................................................... 23
Before you install RadWorks on a Windows 2000 workstation............................ 24
Before installing on Windows NT 4.0 ................................................................... 25
RadWorks licensing ............................................................................................. 36
2 I N S T A L L I N G R A D W O R K S .................................................. 39
Upgrading from a previous version ...................................................................... 45
Modifying or removing a RadWorks installation ................................................... 46
Backing up system settings ................................................................................. 47
Working with user groups and profiles ................................................................. 48
Software patches ................................................................................................. 50
Installing workgroup servers and clients .............................................................. 51
Preparing the workstation for teleradiology.......................................................... 54
Setting up the Connection Service....................................................................... 55
Setting up and configuring destinations ............................................................... 57
Setting up and configuring origins........................................................................ 61
Automatically locking and unlocking studies ........................................................ 63
Compression in teleradiology............................................................................... 65
Automatically compressing and decompressing studies as they are received .... 67
GEMS IT Applicare
6
contents
Working with Wavelet compression...................................................................... 68
Configuring storage commitment.......................................................................... 69
Setting up auto-routing ......................................................................................... 70
Setting up basic automatic routing ....................................................................... 70
Setting up advanced auto-routing......................................................................... 72
Working with auto-routing protocols ..................................................................... 73
Auto-routing configuration examples .................................................................... 75
Troubleshooting an origin and a destination......................................................... 78
CHAPTER
CHAPTER
4 CONFIGURING THE VIEWING SECTION.....81
Viewing properties ................................................................................................ 84
Navigation buttons................................................................................................ 88
Configuring annotations........................................................................................ 89
Setting up calipers ................................................................................................ 89
Setting preferences for measurements ................................................................ 89
Working with hanging protocols............................................................................ 90
Managing hanging protocols ................................................................................ 90
Multi-selectable hanging protocols ..................................................................... 101
Orientation of image ........................................................................................... 102
Adding new DICOM tags as hang criteria .......................................................... 102
Hanging protocol for T1/T2................................................................................. 102
Hanging protocols and upgrading RadWorks ..................................................... 104
Plug-ins............................................................................................................... 105
5 INTEGRATING WITH HIS-RIS AND
W O R K L I S T S ....................................107
RadWorks 6.0 installation and configuration guide
Reporting ............................................................................................................ 110
Worklists............................................................................................................. 110
Notifications and transactions............................................................................. 111
Tags indexed in the local database .................................................................... 113
Configuring CallExe............................................................................................ 115
CHAPTER 6 C O N F I G U R I N G R E P O R T I N G ....................................... 123
Reporting options............................................................................................... 125
Setting up reports in plain text ........................................................................... 126
Setting up reporting for MS Word....................................................................... 128
Setting up for XML reports ................................................................................. 130
Setting up externally stored reports – HIS/RIS .................................................. 132
Setting up externally stored reports – Browser .................................................. 133
Study status mapping ........................................................................................ 134
Reviewing reports from a Mitra PACS Broker.................................................... 135
Compatibility with other systems........................................................................ 137
7
CHAPTER
CHAPTER
7 C O N F I G U R I N G P R I N T I N G ............................................. 139
Setting up a DICOM printer................................................................................ 140
Setting up a Windows printer ............................................................................. 142
Setting up a file printer ....................................................................................... 146
Creating custom print layouts ............................................................................ 149
Configuring printers............................................................................................ 150
Connecting to a DICOM device ......................................................................... 151
Inside DICOM Print configuration ...................................................................... 153
Configuring presentation sheets ........................................................................ 158
Notes on specific printers................................................................................... 161
8 CONFIGURING THE INTEGRATION
M O D U L E ............................................... 163
Inserting a tooltab .............................................................................................. 166
Inserting a menu item ........................................................................................ 168
Inserting a popup menu item ............................................................................. 169
Inserting a command ......................................................................................... 171
Starting an application with a command ............................................................ 171
Opening a Web page with a command .............................................................. 172
Accessing a HIS-RIS function with a command................................................. 173
Applicare Medical Imaging BV
8
contents
Completing the Command Wizard...................................................................... 175
CHAPTER 9 C O N F I G U R I N G Q U A L I T Y C O N T R O L ................. 177
Preparations for configuring Quality Control....................................................... 178
Setting up (auto) matching ................................................................................. 181
Setting up RIS notifications ................................................................................ 184
Editing demographics ......................................................................................... 185
Sending Modality Performed Procedure Step messages................................... 187
MPPS data structure and sources...................................................................... 188
MPPS information sent to HIS/RIS system ........................................................ 192
CHAPTER
CHAPTER
10 SETTING UP SINGLE MEDIA ARCHIVES.201
Setting up RadWorks to copy data to single media ............................................ 202
Setting up RadWorks to copy from a read-write medium ................................... 204
Copying data from a read-write medium and viewing it in RadWorks ................ 205
11 C O N F I G U R I N G D A T A A C Q U I S I T I O N ...............207
Supported devices.............................................................................................. 208
RadWorks Acquisition Module Setup ................................................................. 212
Configuring the Acquisition Module .................................................................... 214
Configuring acquisition properties within RadWorks .......................................... 215
Hardware-specific settings (device management).............................................. 223
Acquire action settings (Image Types) ............................................................... 224
Installation and configuration of digitizers........................................................... 225
Setting up a Lumisys LS75 digitizer ................................................................... 225
Device-specific configuration options ................................................................. 227
Device management........................................................................................... 227
Image types ........................................................................................................ 227
Setting up Lumisys Lumiscan 85........................................................................ 227
Setting up a Howtek Scanmaster DX ................................................................. 227
Setting up a Vidar VXR-12 digitizer .................................................................... 229
RadWorks 6.0 installation and configuration guide
Installation and configuration of frame grabbers................................................ 232
Performance of frame grabber workstations in continuous mode...................... 232
Setting up a Matrox Meteor frame grabber board.............................................. 233
Setting up a Matrox Pulsar frame grabber card ................................................. 236
Matrox Intellicam................................................................................................ 239
Setting up a Data Translation Mach DT3153 ..................................................... 239
Setting up an Foresight HI*DEF Plus or Accura frame grabber......................... 242
Installing and configuring TWAIN devices.......................................................... 245
Installing and configuring the acquisition utilities ............................................... 248
General notes about device drivers ................................................................... 250
9
CHAPTER
CHAPTER
12 MULTI-USER ENVIRONMENTS AND
S E C U R I T Y ......................................... 251
Roaming (roving) profiles ................................................................................... 253
Windows security settings.................................................................................. 254
RadWorks Settings tool...................................................................................... 261
RadWorks access control .................................................................................. 262
Audit trail ............................................................................................................ 263
13 SYSTEM MAINTENANCE .................................................. 267
Automatically cleaning up data .......................................................................... 268
RadWorks software patches .............................................................................. 272
Upgrading .......................................................................................................... 274
RadWorks 1.x to RadWorks 6.0......................................................................... 274
RadWorks 2.1, 4.0, 5.x to RadWorks 6.0........................................................... 274
Known upgrade issues....................................................................................... 274
Workgroup Server.............................................................................................. 276
Users connected to server ................................................................................. 276
Monitoring the performance of the Database Service........................................ 276
Making backups ................................................................................................. 277
Defragmentation ................................................................................................ 279
Moving local database to a different drive.......................................................... 280
Applicare Medical Imaging BV
10
contents
Starting and stopping the services ..................................................................... 282
Getting system information................................................................................. 283
CHAPTER
14 T R O U B L E S H O O T I N G ..............................................................285
Tips on how to diagnose..................................................................................... 287
Running a Service in Console Mode .................................................................. 287
Providing log files and other important information ............................................ 288
Understanding the log files ................................................................................. 290
License files........................................................................................................ 292
Data acquisition solutions................................................................................... 294
Teleradiology solutions ....................................................................................... 295
Storage commitment messages ......................................................................... 299
TCP/IP communication issues............................................................................ 301
Using the RadWorks utilities............................................................................... 314
Checkpal.exe...................................................................................................... 314
CtrlsrvW.exe ....................................................................................................... 314
Dcmecho2.exe.................................................................................................... 314
DcmPing.exe ...................................................................................................... 315
Dcmsend2.exe.................................................................................................... 316
License.exe ........................................................................................................ 316
RunLCfg.exe....................................................................................................... 317
Tiffconv.exe......................................................................................................... 317
Dcmscp.exe........................................................................................................ 317
DICOM repair utility ............................................................................................ 318
Remotely control a Windows system.................................................................. 320
CHAPTER
RadWorks 6.0 installation and configuration guide
15 USING A SQL SERVER DATABASE ..................323
Installing SQL Server 7.0.................................................................................... 324
Installing SQL Server 2000................................................................................. 326
Performance tuning ............................................................................................ 328
APPENDIX A ERROR, WARNING & OTHER MESSAGES329
General .............................................................................................................. 330
Data Selector ..................................................................................................... 333
Integration module ............................................................................................. 337
Viewing............................................................................................................... 337
Reporting ........................................................................................................... 343
Hanging protocols .............................................................................................. 346
MPR/MIP............................................................................................................ 350
Teleradiology...................................................................................................... 352
Converter module .............................................................................................. 360
Printing............................................................................................................... 371
Archiving ............................................................................................................ 375
Quality Control ................................................................................................... 382
Configuration ..................................................................................................... 386
11
APPENDIX
APPENDIX C H A Z A R D S : A N A L Y S I S & M I T I G A T I O N ......... 423
APPENDIX
APPENDIX
B L I S T I N G S O F D I C O M T A G S ........................................ 389
DICOM tags listed in numerical order ................................................................ 389
DICOM tags listed alphabetically ....................................................................... 406
D D E C L A R A T I O N O F C O N F O R M I T Y ....................... 431
E L I C E N S E A G R E E M E N T ....................................................... 433
Index .................................................................................................................. 439
Applicare Medical Imaging BV
12
contents
RadWorks 6.0 installation and configuration guide
Foreword
RadWorks workstation is highly configurable. The user interface can
be adapted to specific needs and workflow. You can connect the workstation other workstations, to image archives and to HIS-RIS systems,
create reports to particular specifications, and much more.
This guide describes how to configure these many aspects of RadWorks. It
also describes how to initially install RadWorks, and how maintenance it and
troubleshooting if necessary.
The guide is meant to be used by system administrators rather than end users.
For general information on how to make user-specific settings and actually
use RadWorks, see the RadWorks User Guide.
Chapters 1 and 2 describe how to install RadWorks. Chapters 3 through 11
show you how to configure the optional RadWorks modules. Information on
how to maintain the RadWorks system is contained in Chapters 13, while
chapter 14 provides useful information on how to troubleshoot particular
issues. Appendix A provides a list of error messages while Appendix B offers
lists of DICOM tags you may find it useful to refer to when making DICOMspecific settings.
13
When installing RadWorks on multiple systems, you can often save a great
deal of time and effort by copying the configuration information from one station to others - see chapter 12 for more on this.
We wish you every success with setting up and configuring your RadWorks
system.
The RadWorks development team
Zeist, The Netherlands
March 2002
GEMS IT Applicare
14
foreword
FOREWORD
Conventions used in this guide
In instructions, where you must select a submenu from a menu, these selections are listed as Menu
Buttons and other items you must click are Bold.
The root directory for RadWorks is given as %ROOT%. So the path to the
\bin subdirectory in the RadWorks root directory is rendered as
%ROOT%\bin. The default root directory is C:\AMI_60, but you can install
into a different directory.
Key to note icons
→ Submenu.
A note offering
additional information on an aspect
described in the text.
Read this.
An aspect of
particular
importance to
take note of.
A tip or trick to help
you get more out of
Centricity DA.
RadWorks 6.0 installation and configuration guide
CHAPTER
Preparing for installation
This chapter lists the different versions of RadWorks and the hardware and
software they require, and describes what needs to be done prior to installation on
a Windows workstation.
RadWorks versions and modules ............................16
Recommended hardware.........................................21
Software requirements.............................................23
Before you install RadWorks on a Windows 2000
workstation...............................................................24
IN THIS
CHAPTER
Before installing on Windows NT 4.0 .......................25
RadWorks licensing .................................................36
16
PREPARING FOR INSTALLATION
chapter 1
ince medical imaging requirements differ widely between locations and
types of use, RadWorks comes in a number of versions and offers many
optional modules. This means that each system need only have the functionality its particular users need. Systems can range from just basic viewing
stations through to powerful multi-monitor radiology workstations including
all the functionality described in this manual.
This means that system requirements may vary. More complex RadWorks setups require more capable hardware, and some options require optional Windows components to be installed. This chapter describes the hard- and
software required for various RadWorks systems, and it guides you through
preparing the workstation for installing RadWorks.
Part of those preparations are changes to Windows’ configuration (networking
and dial-in setup). For in-depth information on these subjects, see Windows
reference books, Microsoft TechNet and on-line documentation, such as “The
Windows 2000 FAQ” by John Saville (www.windows2000faq.com) and the
“The Windows NT FAQ” by John Saville (www.ntfaq.com).
RadWorks versions and modules
To allow systems precisely tailored to specific
needs, there is a vast
range of options when configuring RadWorks. Please consult
your distributor with your exact
requirements if you are considering changing your system.
RadWorks 6.0 installation and configuration guide
This section lists the available RadWorks versions and modules.
Versions
RadWorks systems are available in several versions intended for particular
types of use. Diagnostic is the high-end system positioned specially for diagnostic use by radiologists. It supports multiple high-resolution monitors (2000
x 2500 pixels), printing and MPR/MIP. Review is a more basic system for
referring physicians. The Standard version is generally used in wards, operat-
ing theaters and ICUs and for the radiologist on call.
The Educational version is similar to Diagnostic, but is meant for educational
purposes only.
Workgroup Server allows multiple users to access a single, shared database
and work much more flexibly as a team. Once a study has been sent to the
Workgroup Server, all clients will be able to see it in the Data Selector and
view it. When one client opens the study to work on it, the other clients can
still open the study for viewing only (they can add presentation states, key
notes and structured reports). Study status changes made by the editor are
automatically transmitted to the viewers. The Workgroup Server can also be
used as a workstation. You cannot run the Quality Control Module or the Data
Acquisition Module on a Workgroup Server, and we do not recommend running the Single Media Archive Module on the server.
The users have Workgroup Clients to access the server. A Workgroup Server
supports up to ten Clients. You cannot run the Quality Control Module, Single
Media Archive or the Data Acquisition Module on a Workgroup Client.
Modules
Each type of RadWorks system can be further enhanced by additional modules which cover specific tasks. Some modules are included as standard in
some versions. If a module is not included in a version, it can often be added
to it.
Multi-Monitor module
This allows RadWorks to use multiple monitors in various configurations. It is
included as standard in RadWorks Diagnostic and is optional for the other versions.
17
Print module
This supports background printing to DICOM 3.0-compliant imagers. Both
color and monochrome printing are supported. The module also offers a file
export option to BMP and TIFF file formats which is useful for reporting,
teaching files, creating slides and presentations. You can print series or studies
in pre-defined film layouts which can be selected from the layout pool. The
virtual film sheet (presentation sheet) offers the ability to compose and post
process print jobs on the fly. A single film sheet can be made up of images
from different modalities, and images can be included more than once on the
same sheet with different settings. Printing to Windows-supported printers is
included in RadWorks; you do not need the Print module for that.
GEMS IT Applicare
18
PREPARING FOR INSTALLATION
chapter 1
Single Media Archive module
This allows archiving patient and study data on any media supported by Windows 2000/NT (CD-R, Jaz/zip disks etc.). An indexing tool provides archive
and media management, allowing you to keep a record of which patients studies are located on which disk. The data is written to the media in the DICOM
3.0 Part 10 format, thus, guaranteeing a growth path towards mass archiving
in the future.
Data Acquisition module
This can be used to acquire data from systems that are not DICOM 3.0 compliant. It supports film digitizers from several major vendors (Lumisys, Howtek and Vidar), frame-grabbers, document scanning and graphics file import.
MPR/MIP module
This allows Multi Planar Reconstruction (MPR) and Maximum Intensity Projection (MIP) on 3D data sets of MR and CT slices. MPR is an algorithm that
computes cross-sections as if the slices had been acquired in a different direction. MIP computes images that primarily show the pixels with the highest
values and is excellent, for example, at showing blood vessels in angiography.
MPR/MIP cines can be created, saved to disk and sent to other systems for
review. Collections of individual MPR or MIP frames can also be created and
saved along with the original images.
RadWorks 6.0 installation and configuration guide
MPR and MIP only works with specific data set types, see ‘Requirements for
MPR and MIP’ in chapter 6 for details.
Quality Control module
This allows various quality control tasks to be undertaken at designated workstations within the hospital.
Images that are acquired in certain modalities are routed to such quality control workstations before they enter the network. Studies can be opened for
adding or changing patient demographics before they are saved and stored in
the hospital’s archive, or before they are routed to other clinical workstations
for viewing and reporting. Previous studies can also be (pre-)fetched from the
hospital’s archive and used, for example, to adjust the window width and level
settings or orientation of a CR image to comply with previously acquired CR
studies. You can also re-sort images within a series, or delete images that have
no clinical relevance.
If the hospital information system is capable of generating a DICOM 3.0
Modality Worklist, part of the quality control work can be automated. For
example, the patient demographic information that is part of a worklist entry
can be automatically inserted in a study.
Wavelet compression
This option allows you to use the compression based on the Wavelet algorithm
when sending studies using teleradiology.
Integration module
This permits custom tooltabs, menus and pop-up menus (customizable for
each user) to be added to RadWorks. They will typically provide single-click
access to other applications such as a word processor, a web browser (with a
particular HTML page loaded) or HIS/RIS functions, all from within RadWorks. It is particularly powerful as the basis of close integration between
RadWorks and other systems.
Availability of modules
The following table lists the RadWorks versions, and the modules that can be
added to them.
Modules that are part of all RadWorks versions are:
• Windows Print,
• JPEG compression / decompression,
• Teleradiology.
19
GEMS IT Applicare
20
PREPARING FOR INSTALLATION
chapter 1
RadWorks version
Options Standard Review Diagnostic
Data Acquisition Option Option Option Not available
Integration Option Option Option Option
Multi-Monitor (up to 4) Option, up to 2 Option Included Option
Single Media Archive Option Option Option Clients only
Quality Control Option Option Option Not available
DICOM Print Option Option Included Included
Wavelet Compression/Decompression Option Option Option Option
MPR/MIP Not available Option Included Option
Workgroup
Server
Viewing & reporting limitations
Filters 2 10 10 10
Cine 1 16 16 16
Save alterations annotation/report
(in general: saving changes)
Viewing Matrix
RadWorks supports a resizable application
matrix that begins at 800 x 600 pixels.
Modules available with RadWorks versions
No Ye s Ye s Ye s
max. 1200 x 1600 These have been successfully tested with a matrix of 2000 x 2500 pixels per
monitor.
RadWorks 6.0 installation and configuration guide
RadWorks performance will increase on
a multi-processor
machine, because the software
supports Symmetric Multi Processing (SMP).
You should increase your RAM if
you plan to run RadWorks concurrently with other Windows applications or on a multi-monitor
configuration.
21
Recommended hardware
Depending on the RadWorks license you have, Applicare recommends minimum hardware specifications. This is a guideline, and the final choice will
depend on budgets, available hardware on site, etc. If you decide to run RadWorks on a less capable hardware configuration than our recommendation,
you will most likely experience degraded performance.
When you add one or more RadWorks Modules to an existing system, you
may need to upgrade the hardware.
Although RadWorks will run on systems with slower processors and/or less
memory, the following hardware is recommended for good performance:
• 800 MHz Pentium III processor. When you upgrade an NT 4.0 system from RadWorks 5.1 without changing the hardware, you can
expect performance similar to RadWorks 5.1.
• 128 MB RAM minimum for Windows NT 4.0, 256 MB recommended (see ‘Memory and disk space requirements’ on page 22).
• 256 MB RAM minimum for Windows 2000, 512 MB recommended
(see ‘Memory and disk space requirements’ on page 22).
• 6-9 GB SCSI hard disk, preferably, Ultra Wide or Ultra-2.
(see ‘Memory and disk space requirements’ on page 22).
• Fast graphics card with at least 8 MB RAM and capable of displaying 256 shades of gray. For color display, 16 million colors are
required, 16 MB RAM is recommended.
• A non-interlaced monitor with a refresh rate of at least 70 Hz and a
resolution of at least 800 x 600 pixels is required, although a resolution of 1024 x 768 or greater and a 19-21 inch monitor size is recommended.
• Keyboard and mouse.
• A high-speed analog modem, ISDN terminal adapter, 100 Mbit/s
Ethernet or ATM connection if teleradiology is used.
• A RadWorks-compatible frame grabber board if frame grabbing is
used.
• SCSI card for digitizer connectivity if a digitizer is used.
• Special graphics adapters if multi-monitor capabilities are used.
GEMS IT Applicare
22
PREPARING FOR INSTALLATION
chapter 1
Memory and disk space requirements
If you plan to regularly view large studies like CR images, multiframe studies
or MPR/MIP, use the ‘recommended’, rather than the ‘minimal’ amount of
RAM specified. Increasing the amount of RAM will always improve performance – the more memory the better. RadWorks’ image caching feature will
use all available RAM for better viewing performance.
The optimal capacity of the hard disk depends on the usage of the PC. If it is
used for medical imaging only, a capacity of a few GB will be sufficient for
normal usage. If you want to store many images and studies for a longer
period of time, you might consider using disks with higher capacity. RadWorks itself takes up about 300 MB, the demo data takes up another 360 MB.
You need the disk space mainly for studies; the amount of space you need
depends on how you use RadWorks.
Hardware recommended for Workgroup systems
For a Workgroup Server/Client system, you need the same hardware as for a
stand alone system, with these exceptions:
Server
• If the server will also be used as a client, a dual processor system is
recommended.
RadWorks 6.0 installation and configuration guide
• 512 Mb RAM.
• 9 Gb hard disk (10,000 rpm or faster).
Client
Same as for a RadWorks stand-alone system.
Network
100 Mbps or faster.
Software requirements
RadWorks 6.0 runs under the following computer operating systems:
• Microsoft Windows 2000 Professional with Service Pack 2, or
• Windows NT 4.0 with Service Pack 6a or later.
Windows 2000 is preferred. RadWorks 6.0 will not run under any other Windows version.
If you wish to use hanging protocols and /or reporting, install a scripting host
(JavaScript or VBScript). You can add these by installing Microsoft Internet
Explorer 5.01 or higher, or the Windows Scripting Host.
If you want to use a Word template in reporting, you must also install
Microsoft Word 2000.
RadWorks has built-in teleradiology capabilities. In order to be able to use
them, the following Network Protocols need to be set up, depending on how
the computer is connected (will it move images via a LAN/WAN, or via a
modem link?):
23
TCP/IP For LAN and WAN communications, and use of modem / ISDN. DICOM 3.0 can only
RAS For use of modem / ISDN.
Network protocols
communicate using this protocol.
You can add these during the Windows installation, or you can add them to an
existing installation.
Windows service packs can be downloaded from the Microsoft web site.
Software recommended for a Workgroup Server
• Microsoft Windows 2000 Server with Service Pack 2, or Microsoft
Windows NT 4.0 Server.
Make sure you have a sufficient number of client connection licenses with
your Windows license.
GEMS IT Applicare
24
PREPARING FOR INSTALLATION
chapter 1
Before you install RadWorks on a Windows 2000 workstation
Before you install RadWorks, you must set up networking. If you have a multiple-monitor setup, you must also (install and) configure your monitors.
Below are described the preparatory steps for a Windows 2000 system. If you
are installing on Windows NT, see ‘Before installing on Windows NT 4.0’ on
page 25.
Configuring multiple monitors
1111 Install the video adapters and monitors.
2222 In the Display configuration applet in the Control Panel, configure
your monitors: Arrange the monitors the way you will use them, and
set the resolution, color depth and refresh frequency for each monitor.
RadWorks 6.0 installation and configuration guide
Consult with your network administrator
about network settings
25
Before installing on Windows NT 4.0
Before installing RadWorks on your Windows NT workstation, you will need
to configure networking and also possibly the multi-monitor settings.These
are described in this section.
If you are installing on a Windows 2000 workstation, see ‘Before you install
RadWorks on a Windows 2000 workstation’ on page 24.
Network configuration
Once the TCP/IP Protocol has been installed during Windows NT Setup, you
can modify its properties if and when necessary.
1111 Open the Control Panel.
2222 Open the Network manager.
3333 Click the Protocols tab.
4444 Select TCP/IP Protocol.
GEMS IT Applicare
26
PREPARING FOR INSTALLATION
chapter 1
5555 Click Properties.
6666 During Windows NT Setup you will have been prompted to enter the
IP settings. Check to see whether the settings are still correct.
7777 Click the DNS tab.
8888 Add the IP address of the DNS Service.
9999 After adding or editing network settings, restart the computer for the
changes to take effect.
Remote Access Service configuration
The Remote Access Service (RAS) has to be set up if RadWorks is to receive
and/or send images using an analog modem or an ISDN interface card. RAS is
not necessary for receiving or transmitting images if the RadWorks system
will only be connected to a local area network.
Adding an analog modem to the PC can be done during Windows NT setup or
at a later stage using the Modems Properties in the Control Panel folder. Run
the ‘Install New Modem’ wizard to install a new analog modem.
RadWorks 6.0 installation and configuration guide
Adding an ISDN interface card is best done after installation of Windows NT
by using the Network Properties icon in the Control Panel.
If Windows NT detects any RAS capable devices they will be listed here.
Once a RAS device has been added it needs to be configured to either transmit
(Dial out only) or receive (Receive calls only) or both (Dial out and Receive
calls).
27
The choice made in the Configure Port Usage window will determine the contents of the Network configuration.
DICOM transmissions use the TCP/IP protocol.
GEMS IT Applicare
28
PREPARING FOR INSTALLATION
chapter 1
Setting up RAS to transmit
Setting up RAS as a dial out service you need to choose which Dial out Protocol will be used in the Network Configuration of the RAS device.
The encryption settings can be set when a RAS Address Book entry is created.
This is described later on in this chapter.
Setting up RAS to receive calls
RadWorks 6.0 installation and configuration guide
The Network Configuration window changes as soon as you have set the RAS
device to Receive Calls.
Prior to setting up the system to receive calls from another system determine
which Dial out Protocol to use. Make sure both systems are configured for the
same Protocol(s).
The Server Settings allow you to configure the network accessibility:
Then depending on the local situation you can activate DHCP to assign
remote TCP/IP client addresses. If DHCP is not being used it is necessary to
use a static address pool.
29
The first address will
always be assigned to
the RAS Server and the
second to the client.
Since the client will dial directly into a system you may choose any IP address
you see fit, provided it does not conflict with IP addresses being used within
the local area network.
The encryption settings can be set in the last section of the Network Configuration. Make sure the client uses the same as is set here. This will be described
later on during the RAS installation.
Setting up local host information
If you are able to connect to the other computer using its IP address, but you
are not able to connect to the other computer using its host or NetBIOS name,
there may be a name resolution problem. There are many methods to accomplish name resolution on a network, including the following:
GEMS IT Applicare
30
PREPARING FOR INSTALLATION
chapter 1
• Domain Name Service (DNS)
• Windows Internet Name Service (WINS)
• HOSTS files
• LMHOSTS files.
Detailed information about setting up and troubleshooting local host information is included in this chapter.
To prepare a RadWorks system for receiving images via a remote connection
start the Remote Access Service and configure the Remote Access Server.
RadWorks 6.0 installation and configuration guide
Activating the Remote Access Server
1111 Open the Services control panel.
2222 Select the Remote Access Server in the list. By default, the startup
for this service is set to Manual. The service needs to be started in
order to receive calls.
3333 Click Startup..., and change the startup setting to Automatic. That
way the Server will always be available, and you won’t have to start
it manually.
To start the Server, you can also use the Remote Access Admin (Startup
menu
→Programs → Administrative Tools).
Setting dial in permissions
If the Remote Access Admin has been started and the Server has not, a message will be displayed.
From the Server menu, start the Remote Access Server.
You can set dial-in permissions for users to protect a Windows NT system
from unwanted callers. From the Users menu, select the Permissions option
to set these permissions.
31
Users listed here have been added either by the System Administrator or software installation programs.
GEMS IT Applicare
32
PREPARING FOR INSTALLATION
chapter 1
RadWorks creates several users. One of them, CN_Service, is part of the Connection Service and needs to have dial-in permission on the Server. To set permissions:
1111 Select the user in the list.
2222 Check the Grant dial-in permission to user check box.
Applicare recommend you test the RAS connection prior to installing RadWorks. The next section describes how to create a Phonebook entry for dialing
the remote system.
Creating a RAS Phonebook entry
The client system needs to know which phone number to dial. Use Dial-Up
Networking in the ‘My Computer’ folder, to set this up.
For detailed information on all options not discussed in this section, refer to
the Windows NT help files and manuals.
1111 When you create a new entry, a wizard will guide you through creat-
ing the entry.
RadWorks 6.0 installation and configuration guide
Once these steps have been completed (name, phone number and device to
use) you can edit the entry to refine its settings.
2222 Click More and select the option Edit entry and modem properties
from the menu.
Make sure you have all the relevant information at hand before proceeding to
edit the Phonebook Entry.
3333 For ‘Entry name’, type a descriptive name; make clear which site
will be called. RadWorks uses this name to add a Teleradiology destination.
33
GEMS IT Applicare
34
PREPARING FOR INSTALLATION
chapter 1
4444 Use the next tab in the dialog window to configure the server settings
of the remote site. The default server type is displayed in the illustration and doesn’t usually need to be changed.
5555 Typically, the network protocols will be TCP/IP . If the remote sys-
tem is configured to assign an IP address to the client, then the
default TCP/IP settings will not need changing.
RadWorks 6.0 installation and configuration guide
6666 The Security setting in the Phonebook Entry should be the same as
was set in the Network Configuration on the Remote Access Server.
7777 RadWorks does not need any login script; such a script is sometimes
used to logon to the server of an Internet Provider. If you ever connect to an X.25 network, refer to the appropriate documentation.
Testing Remote Access Server
Once RAS has been setup on both client and server, test the modem communication between the two systems.
1111 Use Dial-Up Networking to dial the remote computer with the entry
you just created.
2222 Verify that the Remote Access Server on the system that will receive
the call has started correctly.
3333 Select the remote systems’ Phonebook Entry and dial: click Dial.
Enter CN_Service as the user and Service20 as password. If both
systems have been setup correctly with RAS and RadWorks the
remote system will authorize the dialing system to access it.
Configure multiple monitors
1111 Install the video adapters and monitors.
2222 In the Display configuration applet in the Control Panel, configure
the monitors: Arrange the monitors the way you will use them, and
set the resolution, color depth and refresh frequency for each monitor.
35
GEMS IT Applicare
36
PREPARING FOR INSTALLATION
chapter 1
RadWorks licensing
The RadWorks software requires an electronic license file. This contains the
codes which enable you to access those parts of RadWorks you have purchased.
Whenever the RadWorks’ Services are started or accessed, a license check is
performed. If the requested license is not available, the Service(s) will not
start and RadWorks also may not.
Electronic licensing and the MAC address
When placing an order for an electronic license, the MAC address (physical or
Ethernet address) of the network interface card in the license server or standalone computer is required so the necessary license file can be created.
These steps are not
required when using a
local license file. You
only need the FLEXlm toolkit for
license server installations.
To obtain the MAC address, either
Open a Command Prompt window and type the command:
ipconfig /all
or
Run the Lmtools executable, supplied on the RadWorks 6.0 CD-ROM, and
open the System Settings property sheet. This is the preferred method.
The program files and documentation for Lmtools are included on the RadWorks 6.0 CD-ROM (\3rdparty\flexlm directory).
FLEXlm toolkit
RadWorks uses the FLEXlm toolkit for electronic licensing. It consists of four
parts.
1111 Lmtools.exe:
FLEXlm tool to obtain MAC address, install the FLEXlm Services,
perform diagnostics, etc.
2222 Lmgrd.exe:
The license manager program, which starts a Windows service when
the server is started.
3333 Amidmn.exe:
Applicare-specific program, which validates the license file.
RadWorks 6.0 installation and configuration guide
4444 Lmutil.exe:
Command Prompt version of Lmtools.
Installing the FLEXlm Service
The Lmtools program allows you to configure the FLEXlm Service for RadWorks 6.0. Copy the four files (Lmtools.exe, Lmgrd.exe, Amidmn.exe,
Lmutil.exe) from the CD-ROM to a permanent directory (e.g. C:\FLEXlm) on
your hard disk.
1111 Start Lmtools.
2222 On the first tab (Service/License File), select Configuration using
Services.
3333 On the last tab (Configure Services), select an appropriate service
name.
4444 Provide the paths to the requested files, lmgrd.exe and the server
license file. Applicare supplies license files with the extension *.dat.
5555 Check the Use Services and Start Service at Powerup checkboxes.
6666 On the fourth tab (Start/Stop/Reread), the service is now displayed.
Click Start Service. The service is started as soon as the message
‘Using license: <license file name>’ is displayed.
The FLEXlm license server is now installed.
37
In the Services control panel, the service will be displayed as being started and
will automatically start at boot time.
To see if the service is functioning and how many licenses it has issued, use
the Server Status and Server Diagnostic tabs.
About license files
Dependencies
If the Database, Connection and Print service do not start automatically with
the license file when the computer restarts, do the following.
1111 Use regedt32 to edit the HKEY_LOCAL_MACHINE\System\Cur-
rentControlSet\Services keys for the Database, Connection and Print
Services.
2222 Double-click DependOnService and add:
• LanmanWorkstation if you are using Windows NT 4 Server.
• LanmanServer if you are using Windows NT 4 Workstation
• Lmhosts.
GEMS IT Applicare
38
PREPARING FOR INSTALLATION
chapter 1
3333 Repeat this for all three Services.
When the computer is restarted, all services should start.
MAC address only contains zeros
If your computer is not connected to the network the MAC of your Ethernet
card will be displayed as zeros.
Running lmhostid will return "000000000000". You need to disable the Media
Sense on your system.
See the web page: ‘How to Disable Media Sense for TCP/IP in Windows
2000’. The Internet address is:
http://support.microsoft.com/support/kb/articles/Q239/9/24.asp
Multiple MAC addresses
If you run lmhostid or lmtools on a Windows 2000 system with one network
card, and you get multiple Ethernet addresses, remove the NetBeui and IPX/
SPX protocols. Alternatively, use the Ethernet address that does not change
when you restart the computer.
Using a dongle
If your setup does not allow the use of electronic licensing, you can order a
dongle (hardware license key) from your distributor instead.
You may need to
access the BIOS set-
ting of the PC in order
to change the parallel port setting
to bidirectional or ECP/EPP.
RadWorks 6.0 installation and configuration guide
A dongle is a piece of hardware that has to be connected to the parallel port of
the computer. Always use LPT1 if more than one parallel port is available.
Normally, licenses do not expire. However, demonstration and evaluation
dongles have an expiry date. A warning dialog box will appear when you start
RadWorks and the license is due to expire in seven days or less.
CHAPTER
Installing RadWorks
This chapter describes the installation procedure for your RadWorks 6.0 software.
Who should install RadWorks? ................................40
Running RadWorks Setup........................................40
Upgrading from a previous version ..........................45
Modifying or removing a RadWorks installation .......46
IN THIS
Backing up system settings......................................47
CHAPTER
Software patches .....................................................50
Installing workgroup servers and clients ..................51
40
INSTALLING RADWORKS
chapter 2
his chapter describes the procedure for installing the RadWorks software. It is recommended that you read this chapter carefully before
installing RadWorks on your system.
Who should install RadWorks?
To install RadWorks you need to log on as a user with administrator rights.
This will ensure that all configuration settings performed by the administrator
and the rights to install RadWorks will be available to all RadWorks users.
Check your logon rights using the User Manager in the Start Programs
Administrative Tools Group. Double-click the Administrators Group to
see if your logon name is in the Member list. If you start the setup without the
necessary rights you will not be able to install RadWorks.
If in doubt about your logon rights, contact your system administrator.
Before you start...
Make sure you have the correct license file, or dongle, before you install RadWorks.
RadWorks 6.0 installation and configuration guide
Running RadWorks Setup
If all the hardware and software requirements for using RadWorks 6.0 are met,
you can run the RadWorks Setup program (setup.exe on the RadWorks installation CD).
Welcome
1111 After Setup has started, a Welcome screen is displayed. Click Next >
to continue.
The Setup may update the Windows Installer on your computer. If
this happens, you will be prompted to reboot the computer.
Destination folder
2222 By default, Setup will install your RadWorks program files in
C:\AMI_60. To place these files in another folder, click Change...
and specify a different location. It is recommended that you select a
folder directly at the root level, not inside another folder.
3333 Click Next > to continue. At any time during the installation, you
can click < Back to return to previous screens and change settings.
RadWorks type and role
4444 Choose the RadWorks product you want to install by clicking the
appropriate selection button under Choose the RadWorks type. You
should have the appropriate license for whatever version of RadWorks you select.
5555 In Choose the RadWorks role, the difference between a Stand-
alone and a Workgroup server installation is that the server’s database and services will be shared so the Workgroup clients can access
them.
41
A Workgroup client
cannot use the Quality
Control, the Data
Acquisition Module or the Single
Media Archive module.
6666 Indicate under Choose the RadWorks role whether you want to
install RadWorks on a standalone computer or a Workgroup client.
Only select Workgroup client if the machine is to be connected
solely to a Workgroup server.
When you install a Workgroup client, this enables you to view studies stored on the Workgroup server. During the Workgroup client
setup you will be asked to enter the hostname of the Workgroup
server.
GEMS IT Applicare
42
chapter 2
If you use a local
license file, we recom-
mend you disconnect
your computer from the network
during installation. If you install
the license while the computer is
connected to the network, the
license will only be valid while the
computer is connected to the network.
Only install the modules
you have a license for.
The setup program does
not check the license content of
the Dongle or license file.
Don’t select the actual Data Acquisition module but the options it
contains.
INSTALLING RADWORKS
RadWorks licensing mechanism
7777 If you are using a license file, select License file and then Browse...
to specify the path on your local hard disk of the license.
8888 If you are using a license server, select the License server option,
specify the file name for the local copy of the license, and enter the
name of the server with the license.
9999 If you are using a dongle, select Dongle.
Modules
10
10 Click the icons of the modules you want to install, and, either, select
1010
This feature will be installed on local hard drive to install the
module, or This feature will not be available, if not. ‘X’ is displayed next to modules that will not be installed. Only mark licensed
modules for installation.
Note that you don’t actually select the Acquisition module itself but
options in that module.
Tra nsmit
DICOM AE Titles have to
be uniqe in a network
environment.
RadWorks 6.0 installation and configuration guide
The Transmit screen is not displayed when you install a Workgroup
client.
11
11 Specify in the DICOM AE title field the Application Entity Title of
1111
the computer you are installing RadWorks on.
The sample studies will
also significantly extend
the installation time for
RadWorks. You can also install
these studies after setting up RadWorks by copying them from the
RadWorks installation CD to the
RadWorks Database\Input folder.
12
12 Use the DICOM port number field to indicate the port number
1212
your system will use to send and receive data. This number does not
have to be unique.
13
13 Enter the Teleradiology name and Teleradiology description, to
1313
name and describe the computer you are installing RadWorks on.
14
14 Check the Use modem for remote connections check box, if you
1414
use a modem to connect to the network.
15
15 Click Next > to continue.
1515
Miscellaneous
16
16 Check the To ol s check box if you want RadWorks Setup to install
1616
vendor-specific tools (this option may not be present in your version).
17
17 Check the Demo Data check box, so RadWorks Setup includes sam-
1717
ple studies when it installs RadWorks. These studies, which are not
required for everyday use of RadWorks, contain images from a wide
range of modalities and are useful for learning about RadWorks.
However, they do take up a significant amount of disk space - about
350 MB.
18
18 Check the Configure Multi Monitor check box, if you want to use
1818
RadWorks on more than one monitor.
43
19
19 Click Next >.
1919
20
20 If you previously checked the Configure Multi Monitor check box,
2020
select your monitor configuration. This will prepare the multi-monitor settings in RadWorks. If your configuration is not listed, select
one that is similar. You can always change the multi-monitor settings
from within RadWorks. If you did not select the Configure Multi
Monitor check box, this screen will be appear.
21
21 Click Install.
2121
The progress bar displays how far RadWorks Setup has progressed.
The installer may start up separate installers for e.g. the VOB CDwriting package. Go through these installers: the default choices are
acceptable.
Installation complete
22
22 Click Finish, to complete the setup.
2222
GEMS IT Applicare
44
INSTALLING RADWORKS
chapter 2
System check
Setup will check whether the Remote Access Manager services have been
installed.
RAS
The following only applies to Windows NT 4.0. RAS is automatically
installed with Windows 2000.
The Remote Access Service Manager must be installed on the system if you
want to use a modem for remote connections. If the setup does not find the
service, you will be unable to use a modem after RadWorks is installed. You
can also install RAS after installing RadWorks. To setup and install the
Remote Access Service Manager, see ‘Remote Access Service configuration’
on page 26 for more information.
RadWorks 6.0 installation and configuration guide
Even if you do not have
a previous version of
RadWorks installed the
setup will search for it. Depending
on the hard disk size this might
take a few moments.
Upgrading from a previous version
When you run the setup on a system that has RadWorks 2.1, 4.0, 5.0 or 5.1
installed, the setup will automatically upgrade the existing installation to RadWorks 6.0.
If Setup detects a previous version on the system, you will be asked whether
you wish to continue and have Setup upgrade your existing version. You can-
not have two versions installed on the same system.
If you choose to continue with the upgrade, the previous RadWorks settings
(remote views, destinations, origins, etc.) and the image data will be automatically migrated during the installation; you will also be able to keep the
DICOM AE Title and port number. If you don’t have RadWorks 5.1 installed,
the RadWorks 6.0 default port number will be 3140 when you install it.
The services of the previous version will be removed during the upgrade procedure.
Setup will detect which services and modules were installed; these will
already be selected in the Setup screens. Run Setup with only these modules.
If you want to add new modules, in the Windows Control Panel select Add/
Remove Programs
→ RadWorks and click the Change button.
45
All image data will be migrated (moved) to the \%ROOT%\Database\Local
directory (including archiving directories).
All local database files will be converted to the DICOM part 10 format.
RadWorks 6.0 does not support Converters. If your installation relies on Converters you have created, you should not upgrade to RadWorks 6.0.
After the upgrade, the old RadWorks services will have been removed.
Multi-monitor settings will also be migrated to RadWorks 6.0.
RadWorks 6.0 will be installed in the same folder as the previous version.
GEMS IT Applicare
46
INSTALLING RADWORKS
chapter 2
Modifying or removing a RadWorks installation
To modify or remove your current installation of RadWorks, use Add/
Remove Programs in the Control Panel.
To modify or remove a RadWorks installation
1111 In the Control Panel, open Add/Remove Programs and then Rad-
Works 6.0.
2222 Click Change to modify the installation, or Remove to remove Rad-
Works entirely.
3333 In the RadWorks installer, click Next > and select Change to open
the Program Maintenance screen or Remove to remove RadWorks.
4444 Select the task you wish to perform and click Next >.
A summary of each task is given below:
RadWorks 6.0 installation and configuration guide
Task What it does
Modify Installs or removes modules from your configuration.
Repair Reinstalls your RadWorks program files.
Remove Completely removes RadWorks from your system (this is the same as using
the ‘Add/Remove Programs’ option in the Control Panel).
Options on the Program Maintenance screen
Important note if RadStore or WebViewer is also installed
When uninstalling RadWorks, its registry keys are removed as well. RadStore
and WebViewer use the same license file. So, if you uninstall RadWorks, any
RadStore or WebViewer installation will also also lose its license.
Backing up system settings
You can create backups of the system settings. These can then be used to
restore a computer’s settings after RadWorks has been reinstalled.
Examples of system settings include user profiles, destinations to image
archives, print layouts, new printer definitions, views and auto-routing rules.
After you have configured a local machine, you can create backups of system
settings and load them by running the RadWorks Settings Tool program
located in the RadWorks Bin folder.
47
To create a backup file
1111 Start RadWorks, adjust it as you wish and close RadWorks again.
2222 In the RadWorks Bin folder, run RadWorks SettingsTool.exe.
3333 In the RadWorks Settings Tool dialog box, click RadWorks System.
4444 In the RadWorks System Settings dialog box, click Backup.
5555 In the Save As dialog box, find the location where you want to save
the backup file, enter its name in the File name field and click Save.
6666 Click Close in both the RadWorks System Settings and RadWorks
Settings Tool dialog box.
To restore a previously created backup
1111 In the RadWorks Bin folder, start the RadWorksSettingsTool.exe
file.
2222 In the RadWorks Settings Tool dialog box, click the RadWorks Sys-
tem button.
3333 In the Available Settings section of the RadWorks System Settings
dialog box, select the backup you want to restore, and then click
Restore.
4444 Click Close, in both the RadWorks System Settings and RadWorks
Settings Tool dialog box.
GEMS IT Applicare
48
INSTALLING RADWORKS
chapter 2
Working with user groups and profiles
When RadWorks is installed, two new groups are installed in User Manager.
One of these is RW_USER. You can add users to this group to make them
users of RadWorks.
Creating user profiles
User profiles allow users to start RadWorks with the settings they need for
their tasks. They allow, for example, a radiologist to have all features required
for advanced viewing and diagnosis, while providing the radiographic technologist with the features that person needs.
You can create user profiles for different groups of users by making the appropriate adjustments within RadWorks and then running the RadWorks Settings
Tool program located in the RadWorks bin folder.
To create a user profile
1111 Log into Windows with the name of the user you want to create a
profile for. Do not log in as an administrator.
If you log in as an administrator, the settings you make are systemwide, not user-specific.
2222 Start RadWorks and adjust the user settings required for the user
group you are creating.
3333 In the \bin folder, start the RadWorksSettingsTool.exe file.
4444 In the RadWorks Settings Tool dialog box, click User.
5555 Click Save in the RadWorks User Settings dialog box.
6666 In the Save As dialog box, enter the name in the File name field and
click Save.
To load a user profile
1111 To load the profile in the registry, select the profile in the Available
Settings section of the RadWorks User Settings dialog and then click
Load.
2222 Select the profile with its.xml extension in the Open dialog box, and
click Open.
RadWorks 6.0 installation and configuration guide
3333 Click OK, to implement the selected profile in the RadWorks Set-
tings Tool message box and view the results in the Loaded Setting
section of the RadWorks User Settings dialog.
If you want to clear the user profile currently loaded in the registry, click
Clear and Ye s to confirm in the RadWorks Settings Tool message box.
Click Delete, to remove a profile from the list of available profiles. This does
not remove a profile from the registry if it has been loaded earlier with the
Load button.
When a user starts RadWorks for the first time, he will see the RadWorks dialog box. Here he can select a user profile, after which RadWorks starts up with
the settings that were configured for the selected user profile. Users can also
not select a profile (by clicking Cancel). RadWorks will then start with the
default settings.
Each time the user, subsequently, starts RadWorks, it will automatically use
the selected profile.
49
GEMS IT Applicare
50
chapter 2
Contact your RadWorks
distributor for information on the latest avail-
able patch.
You may not need to apply the
patch, unless it is labeled as mandatory. If the latter is the case, it
means that a serious problem,
which can occur on the majority
of the installed base, has been
fixed.
INSTALLING RADWORKS
Software patches
A few software issues may be discovered after the final release. These are registered in a bug-tracking database. Should a major issue arise, depending on
its type and frequency of occurrence, a software update (software patch) will
be released as soon as it has been resolved.
Patch release
As soon as the R&D department has released a patch, it is made available to
the distributors.
A patch file is always accompanied by release notes, which should be read
before the patch is applied.
It is also recommended that the latest software patch is applied after a new
installation or an upgrade.
Applying a patch
When a software patch file is executed, it will stop the RadWorks Services,
extract the binary files and copy them to their respective directories, and then
restart the services.
RadWorks 6.0 installation and configuration guide
Version check
The About box contains the following information:
RadWorks version, build number and Software Patch number.
Installing workgroup servers and clients
Installation
Installation of either a Workgroup server or a Workgroup client does not
require special steps; just select the appropriate option during the normal
setup.
To set up a Workgroup client, you do need to know the host name of the
Workgroup server.
The Workgroup server can also be used as a ‘normal’ RadWorks system.
When doing so, it will use one of the concurrent user licenses.
If a client station is licensed to use a RadWorks module, this module has to be
installed on the Workgroup server as well.
Limitations
The Single Media Archive, Quality Control and Data Acquisition modules are
not available on a Workgroup client.
Data issues
Executables and DLLs are stored on the client. Services and data reside on the
server. Service settings can therefore only be changed on the server.
51
The client uses the database on the server. When one client opens the study to
work on it, the other clients can still open the study for viewing only (and they
can add presentation states, key notes and structured reports).
Performance issues
Factors which can influence the performance, are:
• Speed of the server. The server should be a fast machine with a large
memory.
• Speed of the network. A 100 Mbit/s network is recommended.
• Network architecture. A dedicated network, physically separated
from the LAN, will improve the Workgroup performance dramatically. New technologies like Storage Area Networks based on fibre
channel can be considered.
• Total number of clients, a maximum of ten.
• Number of clients simultaneously viewing different studies.
GEMS IT Applicare
52
INSTALLING RADWORKS
chapter 2
Data updates
Changes made to the database, queues, and other shared data are immediately
updated on the other systems in the workgroup.
Log files
The RadWorks log is stored locally.
Workgroup client configuration
A workgroup client needs remote access to the
HKEY_LOCAL_MACHINE\SOFTWARE\AMI key on the server.
If the client has administrator rights on the server, this will not be an issue. If
not, a few changes to the registry on the server are required.
To grant the client access rights on the server
1111 Create a domain account for the Workgroup Clients in the domain
users group.
2222 Back-up your registry and, using REGEDT32, select the following
registry key:
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\SecurePipeServers\winreg
3333 Select Security → Permissions to add domain users and give them
full control. (This means that this remote user has the same rights as
if he were logged on locally).
4444 Make sure the domain users have full control to the key:
HKEY_LOCAL_MACHINE\SOFTWARE\AMI
Now a user without administrator rights can start a RadWorks Workgroup client.
RadWorks 6.0 installation and configuration guide
CHAPTER
Configuring teleradiology
This chapter describes how to set up and configure a RadWorks workstation to
receive and send images (teleradiology).
Preparing the workstation for teleradiology..............54
Setting up the Connection Service...........................55
Setting up and configuring destinations ...................57
Setting up and configuring origins............................61
IN THIS
Automatically locking and unlocking studies ............63
CHAPTER
Compression in teleradiology...................................65
Automatically compressing and decompressing
studies as they are received ....................................67
Working with Wavelet compression .........................68
Configuring storage commitment .............................69
Setting up auto-routing.............................................70
Troubleshooting an origin and a destination ............78
54
chapter 3
Help in the dialog.
For detailed descriptions of the dialogs used
in configuration, click
CONFIGURING TELERADIOLOGY
he current version of RadWorks can send and receive images in DICOM
format, including Keynote Objects, Structured Reports, and Presentation States. For downward compatibility, it can also receive images in
the AMI format.
Before you configure RadWorks to send and receive images, you should
check that the system has been set up correctly for communications, either
over a local area network or via dial-up networking.
Preparing the workstation for teleradiology
Receiving DICOM images requires preparation of both RadWorks and the
sending site, whether that is another RadWorks system or a third-party system.
Testing the DICOM association
We recommend testing the association to ensure that the remote system and
RadWorks have been correctly configured. There is a utility to test the
DICOM association: DCMPing. (this can be found in the %ROOT%\BIN
directory)
RadWorks 6.0 installation and configuration guide
You need administrative rights to change
most of these settings.
Setting up the Connection Service
Configuring Connection Service properties
We recommend you only alter the default settings if this is strictly necessary.
For detailed information on the settings, see the online help (click Help in the
configuration dialog box).
DICOM Application Entity Title
The DICOM Application Entity Title, which is entered during RadWorks
installation, is set in the Configuration
We recommend using unique AE Titles when setting up more than one RadWorks workstation in a network. The port number need not be unique across
the network.
Receive settings
1111 Select Configuration
→ Connection Service from the menu bar in
the Data Selector and click on the Receive tab. The settings on this
tab apply to both AMI and DICOM format images.
2222 Optionally enable Verify Origin to increase system security.
→ Generic... menu.
55
Wavelet lossy compression will only be
displayed as an option
if the Wavelet Compression module has been installed and a
license for the module is present.
3333 Enabling Auto Decompression will decrease loading time when
viewing, but will increase storage space.
4444 Add the location of the post processing .dll in the Post Process field
if the Quality Control Module has been installed and you want to use
Auto Matching, or the Repair tool.
5555 The RadWorks 5.1 Receive settings on this property page usually
do not need changing.
6666 Enable Auto Compress Studies to indicate that studies entering the
system via the Connection Service should be compressed before they
are actually stored in the database.
7777 The Format and Parameters drop-down lists allow you to select the
appropriate compression format and compression specific parameters for compressing incoming studies.
GEMS IT Applicare
56
chapter 3
If for some reason the
compression fails, a log
message at warning
level will appear in the connect.log, and the study will be
stored as is. Failure to compress
will never lead to rejection of the
received study.
CONFIGURING TELERADIOLOGY
After the Connection Service has received a study, after auto-decompressing the study (if configured) will be auto-compressed (if configured). After completion of both steps, the study will be sent to the
Database Service for storage in the local database.
DICOM settings
8888 Select the DICOM tab of the Connection Service Properties dialog
box. The settings in this tab apply to receiving and sending images.
9999 Set the Maximum Number of Associations if desired. This defaults
to 4, but is essentially unlimited. The practical limit, however, is
between 16 and 30 associations depending on CPU power, installed
RAM and I/O speed.
10
10 Set the PDU Packet Size if required. This is a minimum of 4096
1010
bytes and a maximum of 4194304 bytes; the default value is 16 KB.
RadWorks 6.0 installation and configuration guide
To configure a new
remote teleradiology
site you will need to
have administrator rights and a
certain amount of technical information from the new site you want
to send to. If you are uncertain
about configuring a destination,
contact your system administrator
or distributor.
Although it is possible, Applicare
does not recommend you give
multiple destinations the same AE
Title, since in DICOM 3.0 the AE
Title is considered to be unique in
a network situation. Should you
do so, resolving a destination
could be difficult when, for example, a study is retrieved from RadWorks by another system.
Setting up and configuring destinations
You can add new sites to send studies to, or change details of existing destinations.
To add a teleradiology destination
1111 Select Connection → Destinations… from the menu bar in the Data
Selector.
2222 In the Destinations dialog box, click Add. A dialog opens.
3333 Enter the name of the new destination.
The name will be displayed in the list box on the Teleradiology
Tooltab.
The name field must be unique. The system will check this when you
enter a name.
4444 Enter the Host Name (DNS name) of the new destination.
5555 Optionally, you can enter a description.
6666 If you want to access the destination via RAS: check the Use RAS
checkbox.
If you select this option, a new dialog window will appear for specifying RAS parameters. If the Use RAS check box is grayed out,
RAS has not been installed on the system and cannot be used for
connecting to destinations.
57
GEMS IT Applicare
58
chapter 3
Unchecking this
checkbox is a DICOM
violation. There are a
number of archives that will overwrite an image upon “repeated
reception of the same image”, i.e.
they will overwrite the original
uncompressed image and replace
it with the new (lossy compressed) image, which is probably
not intended behavior. Unchecking the box is only recommended
in very tightly controlled workflows, like the two cases
described here.
CONFIGURING TELERADIOLOGY
7777 Select the Options: Study Status ID: if this is ON, RadWorks sends
only the changes to a Study Status instead of transferring all the
images (saving time). The status changes are sent via a DICOM
Study Management N-Set or N-Event message.
N-SET: requests the status change.
N-EVENT: reports that the status has been changed.
You can set the message type once you have created the destination
(the Modify dialog has these options).
The receiving DICOM entity must support this feature (few do at the
moment).
When the destination is a RadWorks 5.1 workstation, select ‘Rad-
Works 5.1 format’. This will convert Presentation States, Structured
Reports and Keynote Objects into the proprietary RadWorks 5.1 formats before sending them. You can also use this option to send this
data to other systems that do not understand this data. When the destination does not understand the data, the entire study will be
rejected. You can set these options here, and you can override them
when you send a study.
The Change SOP instance UID on lossy compression option
should be ON. When it is ON, the image number (UID) is changed
when an image is compressed with a lossy algorithm, ensuring that
the lossy version does not overwrite the (not compressed, higherquality) original. There are only two cases where switching this OFF
may be useful:
- when on the remote system Keynote Objects, Presentation States
and Structured Reports lose their links to an image due to the UID
change.
- when the destination does NOT send back the images, but creates
annotations to the compressed images and sends back the annotations only: the annotations need to be associated with the original
images, not the compressed copies.
8888 Select the IODs that will be sent to this destination. You can select
e.g. only the Presentation States, Key Images and Structured
Reports: this limits the amount of data that gets transferred. The
Other IODs are DICOM data that RadWorks will store, but cannot
change. The IODs are optional because not all destinations can use
these data. When the destination is a RadWorks 6.0 workstation, you
can select all the options.
RadWorks 6.0 installation and configuration guide
9999 Click Next >.
If you use the same AE
Title on all RadWorks
workstations on the
same LAN and perform a retrieve
action on one of them, the remote
system will send the images to the
first DICOM AE Title the remote
system finds.
10
10 Enter the DICOM AE Title for the remote system.
1010
We recommend you give each machine a unique AE Title.
11
11 Enter the DICOM port number for the remote system.
1111
The DICOM port number does not have to be unique. Most modalities have a fixed port number, which can be found in the DICOM
Conformance Statement of that modality.
12
12 If RAS is installed on the system and you have also selected the ‘Use
1212
RAS’ option, another dialog will appear with RAS settings.
59
You can also double-
click the left most col-
umn of a destination to
modify it.
The Backup Destination drop-down list
includes all the destinations that have been defined for
your system. If the destination
you require is not listed, you will
need to set it up. See ‘Setting up
and configuring destinations’ earlier in this chapter.
To change an existing site (destination)
1111 Select Connection → Destinations… from the menu bar in the Data
Selector.
2222 In the Destinations dialog box, select a destination (click in the first
column) and then click Modify.
3333 Change any of the items in the Destination Properties dialog box
(refer to the on-line Help for details on the tabs and all parameters).
Identification
If the RadWorks system needs to be able to send to various departments
within the same hospital you can add more details about each destination in
the Identification tab.
Connection Parameters
The Connection Parameters tab contains the destination information.
The Backup Destination is used to provide redundancy: if sending to a destination fails, RadWorks will send the study to the backup destination. This
makes sure the workflow remains intact (if RadWorks could not send the
study, it could not be deleted from the sending system). To prevent an endless
loop of directions, the redirection process will stop as soon as the Backup
Destination equals the primary destination. You can configure circular references, though. RadWorks will only check for a circular redirection when it
actually transmits studies.
Transmission Par ameters
The type of destination you add determines which default Transmission
Parameters you select.
You choose the default transmission format in this tab. It is still possible to
alter it when you submit a Send Job.
GEMS IT Applicare
60
chapter 3
We strongly recommend
you test the compres-
sion parameters and
decide which ratio is acceptable.
The quality of the image versus
the transmission time forms the
basis for such a decision.
CONFIGURING TELERADIOLOGY
The studies can be sorted according to priority set here, and a Priority column
has been added in the Send Queue dialog window.
Format
This sets the file format for the images. With lossless compression, you can
return to the original image quality after decompression, this is not the case
with lossy compression.
RadWorks 6.0 installation and configuration guide
Setting up and configuring origins
When your system is connected to a network, any properly equipped DICOM
compliant system connected to that network could query your database and
even send you studies. In many situations, especially, when specific security
measures are already in place, this will not matter a great deal. But there may
be circumstances when you want to restrict access to your system to specific
known systems.
In RadWorks, you do this using ‘origins’. When another system tries to communicate with yours, you can tell RadWorks to check the origin (specific
details of the other system), and only allow communication if this origin is
one of a pre-configured set of permitted origins. If not, your system will not
accept the connection. In this case, the other system will not be able to query
your system or send it data.
Setting up origin verification
When RadWorks is first installed, the origins feature is not active. To use origins, you will first need to turn it on.
61
To turn on origin verification
1111 Select Configuration → Connection Service… from the menu bar
in the Data Selector.
2222 Check the Verify Origin check box on the Receive tab of the Con-
nection Services Properties dialog box.
Once you have set up RadWorks to verify the origins of other systems, build a
database of origins which RadWorks should accept.
GEMS IT Applicare
62
chapter 3
The New Study Status
field in the Origin Prop-
erties dialog lets you
specify whether an incoming
study from the origin should be
assigned a specific status. Whatever status a study might have
when arriving at your system, this
will be overwritten by whatever
you select here.
This is particularly useful when
communicating with non-RadWorks systems to ensure that
studies have a known status.
CONFIGURING TELERADIOLOGY
Setting up an origin
The Origins section of the Filing tooltab shows all the remote systems or sites
that have sent studies to your RadWorks system. You can pre-configure Origins to control from which sites and systems your local system can receive
data.
1111 Select Connection → Origins… from the menu bar in the Data
Selector.
2222 Click Add in the Origins dialog box.
3333 Type the appropriate information in the Origin Properties dialog box.
(The Name, Host Name and DICOM AE Title are mandatory fields).
For more information on what you should enter here, click Help.
RadWorks 6.0 installation and configuration guide
Automatically locking and unlocking studies
Studies can be locked in RadWorks to prevent their accidental deletion and the
loss of data this would cause. Locking and unlocking can be performed manually in the Data Selector (see the User Guide). It is, however, also possible to
have RadWorks lock studies automatically as soon as they are received, thus,
immediately protecting the data they contain.
You can set up this automatic locking for just some or all of the sites you
receive data from (using Origins). The origins for which automatic locking is
important, depend on your workflow. It may, for example, not be necessary to
automatically lock studies received from an archive (since these studies will
always remain in the archive even if deleted on the local system). On the other
hand, it may be very important that newly-created studies received for diagnosis are not deleted (at least not until some further action has been taken).
To set whether or not RadWorks will lock incoming studies from a particular
origin, you must modify the properties of that origin.
63
IA series or images can
be received from an ori-
gin with automatic locking enabled. Images, which the
user previously unlocked, could
however be appended to a study
stored on the receiving system. In
this case, the automatic locking
will override what the user did –
RadWorks will lock the whole
study again when it adds the
series and/or images to it.
To automatically lock studies from a particular origin
Select Connection → Origins… from the Data Selector menu bar. In the Origins dialog box, click the first column of the origin you want to have auto-
matic locking from, and click Modify.... In the Origin Properties dialog box,
make sure the Lock Received Study check box is checked.
Automatically unlocking studies
Automatically locking studies is very valuable in many situations. However,
locked studies cannot be deleted manually, nor can they be deleted automatically using the Delete After Send option. In some cases, it may be desirable to
have an automatic unlocking facility to, for example, allow studies sent to an
archive using storage commitment to be deleted.
RadWorks’ automatic unlocking feature is the counterpart of automatic locking, except that it applies to studies that are sent rather than received. For each
destination that your system sends studies to, you can specify whether studies
should be automatically unlocked. It may be appropriate for some destinations
(such as an archive), but not for others (such as a radiologist’s home system or
an ER department), which may not be safe storage sites for studies.
To set whether RadWorks unlocks outgoing studies to a particular destination,
or not, you modify the properties of that destination:
To automatically unlock studies going to a particular destination
GEMS IT Applicare
64
CONFIGURING TELERADIOLOGY
chapter 3
Select Connection → Destinations… from the Data Selector menu bar. In the
Destinations dialog box, click the first column of the destination you want to
enable automatic unlocking for, and click Modify.... Click the Transmission
Parameters tab in the Destination Properties dialog box and make sure the
Unlock Study After Send check box is selected.
Unlocking individual studies when you send them
Apart from having RadWorks automatically unlock studies, you can specify
for particular send jobs that the sent studies should be unlocked when you create those send jobs.
Prepare the send job for sending in the usual way, but before clicking OK in
the Send To… dialog box to submit the job, click the Advanced…. Click the
Transmission Parameters tab of the Advanced Transmission Properties dialog box and make sure the Unlock Study After Send check box is selected.
Overriding automatic unlocking of studies for individual studies
If RadWorks has been set up to automatically unlock studies sent to the destination you are sending to, you can have the studies for a particular send job
not unlocked. When you create send jobs you can, as it were, ‘override’ the
RadWorks default setting concerning unlocking studies. To do this, make sure
that the Unlock Study After Send check box on the Transmission Parameters
Tab of the Advanced Transmission Properties dialog box is not checked.
RadWorks 6.0 installation and configuration guide
With lossy compression, some image
detail is irretrievably
lost. This may render the image
unsuitable for diagnostic purposes.
65
Compression in teleradiology
Teleradiology is, of course, a very powerful tool for distributing image information quickly to where it is needed. Many types of study are, however, very
large and telecommunications links often comparatively slow, so studies can
take a considerable time to send in uncompressed form. RadWorks, therefore,
offers a variety of ways of compressing images before sending them (and
decompressing them at the other end).
Lossless or lossy?
When selecting a form of compression to use when sending studies, the most
fundamental choice is between lossless and lossy compression. As the name
implies, lossless compression means that none of the information in images is
lost – when decompressed on the other system, images will appear exactly as
they were before they were sent. This is not the case with lossy compression –
some of the image detail will be lost in the compression and decompression
process. The advantage of lossy compression is that it achieves greater compression and hence smaller and faster transmission jobs than lossless compression.
Generally, it is best to use lossless compression – when you are sending
images over a reasonably fast network or sufficient time is available even over
a connection of limited bandwidth. For low bandwidth connections and/or
when time is at a premium, you may well need to use lossy compression.
Once an image has been
compressed with a lossy
compression, you cannot apply another lossy compression option.
Images that are stored in a lossless compression format can be
converted to another compression format.
RadWorks will not compress images in a lossy way if the image is already
lossy or has been lossy compressed previously.
The options
RadWorks offers a much wider choice besides lossy or lossless. Depending on
how your system is configured, you can choose some or all of these options
when sending studies using teleradiology.
DICOM 3.0
pressed form. It is part of the DICOM standard and allows images to be transferred between systems from different manufacturers. Use for transmitting
images with no loss of quality over relatively high-bandwidth links.
JPEG Lossy
standard, allows images to be readily transferred between different manufacturers' systems. Use for sending images when bandwidth and transmission
time are an issue.
is not a compressed format at all. Images are sent in uncom-
is a lossy form of compression which, as part of the DICOM
GEMS IT Applicare
66
CONFIGURING TELERADIOLOGY
chapter 3
If sent to older RadWorks (5.1 and down) versions, the actual transfer syntax
used will be a DICOM transfer syntax (DICOM JPEG Lossy). NOTE: In that
case only unsigned 8- & 12- bit images can be compressed.
If sent to another RadWorks 6.0 system, the actual transfer syntax used will be
a private transfer syntax (JPEG Lossy) for images other than unsigned 8- &
12- bit images. NOTE: In that case all images can be compressed, except for
images containing image overlays and RGB bi-plane.
DICOM JPEG Lossless
like the lossy version, this is a format which, as part of
the DICOM standard, allows images to be readily transferred between different manufacturers' systems. Compression is not as high as for the DICOM
lossy format, but image quality is not diminished.
This transfer syntax can only handle 2-16 monochrome and 8-bit RGB
images.
ZLIB
an all-purpose lossless compression method.
Wavelet
lossy Wavelet compression which produces high levels of compres-
sion. It is NOT part of the DICOM standard. You need to buy a separate
licence to use this.
If sent to older RadWorks (5.1 and down) versions, the actual transfer syntax
used will be a plain DICOM (3.0) transfer syntax.
JPEG and Wavelet – what compression factor?
If you are using JPEG lossy compression, the lower the quality factor, the
higher the compression ratio used. A quality factor of 10 will, therefore, produce much higher compression but poorer image quality than a quality factor
of 50.
As with other forms of lossy compression, the results you achieve will depend
very much on the types of images you send. If unsure about what quality factor to use, you may wish to experiment with various settings using a selection
of images which are typical of what you normally transmit.
RadWorks 6.0 installation and configuration guide
Automatic compression for received stud-
ies works separately
from compression applied to
studies that are stored (see ‘Saving hard disk space by compressing studies’ in chapter 3 of the
User Guide).
To compress studies using Wavelet compression, your system will
need to have the Wavelet module
installed.
If automatic compression is on,
RadWorks stores images it
receives in a compressed format,
without changing that format.
Automatically compressing and decompressing studies as they are received
To save disk space, you can configure RadWorks to automatically compress
studies when they are received.
To automatically compress studies as they are received
Connection Service... from the Data Selector menu bar. On the Receive tab
of the Connection Service Properties dialog box, check the Auto Compress
Studies check box and select the format from the Format drop-down list. If
the format accepts compression parameters, specify these by selecting them
from the Parameters drop-down list.
Automatically decompressing incoming studies
While you may wish to have studies compressed as they arrive to save disk
space, compressed studies take longer to display since RadWorks has to
decompress the images first. If performance is a higher priority than cutting
down on disk space requirements, you can have RadWorks decompress all
incoming studies that have been compressed so they are ready to be displayed
as quickly as possible. You can choose whether RadWorks should decompress
only lossless compressed studies, only lossy compressed studies, or both.
select Configuration →
67
To automatically decompress studies as they are received
select Configuration
→ Connection Service... from the Data Selector menu bar. On the Receive
tab of the Connection Service Properties dialog box, check the Auto Decom-
press Lossless Compressed Studies check box and/or the Auto Decompress
Lossy Compressed Studies check box.
GEMS IT Applicare
68
chapter 3
If you plan to use lossy
Wavelet compression on
a routine basis, you can
experiment sending several basic
types of studies with varying compression factors to find the most
acceptable ones for you.
If you select Wavelet as the format
for sending, you can also select a
compression factor in the same
dialog box. If the supplied factors
are not sufficient, you can configure new ones in the Connection
Service Properties of the Configuration drop-down menu in the
Data Selector.
CONFIGURING TELERADIOLOGY
Working with Wavelet compression
Wavelet is claimed to be one of the most effective compression algorithms for
medical teleradiology. Clinical studies indicate that a higher compression ratio
can be achieved while maintaining image quality than could be achieved using
more conventional compression methods. This means that Wavelet requires
less transmission time, which can be essential in situations where the infrastructure is not always completely reliable or access time is at a premium. A
further benefit is that Wavelet-compressed files use much less disk space at
the receiving site than uncompressed files.
RadWorks provides lossy Wavelet compression. To make Wavelet compression available to RadWorks users in a form that has been clinically tested,
Applicare has used a third party toolkit that functions transparently with the
RadWorks software.
How to tell it you have Wavelet compression installed…
If you have Wavelet compression installed on your system, Wavelet will be
one of the options in the Format drop-down list in the Send to… dialog box
(click Send on the Teleradiology tooltab in the Data Selector to view this).
RadWorks 6.0 installation and configuration guide
Compression and decompression
The Wavelet Module can compress jobs with various lossy compression factors. In addition, the receiving RadWorks 6.0 system, it will automatically
decompress a Wavelet compressed study when it is opened for viewing. Studies, series or image selections that have been sent using Wavelet compression
will display a non-erasable message to this effect along with the compression
factor.
Configuring storage commitment
The mechanism defined in DICOM for network-based data storage, the Storage Service Class, allows a sender (SCU) to transmit study images to a
receiver (SCP). However, the Storage Service Class does not specify the safekeeping of data: there is no commitment that the SCP will do more than
accept the transmitted studies.
Safekeeping is done via a separate Service Class: the Storage Commitment
Service Class.
The SCP implementation defines how it provides its commitment to storage.
Certain SCPs may commit to permanently store the studies (e.g. an archiving
system) while other SCPs may commit to provide storage for only a limited
amount of time.
Once the SCP has accepted the commitment to store the studies, the SCU may
decide that it is appropriate to delete its copies of the studies. DICOM Storage
Commitment does not demand a byte-to-byte comparison of the data. Also a
checksum of the image data is not compared. For a successful Storage Commitment, it is verified that at least the following is identical at the source and
the destination: Study UID, Series UID(s), and the number of images.
69
An alternative destination can be configured (at destination level) for Storage
Commit. When the storage commit request must be sent to a different destination than the images, a new DICOM association is opened on which the Storage Commit request is sent. An empty Storage Commit destination (default)
means that the Storage Commit request will be sent to the same destination as
the images.
Setting a time-out value
You can set a maximum time for your system to wait for an answer from the
other system before indicating that storage commitment has not succeeded. If
this time has exceeded, the job in the send queue receives the status Error.
To set a time-out value for storage commitment
1111 Select Configuration → Connection Service… from the Data
Selector menu bar.
2222 Click the Maintenance tab, in the Connection Service Properties
dialog box.
3333 Set the time (in hours) in the Time Out DICOM Storage Commit-
ment field.
GEMS IT Applicare
70
CONFIGURING TELERADIOLOGY
chapter 3
Setting up auto-routing
RadWorks supports multiple auto transmit protocols. You can send to multiple
destinations using a trigger mechanism with or without a set of rules and
based on the origin of the study.
Use this type of transmission, for instance, when the hospital’s radiologist is at
home on call and has access to a RadWorks system, or on a Quality Control
workstation which allows automatic transmissions to an archive after Matching and saving studies.
Only a user with administrator rights can configure the Auto Transmit Protocol. Other users will only be able to use and modify the Basic Protocol.
End users will only be able to select one destination for auto transmissions,
which will be triggered as soon as the system receives studies.
The option Delete After Send overrides the setting of the Destination properties.
Setting up basic automatic routing
While you can create highly sophisticated auto transmission setups in RadWorks, for many users the facility of automatically forwarding incoming studies to another system will suffice. Setting up such basic automatic
transmission is covered here. For details on setting up more sophisticated
automatic transmission, see ‘Setting up advanced automatic transmission’
later in this chapter.
RadWorks 6.0 installation and configuration guide
<basic protocol> in the
Auto Transmit dialog
box is a basic ‘auto
transmit protocol’ included when
RadWorks is installed. To create
more sophisticated auto transmission, you will need to create new
auto transmit protocols. See ‘Setting up advanced automatic transmission’ later in this chapter.
If the destination you want is not
displayed in the Destinations
drop-down list in the Auto Transmit Basic dialog box, it has not
been set up properly on your system. See ‘Setting up and configuring destinations’ earlier in this
chapter.
71
To automatically forward received studies to another system
1111 Select Configuration → Auto Routing… from the menu bar in the
Data Selector. If you are logged on with administrator rights, go to
step 2. If you do not have administrator rights, go straight to step 3.
2222 Click <basic protocol>, (in the Name column) and then Modify in
the Auto Route dialog box.
3333 Select a destination from the drop-down list, in the Auto Route Basic
Teleradiology dialog box
4444 Click Send Immediate, to forward incoming studies immediately to
the destination. Click Transmission Time, if you want to specify a
particular time that incoming studies should be sent (possibly to take
advantage of lower telephone call rates), or Delay Time if you want
to specify a delay before the studies are sent to the destination. Set
the transmission time or delay time appropriately.
5555 Check the Delete After Send check box, to remove the study from
your system after it has been sent successfully.
If auto transmission has been set, this will be shown by the indicator in the
Send section of the Teleradiology tooltab.
You can turn off the automatic sending of studies in the Auto Transmit dialog
box.
To turn off auto-routing
Select Configuration → Auto Routing… from the
menu bar in the Data Selector. In the Auto Route dialog box, click <basic
protocol> (in the Name column) and then Modify. Select <none> from the
Destination drop-down list in the Auto Route Basic Teleradiology dialog box.
Automatic transmission and the Auto Transmit Basic dialog box
If the text Auto Transmit to the left of the indicator on the Teleradiology tooltab is
not active, at least one protocol besides the basic protocol is active. So if you turn
the basic protocol off, studies may still be automatically forwarded by another
protocol.
The Auto Transmit indicator light on the Teleradiology tooltab indicates whether
the basic protocol is operating. The indicator is on, if studies will be automatically forwarded according to the basic protocol. The indicator is off, if the basic
protocol is switched off.
End users will only be able to select one destination for auto transmissions,
which will be triggered as soon as the system receives studies.
GEMS IT Applicare
72
CONFIGURING TELERADIOLOGY
chapter 3
The option Delete After Send overrides the setting of the Destination properties.
Setting up advanced auto-routing
Earlier in this chapter, there was a description of how to set up automatic
transmission. This, however, only lets you select a single destination and a
limited choice about how the auto-routing is to take place. In fact, you can
create many auto-routing configurations in RadWorks to meet a wide range of
requirements, based on filter criteria, rules, origins and triggers.
Filter criteria and rules
How auto-routing takes place is determined by filter criteria and rules.
A filter criterion might, for example, specify that the modality of a study
should be CT or MR. This could then be used to send only CT or MR studies
to a particular destination. Another filter criterion might be that the status of
the study should be Authorized. Then auto-routing could be set up only for
authorized studies.
A rule combines filter criteria. Thus, the two filter criteria given as examples
above could be combined so that only Authorized CT or MR studies are sent
to a particular destination. Any DICOM field can be used to specify filter criteria and rules, allowing very specific and potentially very complex conditions
for auto-routing to be created.
RadWorks 6.0 installation and configuration guide
Auto-routing protocols
Another term used in RadWorks is auto-route protocol. This contains a rule
specifying when auto-routing should be started as well as a list of destinations
and origins. When performed, an auto-routing protocol generates one or more
jobs in the teleradiology send queue. Auto-routing protocols also let you specify whether studies should be deleted from the system after being sent, the
time at which transmission is scheduled, the delay before transmission, and
other aspects of the transmission process.
In other words, when you create an auto-routing protocol you define exactly
what should happen when a given event occurs.
Triggers
Events that can start auto-routing are called triggers in RadWorks. The triggers currently available in RadWorks are listed in ‘Setting Auto-Transmit trig-
gers’ on page 73.
You will require admin-
istrator rights to cre-
ate, modify, delete or
disable auto transmit protocols.
73
Working with auto-routing protocols
Setting up a system to use auto-routing involves stating what should happen
(defining an auto-routing protocol) and under what circumstances this should
happen (specifying a trigger for the protocol). You can set up a number of
auto-routing protocols linked with various triggers.
You manage auto-routing protocols using the Auto Route dialog box. This
shows a list of the auto-route protocols currently installed on the system.
Use the Copy button in
the Auto Transmit dialog
box to help create a new
auto transmit protocol which is
similar to the one that was created
created previously.
To see the auto-route protocols that have been installed
Select Configuration → Auto Routing… from the menu bar in the Data
Selector.
To create or modify an auto route protocol
Select Configuration → Auto Routing… from the menu bar in the Data
Selector. To create a new auto-route protocol, click Add. To change an existing protocol, click its name in the first column of the Auto Route dialog box
and click Modify. In the Auto Route Protocol dialog box, set appropriate values on the General, Rule, Teleradiology, Move to folder and Archive tabs.
For detailed help on any item, click Help.
Once you have created auto route protocols, you may, subsequently, wish to
remove them.
To permanently remove (delete) an auto route protocol
Select Configuration → Auto Routing… from the menu bar in the Data
Selector. Select the auto route protocol you want to delete (click its name in
the first column of the Auto Transmit dialog box) and then click Delete.
You may, however, wish to disable the auto-route protocol without deleting it
completely, so that you can reinstate it at some later time.
To (temporarily) disable an auto-route protocol
Select Configuration → Auto Routing… from the menu bar in the Data
Selector. Select the auto-routing protocol you want to disable (click its name
in the first column of the Auto Route dialog box) and then click Modify. On
the General tab of the Auto Transmit Protocol dialog box, select <disabled>
from the Auto Transmit Trigger drop-down list.
Setting Auto-Transmit triggers
Depending on which RadWorks add-on has been installed, various triggers
can be chosen:
GEMS IT Applicare
74
chapter 3
Trigger name Description
CONFIGURING TELERADIOLOGY
<disabled> Disables the Auto Transmit functionality. If a Quality Control trigger has been defined and the Mod-
Study Received When a study from the selected origin(s) has been received
Key Images Defined When Key Images have been defined and saved with the study, and the Study Status has been set
Save after Viewing When a study has been saved after viewing it; this also applies when using Special Commands
Save after Acquisition When an acquired study has been saved (only possible if the Data Acquisition Module has been
Save after QCM When a study from the selected origin(s) has been received and has been modified and saved (only
QC Match Successful When a study from the selected origin(s) has been received and the study demographics have suc-
QC Match Failed When a study from the selected origin(s) has been received and a match event has failed (only pos-
Study Status ID changed When you change the Study Status for a study in the Data Selector.
Auto-transmit triggers and what they do
ule is removed from the system, the QC triggered Auto Transmit Protocol will not be removed, but
will be disabled.
to ‘Authorized’.
installed)
possible if the Quality Control Module has been installed)
cessfully been matched with a DICOM modality worklist (only possible if the Quality Control Module
has been installed)
sible if the Quality Control Module has been installed)
Setting the Auto Route Teleradiology properties
Destinations, added by selecting Connection → Destinations...and clicking
the Add button, will be displayed on the Teleradiology tab of the Auto Route
Protocol dialog box.
RadWorks 6.0 installation and configuration guide
When the Priority is set to <Mixed> the study will be sent with the priorities
defined for the different destinations. However, when you select a single
value, such as ‘High’, the priority settings of all destinations will be overridden with this new value. Likewise, the destination’s transmission format will
not be overruled by the settings here, when the format is set to <Mixed>.
The options Send Immediate, Transmission Time and Delay Time will always
override those of the individual destination’s settings.
Setting Auto Route Rules
In many cases, it may be necessary to add filter criteria, so only certain studies
will be sent automatically after the Auto Route protocol has been triggered.
Adding a filter criterion allows you to use ‘AND’ or ‘NOT’ as a condition.
You can also use wildcards by typing an asterisk as prefix and/or suffix (e.g.
*b* or *hair*). You cannot use a wildcard as part of a range.
If you type a value, then press enter, that value will be added to the grayed out
line at the bottom of the dialog window and the Value field is emptied. Typing
a new value using the same DICOM tag will add that value to the existing one.
You can create more complex rules by adding rules in scripts. Once a rule has
been edited you can no longer modify it with Modify.
Duplicate jobs
You can define two or more Auto Transmit protocols for the same trigger.
Consequently, duplicate jobs may appear in the Send Queue: the same study is
sent twice to the same destination. There are cases when this is what the user
wants: e.g. to send a highly compressed study immediately, and the uncompressed study later during the night. However, in some cases the duplicate job
is not submitted to the Send Queue.
The duplicate job is only submitted, if “extra data” will be sent by the duplicate job. “Extra data” are:
• The whole study instead of only the key images.
• An uncompressed (or lossless compressed) study instead of a lossy
compressed study.
• The study with the same lossy compression format, but with a lower
compression rate (= less affected images).
75
• The study with a different lossy compression format than in the first
job.
Duplicates are only detected for jobs generated by the same trigger, or jobs
generated by simultaneous triggers (e.g. ‘Study Received’ and ‘QC Match
failed’, or ‘Save After Viewing’ and ‘Key Images Defined’).
The order of the jobs (“which is the first and which is the second job” in the
description above) is determined by the job priority and the transmission time.
Auto-routing configuration examples
This section includes a number of examples of how to configure auto-routing.
Example 1
All studies received during office hours are sent to destination 1, and studies
outside office hours are sent to destination 2.
1111 Add Destination 1 and Destination 2 by selecting Connection →
Destinations...and clicking the Add button.
GEMS IT Applicare
76
CONFIGURING TELERADIOLOGY
chapter 3
2222 Create two Auto Route protocols, one that is activated between 9:00
AM and 5:00 PM and the other that is activated between 5:00 PM
and 9:00 AM.
3333 Set the trigger as ‘Study Received’ and from all origins.
4444 Select the destinations, Destination 1 and Destination 2, respectively.
Example 2
A received study is auto routed to Destination 1 uncompressed and to Destination 2 compressed.
1111 Add Destination 1 and Destination 2 by selecting Connection →
Destinations...and clicking the Add button.
2222 Set the default transmission parameters for the Destination 1 to
uncompressed and Destination 2 to compressed.
3333 Create two auto transmit protocols, select Destinations 1 and 2, but
do not change the Origins, Transmission Format and Compression
Parameters settings (use default).
4444 Set the trigger for both to ‘Study Received’
RadWorks 6.0 installation and configuration guide
Example 3
After viewing and authorization, CT studies must be auto transmitted to Destination 1 and MR studies must be auto transmitted to Destination 2.
1111 Add Destination 1 and Destination 2 by selecting Connection →
Destinations...and clicking the Add button.
2222 Create two Auto Transmit protocols with the trigger set to ‘Save
after Viewing’.
3333 Create rules for Destination 1:
DICOM tag 0008.0061, value *CT*
DICOM tag 0032.000A, value AUTHORIZED.
4444 Create a rule for Destination 2:
DICOM tag 0008.0061, value *MR*
DICOM tag 0032.000A, value AUTHORIZED.
Example 4
When a radiologist is on call, CR studies must be sent compressed, and all
other studies must be sent uncompressed to him.
1111 Add two Destinations by selecting Connection → Destina-
tions...and clicking the Add button.
2222 Create two Auto Transmit protocols with the trigger set to ‘Study
Received’ and from all origins.
3333 For the first protocol, select a compression format and add the rule:
DICOM tag 0008.0061, value *CR*
4444 For the second protocol, no compression format and add the rule:
NOT (DICOM tag 0008.0061, value *CR*)
Example 5
Six remote sites transfer un-reported studies to the hub, which RadWorks
receives. For example, CT's Bone have to be sent on to Radiologist 1, all other
CT's to Radiologist 2, MR’s Neuro to Radiologist 3 and all other MR's to
Radiologist 4.
Configuration:
1111 Add the 4 different destinations by selecting Connection → Desti-
nations...and clicking the Add button.
2222 Add the 6 different origins in the Connection → Origins menu
option.
3333 Create 4 Auto Transmit protocols with the trigger set to ‘Study
Received’ and select the six specific origins in each protocol.
77
4444 Set the rules:
Radiologist 1:
DICOM tag 0008.0061, value *CT*
DICOM tag 0018.0015, value Bone
Radiologist 2:
DICOM tag 0008.0061, value *CT*’
NOT DICOM tag 0018.0015, value Bone
Radiologist 3:
DICOM tag 0008.0061, value *CT*
DICOM tag 0018.0015, value Neuro
Radiologist 4:
DICOM tag 0008.0061, value *CT*
NOT DICOM tag 0018.0015, value Neuro
GEMS IT Applicare
78
CONFIGURING TELERADIOLOGY
chapter 3
Troubleshooting an origin and a destination
First check your network connections to confirm the remote site information
(even another workstation in your LAN could be set up as a remote site).
Verifying the network IP address
1111 Open the Control Panel.
2222 Double click Network.
3333 Click the Protocols tab in the Network dialog box.
4444 Double click TCP/IP Protocol.
5555 In the Microsoft TCP/IP Properties dialog box, click the WINS
Address tab. Check the Primary WINS server IP address to confirm
its accuracy: if the address is accurate, you can also check that the
connection is active by pinging it.
Pinging a remote site
1111 Open a command prompt (in NT 4: MS-DOS Prompt).
RadWorks 6.0 installation and configuration guide
2222 At the command prompt, type ‘ping’[space][the IP address of the
remote site].
3333 Verify the returned ‘Reply from…’ IP address.
Checking the Host Name to IP address mapping
1111 Go to the C:\Winnt\system 32\drivers\etc folder.
2222 Open ‘Hosts’ with Notepad. This file contains the mapping of IP
addresses to host names.
3333 Read the instruction given in the file and, on a new line, enter the IP
address followed by spaces and then the host name (the host name
must be a single word) of the remote system.
4444 Save the ‘Hosts’ file.
5555 If you are concerned about security, right click the ‘Hosts’ file and
select Properties from the pop-up menu.
79
GEMS IT Applicare
80
CONFIGURING TELERADIOLOGY
chapter 3
RadWorks 6.0 installation and configuration guide
CHAPTER
Configuring the Viewing Section
This chapter describes the installation and configuration of the RadWorks Viewing
Section.
Configuring multiple monitors...................................82
Viewing properties....................................................84
Navigation buttons ...................................................88
Configuring annotations ...........................................89
IN THIS
Working with hanging protocols ...............................90
CHAPTER
Plug-ins ..................................................................105
82
Y
CONFIGURING THE VIEWING SECTION
chapter 4
ou can define in detail how to view images in RadWorks. Some of this
configuration depends on your monitors, the rest you can set.
Configuring multiple monitors
While most of the configuration of multiple monitors can be done in Windows, RadWorks still needs to know how to use your monitors.
To set these properties, log on as a system administrator.
1111 Select Configuration → Generic from the menu bar in the Data
Selector and click the Monitors tab.
RadWorks 6.0 installation and configuration guide
The monitor numbers in this dialog box correspond to the numbers
on the Settings tab of the Display control panel.
2222 For each adapter, set the arrangement: click Settings, and specify
how many rows and columns of monitors are connected to that
adapter.
3333 Optionally, define monitor groups. A group must have monitors with
the same resolution and/or color space. Monitors in a group must be
adjacent to each other. For each group, you can set the font, the scale
factor, and whether the monitors are portrait and/or color monitors.
4444 Set the ‘Default Monitor’.
5555 Set the ‘Selector Monitor’ - this determines where the Data Selector
will appear.
6666 Restart RadWorks.
7777 Select the Configuration → Viewing Properties menu, and click
the General tab.
8888 If you have more than one monitor group: in the ‘Monitor Groups’
box, set which monitor groups will be used as the viewing area.
9999 In the ‘Hanging Protocols group’ box, select the monitor group to
display the Hanging Protocols on. All other monitors will display the
default single viewport.
The other settings on this tab are for the Viewing properties.
83
GEMS IT Applicare
84
CONFIGURING THE VIEWING SECTION
chapter 4
Viewing properties
You must log on as an administrator to be able to alter all the properties. If you
do not have administrative rights you will only be able to change ‘nonghosted’ properties.
The next sections describe the options in the Configuration → Viewing
Properties dialog. Refer to the online help for more detailed information
about each tab of this dialog.
General tab
Select the Direct View option to view images as they arrive (see below).
View Images as they arrive
This feature consists of three items:
• Direct view of items in a remote view (or archive).
• Direct view of worklist items that are not local.
• Wait mode for receiving new studies from a selected origin (monitoring mode).
RadWorks 6.0 installation and configuration guide
After restarting RadWorks, right click in the Data Selector and select ‘Receive
new study’ in the menu that appears, to enable Monitoring mode. When you
select this, a dialog box appears that allows you to choose the origin for the
studies.
To view Remote View studies, select a study in the active Remote View, right
click, and select ‘View’ instead of ‘Import’ in the menu that appears.
Pop-up menu tab
Here, both administrators and end-users can decide which menu items will be
available in the Viewports and the Worklist windows. Select the items you
want to be available.
Cutlines tab
Here, you can set preferences (line color, style) for cutlines and their labels.
Require Frame of Reference
When determining whether cutlines can be computed between multiple series
this option decides whether those series need to have the same “Frame of Reference” UID (DICOM tag 00200052). By default this option is checked,
meaning that multiple series need to have the same Frame of Reference UID
for cutlines to be computed.
In case the Frame of Reference UIDs are different or absent, and it is known
(as declared by the modality manufacturer) that the series are still spatially
related to each other, this option can be disabled to still allow cutlines to be
computed and displayed. However, this may result in the incorrect display of
the cutlines.
Applicare will not take any responsibility for the display results of the cutlines
if this option is disabled.
Compose set description
Select the way you want to identify a series of images in the Cutline Sets section of the Cutline Tooltab; e.g., by series number, study description or body
part etc. Show Image Information tells RadWorks to indicate the number of
images in a series when it displays the set description.
View the results of your settings in the pane below the drop-down list and
check box.
Compose Label
Compose Label determines how you want to display labels. A label consists
of three parts. Select from the first drop-down list the first part of the label.
Use the second drop-down list to select a separator and the third list to define
the third part of the label.
85
View the results in the pane below the drop-down lists.
Patient Info/Cine tab
De-activate the Patient Information window if you are setting up an educational system. This will ensure the privacy of the patients.
You may also want to disable the Viewport Annotations, or edit them so that
patient related information will not be available in the Viewports.
You can specify the number of cines RadWorks can simultaneously run. RadWorks sets this to 4 by default. The minimum is 1 and the maximum is 16.
Pictorial tab
Define the properties of the Pictorial Index. You use this tab to create more or
less room, provide more or less information or define the fonts and style of
study or series headers in the Viewing Section. You also define the kind of
information that will appear in headers.
Modalities tab
The initial zoom factor in Viewing can be clipped to a user definable value
that is modality dependent.
GEMS IT Applicare
86
CONFIGURING THE VIEWING SECTION
chapter 4
The administrator can set an upper boundary to the initial zoom factor. After
changing the zoom settings, the clipping is disabled. The clipping is reenabled when the study is loaded again or if the reset button is clicked.
Viewport Annotation tab
For each modality, you can set which information is to be displayed along the
edges of each image. Private attributes (those with an odd DICOM group
number, for example 00191010) can also be included when the private tag is
known from, for instance, the sending modality console. This can be useful to
display special scanner options such as contrast settings.
Contents not enclosed by ‘@’ characters will be shown literally in the Viewports and can be used for additional explanations.
Date Time will be shown in the format specified in the Regional Settings control panel.
The contents of a tag is displayed formatted (patient names have commas
instead of ^).
Tags which contain a sequence will display all items in the sequence, separated by backslashes. You can also select one item from the sequence, using
the syntax:
@xxxxyyyy[n]aaaabbbb@
of the sequence with tag (xxxx,yyyy) display from the n-th sequence item, the
value with tag (aaaa,bbbb).
Nested sequences are also supported.
Both sequence and non-sequence items can be suffixed by an index and/or be
followed by a format string (in that order).
Index: @...[n]@: display the n-th value in a multi-valued element.
Invalid indices will result in empty values.
Format: @...%format@: displays the value, formatted according to a C-style
format string.
Examples:
Definition
@00100010@ Sylvia Delors Patient name is displayed
RadWorks 6.0 installation and configuration guide
Example of
contents
Explanation
ST: @00180050@ mm ST: 3 mm @00180060@ is substituted with the image value ‘3’
87
@00200013%i@ 17 The value 00017 from the tag 00200013 is formatted using %i resulting in
@frame@ 1 Frame number is displayed on the individual frames, since there is no
(F@frame@/@00280008@) (F3/12) Will display frame number # of ## frames in brackets. Default setting for
TR: @00180080%.1f@ ms TR: 2000.0 ms The value 005.500000E+03 from the tag 00180080 is formatted using
@00080008@ ORIGINAL\PRIMARY image type, the tag has multiple items as content
@00540410[0]00080104@ displays the first item in the ‘Patient Orientation Code Sequence’
@00080008[0]@ ORIGINAL Index
@00200013%04X@ 000E image number is 14 (000E hexadecimal = 14 decimal)
17
DICOM tag available
XA studies
%.1f giving a result with one decimal
GEMS IT Applicare
88
CONFIGURING THE VIEWING SECTION
chapter 4
Navigation buttons
You can change the position of the navigation buttons in the Viewing Area:
1111 Select Configuration → Viewing... from the Data Selector menu
bar.
2222 Click the General tab of the Viewing Properties dialog box.
3333 Click Configure. The Navigation Buttons dialog opens.
4444 From the drop-down list, select where you want the buttons to be dis-
played.
5555 You can check some of the checkboxes of the buttons to display
them.
The Up Series and Down Series buttons allow you to navigate between the
series. If a study only contains one series, these buttons will not be displayed.
The Prev and Next buttons allow you to navigate through studies in the
Worklist. These buttons work like the ones in the bottom right area of the
tooltab.
RadWorks 6.0 installation and configuration guide
The Back button returns you to the Data Selector. This button works like the
buttons in the bottom right area of the tooltab.
Configuring annotations
Setting up calipers
A caliper can be added to images in the Viewing Section. The caliper will only
be displayed if size information is present in the image (in the Pixel Spacing
DICOM tag 0028,0030).
The caliper is displayed in the center right side of the viewport. Other annotations will not be displayed in the calipers area.
89
To switch calipers on for each modality
1111 Select Configuration → Viewing... from the menu bar in the Data
Selector.
2222 Click the Viewport Annotations tab.
3333 Select the modality.
4444 Check the Show Caliper check box.
Once you have switched this on, you can use the caliper. Open a suitable
study, click the Annotation and Measurement tooltab and check the Show
Caliper check box.
Setting preferences for measurements
Use the Distance tool on the Annotation and Measurement tooltab to drag distance lines across images.
To set preferences for these lines
1111 Open the Configuration → Viewing dialog.
2222 Click the Image Annotations tab.
3333 Check the Tickmarks check box to show tick marks on the distance
lines.
4444 Set the minimal number of pixels between two ticks (experiment
with this setting so the tick marks are at a usable distance on your
monitors).
GEMS IT Applicare
90
CONFIGURING THE VIEWING SECTION
chapter 4
Working with hanging protocols
Hanging protocols allow RadWorks to manage the order and layout of viewports. They also allow the positioning the images from current and prior studies. You can use the hanging protocols on both single and multi-monitor
systems.
RadWorks implements two types of hanging protocol: default and automated.
The basic difference between these is that the automated hanging protocols
allow you to define selection criteria, whilst the default hanging protocols do
not.
Managing hanging protocols
Select Viewing → Hanging Protocols Manager from the Data Selector
menu bar. The ‘Hanging Protocols Manager’ dialog box displays a list of all
the available hanging protocols. With the buttons below the list you can create, modify, copy, disable, delete, import or export hanging protocols. With
the arrow buttons to the left of the list, you can set the priority of a specific
protocol. You can select the group (default or automated hanging protocols)
via the radio buttons.
RadWorks 6.0 installation and configuration guide
To add or modify a hanging protocol
1111 To add a hanging protocol, click New.
2222 To modify an existing hanging protocol, select the protocol you want
to modify and click Modify.
3333 Adjust the settings in the Hanging Protocol Editor (click Help for
detailed information on the options).
4444 If you want to change the layout definition or select a specific hang-
ing protocol under certain conditions, click Wizard (see next section).
Using the wizard will generally be sufficient to create the hanging protocol
selection you want to use. You can fine-tune the hanging protocol with the
Fine tuning button in the Hanging Protocol Editor. This allows you to edit the
VB script that defines the Hanging Protocol. Only change this if you are
familiar with Visual Basic.
Wizard
There are three wizards that guide you through the main features of the protocol:
• Layout design wizard,
• Hang criteria wizard,
• Selection criteria wizard.
With the layout design and hang criteria wizards you define how the selected
studies are presented. By using the wizard, you actually create or modify a
two-part script.
The first part of the script contains the layout (the positioning of series areas
and image areas) and hang criteria (the placement of a scout image for example).
The second part of the script is a VB script. This part contains the selection
criteria definitions. With the selection criteria, you can make rules to select
specific study data to apply to the layout design and hang criteria.
If the set of studies you select for viewing match the selection criteria, the
studies are presented in the way you defined the layout design and hang criteria. If there are more hanging protocols with valid selection criteria, the one
with the highest priority will be applied. The higher the position in the list
with protocols in the Hanging Protocols Manager, the higher its priority.
91
Also, if there are multiple hanging protocols with one or more of the same
selection criteria, you should place the protocol with the most selection criteria at the top of the list.
Fine-tuning
You can make modifications to the ‘programming code’ that makes up a hanging protocol using the Fine Tuning button.
When you are adding or modifying a default hanging protocol, you cannot
edit the ‘Hanging Protocol Selection Criteria’ function area, because this
function only applies to automated hanging protocols. The selection criteria
script is displayed on a grayed background.
The ‘Hanging Protocol Fine Tuning’ dialog box displays two editable text
boxes. Only the second box, containing the selection criteria definitions, will
be parsed each time the user opens study data.
GEMS IT Applicare
92
chapter 4
Comment text in the
boxes is preceded by a
single quote (‘). It is recommended to maximize the
‘Hanging Protocol Fine Tuning’
dialog when you are editing one of
the boxes.
CONFIGURING THE VIEWING SECTION
The second box contains Hanging Protocol Selection Criteria. This code consists of a function that validates the protocol based on the selected array of
data_selection) as the input variable. The code loops through the supplied
data (
data selection. The code in the loop can set the function return variable to
TRUE or FALSE if given conditions are met or not met. For example, if the
modality of all data series is equal to ‘MR’ the function returns TRUE.
The text displayed in the gray areas above and under the second text box contains information about the protocol itself and the editor.
Hanging protocol definition
The first editable area does not contain VB Script language but a structured
language developed by GEMS IT Applicare, which can only be read by the
RadWorks program. With this language, a custom layout can be defined by
dividing the viewing area in series and image areas. You can also add hang
criteria in this area like the pinning of a scout image and the positioning of an
AP or LR image. The following layout functions can be used.
Element Description
[L begin layout
[S begin series area
[V begin image area (also called viewport)
] End of L, S, V
LayoutName(“Name”) Function for setting the name for this layout function:
SplitNone Use the full area for just one view area
SplitHor X Divide the selected series into X rows; X is a number.
SplitVer Y Divide the selected row of the selected series in Y number of
PinProp AllCutlineSets Pin the image. Do not select a particular cutline set.
HangCriteria(0x80008,IS,”LOCALIZER”)
HangCriteria(0x185101,IsEqualTo,"AP" "PA")
HangCriteria(0x185101,IsEqualTo,"LR" "RL")
HangCriteria(0x80060,IsEqualTo,"MR")
Possible layout functions
rows.
Position image with DICOM tag ‘Image Type’ equals “Localizer”.
Position AP / PA images.
Position LR / RL images.
Position to DICOM tag modality.
RadWorks 6.0 installation and configuration guide
Element Description
93
No(x) Sequential number of Series or image. This is currently not used
TimeOrder(MostRecent) Position to time order.
WindowProp(518,1549,Linear) Position with set windowing levels.
ZoomProp(Relative,1.000000) Position with set zoom factor.
AnnotationProp(None) Position with set level of annotation.
OrientationProp("L\F") Position with set orientation.
Possible layout functions
by RadWorks, but can be in one of the future releases or Service
Packs.
Example:
• The name of the layout is TechRef.
• There are 2 series in the viewport.
• There are 6 images in each series.
• The 6 images are configured with 3 rows with 2 columns.
• The first picture of the first series is the scout image.
• Position AP / PA images first.
Result code:
[L LayoutName("TechRef") SplitVer 2 LAYOUT ‘TechRef’ with 2 columns
[S No(0) SplitHor 3 divide FIRST SERIES in 3 rows
[ SplitVer 2 divide first row in 2 columns
[V No(0) PinProp AllCutlineSets pin the first image if the DICOM
tag
HangCriteria(0x185101,IsEqualTo,"AP" "PA")position AP,PA images
first
contains “LOCALIZER”
V] end scout image area
[V No(0) V]second image area
]end of first row
[ SplitVer 2 divide second row in 2 columns
[V No(0) V] first image area
[V No(0) V] second image area
] end of second row
[ SplitVer 2 divide third row in 2 columns
[V No(0) V] first image area
HangCriteria(0x80008,IsEqualTo,"LOCALIZER") Image Type
GEMS IT Applicare
94
CONFIGURING THE VIEWING SECTION
chapter 4
[V No(0) V] second image area
] end of third row
S] end of FIRST SERIES AREA
[S No(0) SplitHor 3 divide SECOND SERIES in 3 rows
HangCriteria(0x185101,IsEqualTo,"LR" "RL") position LR,RL
images secondly
[ SplitVer 2 divide second row in 2 columns
[V No(0) V] first image area
[V No(0) V] second image area
] end of first row
[ SplitVer 2 divide second row in 2 columns
[V No(0) V] first image area
[V No(0) V] second image area
] end of second row
[ SplitVer 2 divide third row in 2 columns
[V No(0) V] first image area
[V No(0) V] second image area
] end of third row
S] end of SECOND SERIES AREA
L]end of LAYOUT definition
Regularly check the syn-
tax with the Check but-
ton next to the box you
are editing.
Hanging protocol selection criteria
The second editable area contains VB Script language. As already stated, the
best way to create the selection criteria is to use the Selection Criteria Wizard
by clicking the Wizard button in the Hanging Protocol Manager. With this
script, a custom selector can be defined by applying certain conditions in it. If,
however, you desire very specific selections, you will need to use the scripting
tool. The scripting statements shown below can be used.
Statement Description
For study... Next With this statement the script loops through the selected studies.
For series... Next With this statement the script loops through the series of the selected studies.
Scripting statements
RadWorks 6.0 installation and configuration guide
Statement Description
95
For tag... Next With this statement the script loops through the tags stored in tag_descr.
LBOUND (ARRAY
[,DIM])
UBOUND (ARRAY
[,DIM])
Scripting statements
These tags are a restricted set of tags. The tags are:
BodyPartExamined
ContrastBolusAgent
EchoTime
ImageOrientation
ImageType
Modality
PatientOrientation
PatientPosition
Protocol
RepetitionTime
SeriesDescription
SeriesInstanceUID
StudyDescription
StudyInstanceUID
ViewPosition
SeriesInStudy
ImagesInSeries
ImagesInStudy
StudiesInDataSelection
SeriesInDataSelection
Keep in mind that tag_descr is case sensitive. It is possible to expand the list
of available DICOM tags by adding them as keys to the registry.
HKEY_LOCAL_MACHINE\SOFTWARE\AMI\RadWorks\6.0\Modules\Viewing\HangingProtocols\DICOMTags\Default.
Note: Do not create too many keys because it might decrease the performance of your system.
Returns the lower bounds for all dimensions of an array, or the lower bound
for a specified dimension. ARRAY must be an array. DIM must be a scalar
integer with a value in the range 1 to n, where n is the rank of ARRAY.
Results: The result type is default integer.
Returns the upper bounds for all dimensions of an array, or the upper bound
for a specified dimension. ARRAY must be an array. DIM must be a scalar
integer with a value in the range 1 to n, where n is the rank of ARRAY.
Results: The result type is default integer.
Sample script
Apply this hanging protocol only for selected series containing CT modalities
with a localizer image (also called scout or pilot image). This localizer image
should not be the only image in the series.
Function CheckSelectionCriteria_TechRef(data_selection)
CheckSelectionCriteria_TechRef = false
For study = LBound(data_selection, 1) To UBound(data_selection, 1)
For series = LBound(data_selection, 2) To UBound(data_selection, 2)
ScoutPresent = false
ImagesPerSeries = 0
GEMS IT Applicare
96
CONFIGURING THE VIEWING SECTION
chapter 4
For tag = LBound(data_selection, 3) To UBound(data_selection, 3)
tag_descr = data_selection(study, series, tag, 0)
tag_value = data_selection(study, series, tag, 1)
tag_count = data_selection(study, series, tag, 2)
If tag_descr = "" Then
Exit For
End If
If tag_descr = "ImagesInSeries" Then
ImagesPerSeries = tag_value
End If
If tag_descr = "Modality" Then
If tag_value <> "CT" Then
Exit Function
End If
End If
If tag_descr = "ImageType" Then
If tag_value = "LOCALIZER" Then
ScoutPresent = TRUE
CheckSelectionCriteria_TechRef = TRUE
End If
End If
Next
If ScoutPresent = TRUE Then
If ImagesPerSeries = 1 Then
CheckSelectionCriteria_TechRef = FALSE
End If
End If
Next
Next
End Function
RadWorks 6.0 installation and configuration guide
Explanation of the sample script
Declaration of the function. Return the result as Boolean. Take the array
data_selection as input.
Function CheckSelectionCriteria_TechRef(data_selection)
Init the return value as FALSE from the function. Assume the selection is
incorrect.
CheckSelectionCriteria_TechRef = FALSE
Next, loop through the studies in the selected data.
For study = LBound(data_selection, 1) To UBound(data_selection, 1)
Now, loop through the series in the selected study.
For series = LBound(data_selection, 2) To UBound(data_selection,
2)
Declare and initialize the required local variables. Mark the scout image as not
found and the number of images per series as 0.
ScoutPresent = false
ImagesPerSeries = 0
Loop through the tags in the selected series.
For tag = LBound(data_selection, 3) To UBound(data_selection,
3)
Next, retrieve tag information from the data selection array. Store them in
local variables.
tag_descr = data_selection(study, series, tag, 0)
tag_value = data_selection(study, series, tag, 1)
tag_count = data_selection(study, series, tag, 2)
Stop the search ASAP. If out of tags then leave the series loop. Go to the next
series.
If tag_descr = "" Then
Exit For
End If
Put number of images in this series in a local variable ImagePerSeries.
97
If tag_descr = "ImagesInSeries" Then
ImagesPerSeries = tag_value
End If
Next, specify your selection criteria.
Example: Check if modality is not MR.
First check if
tag_descr equals “Modality”.
If tag_descr = "Modality" Then
Don’t select data other than with the CT modality. Check if tag_value does
NOT equal “CT”.
If tag_value <> "CT" Then
Stop selecting by exiting the function. Hence the function return value stays
FALSE.
Exit Function
Correctly end the IF .. THEN conditions with END IF statements
End If
GEMS IT Applicare
98
CONFIGURING THE VIEWING SECTION
chapter 4
End If
Check if tag_descr equals “Imagetype”.
If tag_descr = "ImageType" Then
Check if tag_value of “ImageType” contains the string “LOCALIZER”.
If tag_value = "LOCALIZER" Then
Mark scout image by setting variable ScoutPresent as TRUE.
ScoutPresent = TRUE
Return function variable as TRUE.
CheckSelectionCriteria_TechRef = TRUE
End If
End If
Next
If, after looping all the tags, a localizer image is found.
If ScoutPresent = TRUE Then
Check if the number of images equals 1.
IfImagesPerSeries=1Then
If the number of images equals 1, return the function variable as FALSE.
RadWorks 6.0 installation and configuration guide
CheckSelectionCriteria_TechRef = FALSE
End If
End If
Correctly end the FOR .. NEXT statements with NEXT.
Next
Next
Correctly end the declaration of the function.
End Function
Combined statements
Combined statements like the following example.
If tag_descr = "Modality" Then
If tag_value <> "MR" Then
CheckSelectionCriteria_TechRef_ = false
Exit Function
End If
End If
Can be replaced with:
If tag_descr = "Modality" And tag_value <> "MR" Then
CheckSelectionCriteria_TechRef_ = false
Exit Function
End If
This often saves some code. It’s up to you what style of programming you
apply. Choose your programming style preferably in such a way that the
source code is easily readable.
You can also use the OR function on the tag selections.
If tag_descr = "Modality" Then
If tag_value = "MR" or tag_value = "CT" Then
CheckSelectionCriteria_TechRef_ = false
Exit Function
End if
End If
In this example MR and CT modalities are not allowed.
99
Or you can use the
ElseIf statement on the tag selections in combination with
And and Or.
If tag_descr = "Modality" and tag_value <> "MR" Then
CheckSelectionCriteria_TechnicalReferenceManual = false
Exit Function
ElseIf tag_descr = "ImagesInSeries" and (tag_value < "2" or tag_value
>= "9") Then
CheckSelectionCriteria_TechnicalReferenceManual = false
Exit Function
End If
In this example MR modalities are not allowed. For all other modalities, only
the series with 2 images or more, but no more than 9 images in it will return
TRUE.
Most elegant would be the following use of the Select Case statement instead
of separate
If .. Then statements. To make the source better readable you better
add the loop variable behind the Next statements. It also prevents errors by
improper use of the
Function CheckSelectionCriteria_TechRef(data_selection)
CheckSelectionCriteria_TechRef = false
For study = LBound(data_selection, 1) To UBound(data_selection, 1)
For series = LBound(data_selection, 2) To UBound(data_selection, 2)
For .. Next statement
ScoutPresent = false
ImagesPerSeries = 0
GEMS IT Applicare
100
CONFIGURING THE VIEWING SECTION
chapter 4
For tag = LBound(data_selection, 3) To UBound(data_selection, 3)
tag_descr = data_selection(study, series, tag, 0)
tag_value = data_selection(study, series, tag, 1)
tag_count = data_selection(study, series, tag, 2)
Select Case tag_descr
Case "":
Exit For
Case "ImagesInSeries":
ImagesPerSeries = tag_value
Case "Modality":
If tag_value <> "CT" Then
Exit Function
End If
Case "ImageType":
If tag_value = "LOCALIZER" Then
ScoutPresent = TRUE
CheckSelectionCriteria_TechRef = TRUE
End If
End Select
Next tag
If ScoutPresent = TRUE And ImagesPerSeries = 1 Then
CheckSelectionCriteria_TechRef = FALSE
End If
Next series
Next study
End Function
RadWorks 6.0 installation and configuration guide
Data selection array
Before RadWorks starts evaluating the first hanging protocol, it collects only a
subset of DICOM tag contents in the active study selection. The data selection
can consist of a single study or multiple studies selected by the user. This collected data is stored in an array named
data_selection.
Only the tags named in the registry key(s) ‘HangingProtocols\DICOMTags’
are aggregated. Tags occurring multiple times with the same value are stored
just once for evaluation performance reasons. For each occurrence the
tag_count is incremented.
Tags are collected per study and series separately, not per image. That is done
for reasons of speed. There is no need for it to collect tags per image either.
Loading...